@g9tm/syncdata 1.3.1 → 1.5.0

package/PARITY.md

@@ -13,7 +13,7 @@ it). This file maps every .NET piece to its twin and lists every deliberate diff
 | Requests written by TypeScript, parsed by the .NET server's own hub protocols (JSON and Nerdbank MessagePack) and compared with the .NET samples | `test/hub.test.ts` → `test/golden/js-vectors.json` → `JsGoldenVectorsTests.Requests_the_TypeScript_client_writes_deserialize_on_the_server` |
 | The TypeScript engine + store + transport against the real .NET sample server (50,000 rows, push, pokes, reconcile, unsubscribe), over both hub protocols | `test/interop/server.test.ts` (`npm run test:interop`) |
 | The database the TypeScript store writes equals the one the .NET store writes for the same sync: app rows and storage classes, every `g9_*` row, the schema, the stored JSON | `test/interop/server.test.ts` → database parity |
-| A site's first download as a snapshot FILE (ADR-0072) copied by the TypeScript store leaves the database the .NET store leaves (both sites as files, the second merged into the first's table) | `test/interop/server.test.ts` → "a snapshot FILE copied by the TypeScript store" |
+| A site's first download as a snapshot FILE (ADR-0072) copied by the TypeScript store leaves the database the .NET store leaves (both sites as files, the second appended to the first's table) | `test/interop/server.test.ts` → "a snapshot FILE copied by the TypeScript store" |
 | The same scenario in a Lynx-shaped runtime (no BigInt/TextEncoder/URL/WebSocket, native modules behind a copying bridge), with and without snapshot files through `lynxSnapshotFileSink`'s module methods | `@g9tm/syncdata-lynx` `npm run test:lynxsim` |
 
 `G9_UPDATE_GOLDEN=1` rewrites the golden files after an intended change; commit them with the change that needs them.
@@ -37,14 +37,15 @@ it). This file maps every .NET piece to its twin and lists every deliberate diff
 | `G9CSyncRun`, `G9CSyncRequest`, `G9CSyncRunResult`, `G9CSyncPostStep` | `G9SyncRun`, `G9SyncRequest`, `G9SyncRunResult`, `G9SyncPostStep` | `run.progress()` is the bounded progress channel |
 | `G9CSyncProgressTracker`, `G9DtSyncProgress` | `G9SyncProgressTracker`, `G9DtSyncProgress` (`etaMs`) | same planning, creep and monotonicity |
 | `IG9SyncClientStore` | `G9SyncClientStore` | |
+| `ReadChangeFeedAsync(table, after, limit, G9CChangeFeedKeyFilter, ct)` | `readChangeFeedFiltered(table, after, limit, G9ChangeFeedKeyFilter, signal?)` | a named method instead of an overload; the same SQL and the same validation (`validateChangeFeedKeyFilter`) |
 | `G9CSqliteSyncStore`, options | `G9SqliteSyncStore` (`@g9tm/syncdata/sqlite`) over a `G9SqliteDriver` | same tables, triggers, SQL, JSON blobs and storage forms |
