Merge pull request #195 from jamals86/027-pg-transactions

A stable version with number of improvements to memory consuption and light weight subscription

Author: jamals86

.config/nextest.toml

@@ -1,3 +1,7 @@
+[[profile.default.overrides]]
+filter = 'test(test_setup_complete_environment)'
+threads-required = 15
+
 [profile.ci]
 # Store test results in JUnit format
 junit.path = "junit.xml"

.github/test-release.sh

@@ -44,8 +44,8 @@ if ! command -v wasm-pack &> /dev/null; then
 fi
 
 # Build SDK
-print_step "Building kalam-link SDK..."
-cd "$REPO_ROOT/link/sdks/typescript"
+print_step "Building @kalamdb/client SDK..."
+cd "$REPO_ROOT/link/sdks/typescript/client"
 npm install
 npm run build
 print_success "SDK built"

.github/workflows/ci.yml

@@ -344,7 +344,7 @@ jobs:
 
       - name: Install SDK dependencies
         shell: bash
-        working-directory: link/sdks/typescript
+        working-directory: link/sdks/typescript/client
         run: |
           set -euo pipefail
           npm install --no-audit --no-fund
@@ -353,8 +353,8 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
-          cd link/sdks/typescript
-          npx --yes license-checker --production --json > ../../../target/license/sdk-licenses.json
+          cd link/sdks/typescript/client
+          npx --yes license-checker --production --json > "$GITHUB_WORKSPACE/target/license/sdk-licenses.json"
 
       - name: Validate licenses and generate third-party report
         shell: bash

.github/workflows/release.yml

@@ -132,7 +132,7 @@ jobs:
 
       - name: Install SDK dependencies
         shell: bash
-        working-directory: link/sdks/typescript
+        working-directory: link/sdks/typescript/client
         run: |
           set -euo pipefail
           npm install --no-audit --no-fund
@@ -141,8 +141,8 @@ jobs:
         shell: bash
         run: |
           set -euo pipefail
-          cd link/sdks/typescript
-          npx --yes license-checker --production --json > ../../../target/license/sdk-licenses.json
+          cd link/sdks/typescript/client
+          npx --yes license-checker --production --json > "$GITHUB_WORKSPACE/target/license/sdk-licenses.json"
 
       - name: Validate and generate third-party report
         shell: bash
@@ -207,11 +207,11 @@ jobs:
           cargo install wasm-pack --version "$WASM_PACK_VERSION" --locked
           wasm-pack --version
 
-      - name: Build SDK (kalam-link)
+      - name: Build SDK (@kalamdb/client)
         shell: bash
         run: |
           set -euo pipefail
-          cd link/sdks/typescript
+          cd link/sdks/typescript/client
           npm install
           npm run build
 

.github/workflows/sdks.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
     inputs:
       npm_publish:
-        description: "Publish TypeScript SDK to npm"
+        description: "Publish TypeScript SDK packages to npm"
         type: boolean
         required: false
         default: false
@@ -606,7 +606,7 @@ jobs:
           git push origin main
 
   publish_npm:
-    name: Publish TypeScript SDK to npm
+    name: Publish TypeScript SDK packages to npm
     runs-on: ubuntu-latest
     needs:
       - resolve_versions
@@ -641,9 +641,24 @@ jobs:
           shared-key: npm-publish
           cache-on-failure: true
 
-      - name: Publish TypeScript SDK to npm
+      - name: Publish @kalamdb/client to npm
         shell: bash
-        working-directory: link/sdks/typescript
+        working-directory: link/sdks/typescript/client
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          set -euo pipefail
+          VERSION="${{ needs.resolve_versions.outputs.ts_version }}"
+          FORCE_FLAG=""
+          if [[ "${{ github.event.inputs.force_npm_publish }}" == "true" ]]; then
+            FORCE_FLAG="--force"
+          fi
+          chmod +x ./publish.sh
+          ./publish.sh --version "$VERSION" $FORCE_FLAG
+
+      - name: Publish @kalamdb/consumer to npm
+        shell: bash
+        working-directory: link/sdks/typescript/consumer
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: |

.gitignore

@@ -108,3 +108,12 @@ ui/package-lock.json
 /link/sdks/typescript/.wasm-cargo-home-test2
 ts-sdk-repro/server.toml
 /benchv2/logs
+/benchv2/logs
+/link/kalam-client/sdks/typescript/.wasm-cargo-home
+/link/kalam-client/sdks/typescript/.wasm-target
+/link/kalam-client/sdks/typescript/client/.wasm-cargo-home
+/link/kalam-client/sdks/typescript/client/.wasm-target
+/link/kalam-consumer-wasm/sdks/typescript/consumer/.wasm-cargo-home
+/link/kalam-consumer-wasm/sdks/typescript/consumer/.wasm-target
+/link/sdks/typescript/client/.wasm-cargo-home
+/link/sdks/typescript/client/.wasm-target

AGENTS.md

@@ -82,7 +82,7 @@ use kalamdb_commons::models::UserId;
 - `cli/`: Kalam CLI, smoke tests, and CLI-facing integration flows.
 - `link/`: SDK bridge workspace and shared link infrastructure.
 - `link/sdks/typescript/`: TypeScript SDK.
-- `link/sdks/dart/`: Dart/Flutter SDK. `link/sdks/dart/lib/src/generated` is generated; regenerate with `link/sdks/dart/build_native_libs.sh`.
+- `link/sdks/dart/`: Dart/Flutter SDK. `link/sdks/dart/lib/src/generated` is generated; regenerate and prepare the SDK with `link/sdks/dart/build.sh`.
 - `link/kalam-link-dart/`: Rust bridge/native layer used by the Dart SDK.
 - `pg/`: PostgreSQL extension workspace for `pg_kalam`; see `pg/pg_kalam.control`, `pg/src/`, `pg/crates/`, and `pg/tests/`.
 - `benchv2/`: Benchmark harness, scenarios, templates, and results for performance work.
@@ -138,6 +138,7 @@ backend/crates/
 - Always add `#[ntest::timeout(time)]` to every async test where `time` is the **actual observed runtime** × 1.5 (to cover slower machines).
    - Example: if a test took 40s, set `#[ntest::timeout(60000)]`.
    - Recalculate and update timeouts after significant changes to test behavior or data size.
+- Timeouts are guardrails, not the fix: do not increase a test timeout just because a test started failing. Fix the hang, race, or slow path first, then set the timeout from the measured healthy runtime × 1.5.
 
 ## Workflows & Commands (Documented)
 
@@ -189,4 +190,4 @@ Suggested extra checks:
 6. WebSocket origins must be validated against config or rejected when strict mode is enabled.
 7. Admin or root password by default should be set or is set to kalamdb123 for testing or writting in tests, and the user should be admin
 
-the folder: link/sdks/dart/lib/src/generated is generated dont modify anything in it, to regenerate this run the link/sdks/dart, build_native_libs.sh file which will regenerate this folder
+the folder: link/sdks/dart/lib/src/generated is generated dont modify anything in it, to regenerate this run the link/sdks/dart/build.sh script which also prepares the SDK artefacts