@g9tm/syncdata 1.2.1

package/dist/brotli-js/index.d.ts

@@ -0,0 +1,5 @@
+import type { G9FrameDecompressor } from '../protocol/rowBatch/reader.js';
+/** Decodes a raw Brotli stream. */
+export declare function brotliDecompressJs(compressed: Uint8Array): Uint8Array;
+/** A frame decompressor over the JavaScript decoder. */
+export declare function jsBrotliDecompressor(): G9FrameDecompressor;

package/dist/brotli-js/index.js

@@ -0,0 +1,19 @@
+import { brotliDecode } from './decode.js';
+/** Decodes a raw Brotli stream. */
+export function brotliDecompressJs(compressed) {
+    const input = new Int8Array(compressed.buffer, compressed.byteOffset, compressed.length);
+    const output = brotliDecode(input);
+    return new Uint8Array(output.buffer, output.byteOffset, output.length);
+}
+/** A frame decompressor over the JavaScript decoder. */
+export function jsBrotliDecompressor() {
+    return {
+        decompress(compressed, expectedLength) {
+            const out = brotliDecompressJs(compressed);
+            if (out.length !== expectedLength)
+                throw new Error(`Brotli body decoded to ${out.length} bytes, ${expectedLength} expected.`);
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/brotli-js/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brotli-js/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,mCAAmC;AACnC,MAAM,UAAU,kBAAkB,CAAC,UAAsB;IACvD,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAc,CAAC;IAChD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,UAAU,CAAC,UAAsB,EAAE,cAAsB;YACvD,MAAM,GAAG,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;YAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,cAAc;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,WAAW,cAAc,YAAY,CAAC,CAAC;YAC9H,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["// @g9tm/syncdata/brotli-js — a pure-JavaScript Brotli decoder for frames, for runtimes with no native one (Lynx web,\n// a Lynx host without @g9tm/syncdata-lynx's native module, tests). It is Google's own decoder (about 190 KB of source,\n// most of it the static dictionary), so import it only where it is needed: the native decoders are far faster.\nimport type { G9FrameDecompressor } from '../protocol/rowBatch/reader.js';\nimport { brotliDecode } from './decode.js';\n\n/** Decodes a raw Brotli stream. */\nexport function brotliDecompressJs(compressed: Uint8Array): Uint8Array {\n  const input = new Int8Array(compressed.buffer, compressed.byteOffset, compressed.length);\n  const output = brotliDecode(input) as Int8Array;\n  return new Uint8Array(output.buffer, output.byteOffset, output.length);\n}\n\n/** A frame decompressor over the JavaScript decoder. */\nexport function jsBrotliDecompressor(): G9FrameDecompressor {\n  return {\n    decompress(compressed: Uint8Array, expectedLength: number): Uint8Array {\n      const out = brotliDecompressJs(compressed);\n      if (out.length !== expectedLength) throw new Error(`Brotli body decoded to ${out.length} bytes, ${expectedLength} expected.`);\n      return out;\n    },\n  };\n}\n"]}

package/dist/client/engine.d.ts

@@ -0,0 +1,110 @@
+import { G9SyncParameters } from '../abstractions/parameters.js';
+import { type G9DtHelloResult, type G9DtNegotiatedTable, type G9DtSubscriptionState } from '../protocol/dtos.js';
+import type { G9SyncClientModel } from './model.js';
+import { G9SyncRun, type G9RowsAppliedEvent, type G9SubscriptionOptions, type G9SyncEngineOptions, type G9SyncHealth, type G9SyncRequest, type G9SyncRunResult } from './runs.js';
+import { type G9ChangeFeedEntry, type G9LocalCommand, type G9LocalCommandWriter, type G9ELocalCommandState, type G9PendingSummary, type G9QuarantinedRow, type G9RetainedRow, type G9SyncClientStore, type G9SyncRejection, type G9SyncSubscriptionRecord } from './storeTypes.js';
+import type { G9SyncTransport } from './transport.js';
+/**
+ * The client sync engine (`G9CSyncEngine`): one per local database. Owns a prioritised run queue, so status queries
+ * never wait for a running sync and background runs yield to user runs.
+ */
+export declare class G9SyncEngine {
+    readonly model: G9SyncClientModel;
+    private readonly _store;
+    private readonly _transport;
+    private readonly _options;
+    private readonly _lifetime;
+    private readonly _queue;
+    private readonly _pokedTables;
+    private readonly _rowsAppliedListeners;
+    private readonly _runCompletedListeners;
+    private readonly _unsubscribePokes;
+    private _initialized;
+    private _initializing;
+    private _clientId;
+    private _order;
+    private _current;
+    private _suppressions;
+    private _autoTimer;
+    private _pokeTimer;
+    private _wake;
+    private _worker;
+    private _disposed;
+    /** The model problems last logged, so the warning is said once per distinct set (ADR-0061). */
+    private _reportedModelProblems;
+    constructor(store: G9SyncClientStore, transport: G9SyncTransport, model: G9SyncClientModel, options?: G9SyncEngineOptions);
+    get clientId(): string;
+    get isRunning(): boolean;
+    get queuedRuns(): number;
+    get isBackgroundSuppressed(): boolean;
+    /** Raised after rows were written locally (download, reconciliation or canonical push results). Returns the unsubscribe function. */
+    onRowsApplied(listener: (event: G9RowsAppliedEvent) => void): () => void;
+    onRunCompleted(listener: (result: G9SyncRunResult) => void): () => void;
+    /** Provisions local tables and capture, and starts the run worker. Idempotent. */
+    initialize(signal?: AbortSignal): Promise<void>;
+    /** Adds (or returns) a subscription. Its rows arrive on the next run that includes it. */
+    subscribe(name: string, parameters?: G9SyncParameters | null, options?: G9SubscriptionOptions | null, signal?: AbortSignal): Promise<G9SyncSubscriptionRecord>;
+    /** Removes a subscription; rows no other subscription holds follow the server's move-out policy. */
+    unsubscribe(name: string, parameters?: G9SyncParameters | null, signal?: AbortSignal): Promise<void>;
+    getSubscriptions(signal?: AbortSignal): Promise<G9SyncSubscriptionRecord[]>;
+    /** Queues a run. Identical plain requests already waiting are coalesced into one run. */
+    run(request?: G9SyncRequest | null): G9SyncRun;
+    /** Queues a run and awaits its result. */
+    sync(request?: G9SyncRequest | null): Promise<G9SyncRunResult>;
+    /** While the returned scope is alive, background runs are skipped. Call the returned function to end it. */
+    suppressBackground(): () => void;
+    /** Queues a background push+pull of every non-heavy subscription on a fixed interval. */
+    startAutomaticSync(intervalMs: number): void;
+    stopAutomaticSync(): void;
+    /**
+     * Records a command (ADR-0025): the server executes the handler registered for `name` on the next push, once, in
+     * device order. `applyLocally` writes its local effects immediately, in the same transaction.
+     */
+    executeCommand(name: string, payloadJson: string, applyLocally?: ((writer: G9LocalCommandWriter, signal?: AbortSignal) => Promise<void>) | null, version?: number, signal?: AbortSignal): Promise<G9LocalCommand>;
+    /** Frees space taken by an UPLOAD-ONLY table: removes uploaded rows without uploading a delete. */
+    forgetUploadedRows(localTable: string, keys?: readonly string[] | null, signal?: AbortSignal): Promise<number>;
+    getCommands(state?: G9ELocalCommandState | null, limit?: number, signal?: AbortSignal): Promise<G9LocalCommand[]>;
+    getPendingSummary(signal?: AbortSignal): Promise<G9PendingSummary>;
+    getRejections(signal?: AbortSignal): Promise<G9SyncRejection[]>;
+    getQuarantined(signal?: AbortSignal): Promise<G9QuarantinedRow[]>;
+    restoreQuarantined(localTable: string, key: string, signal?: AbortSignal): Promise<number>;
+    /** Throws away every staged pull, so the next run plans afresh. Returns whether there was one. */
+    discardStagedPull(signal?: AbortSignal): Promise<boolean>;
+    discardQuarantined(localTable?: string | null, key?: string | null, signal?: AbortSignal): Promise<number>;
+    getRetained(signal?: AbortSignal): Promise<G9RetainedRow[]>;
+    retryRejected(localTable?: string | null, key?: string | null, signal?: AbortSignal): Promise<number>;
+    readChangeFeed(localTable: string, afterSequence: number, limit?: number, signal?: AbortSignal): Promise<G9ChangeFeedEntry[]>;
+    /** The highest sequence readChangeFeed can return today (a watermark above it belongs to a store that no longer exists). */
+    getChangeSequence(signal?: AbortSignal): Promise<number>;
+    /** The highest sequence ever purged from the change feed; 0 when nothing was (ADR-0059). */
+    getChangeFeedFloor(signal?: AbortSignal): Promise<number>;
+    adoptExistingRows(signal?: AbortSignal): Promise<number>;
+    markDirty(localTable: string, keys: readonly string[], signal?: AbortSignal): Promise<number>;
+    getHealth(signal?: AbortSignal): Promise<G9SyncHealth>;
+    dispose(): Promise<void>;
+    private _signal;
+    private _dequeue;
+    private _workerLoop;
+    private _tryQueueBackground;
+    private _onChangesAvailable;
+    private _flushPokes;
+    private _raiseRowsApplied;
+    private _log;
+    private _executeRun;
+    private _planPhases;
+    private _selectSubscriptions;
+    private _pushAll;
+    private _download;
+    private _withRetry;
+    private _backoff;
+    private _ensureConnected;
+    private _persistRun;
+    private _reconcileSubscription;
+}
+/**
+ * Everything a staged pull's rows depend on (ADR-0046): the server's epoch, the exact set of subscriptions with their
+ * definition and authorisation hashes, and the negotiated columns. The cursor is deliberately NOT part of it (ADR-0060).
+ */
+export declare function stageGeneration(hello: G9DtHelloResult, plannable: readonly G9SyncSubscriptionRecord[], states: {
+    [key: string]: G9DtSubscriptionState;
+}, negotiated: readonly G9DtNegotiatedTable[]): string;