Merge pull request #205 from kalamstack/027-pg-transactions

027 pg transactions

Author: jamals86

.gitignore

@@ -120,3 +120,4 @@ ts-sdk-repro/server.toml
 /target-pg-e2e-isolated
 /benchv2/logs
 /benchv2/logs
+link/sdks/typescript/client/.npmrc

Cargo.toml

@@ -56,7 +56,7 @@ edition = "2021"
 rust-version = "1.92"
 authors = ["KalamDB Team"]
 license = "Apache-2.0"
-repository = "https://github.com/jamals86/KalamDB"
+repository = "https://github.com/kalamstack/KalamDB"
 
 # Shared dependencies for all crates
 [workspace.dependencies]

README.md

@@ -5,18 +5,18 @@
 <p align="center">
   <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/rust-1.92%2B-orange.svg" alt="Rust" /></a>
   <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/license-Apache%202.0-blue.svg" alt="License" /></a>
-  <a href="https://github.com/jamals86/KalamDB/actions/workflows/ci.yml"><img src="https://github.com/jamals86/KalamDB/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
-  <a href="https://github.com/jamals86/KalamDB/actions/workflows/ci.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/jamals86/KalamDB/main/.github/badges/tests.json" alt="Overall Tests" /></a>
-  <a href="https://github.com/jamals86/KalamDB/releases"><img src="https://img.shields.io/github/v/release/jamals86/KalamDB?display_name=tag" alt="Release" /></a>
+  <a href="https://github.com/kalamstack/KalamDB/actions/workflows/ci.yml"><img src="https://github.com/kalamstack/KalamDB/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/kalamstack/KalamDB/actions/workflows/ci.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/kalamstack/KalamDB/main/.github/badges/tests.json" alt="Overall Tests" /></a>
+  <a href="https://github.com/kalamstack/KalamDB/releases"><img src="https://img.shields.io/github/v/release/kalamstack/KalamDB?display_name=tag" alt="Release" /></a>
   <a href="https://hub.docker.com/r/jamals86/kalamdb"><img src="https://img.shields.io/docker/pulls/jamals86/kalamdb" alt="Docker Pulls" /></a>
   <a href="https://hub.docker.com/r/jamals86/pg-kalam"><img src="https://img.shields.io/docker/pulls/jamals86/pg-kalam?label=pg-kalam%20docker" alt="pg-kalam Docker Pulls" /></a>
 </p>
 
 <p align="center"><strong>SDKs</strong></p>
 
 <p align="center">
-  <a href="https://github.com/jamals86/KalamDB/actions/workflows/sdks.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/jamals86/KalamDB/main/.github/badges/sdk-typescript-tests.json" alt="TypeScript SDK Tests" /></a>
-  <a href="https://github.com/jamals86/KalamDB/actions/workflows/sdks.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/jamals86/KalamDB/main/.github/badges/sdk-dart-tests.json" alt="Dart SDK Tests" /></a>
+  <a href="https://github.com/kalamstack/KalamDB/actions/workflows/sdks.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/kalamstack/KalamDB/main/.github/badges/sdk-typescript-tests.json" alt="TypeScript SDK Tests" /></a>
+  <a href="https://github.com/kalamstack/KalamDB/actions/workflows/sdks.yml"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/kalamstack/KalamDB/main/.github/badges/sdk-dart-tests.json" alt="Dart SDK Tests" /></a>
   <a href="https://www.npmjs.com/package/@kalamdb/client"><img src="https://img.shields.io/npm/v/%40kalamdb%2Fclient?label=typescript%20sdk" alt="TypeScript SDK" /></a>
   <a href="https://pub.dev/packages/kalam_link"><img src="https://img.shields.io/pub/v/kalam_link?label=dart%20sdk" alt="Dart SDK" /></a>
 </p>
@@ -54,15 +54,6 @@ This is what lets chat UIs and agent apps read/write state directly and receive
 
 ## Feature & Status
 
