@g9tm/syncdata 1.2.1

package/dist/testing/index.js

@@ -0,0 +1,175 @@
+// @g9tm/syncdata/testing — the twin of G9SyncData.Testing's fault scripting (G9CTransportFaults). The .NET in-memory
+// transport calls a server engine in-process; JavaScript has no server engine, so the TypeScript twin wraps ANY transport
+// (typically the SignalR transport against a test server) and injects the same scripted faults (PARITY.md).
+import { G9SyncErrorCodes, G9SyncException } from '../abstractions/errors.js';
+import { delay } from '../internal/abort.js';
+/** The protocol operations (`G9ETransportOperation`). */
+export const G9ETransportOperation = {
+    Connect: 0,
+    Hello: 1,
+    Push: 2,
+    PlanPull: 3,
+    Pull: 4,
+    Reconcile: 5,
+    FetchRows: 6,
+};
+const NAMES = ['Connect', 'Hello', 'Push', 'PlanPull', 'Pull', 'Reconcile', 'FetchRows'];
+/** Scripted transport failures, each consumed once per affected call (`G9CTransportFaults`). */
+export class G9TransportFaults {
+    constructor() {
+        /** Delay (ms) added before every call and every streamed chunk. */
+        this.latencyMs = 0;
+        this._failBefore = new Map();
+        this._failAfter = new Map();
+        this._breakAfter = new Map();
+    }
+    /** The next `times` calls fail before reaching the server. */
+    failBefore(operation, times = 1) {
+        var _a;
+        this._failBefore.set(operation, ((_a = this._failBefore.get(operation)) !== null && _a !== void 0 ? _a : 0) + times);
+        return this;
+    }
+    /** The next `times` unary calls complete on the server, then the response is lost ("applied but not acknowledged"). */
+    failAfter(operation, times = 1) {
+        var _a;
+        this._failAfter.set(operation, ((_a = this._failAfter.get(operation)) !== null && _a !== void 0 ? _a : 0) + times);
+        return this;
+    }
+    /** The next `times` streams of the operation break after delivering `chunks` chunks. */
+    breakStreamAfter(operation, chunks, times = 1) {
+        var _a;
+        if (chunks < 0)
+            throw new RangeError('chunks must be non-negative.');
+        const queue = (_a = this._breakAfter.get(operation)) !== null && _a !== void 0 ? _a : [];
+        for (let i = 0; i < times; i++)
+            queue.push(chunks);
+        this._breakAfter.set(operation, queue);
+        return this;
+    }
+    clear() {
+        this._failBefore.clear();
+        this._failAfter.clear();
+        this._breakAfter.clear();
+    }
+    /** @internal */
+    takeFailBefore(operation) {
+        return take(this._failBefore, operation);
+    }
+    /** @internal */
+    takeFailAfter(operation) {
+        return take(this._failAfter, operation);
+    }
+    /** @internal Chunks to deliver before breaking, or -1. */
+    takeStreamBreak(operation) {
+        const queue = this._breakAfter.get(operation);
+        return queue && queue.length > 0 ? queue.shift() : -1;
+    }
+}
+function take(map, operation) {
+    var _a;
+    const remaining = (_a = map.get(operation)) !== null && _a !== void 0 ? _a : 0;
+    if (remaining <= 0)
+        return false;
+    map.set(operation, remaining - 1);
+    return true;
+}
+function networkFailure(operation, reason) {
+    return new G9SyncException(G9SyncErrorCodes.NetworkFailure, `Injected fault on ${NAMES[operation]}: ${reason}.`, { retryable: true });
+}
+/** A transport that injects {@link G9TransportFaults} into another one, and counts calls. */
+export class G9FaultInjectingTransport {
+    constructor(inner) {
+        this.faults = new G9TransportFaults();
+        /** The continuation of every pull call, in call order (null for a fresh pull). */
+        this.pullContinuations = [];
+        this._calls = new Map();
+        this._disconnected = false;
+        this.inner = inner;
+    }
+    get isConnected() {
+        return !this._disconnected && this.inner.isConnected;
+    }
+    callCount(operation) {
+        var _a;
+        return (_a = this._calls.get(operation)) !== null && _a !== void 0 ? _a : 0;
+    }
+    /** Simulates a dropped connection: the next call fails until the engine reconnects. */
+    disconnect() {
+        this._disconnected = true;
+    }
+    onChangesAvailable(handler) {
+        return this.inner.onChangesAvailable(handler);
+    }
+    async connect(signal) {
+        await this._begin(G9ETransportOperation.Connect, signal);
+        this._disconnected = false;
+        await this.inner.connect(signal);
+    }
+    hello(request, signal) {
+        return this._unary(G9ETransportOperation.Hello, signal, () => this.inner.hello(request, signal));
+    }
+    push(request, chunks, signal) {
+        return this._unary(G9ETransportOperation.Push, signal, () => this.inner.push(request, chunks, signal));
+    }
+    planPull(request, signal) {
+        return this._unary(G9ETransportOperation.PlanPull, signal, () => this.inner.planPull(request, signal));
+    }
+    pull(token, continuation, signal) {
+        this.pullContinuations.push(continuation ? { ...continuation } : null);
+        return this._stream(G9ETransportOperation.Pull, signal, () => this.inner.pull(token, continuation, signal));
+    }
+    reconcile(request, signal) {
+        return this._stream(G9ETransportOperation.Reconcile, signal, () => this.inner.reconcile(request, signal));
+    }
+    fetchRows(request, signal) {
+        return this._stream(G9ETransportOperation.FetchRows, signal, () => this.inner.fetchRows(request, signal));
+    }
+    dispose() {
+        return this.inner.dispose();
+    }
+    async _begin(operation, signal) {
+        var _a;
+        if (signal && signal.aborted)
+            throw new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.');
+        this._calls.set(operation, ((_a = this._calls.get(operation)) !== null && _a !== void 0 ? _a : 0) + 1);
+        if (this.faults.latencyMs > 0)
+            await delay(this.faults.latencyMs, signal);
+        if (this.faults.takeFailBefore(operation))
+            throw networkFailure(operation, 'the call failed before reaching the server');
+    }
+    _ensureConnected() {
+        if (this._disconnected)
+            throw new G9SyncException(G9SyncErrorCodes.NetworkFailure, 'The transport is not connected.', { retryable: true });
+    }
+    async _unary(operation, signal, call) {
+        await this._begin(operation, signal);
+        this._ensureConnected();
+        const result = await call();
+        if (this.faults.takeFailAfter(operation))
+            throw networkFailure(operation, 'the response was lost after the server completed the call');
+        return result;
+    }
+    _stream(operation, signal, open) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        return {
+            async *[Symbol.asyncIterator]() {
+                await self._begin(operation, signal);
+                self._ensureConnected();
+                const breakAfter = self.faults.takeStreamBreak(operation);
+                let delivered = 0;
+                for await (const chunk of open()) {
+                    if (breakAfter >= 0 && delivered >= breakAfter)
+                        throw networkFailure(operation, `the stream broke after ${delivered} chunks`);
+                    if (self._disconnected)
+                        throw networkFailure(operation, 'the connection dropped');
+                    if (self.faults.latencyMs > 0)
+                        await delay(self.faults.latencyMs, signal);
+                    delivered++;
+                    yield chunk;
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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","sourcesContent":["// @g9tm/syncdata/testing — the twin of G9SyncData.Testing's fault scripting (G9CTransportFaults). The .NET in-memory\n// transport calls a server engine in-process; JavaScript has no server engine, so the TypeScript twin wraps ANY transport\n// (typically the SignalR transport against a test server) and injects the same scripted faults (PARITY.md).\nimport { G9SyncErrorCodes, G9SyncException } from '../abstractions/errors.js';\nimport { delay } from '../internal/abort.js';\nimport type { G9SyncTransport } from '../client/transport.js';\nimport type {\n  G9DtChangesAvailable,\n  G9DtFetchRowsRequest,\n  G9DtHelloRequest,\n  G9DtHelloResult,\n  G9DtPullContinuation,\n  G9DtPullPlan,\n  G9DtPullRequest,\n  G9DtPushRequest,\n  G9DtPushResult,\n  G9DtReconcileRequest,\n  G9DtSyncChunk,\n} from '../protocol/dtos.js';\n\n/** The protocol operations (`G9ETransportOperation`). */\nexport const G9ETransportOperation = {\n  Connect: 0,\n  Hello: 1,\n  Push: 2,\n  PlanPull: 3,\n  Pull: 4,\n  Reconcile: 5,\n  FetchRows: 6,\n} as const;\nexport type G9ETransportOperation = (typeof G9ETransportOperation)[keyof typeof G9ETransportOperation];\n\nconst NAMES = ['Connect', 'Hello', 'Push', 'PlanPull', 'Pull', 'Reconcile', 'FetchRows'];\n\n/** Scripted transport failures, each consumed once per affected call (`G9CTransportFaults`). */\nexport class G9TransportFaults {\n  /** Delay (ms) added before every call and every streamed chunk. */\n  latencyMs = 0;\n  private readonly _failBefore = new Map<number, number>();\n  private readonly _failAfter = new Map<number, number>();\n  private readonly _breakAfter = new Map<number, number[]>();\n\n  /** The next `times` calls fail before reaching the server. */\n  failBefore(operation: G9ETransportOperation, times = 1): this {\n    this._failBefore.set(operation, (this._failBefore.get(operation) ?? 0) + times);\n    return this;\n  }\n\n  /** The next `times` unary calls complete on the server, then the response is lost (\"applied but not acknowledged\"). */\n  failAfter(operation: G9ETransportOperation, times = 1): this {\n    this._failAfter.set(operation, (this._failAfter.get(operation) ?? 0) + times);\n    return this;\n  }\n\n  /** The next `times` streams of the operation break after delivering `chunks` chunks. */\n  breakStreamAfter(operation: G9ETransportOperation, chunks: number, times = 1): this {\n    if (chunks < 0) throw new RangeError('chunks must be non-negative.');\n    const queue = this._breakAfter.get(operation) ?? [];\n    for (let i = 0; i < times; i++) queue.push(chunks);\n    this._breakAfter.set(operation, queue);\n    return this;\n  }\n\n  clear(): void {\n    this._failBefore.clear();\n    this._failAfter.clear();\n    this._breakAfter.clear();\n  }\n\n  /** @internal */\n  takeFailBefore(operation: number): boolean {\n    return take(this._failBefore, operation);\n  }\n\n  /** @internal */\n  takeFailAfter(operation: number): boolean {\n    return take(this._failAfter, operation);\n  }\n\n  /** @internal Chunks to deliver before breaking, or -1. */\n  takeStreamBreak(operation: number): number {\n    const queue = this._breakAfter.get(operation);\n    return queue && queue.length > 0 ? (queue.shift() as number) : -1;\n  }\n}\n\nfunction take(map: Map<number, number>, operation: number): boolean {\n  const remaining = map.get(operation) ?? 0;\n  if (remaining <= 0) return false;\n  map.set(operation, remaining - 1);\n  return true;\n}\n\nfunction networkFailure(operation: number, reason: string): G9SyncException {\n  return new G9SyncException(G9SyncErrorCodes.NetworkFailure, `Injected fault on ${NAMES[operation]}: ${reason}.`, { retryable: true });\n}\n\n/** A transport that injects {@link G9TransportFaults} into another one, and counts calls. */\nexport class G9FaultInjectingTransport implements G9SyncTransport {\n  readonly inner: G9SyncTransport;\n  readonly faults = new G9TransportFaults();\n  /** The continuation of every pull call, in call order (null for a fresh pull). */\n  readonly pullContinuations: (G9DtPullContinuation | null)[] = [];\n  private readonly _calls = new Map<number, number>();\n  private _disconnected = false;\n\n  constructor(inner: G9SyncTransport) {\n    this.inner = inner;\n  }\n\n  get isConnected(): boolean {\n    return !this._disconnected && this.inner.isConnected;\n  }\n\n  callCount(operation: G9ETransportOperation): number {\n    return this._calls.get(operation) ?? 0;\n  }\n\n  /** Simulates a dropped connection: the next call fails until the engine reconnects. */\n  disconnect(): void {\n    this._disconnected = true;\n  }\n\n  onChangesAvailable(handler: (changes: G9DtChangesAvailable) => void): () => void {\n    return this.inner.onChangesAvailable(handler);\n  }\n\n  async connect(signal?: AbortSignal): Promise<void> {\n    await this._begin(G9ETransportOperation.Connect, signal);\n    this._disconnected = false;\n    await this.inner.connect(signal);\n  }\n\n  hello(request: G9DtHelloRequest, signal?: AbortSignal): Promise<G9DtHelloResult> {\n    return this._unary(G9ETransportOperation.Hello, signal, () => this.inner.hello(request, signal));\n  }\n\n  push(request: G9DtPushRequest, chunks: AsyncIterable<G9DtSyncChunk>, signal?: AbortSignal): Promise<G9DtPushResult> {\n    return this._unary(G9ETransportOperation.Push, signal, () => this.inner.push(request, chunks, signal));\n  }\n\n  planPull(request: G9DtPullRequest, signal?: AbortSignal): Promise<G9DtPullPlan> {\n    return this._unary(G9ETransportOperation.PlanPull, signal, () => this.inner.planPull(request, signal));\n  }\n\n  pull(token: string, continuation: G9DtPullContinuation | null, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk> {\n    this.pullContinuations.push(continuation ? { ...continuation } : null);\n    return this._stream(G9ETransportOperation.Pull, signal, () => this.inner.pull(token, continuation, signal));\n  }\n\n  reconcile(request: G9DtReconcileRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk> {\n    return this._stream(G9ETransportOperation.Reconcile, signal, () => this.inner.reconcile(request, signal));\n  }\n\n  fetchRows(request: G9DtFetchRowsRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk> {\n    return this._stream(G9ETransportOperation.FetchRows, signal, () => this.inner.fetchRows(request, signal));\n  }\n\n  dispose(): Promise<void> {\n    return this.inner.dispose();\n  }\n\n  private async _begin(operation: number, signal?: AbortSignal): Promise<void> {\n    if (signal && signal.aborted) throw new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.');\n    this._calls.set(operation, (this._calls.get(operation) ?? 0) + 1);\n    if (this.faults.latencyMs > 0) await delay(this.faults.latencyMs, signal);\n    if (this.faults.takeFailBefore(operation)) throw networkFailure(operation, 'the call failed before reaching the server');\n  }\n\n  private _ensureConnected(): void {\n    if (this._disconnected) throw new G9SyncException(G9SyncErrorCodes.NetworkFailure, 'The transport is not connected.', { retryable: true });\n  }\n\n  private async _unary<T>(operation: number, signal: AbortSignal | undefined, call: () => Promise<T>): Promise<T> {\n    await this._begin(operation, signal);\n    this._ensureConnected();\n    const result = await call();\n    if (this.faults.takeFailAfter(operation)) throw networkFailure(operation, 'the response was lost after the server completed the call');\n    return result;\n  }\n\n  private _stream(operation: number, signal: AbortSignal | undefined, open: () => AsyncIterable<G9DtSyncChunk>): AsyncIterable<G9DtSyncChunk> {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const self = this;\n    return {\n      async *[Symbol.asyncIterator](): AsyncGenerator<G9DtSyncChunk> {\n        await self._begin(operation, signal);\n        self._ensureConnected();\n        const breakAfter = self.faults.takeStreamBreak(operation);\n        let delivered = 0;\n        for await (const chunk of open()) {\n          if (breakAfter >= 0 && delivered >= breakAfter) throw networkFailure(operation, `the stream broke after ${delivered} chunks`);\n          if (self._disconnected) throw networkFailure(operation, 'the connection dropped');\n          if (self.faults.latencyMs > 0) await delay(self.faults.latencyMs, signal);\n          delivered++;\n          yield chunk;\n        }\n      },\n    };\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,104 @@
+{
+  "name": "@g9tm/syncdata",
+  "version": "1.2.1",
+  "description": "TypeScript twin of the G9SyncData .NET client for Lynx, Node and browsers: the sync engine, the G9RowBatch protocol, the SQLite client store (same schema as the .NET store) and the SignalR transport.",
+  "license": "MIT",
+  "author": "Iman Kari (G9TM)",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./sqlite": {
+      "types": "./dist/sqlite/index.d.ts",
+      "import": "./dist/sqlite/index.js",
+      "default": "./dist/sqlite/index.js"
+    },
+    "./signalr": {
+      "types": "./dist/signalr/index.d.ts",
+      "import": "./dist/signalr/index.js",
+      "default": "./dist/signalr/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js",
+      "default": "./dist/testing/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "default": "./dist/node/index.js"
+    },
+    "./brotli-js": {
+      "types": "./dist/brotli-js/index.d.ts",
+      "import": "./dist/brotli-js/index.js",
+      "default": "./dist/brotli-js/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "PARITY.md",
+    "LICENSE.md",
+    "THIRD-PARTY-NOTICES.md"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "keywords": [
+    "sync",
+    "offline-first",
+    "sqlite",
+    "signalr",
+    "lynx",
+    "g9"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "node scripts/clean.mjs",
+    "build": "node scripts/clean.mjs && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run",
+    "test:interop": "vitest run --config vitest.interop.config.ts",
+    "test:watch": "vitest",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "@g9tm/signalr-supernetcore-client": "^2.10.0",
+    "@microsoft/signalr": "^10.0.0",
+    "@microsoft/signalr-protocol-msgpack": "^10.0.0",
+    "@msgpack/msgpack": "^2.8.0"
+  },
+  "peerDependenciesMeta": {
+    "@g9tm/signalr-supernetcore-client": {
+      "optional": true
+    },
+    "@microsoft/signalr": {
+      "optional": true
+    },
+    "@microsoft/signalr-protocol-msgpack": {
+      "optional": true
+    },
+    "@msgpack/msgpack": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@g9tm/signalr-supernetcore-client": "file:../../vendor/g9tm-signalr-supernetcore-client-2.10.0.tgz",
+    "@microsoft/signalr": "^10.0.11",
+    "@microsoft/signalr-protocol-msgpack": "^10.0.11",
+    "@msgpack/msgpack": "2.8.0",
+    "@types/node": "^22.15.0",
+    "typescript": "~5.9.3",
+    "vitest": "^5.0.1"
+  }
+}