@g9tm/syncdata 1.2.1

package/dist/signalr/transport.js

@@ -0,0 +1,286 @@
+// Twin of G9SyncData.Client.SignalR/G9CSignalRSyncTransport.cs: the sync transport over the G9SignalRSuperNetCore client
+// (its jittered reconnect policy and connection states), every failure surfacing as a G9SyncException with the server's
+// stable code. Lynx hosts build the client with the native WebSocket of @g9tm/signalr-supernetcore-lynx
+// (`createLynxSyncTransport` in @g9tm/syncdata-lynx does).
+import { G9Client } from '@g9tm/signalr-supernetcore-client';
+import { HubConnectionState, Subject } from '@microsoft/signalr';
+import { G9SyncErrorCodes, G9SyncException, isSyncException } from '../abstractions/errors.js';
+import { createAbortController, onAbort } from '../internal/abort.js';
+import { G9SyncHubErrors, G9SyncProtocol } from '../protocol/protocol.js';
+import { fromMessagePackNames, readChangesAvailable, readHelloResult, readPullPlan, readPushResult, readSyncChunk, toMessagePackNames, } from '../protocol/wire.js';
+import { createSyncMessagePackProtocol, G9SyncJsonHubProtocol } from './protocols.js';
+/** The SignalR hub protocol a client speaks (`G9ESyncHubProtocol`). The server accepts both. */
+export const G9ESyncHubProtocol = {
+    /** Text frames; payloads base64-encoded (+33%). Readable in traces. */
+    Json: 0,
+    /** Binary frames: payloads as raw bytes. The default. */
+    MessagePack: 1,
+};
+/** The SignalR implementation of {@link G9SyncTransport}. */
+export class G9SignalRSyncTransport {
+    constructor(options) {
+        var _a, _b, _c, _d;
+        this._handlers = [];
+        this._connecting = null;
+        if (!options || typeof options.url !== 'string' || options.url.trim() === '')
+            throw new TypeError('A hub URL is required.');
+        this._options = options;
+        const json = options.protocol === G9ESyncHubProtocol.Json;
+        this.format = json ? 'json' : 'messagepack';
+        const protocol = json ? new G9SyncJsonHubProtocol() : createSyncMessagePackProtocol();
+        const clientOptions = {
+            ...((_a = options.client) !== null && _a !== void 0 ? _a : {}),
+            url: options.url,
+            protocol,
+            statefulReconnect: (_b = options.statefulReconnect) !== null && _b !== void 0 ? _b : false,
+            serverTimeoutMs: (_c = options.serverTimeoutMs) !== null && _c !== void 0 ? _c : 30000,
+            keepAliveIntervalMs: (_d = options.keepAliveIntervalMs) !== null && _d !== void 0 ? _d : 10000,
+        };
+        if (options.accessTokenFactory)
+            clientOptions.accessTokenFactory = options.accessTokenFactory;
+        this.client = options.createClient ? options.createClient(clientOptions) : new G9Client(clientOptions);
+        this.client.on(G9SyncProtocol.Listeners.OnChangesAvailable, (payload) => this._onChanges(payload));
+    }
+    get isConnected() {
+        return this.client.connection.state === HubConnectionState.Connected;
+    }
+    onChangesAvailable(handler) {
+        this._handlers.push(handler);
+        return () => {
+            const index = this._handlers.indexOf(handler);
+            if (index >= 0)
+                this._handlers.splice(index, 1);
+        };
+    }
+    /** Connects (joins a connect in progress); a connect that takes longer than connectTimeoutMs is a network failure. */
+    connect(signal) {
+        if (this.isConnected)
+            return Promise.resolve();
+        if (!this._connecting) {
+            const connecting = this._connectCore().finally(() => {
+                if (this._connecting === connecting)
+                    this._connecting = null;
+            });
+            this._connecting = connecting;
+        }
+        const connecting = this._connecting;
+        if (!signal)
+            return connecting;
+        return new Promise((resolve, reject) => {
+            const unsubscribe = onAbort(signal, () => reject(new G9SyncException(G9SyncErrorCodes.Canceled, 'The connect was canceled.')));
+            connecting.then(() => {
+                unsubscribe();
+                resolve();
+            }, (error) => {
+                unsubscribe();
+                reject(error);
+            });
+        });
+    }
+    async _connectCore() {
+        var _a, _b;
+        const timeout = createAbortController();
+        const timer = setTimeout(() => timeout.abort(), (_a = this._options.connectTimeoutMs) !== null && _a !== void 0 ? _a : 20000);
+        try {
+            await this.client.start(timeout.signal);
+        }
+        catch (error) {
+            const mapped = (_b = mapError(error, false)) !== null && _b !== void 0 ? _b : new G9SyncException(G9SyncErrorCodes.NetworkFailure, messageOf(error), { retryable: true, cause: error });
+            throw mapped.code === G9SyncErrorCodes.Canceled
+                ? new G9SyncException(G9SyncErrorCodes.NetworkFailure, `The sync connection to ${this._options.url} did not open in time.`, { retryable: true, cause: error })
+                : mapped;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!this.isConnected) {
+            throw new G9SyncException(G9SyncErrorCodes.NetworkFailure, `The sync connection is ${String(this.client.connection.state)}.`, { retryable: true });
+        }
+    }
+    hello(request, signal) {
+        return this._invoke(G9SyncProtocol.Methods.Hello, [this._wire(request)], readHelloResult, signal);
+    }
+    push(request, chunks, signal) {
+        const subject = new Subject();
+        const result = this._invoke(G9SyncProtocol.Methods.Push, [this._wire(request), subject], readPushResult, signal);
+        void (async () => {
+            try {
+                for await (const chunk of chunks)
+                    subject.next(this._wire(chunk));
+                subject.complete();
+            }
+            catch (error) {
+                subject.error(error);
+            }
+        })();
+        return result;
+    }
+    planPull(request, signal) {
+        return this._invoke(G9SyncProtocol.Methods.PlanPull, [this._wire(request)], readPullPlan, signal);
+    }
+    pull(token, continuation, signal) {
+        return this._stream(G9SyncProtocol.Methods.Pull, [token, continuation === null ? null : this._wire(continuation)], signal);
+    }
+    reconcile(request, signal) {
+        return this._stream(G9SyncProtocol.Methods.Reconcile, [this._wire(request)], signal);
+    }
+    fetchRows(request, signal) {
+        return this._stream(G9SyncProtocol.Methods.FetchRows, [this._wire(request)], signal);
+    }
+    async dispose() {
+        this._handlers.length = 0;
+        await this.client.stop();
+    }
+    // ================================================================ plumbing
+    _wire(value) {
+        return this.format === 'messagepack' ? toMessagePackNames(value) : value;
+    }
+    _read(value) {
+        return this.format === 'messagepack' ? fromMessagePackNames(value) : value;
+    }
+    async _invoke(method, args, read, signal) {
+        var _a;
+        if (signal && signal.aborted)
+            throw new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.');
+        let unsubscribe = () => undefined;
+        try {
+            const call = this.client.connection.invoke(method, ...args);
+            const raw = signal
+                ? await new Promise((resolve, reject) => {
+                    unsubscribe = onAbort(signal, () => reject(new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.')));
+                    call.then(resolve, reject);
+                })
+                : await call;
+            return read(this._read(raw));
+        }
+        catch (error) {
+            throw (_a = mapError(error, signal ? signal.aborted : false)) !== null && _a !== void 0 ? _a : error;
+        }
+        finally {
+            unsubscribe();
+        }
+    }
+    _stream(method, args, signal) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        return {
+            [Symbol.asyncIterator]() {
+                const queue = [];
+                let done = false;
+                let failure = null;
+                let wake = null;
+                let subscription = null;
+                const notify = () => {
+                    const w = wake;
+                    wake = null;
+                    if (w)
+                        w();
+                };
+                let unsubscribeAbort = () => undefined;
+                const start = () => {
+                    if (subscription || done)
+                        return;
+                    let stream;
+                    try {
+                        stream = self.client.connection.stream(method, ...args);
+                    }
+                    catch (error) {
+                        failure = error;
+                        done = true;
+                        return;
+                    }
+                    subscription = stream.subscribe({
+                        next: (item) => {
+                            queue.push(readSyncChunk(self._read(item)));
+                            notify();
+                        },
+                        error: (error) => {
+                            failure = error;
+                            done = true;
+                            notify();
+                        },
+                        complete: () => {
+                            done = true;
+                            notify();
+                        },
+                    });
+                    unsubscribeAbort = onAbort(signal, () => {
+                        failure = new G9SyncException(G9SyncErrorCodes.Canceled, 'The stream was canceled.');
+                        done = true;
+                        subscription === null || subscription === void 0 ? void 0 : subscription.dispose();
+                        notify();
+                    });
+                };
+                const finish = () => {
+                    unsubscribeAbort();
+                    if (subscription && !done)
+                        subscription.dispose();
+                    done = true;
+                };
+                return {
+                    async next() {
+                        var _a;
+                        start();
+                        for (;;) {
+                            const item = queue.shift();
+                            if (item)
+                                return { value: item, done: false };
+                            if (done) {
+                                unsubscribeAbort();
+                                if (failure !== null)
+                                    throw (_a = mapError(failure, signal ? signal.aborted : false)) !== null && _a !== void 0 ? _a : failure;
+                                return { value: undefined, done: true };
+                            }
+                            await new Promise((resolve) => {
+                                wake = resolve;
+                            });
+                        }
+                    },
+                    async return() {
+                        finish();
+                        return { value: undefined, done: true };
+                    },
+                };
+            },
+        };
+    }
+    _onChanges(payload) {
+        const changes = readChangesAvailable(this._read(payload));
+        for (const handler of this._handlers.slice()) {
+            try {
+                handler(changes);
+            }
+            catch {
+                // A ChangesAvailable handler threw (logged by the .NET transport); it must not break the connection.
+            }
+        }
+    }
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * The sync exception for a transport failure (`Map`): the server's `[G9S|code|retryable]` marker wins; any other hub
+ * error is a retryable server error; 401/403 is Unauthorized; the rest is a retryable network failure. Null leaves the
+ * error as it is (an already mapped one).
+ */
+export function mapError(error, canceled) {
+    if (isSyncException(error))
+        return null;
+    if (canceled)
+        return new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.', { cause: error });
+    const message = messageOf(error);
+    const marked = G9SyncHubErrors.tryParse(message);
+    if (marked)
+        return marked;
+    const status = error.statusCode;
+    if (status === 401 || status === 403)
+        return new G9SyncException(G9SyncErrorCodes.Unauthorized, 'The sync server refused the credentials.', { cause: error });
+    if (error instanceof Error && error.name === 'AbortError')
+        return new G9SyncException(G9SyncErrorCodes.Canceled, message, { cause: error });
+    // A completion error from the hub: SignalR words it "An unexpected error occurred invoking '…' on the server."
+    if (/on the server|HubException/i.test(message))
+        return new G9SyncException(G9SyncErrorCodes.ServerError, message, { retryable: true, cause: error });
+    return new G9SyncException(G9SyncErrorCodes.NetworkFailure, message, { retryable: true, cause: error });
+}
+//# sourceMappingURL=transport.js.map

package/dist/signalr/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/signalr/transport.ts"],"names":[],"mappings":"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","sourcesContent":["// Twin of G9SyncData.Client.SignalR/G9CSignalRSyncTransport.cs: the sync transport over the G9SignalRSuperNetCore client\n// (its jittered reconnect policy and connection states), every failure surfacing as a G9SyncException with the server's\n// stable code. Lynx hosts build the client with the native WebSocket of @g9tm/signalr-supernetcore-lynx\n// (`createLynxSyncTransport` in @g9tm/syncdata-lynx does).\nimport { G9Client, type G9ClientOptions } from '@g9tm/signalr-supernetcore-client';\nimport { HubConnectionState, Subject, type IHubProtocol, type IStreamResult, type ISubscription } from '@microsoft/signalr';\nimport { G9SyncErrorCodes, G9SyncException, isSyncException } from '../abstractions/errors.js';\nimport { createAbortController, onAbort } 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';\nimport { G9SyncHubErrors, G9SyncProtocol } from '../protocol/protocol.js';\nimport {\n  fromMessagePackNames,\n  readChangesAvailable,\n  readHelloResult,\n  readPullPlan,\n  readPushResult,\n  readSyncChunk,\n  toMessagePackNames,\n  type G9WireFormat,\n} from '../protocol/wire.js';\nimport { createSyncMessagePackProtocol, G9SyncJsonHubProtocol } from './protocols.js';\n\n/** The SignalR hub protocol a client speaks (`G9ESyncHubProtocol`). The server accepts both. */\nexport const G9ESyncHubProtocol = {\n  /** Text frames; payloads base64-encoded (+33%). Readable in traces. */\n  Json: 0,\n  /** Binary frames: payloads as raw bytes. The default. */\n  MessagePack: 1,\n} as const;\nexport type G9ESyncHubProtocol = (typeof G9ESyncHubProtocol)[keyof typeof G9ESyncHubProtocol];\n\n/** Options of {@link G9SignalRSyncTransport} (`G9CSignalRSyncTransportOptions`). Durations are milliseconds. */\nexport interface G9SignalRSyncTransportOptions {\n  /** Absolute hub URL, e.g. `https://sync.example.com/g9sync`. */\n  url: string;\n  /** Hub protocol; MessagePack by default. */\n  protocol?: G9ESyncHubProtocol;\n  /** Supplies the bearer token for every (re)connect. */\n  accessTokenFactory?: () => string | Promise<string>;\n  /** SignalR stateful reconnect (ADR-0069); off by default, the server must allow it too. */\n  statefulReconnect?: boolean;\n  /** How long one connect may take before it counts as a network failure. */\n  connectTimeoutMs?: number;\n  serverTimeoutMs?: number;\n  keepAliveIntervalMs?: number;\n  /**\n   * Everything else the G9 client takes (transport, headers, WebSocket constructor, skipNegotiation, reconnect policy, log\n   * level…) — the twin of ConfigureHttpConnection/ConfigureBuilder. `url`, `protocol` and the timeouts above win.\n   */\n  client?: Partial<G9ClientOptions>;\n  /** Builds the client (tests, hosts with their own wiring); `new G9Client(options)` by default. */\n  createClient?: (options: G9ClientOptions) => G9Client;\n}\n\n/** The SignalR implementation of {@link G9SyncTransport}. */\nexport class G9SignalRSyncTransport implements G9SyncTransport {\n  readonly client: G9Client;\n  readonly format: G9WireFormat;\n  private readonly _options: G9SignalRSyncTransportOptions;\n  private readonly _handlers: ((changes: G9DtChangesAvailable) => void)[] = [];\n  private _connecting: Promise<void> | null = null;\n\n  constructor(options: G9SignalRSyncTransportOptions) {\n    if (!options || typeof options.url !== 'string' || options.url.trim() === '') throw new TypeError('A hub URL is required.');\n    this._options = options;\n    const json = options.protocol === G9ESyncHubProtocol.Json;\n    this.format = json ? 'json' : 'messagepack';\n    const protocol: IHubProtocol = json ? new G9SyncJsonHubProtocol() : createSyncMessagePackProtocol();\n    const clientOptions: G9ClientOptions = {\n      ...(options.client ?? {}),\n      url: options.url,\n      protocol,\n      statefulReconnect: options.statefulReconnect ?? false,\n      serverTimeoutMs: options.serverTimeoutMs ?? 30000,\n      keepAliveIntervalMs: options.keepAliveIntervalMs ?? 10000,\n    };\n    if (options.accessTokenFactory) clientOptions.accessTokenFactory = options.accessTokenFactory;\n    this.client = options.createClient ? options.createClient(clientOptions) : new G9Client(clientOptions);\n    this.client.on(G9SyncProtocol.Listeners.OnChangesAvailable, (payload: unknown) => this._onChanges(payload));\n  }\n\n  get isConnected(): boolean {\n    return this.client.connection.state === HubConnectionState.Connected;\n  }\n\n  onChangesAvailable(handler: (changes: G9DtChangesAvailable) => void): () => void {\n    this._handlers.push(handler);\n    return () => {\n      const index = this._handlers.indexOf(handler);\n      if (index >= 0) this._handlers.splice(index, 1);\n    };\n  }\n\n  /** Connects (joins a connect in progress); a connect that takes longer than connectTimeoutMs is a network failure. */\n  connect(signal?: AbortSignal): Promise<void> {\n    if (this.isConnected) return Promise.resolve();\n    if (!this._connecting) {\n      const connecting = this._connectCore().finally(() => {\n        if (this._connecting === connecting) this._connecting = null;\n      });\n      this._connecting = connecting;\n    }\n    const connecting = this._connecting;\n    if (!signal) return connecting;\n    return new Promise<void>((resolve, reject) => {\n      const unsubscribe = onAbort(signal, () => reject(new G9SyncException(G9SyncErrorCodes.Canceled, 'The connect was canceled.')));\n      connecting.then(\n        () => {\n          unsubscribe();\n          resolve();\n        },\n        (error) => {\n          unsubscribe();\n          reject(error);\n        },\n      );\n    });\n  }\n\n  private async _connectCore(): Promise<void> {\n    const timeout = createAbortController();\n    const timer = setTimeout(() => timeout.abort(), this._options.connectTimeoutMs ?? 20000);\n    try {\n      await this.client.start(timeout.signal);\n    } catch (error) {\n      const mapped = mapError(error, false) ?? new G9SyncException(G9SyncErrorCodes.NetworkFailure, messageOf(error), { retryable: true, cause: error });\n      throw mapped.code === G9SyncErrorCodes.Canceled\n        ? new G9SyncException(G9SyncErrorCodes.NetworkFailure, `The sync connection to ${this._options.url} did not open in time.`, { retryable: true, cause: error })\n        : mapped;\n    } finally {\n      clearTimeout(timer);\n    }\n    if (!this.isConnected) {\n      throw new G9SyncException(G9SyncErrorCodes.NetworkFailure, `The sync connection is ${String(this.client.connection.state)}.`, { retryable: true });\n    }\n  }\n\n  hello(request: G9DtHelloRequest, signal?: AbortSignal): Promise<G9DtHelloResult> {\n    return this._invoke(G9SyncProtocol.Methods.Hello, [this._wire(request)], readHelloResult, signal);\n  }\n\n  push(request: G9DtPushRequest, chunks: AsyncIterable<G9DtSyncChunk>, signal?: AbortSignal): Promise<G9DtPushResult> {\n    const subject = new Subject<unknown>();\n    const result = this._invoke(G9SyncProtocol.Methods.Push, [this._wire(request), subject], readPushResult, signal);\n    void (async () => {\n      try {\n        for await (const chunk of chunks) subject.next(this._wire(chunk));\n        subject.complete();\n      } catch (error) {\n        subject.error(error);\n      }\n    })();\n    return result;\n  }\n\n  planPull(request: G9DtPullRequest, signal?: AbortSignal): Promise<G9DtPullPlan> {\n    return this._invoke(G9SyncProtocol.Methods.PlanPull, [this._wire(request)], readPullPlan, signal);\n  }\n\n  pull(token: string, continuation: G9DtPullContinuation | null, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk> {\n    return this._stream(G9SyncProtocol.Methods.Pull, [token, continuation === null ? null : this._wire(continuation)], signal);\n  }\n\n  reconcile(request: G9DtReconcileRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk> {\n    return this._stream(G9SyncProtocol.Methods.Reconcile, [this._wire(request)], signal);\n  }\n\n  fetchRows(request: G9DtFetchRowsRequest, signal?: AbortSignal): AsyncIterable<G9DtSyncChunk> {\n    return this._stream(G9SyncProtocol.Methods.FetchRows, [this._wire(request)], signal);\n  }\n\n  async dispose(): Promise<void> {\n    this._handlers.length = 0;\n    await this.client.stop();\n  }\n\n  // ================================================================ plumbing\n\n  private _wire(value: unknown): unknown {\n    return this.format === 'messagepack' ? toMessagePackNames(value) : value;\n  }\n\n  private _read(value: unknown): unknown {\n    return this.format === 'messagepack' ? fromMessagePackNames(value) : value;\n  }\n\n  private async _invoke<T>(method: string, args: unknown[], read: (value: unknown) => T, signal?: AbortSignal): Promise<T> {\n    if (signal && signal.aborted) throw new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.');\n    let unsubscribe: () => void = () => undefined;\n    try {\n      const call = this.client.connection.invoke(method, ...args);\n      const raw = signal\n        ? await new Promise<unknown>((resolve, reject) => {\n            unsubscribe = onAbort(signal, () => reject(new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.')));\n            call.then(resolve, reject);\n          })\n        : await call;\n      return read(this._read(raw));\n    } catch (error) {\n      throw mapError(error, signal ? signal.aborted : false) ?? error;\n    } finally {\n      unsubscribe();\n    }\n  }\n\n  private _stream(method: string, args: unknown[], signal?: AbortSignal): AsyncIterable<G9DtSyncChunk> {\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    const self = this;\n    return {\n      [Symbol.asyncIterator](): AsyncIterator<G9DtSyncChunk> {\n        const queue: G9DtSyncChunk[] = [];\n        let done = false;\n        let failure: unknown = null;\n        let wake: (() => void) | null = null;\n        let subscription: ISubscription<unknown> | null = null;\n        const notify = (): void => {\n          const w = wake;\n          wake = null;\n          if (w) w();\n        };\n        let unsubscribeAbort: () => void = () => undefined;\n        const start = (): void => {\n          if (subscription || done) return;\n          let stream: IStreamResult<unknown>;\n          try {\n            stream = self.client.connection.stream(method, ...args);\n          } catch (error) {\n            failure = error;\n            done = true;\n            return;\n          }\n          subscription = stream.subscribe({\n            next: (item) => {\n              queue.push(readSyncChunk(self._read(item)));\n              notify();\n            },\n            error: (error) => {\n              failure = error;\n              done = true;\n              notify();\n            },\n            complete: () => {\n              done = true;\n              notify();\n            },\n          });\n          unsubscribeAbort = onAbort(signal, () => {\n            failure = new G9SyncException(G9SyncErrorCodes.Canceled, 'The stream was canceled.');\n            done = true;\n            subscription?.dispose();\n            notify();\n          });\n        };\n        const finish = (): void => {\n          unsubscribeAbort();\n          if (subscription && !done) subscription.dispose();\n          done = true;\n        };\n        return {\n          async next(): Promise<IteratorResult<G9DtSyncChunk>> {\n            start();\n            for (;;) {\n              const item = queue.shift();\n              if (item) return { value: item, done: false };\n              if (done) {\n                unsubscribeAbort();\n                if (failure !== null) throw mapError(failure, signal ? signal.aborted : false) ?? failure;\n                return { value: undefined as unknown as G9DtSyncChunk, done: true };\n              }\n              await new Promise<void>((resolve) => {\n                wake = resolve;\n              });\n            }\n          },\n          async return(): Promise<IteratorResult<G9DtSyncChunk>> {\n            finish();\n            return { value: undefined as unknown as G9DtSyncChunk, done: true };\n          },\n        };\n      },\n    };\n  }\n\n  private _onChanges(payload: unknown): void {\n    const changes = readChangesAvailable(this._read(payload));\n    for (const handler of this._handlers.slice()) {\n      try {\n        handler(changes);\n      } catch {\n        // A ChangesAvailable handler threw (logged by the .NET transport); it must not break the connection.\n      }\n    }\n  }\n}\n\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * The sync exception for a transport failure (`Map`): the server's `[G9S|code|retryable]` marker wins; any other hub\n * error is a retryable server error; 401/403 is Unauthorized; the rest is a retryable network failure. Null leaves the\n * error as it is (an already mapped one).\n */\nexport function mapError(error: unknown, canceled: boolean): G9SyncException | null {\n  if (isSyncException(error)) return null;\n  if (canceled) return new G9SyncException(G9SyncErrorCodes.Canceled, 'The call was canceled.', { cause: error });\n  const message = messageOf(error);\n  const marked = G9SyncHubErrors.tryParse(message);\n  if (marked) return marked;\n  const status = (error as { statusCode?: unknown }).statusCode;\n  if (status === 401 || status === 403) return new G9SyncException(G9SyncErrorCodes.Unauthorized, 'The sync server refused the credentials.', { cause: error });\n  if (error instanceof Error && error.name === 'AbortError') return new G9SyncException(G9SyncErrorCodes.Canceled, message, { cause: error });\n  // A completion error from the hub: SignalR words it \"An unexpected error occurred invoking '…' on the server.\"\n  if (/on the server|HubException/i.test(message)) return new G9SyncException(G9SyncErrorCodes.ServerError, message, { retryable: true, cause: error });\n  return new G9SyncException(G9SyncErrorCodes.NetworkFailure, message, { retryable: true, cause: error });\n}\n"]}

package/dist/sqlite/apply.d.ts

@@ -0,0 +1,91 @@
+import { G9EMoveOutPolicy } from '../abstractions/enums.js';
+import { G9Long } from '../abstractions/long.js';
+import { G9ApplyReport, type G9ApplySlice } from '../client/storeTypes.js';
+import { type G9DtBackfillRequest, type G9DtNegotiatedTable, type G9DtPullPlan } from '../protocol/dtos.js';
+import { G9StatementBatch, type G9SqliteConnection } from './connection.js';
+import type { G9SqlResult } from './driver.js';
+import { type LocalTable, type StoreInternals } from './internals.js';
+/** The state of one apply transaction (`ApplyContext`). */
+export declare class ApplyContext {
+    readonly connection: G9SqliteConnection;
+    readonly batch: G9StatementBatch;
+    readonly report: G9ApplyReport;
+    readonly dirty: Set<string>;
+    readonly subscriptions: Map<string, {
+        slot: number;
+        ephemeral: boolean;
+    }>;
+    readonly policies: Map<string, G9EMoveOutPolicy>;
+    readonly backfillColumns: Map<number, readonly string[]>;
+    readonly deferredIndexes: {
+        name: string;
+        sql: string;
+    }[];
+    /** Library triggers dropped for the apply, re-created from this SQL before commit. */
+    readonly droppedTriggers: {
+        name: string;
+        sql: string;
+    }[];
+    rows: number;
+    hasRevoked: boolean;
+    private readonly _dirtyTables;
+    private readonly _tableTime;
+    private readonly _progress;
+    private readonly _maxChangedKeys;
+    private readonly _signal;
+    constructor(connection: G9SqliteConnection, progress: ((rows: number) => void) | null, maxChangedKeys: number, statementsPerBatch: number, signal?: AbortSignal);
+    addDirty(tid: number, key: string): void;
+    isDirty(tid: number, key: string): boolean;
+    hasDirty(tid: number): boolean;
+    wantsChangedKey(table: string): boolean;
+    addChanged(table: string, key: string): void;
+    tick(): void;
+    /** Queues a script; flushes when the batch is full. */
+    queue(script: string, params?: Parameters<G9StatementBatch['add']>[1], callback?: (results: G9SqlResult[]) => void): Promise<void>;
+    /** Runs what is queued (before anything that reads, and at the end). Yields to the event loop between batches. */
+    flush(): Promise<void>;
+    addTableTime(table: string, rows: number, elapsedMs: number): void;
+    private readonly _tableNames;
+    publishTableTimes(): void;
+}
+/**
+ * Opens an apply and decides which rows it may not touch (`BeginApply`). `dirtyAfterSequence` narrows the protected set to
+ * pending changes after it; `changedAfterSequence` widens it with every row changed after it (ADR-0046).
+ */
+export declare function beginApply(store: StoreInternals, connection: G9SqliteConnection, options: {
+    dirtyAfterSequence?: number | null;
+    progress?: ((rows: number) => void) | null;
+    backfills?: readonly G9DtBackfillRequest[];
+    snapshotRows?: Map<number, number> | null;
+    changedAfterSequence?: number | null;
+    protectedRows?: {
+        tid: number;
+        key: string;
+    }[] | null;
+    skipTriggers?: boolean;
+    signal?: AbortSignal;
+}): Promise<ApplyContext>;
+/** `EndApply`: rebuilds deferred indexes, re-creates dropped triggers, clears the applying flag. */
+export declare function endApply(context: ApplyContext): Promise<void>;
+/** `g9_{table}_{ai|au|ad|ci|cu|cd}` for a table of the model. */
+export declare function isLibraryTrigger(store: StoreInternals, name: string): boolean;
+/** The triggers the library did not create. */
+export declare function foreignTriggerNames(store: StoreInternals, connection: G9SqliteConnection): Promise<string[]>;
+/** Rows changed after a sequence, table by table (`g9_rows_feed (tid, local_seq)` serves each read). */
+export declare function readRowsChangedAfter(store: StoreInternals, connection: G9SqliteConnection, sequence: number, add: (tid: number, key: string) => void): Promise<void>;
+/** Rows each table receives from snapshot parts of a plan, by server table id. */
+export declare function snapshotRowsByTable(plan: G9DtPullPlan): Map<number, number>;
+/** `synchronous=NORMAL` while a transaction writes only server-derived data (WAL only); returns the restore action. */
+export declare function downloadDurability(store: StoreInternals, connection: G9SqliteConnection): Promise<(() => Promise<void>) | null>;
+/** Applies one frame (`ApplyFrame`). */
+export declare function applyFrame(store: StoreInternals, context: ApplyContext, frame: Uint8Array, subscriptionKey: string | null): Promise<void>;
+/** `MoveOut`: drops the membership; with a Delete policy a row nobody holds goes through the revocation policy. */
+export declare function moveOut(store: StoreInternals, context: ApplyContext, table: LocalTable, key: string, subscriptionKey: string, slot: number, ephemeral: boolean, policy: G9EMoveOutPolicy): Promise<void>;
+/** `AddMembership`. */
+export declare function addMembership(context: ApplyContext, table: LocalTable, key: string, slot: number, ephemeralKey: string | null): Promise<void>;
+/** `ApplyStagedPullAsync`: atomic, or in committed slices (ADR-0053); cursors move only with the last slice. */
+export declare function applyStagedPull(store: StoreInternals, runId: string, rowsApplied: ((rows: number) => void) | null, slices: ((slice: G9ApplySlice) => void) | null, readStagedRun: (connection: G9SqliteConnection, runId: string) => Promise<import('../client/storeTypes.js').G9StagedPull | null>, signal?: AbortSignal): Promise<G9ApplyReport>;
+/** `ApplyReconcileAsync`. */
+export declare function applyReconcile(store: StoreInternals, subscriptionKey: string, table: G9DtNegotiatedTable, fetchedFrames: readonly Uint8Array[], addMembershipKeys: readonly string[], moveOutKeys: readonly string[], policy: G9EMoveOutPolicy, signal?: AbortSignal): Promise<G9ApplyReport>;
+/** For callers that need a G9Long bit as a bind value. */
+export declare function bitValue(slot: number): G9Long;