-- **User Tables**: First-class `USER` tables provide per-user isolation so the same SQL can safely serve frontend and backend clients.
-- **Shared Tables and SQL Storage**: Standard SQL tables support application state, relational data modeling, and transactional reads and writes.
-- **Streams and Pub/Sub**: Built-in topics, consumer groups, `CONSUME`, and `ACK` support event-driven backends and AI agent workflows.
-- **Live Queries**: WebSocket-backed subscriptions keep clients synchronized in realtime without polling.
-- **Cluster Replication**: Multi-Raft clustering enables multi-node deployments, failover, and replicated state.
-- **Vector Workloads**: Native `EMBEDDING(dimension)` support enables vector storage and semantic retrieval workflows.
-- **PostgreSQL Extension**: `pg_kalam` integrates PostgreSQL with a running KalamDB instance through the bundled FDW.
-- **Admin and Developer Tooling**: KalamDB ships with an Admin UI, the `kalam` CLI, and official TypeScript and Dart SDKs.
-
 | Feature                     | Status       | Feature                 | Status       |
 | :-------------------------- | :----------- | :---------------------- | :----------- |
 | **User Tables**             | ✅ Available | **Shared Tables**       | ✅ Available |
@@ -79,20 +70,20 @@ This is what lets chat UIs and agent apps read/write state directly and receive
 
 ```bash
 KALAMDB_JWT_SECRET="$(openssl rand -base64 32)" \
-curl -sSL https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/single/docker-compose.yml | docker-compose -f - up -d
+curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/single/docker-compose.yml | docker-compose -f - up -d
 ```
 
 ### 3-node cluster
 
 ```bash
 KALAMDB_JWT_SECRET="$(openssl rand -base64 32)" \
-curl -sSL https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/cluster/docker-compose.yml | docker-compose -f - up -d
+curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/cluster/docker-compose.yml | docker-compose -f - up -d
 ```
 
 ### Local run
 
 ```bash
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 cargo run --bin kalamdb-server
 ```

docker/REPO-README.md

@@ -64,13 +64,13 @@ curl -X POST http://localhost:8080/v1/api/sql \
 
 ### 📄 Single-node compose file
 
-- GitHub view: https://github.com/jamals86/KalamDB/blob/main/docker/run/single/docker-compose.yml
-- Raw file: https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/single/docker-compose.yml
+- GitHub view: https://github.com/kalamstack/KalamDB/blob/main/docker/run/single/docker-compose.yml
+- Raw file: https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/single/docker-compose.yml
 
 ### 🧱 3-node cluster compose file
 
-- GitHub view: https://github.com/jamals86/KalamDB/blob/main/docker/run/cluster/docker-compose.yml
-- Raw file: https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/cluster/docker-compose.yml
+- GitHub view: https://github.com/kalamstack/KalamDB/blob/main/docker/run/cluster/docker-compose.yml
+- Raw file: https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/cluster/docker-compose.yml
 
 ### ⚡ Start single node with compose
 
@@ -102,14 +102,14 @@ Single node:
 
 ```bash
 KALAMDB_JWT_SECRET=replace-with-a-32-char-secret \
-curl -sSL https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/single/docker-compose.yml | docker compose -f - up -d
+curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/single/docker-compose.yml | docker compose -f - up -d
 ```
 
 3-node cluster:
 
 ```bash
 KALAMDB_JWT_SECRET=replace-with-a-32-char-secret \
-curl -sSL https://raw.githubusercontent.com/jamals86/KalamDB/main/docker/run/cluster/docker-compose.yml | docker compose -f - up -d
+curl -sSL https://raw.githubusercontent.com/kalamstack/KalamDB/main/docker/run/cluster/docker-compose.yml | docker compose -f - up -d
 ```
 
 ## 🖥️ Open the UI
@@ -270,7 +270,7 @@ docker volume rm kalamdb_data
 ## 🔗 Links
 
 - Docker Hub: https://hub.docker.com/r/jamals86/kalamdb
-- GitHub: https://github.com/jamals86/KalamDB
+- GitHub: https://github.com/kalamstack/KalamDB
 - Docs: https://kalamdb.org/docs
-- Single-node compose: https://github.com/jamals86/KalamDB/blob/main/docker/run/single/docker-compose.yml
-- Cluster compose: https://github.com/jamals86/KalamDB/blob/main/docker/run/cluster/docker-compose.yml
+- Single-node compose: https://github.com/kalamstack/KalamDB/blob/main/docker/run/single/docker-compose.yml
+- Cluster compose: https://github.com/kalamstack/KalamDB/blob/main/docker/run/cluster/docker-compose.yml

docker/build/Dockerfile.prebuilt

