@syncular/server 0.31.0 → 0.32.1

package/dist/storage.d.ts

@@ -303,13 +303,55 @@ export interface CommitMetadata {
     readonly createdAtMs: number;
     readonly changeCount: number;
     readonly tables: readonly string[];
+    /** The first `changeSample` changes in commit order, when requested. */
+    readonly sample?: readonly CommitChangeSummary[];
+}
+/** One change without its payload, for commit lists. */
+export interface CommitChangeSummary {
+    readonly table: string;
+    readonly rowId: string;
+    readonly op: 'upsert' | 'delete';
 }
 export interface CommitMetadataQuery {
-    /** Window `afterSeq < commitSeq`, oldest first. */
+    /** Window lower bound, exclusive: `afterSeq < commitSeq`. */
     readonly afterSeq: number;
+    /** Window upper bound, exclusive: `commitSeq < beforeSeq` (older pages). */
+    readonly beforeSeq?: number;
+    /** Newest first, at most `limit` commits. */
     readonly limit: number;
     /** Restrict to commits that touched this table (via the change index). */
     readonly table?: string;
+    /** Attach the first N changes of each commit as `sample`. */
+    readonly changeSample?: number;
+}
+export interface RowListQuery {
+    readonly table: string;
+    /** Resume after this rowId (exclusive); `null` = start of table. */
+    readonly afterRowId: string | null;
+    readonly limit: number;
+}
+/** A stored push outcome with the client that sent it. */
+export interface ClientPushResult {
+    readonly clientId: string;
+    readonly result: StoredPushResult;
+}
+/** One retained commit with its changes, for the admin commit drill-down. */
+export interface CommitDetail extends CommitMetadata {
+    readonly changes: readonly StoredChange[];
+}
+/** One retained change to a single row, for the admin row history. */
+export interface RowChangeRecord {
+    readonly commitSeq: number;
+    readonly op: 'upsert' | 'delete';
+    readonly rowVersion?: number;
+    readonly actorId: string;
+    readonly clientId: string;
+    readonly createdAtMs: number;
+}
+export interface RowChangesQuery {
+    readonly table: string;
+    readonly rowId: string;
+    readonly limit: number;
 }
 /** One recent commit touching a scope key, for the admin scope activity view. */
 export interface ScopeCommitActivity {
@@ -671,18 +713,27 @@ export interface ServerStorage {
      * touched tables), the newest-oriented window an operator inspects.
      * `scopeActivity`: the recent commits touching one scope key, via the
      * change scope index (never a log scan).
-     * `getRowScopes`: the (table, rowId) row's current server_version and
-     * stored scopes without decoding its payload — the row inspector.
+     * `getCommit`: one retained commit with its changes and payloads;
+     * `undefined` when the commit does not exist or was pruned.
+     * `listRowChanges`: the retained changes to one row, newest first. It
+     * reads the partition's retained log without a dedicated index, so the
+     * write path pays nothing for it and its cost is bounded by retention.
+     * `listRows`: one table's rows ordered by rowId, without a scope filter.
+     * `countRows`: one table's row count.
+     * `listPushResults`: every stored idempotency outcome for one
+     * clientCommitId across the partition's clients, scanning the retained
+     * outcomes without a dedicated index.
      * `listPartitions`: the partition-only compatibility view of
      * `listPartitionRegistry`, sorted.
      */
     listClientRecords?(partition: string): Promise<ClientRecord[]>;
     listCommitMetadata?(partition: string, query: CommitMetadataQuery): Promise<CommitMetadata[]>;
     scopeActivity?(partition: string, query: ScopeActivityQuery): Promise<ScopeCommitActivity[]>;
-    getRowScopes?(partition: string, table: string, rowId: string): Promise<{
-        serverVersion: number;
-        scopes: Record<string, string>;
-    } | undefined>;
+    getCommit?(partition: string, commitSeq: number): Promise<CommitDetail | undefined>;
+    listRowChanges?(partition: string, query: RowChangesQuery): Promise<RowChangeRecord[]>;
+    listRows?(partition: string, query: RowListQuery): Promise<StoredRow[]>;
+    countRows?(partition: string, table: string): Promise<number>;
+    listPushResults?(partition: string, clientCommitId: string): Promise<ClientPushResult[]>;
     listPartitions(): Promise<string[]>;
 }
 /** A row referencing a blob, with the scopes needed to authorize download. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/server",
-  "version": "0.31.0",
+  "version": "0.32.1",
   "description": "Syncular server: handleSyncRequest + storage/auth interfaces for the sync protocol",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -68,7 +68,7 @@
     "verify:node": "cd ../.. && bun build ./packages/server/test/sqlite-runtime/verify-node.mjs --target=node --conditions=bun --outfile=./packages/server/.verify-node.built.mjs && node ./packages/server/.verify-node.built.mjs"
   },
   "dependencies": {
-    "@syncular/core": "0.31.0"
+    "@syncular/core": "0.32.1"
   },
   "devDependencies": {
     "@electric-sql/pglite": "^0.5.4"