-| Snapshot files (`G9CSqliteSyncStore.SnapshotFiles.cs`): `AcceptSnapshotFiles`, `SnapshotFileDirectory`, checkpoints, staging, verification, the copy/columns/merge apply, the sweep | `snapshotFiles: G9SnapshotFileSink` (`nodeSnapshotFileSink(dir)` in `@g9tm/syncdata/node`, `lynxSnapshotFileSink(db)` in `@g9tm/syncdata-lynx`), `src/sqlite/snapshotFiles.ts` | the same SQL statement for statement; the bytes go through the sink (decompress + SHA-256 + positional write) instead of `RandomAccess` in process; `G9CSnapshotFileWriter` (the server's) has no twin |
+| Snapshot files (`G9CSqliteSyncStore.SnapshotFiles.cs`): `AcceptSnapshotFiles`, `SnapshotFileDirectory`, checkpoints, staging, verification, the copy/columns/append/merge apply, the sweep | `snapshotFiles: G9SnapshotFileSink` (`nodeSnapshotFileSink(dir)` in `@g9tm/syncdata/node`, `lynxSnapshotFileSink(db)` in `@g9tm/syncdata-lynx`), `src/sqlite/snapshotFiles.ts` | the same SQL statement for statement; the bytes go through the sink (decompress + SHA-256 + positional write) instead of `RandomAccess` in process; `G9CSnapshotFileWriter` (the server's) has no twin |
 | `EnqueueCommand(sqlite3 appConnection, …)` | `enqueueCommandOnSession({ driver, session, tx }, …)` | SAVEPOINT inside the app's transaction |
 | `IncarnationMarkerPath` | `incarnationMarker` (`fileIncarnationMarker(fileSystem, path)`) | any `G9FileSystem` (Lynx: the SignalR native module's) |
 | `ExportPendingChangesAsync(path)` | `exportPendingChanges(writeLine)` | the caller writes the lines where it wants |
 | `CheckIntegrityAsync` | `checkIntegrity()` | |
 | `G9CSqliteException` (`IG9SyncLocalStoreFailure`) | `G9SqliteStoreError` (`localStoreFailure`) | classified from the driver's code |
-| `G9CSignalRSyncTransport`, options | `G9SignalRSyncTransport` (`@g9tm/syncdata/signalr`) | over `G9Client` of `@g9tm/signalr-supernetcore-client`; Lynx: `createLynxSyncTransport` |
+| `G9CSignalRSyncTransport`, options | `G9SignalRSyncTransport` (`@g9tm/syncdata/signalr`) | over `G9Client` of `@g9tm/signalr-supernetcore-client`; Lynx: `createLynxSyncTransport`. Limits (ADR-0074): `CallTimeout` / `PushTimeout` / `StreamIdleTimeout` = `callTimeoutMs` / `pushTimeoutMs` / `streamIdleTimeoutMs`, same defaults, same retryable `G9S-NET-FAILURE`, same connection drop (`SignalRTimeoutTests` / `test/transportTimeouts.test.ts`) |
 | `G9CInMemorySyncTransport`, `G9CTransportFaults` | `G9FaultInjectingTransport`, `G9TransportFaults` (`@g9tm/syncdata/testing`) | wraps a real transport (no in-process server engine in JavaScript) |
 
 ## Deliberate differences

package/dist/client/engine.d.ts

@@ -2,7 +2,7 @@ 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 G9ChangeFeedEntry, type G9ChangeFeedKeyFilter, 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
@@ -74,6 +74,11 @@ export declare class G9SyncEngine {
     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 change feed for one table narrowed to the keys `keyFilter` selects (plus every deletion), so a projection of one site does
+     * not walk the entries of every other one (`ReadChangeFeedAsync(..., G9CChangeFeedKeyFilter, ...)`).
+     */
+    readChangeFeedFiltered(localTable: string, afterSequence: number, limit: number, keyFilter: G9ChangeFeedKeyFilter, 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). */

package/dist/client/engine.js

@@ -11,7 +11,7 @@ import { G9EPullPartKind, G9ESubscriptionAction, syncErrorToException, } from '.
 import { openRowBatch } from '../protocol/rowBatch/reader.js';
 import { G9ESyncPhase, G9SyncProgressTracker, phaseName } from './progress.js';
 import { G9ESyncOutcome, G9ESyncPriority, G9SyncRun, canCoalesce, describeModelProblem, isTransientError, makeRunResult, normalizeError, outcomeName, priorityName, requestSignature, resolveEngineOptions, resolveRequest, } from './runs.js';
-import { G9ApplyReport, G9ESubscriptionState, toSubscriptionRef, } from './storeTypes.js';
+import { G9ApplyReport, G9ESubscriptionState, toSubscriptionRef, validateChangeFeedKeyFilter, } from './storeTypes.js';
 const STAT_CONNECTING = 'Connecting';
 const STAT_PLANNING = 'Planning';
 const STAT_PUSH_PER_K_ROW = 'PushPerKRow';
@@ -240,6 +240,15 @@ export class G9SyncEngine {
         await this.initialize(signal);
         return this._store.readChangeFeed(localTable, afterSequence, limit, signal);
     }
+    /**
+     * The change feed for one table narrowed to the keys `keyFilter` selects (plus every deletion), so a projection of one site does
+     * not walk the entries of every other one (`ReadChangeFeedAsync(..., G9CChangeFeedKeyFilter, ...)`).
+     */
+    async readChangeFeedFiltered(localTable, afterSequence, limit, keyFilter, signal) {
+        validateChangeFeedKeyFilter(keyFilter);
+        await this.initialize(signal);
+        return this._store.readChangeFeedFiltered(localTable, afterSequence, limit, keyFilter, signal);
+    }
     /** The highest sequence readChangeFeed can return today (a watermark above it belongs to a store that no longer exists). */
     async getChangeSequence(signal) {
         await this.initialize(signal);