@@ -44,7 +44,7 @@ RUN apt-get update && \
 ARG OCI_IMAGE_TITLE="KalamDB"
 ARG OCI_IMAGE_DESCRIPTION="SQL-first realtime state database for AI agents, chat products, and multi-tenant SaaS"
 ARG OCI_IMAGE_URL="https://kalamdb.org"
-ARG OCI_IMAGE_SOURCE="https://github.com/jamals86/KalamDB"
+ARG OCI_IMAGE_SOURCE="https://github.com/kalamstack/KalamDB"
 ARG OCI_IMAGE_DOCUMENTATION="https://kalamdb.org/docs"
 ARG OCI_IMAGE_VENDOR="KalamDB"
 ARG OCI_IMAGE_AUTHORS="Jamal Saad"

docs/development/development-setup.md

@@ -142,7 +142,7 @@ $env:LIBCLANG_PATH
 
 ```powershell
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB\backend
 
 # Build the project (first build will take 10-20 minutes)
@@ -226,7 +226,7 @@ brew install pkg-config
 
 ```bash
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 
 # Build the project (first build will take 10-20 minutes)
@@ -282,7 +282,7 @@ cargo --version
 
 ```bash
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 
 # Build the project (first build will take 10-20 minutes)
@@ -330,7 +330,7 @@ cargo --version
 
 ```bash
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 
 # Build the project
@@ -374,7 +374,7 @@ cargo --version
 
 ```bash
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 
 # Build the project
@@ -692,7 +692,7 @@ If you encounter issues not covered here:
   - [macOS Setup Guide](macos.md#troubleshooting)
   - [Linux Setup Guide](linux.md#troubleshooting)
   - [Windows Setup Guide](windows.md#troubleshooting)
-2. **Check GitHub Issues**: [KalamDB Issues](https://github.com/jamals86/KalamDB/issues)
+2. **Check GitHub Issues**: [KalamDB Issues](https://github.com/kalamstack/KalamDB/issues)
 3. **Search Rust Forums**: Many dependency issues are common across Rust projects
 4. **Enable Verbose Output**: `cargo build -vv` for detailed error messages
 5. **Check Dependencies**: Ensure all system dependencies are installed

docs/development/linux.md

@@ -26,7 +26,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 source $HOME/.cargo/env
 
 # 3. Clone and build
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 cargo build
 ```
@@ -43,7 +43,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 source $HOME/.cargo/env
 
 # 3. Clone and build
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 cargo build
 ```
@@ -60,7 +60,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 source $HOME/.cargo/env
 
 # 3. Clone and build
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 cargo build
 ```
@@ -77,7 +77,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 source $HOME/.cargo/env
 
 # 3. Clone and build
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 cargo build
 ```
@@ -273,7 +273,7 @@ export CARGO_BUILD_JOBS=4
 
 ```bash
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 
 # First build (takes 10-20 minutes - compiles RocksDB, Arrow, Parquet)
@@ -457,7 +457,7 @@ sudo chown -R $USER:$USER ~/KalamDB
 # Or reclone without sudo
 cd ~
 rm -rf KalamDB
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 ```
 
 ---

docs/development/macos.md

@@ -31,7 +31,7 @@ echo 'export DYLD_FALLBACK_LIBRARY_PATH="/Applications/Xcode.app/Contents/Develo
 source ~/.zshrc
 
 # 5. Clone and build
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 cargo build
 ```
@@ -187,7 +187,7 @@ brew install openssl@3
 
 ```bash
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB/backend
 
 # First build (takes 10-20 minutes - compiles RocksDB, Arrow, Parquet)

docs/development/windows.md

@@ -33,7 +33,7 @@ clang --version
 cargo --version
 
 # 5. Clone and build
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB\backend
 cargo build
 
@@ -199,7 +199,7 @@ winget install --id Git.Git -e --source winget
 
 ```powershell
 # Clone the repository
-git clone https://github.com/jamals86/KalamDB.git
+git clone https://github.com/kalamstack/KalamDB.git
 cd KalamDB\backend
 
 # First build (takes 15-30 minutes on Windows - compiles RocksDB, Arrow, Parquet)

docs/getting-started/cli.md

@@ -491,7 +491,7 @@ kalam --csv
 ## Support
 
 For issues, questions, or contributions:
-- GitHub: [github.com/jamals86/KalamDB](https://github.com/jamals86/KalamDB)
+- GitHub: [github.com/kalamstack/KalamDB](https://github.com/kalamstack/KalamDB)
 - Documentation: [docs/README.md](../README.md)
 
 ---