@firtoz/drizzle-durable-sqlite 1.0.4 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @firtoz/drizzle-durable-sqlite
 
+## 2.1.0
+
+### Minor Changes
+
+- [`c3a3cc7`](https://github.com/firtoz/fullstack-toolkit/commit/c3a3cc778ba9ce4b5efe1bcdd8d541f46dec3bfd) Thanks [@firtoz](https://github.com/firtoz)! - Publish compiled ESM and TypeScript declarations from `dist/` for each package (`tsup`, `prepack` build). `exports`, `main`, and `types` resolve to `dist/`; CLI bins point at built JS with a Node shebang where applicable. Shared `scripts/tsup-lib.ts` discovers `src` entries and externals; workspace test apps map `@firtoz/*` to package sources in `tsconfig` for accurate generics during typecheck. `@firtoz/socka` is published under the scoped name with the same `dist/` layout.
+
+### Patch Changes
+
+- [`f78c988`](https://github.com/firtoz/fullstack-toolkit/commit/f78c988d37a9cc48490ee3372dccc14a42810bfe) Thanks [@firtoz](https://github.com/firtoz)! - Improve READMEs: npm shields, contextual stack badges, clearer taglines, and new docs for `@firtoz/idb-collections` and `@firtoz/collection-sync`. Align `@firtoz/db-helpers` copy with published `dist/` builds.
+
+- Updated dependencies [[`c3a3cc7`](https://github.com/firtoz/fullstack-toolkit/commit/c3a3cc778ba9ce4b5efe1bcdd8d541f46dec3bfd), [`f78c988`](https://github.com/firtoz/fullstack-toolkit/commit/f78c988d37a9cc48490ee3372dccc14a42810bfe)]:
+  - @firtoz/collection-sync@6.0.0
+  - @firtoz/db-helpers@2.2.0
+  - @firtoz/drizzle-utils@1.3.0
+  - @firtoz/maybe-error@1.6.0
+  - @firtoz/websocket-do@13.0.0
+
+## 2.0.0
+
+### Major Changes
+
+- [#70](https://github.com/firtoz/fullstack-toolkit/pull/70) [`e1c08cb`](https://github.com/firtoz/fullstack-toolkit/commit/e1c08cb803574654d5808a984e358258c4171698) Thanks [@firtoz](https://github.com/firtoz)! - **@firtoz/websocket-do:** `BaseSessionHandlers.handleClose` and `StandardSchemaSessionHandlers.handleClose` receive the session instance (aligned with DO teardown).
+
+  **@firtoz/drizzle-durable-sqlite:** `handleClose` handlers on bundled DO session wiring match the session-aware `BaseSession` contract.
+
+### Patch Changes
+
+- [#70](https://github.com/firtoz/fullstack-toolkit/pull/70) [`d35e718`](https://github.com/firtoz/fullstack-toolkit/commit/d35e718bf3292258c2b0006affc7aad5ecc35208) Thanks [@firtoz](https://github.com/firtoz)! - **@firtoz/websocket-do:** Replace Zod-only `ZodSession`, `ZodWebSocketClient`, `ZodWebSocketDO`, and `zodMsgpack` with Standard Schema v1–based `StandardSchemaSession`, `StandardSchemaWebSocketClient`, `StandardSchemaWebSocketDO`, and `standardSchemaMsgpack`. Add `parseStandardSchema` and a direct dependency on `@standard-schema/spec`. Subpath `./zod-client` is removed; use `./schema-client`. Client `send` is now async (`Promise<void>`). Server session `send`/`broadcast` stay `void` with async validation under the hood. Remove the experimental `@firtoz/websocket-do/ws-rpc-protocol` export; use **`socka/core`** (`defineSocka`, typed RPC) instead.
+
+  **@firtoz/collection-sync:** `connectSync` / `connect-partial-sync` now use `StandardSchemaWebSocketClient` from `@firtoz/websocket-do/schema-client`.
+
+  **@firtoz/drizzle-durable-sqlite:** `SyncableDurableObject` and `QueryableDurableObject` extend `StandardSchemaWebSocketDO` / `StandardSchemaSession` and use `createStandardSchemaSession` / `standardSchemaSessionOptions` in constructors.
+
+- Updated dependencies [[`ffee5b3`](https://github.com/firtoz/fullstack-toolkit/commit/ffee5b313d073366a10e049dc988c9a9c95719be), [`7eb49ad`](https://github.com/firtoz/fullstack-toolkit/commit/7eb49adb100ffc5187a1f858b013b151db82643f), [`e1c08cb`](https://github.com/firtoz/fullstack-toolkit/commit/e1c08cb803574654d5808a984e358258c4171698), [`d35e718`](https://github.com/firtoz/fullstack-toolkit/commit/d35e718bf3292258c2b0006affc7aad5ecc35208), [`138c394`](https://github.com/firtoz/fullstack-toolkit/commit/138c3944b491ebf2e76b7f2c00d651fd5d788bac), [`d35e718`](https://github.com/firtoz/fullstack-toolkit/commit/d35e718bf3292258c2b0006affc7aad5ecc35208)]:
+  - @firtoz/websocket-do@12.0.0
+  - @firtoz/collection-sync@5.0.0
+  - @firtoz/db-helpers@2.1.1
+  - @firtoz/drizzle-utils@1.2.1
+
 ## 1.0.4
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,14 @@
 # @firtoz/drizzle-durable-sqlite
 
-TanStack DB collection configuration for **Drizzle ORM** on **Cloudflare Durable Object SQLite** (`drizzle-orm/durable-sqlite`). This mirrors [`@firtoz/drizzle-sqlite-wasm`](../drizzle-sqlite-wasm) for the browser (SQLite WASM + workers), but targets Workers/DOs only—no React provider, no OPFS, no Web Workers.
+[![npm version](https://img.shields.io/npm/v/%40firtoz%2Fdrizzle-durable-sqlite.svg)](https://www.npmjs.com/package/@firtoz/drizzle-durable-sqlite)
+[![npm downloads](https://img.shields.io/npm/dm/%40firtoz%2Fdrizzle-durable-sqlite.svg)](https://www.npmjs.com/package/@firtoz/drizzle-durable-sqlite)
+[![license](https://img.shields.io/npm/l/%40firtoz%2Fdrizzle-durable-sqlite.svg)](https://github.com/firtoz/fullstack-toolkit/blob/main/LICENSE)
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Drizzle ORM](https://img.shields.io/badge/Drizzle-ORM-000000)](https://orm.drizzle.team/)
+[![Cloudflare](https://img.shields.io/badge/Cloudflare-Durable_Objects-F38020?logo=cloudflare&logoColor=white)](https://developers.cloudflare.com/durable-objects/)
+
+**Drizzle + TanStack DB on Durable Object SQLite** — same ideas as [`@firtoz/drizzle-sqlite-wasm`](../drizzle-sqlite-wasm) in the browser, but for Workers/DOs only (no React provider, no OPFS, no web workers).
 
 ## Install
 

package/dist/chunk-3XAF3IZW.js

@@ -0,0 +1,206 @@
+import { DEFAULT_SYNC_COLLECTION_ID, PartialSyncServerBridge, PartialSyncMutationHandler, createClientMessageSchema, createServerMessageSchema } from '@firtoz/collection-sync';
+import { StandardSchemaWebSocketDO, StandardSchemaSession } from '@firtoz/websocket-do';
+import { drizzle } from 'drizzle-orm/durable-sqlite';
+import { migrate } from 'drizzle-orm/durable-sqlite/migrator';
+
+// src/queryable-durable-object.ts
+function createSessionCodecOptions(enableBufferMessages, serializeJson, deserializeJson) {
+  const clientSchema = createClientMessageSchema();
+  const serverSchema = createServerMessageSchema();
+  if (!enableBufferMessages) {
+    return {
+      clientSchema,
+      serverSchema,
+      enableBufferMessages: false,
+      ...serializeJson && deserializeJson ? { serializeJson, deserializeJson } : {}
+    };
+  }
+  return {
+    clientSchema,
+    serverSchema,
+    enableBufferMessages: true
+  };
+}
+async function routeQueryableClientMessage(message, dispatch) {
+  const mid = message.collectionId ?? DEFAULT_SYNC_COLLECTION_ID;
+  switch (message.type) {
+    case "mutateBatch":
+    case "syncHello":
+      if (dispatch.partialMutationHandler !== void 0 && mid === dispatch.partialMutationHandler.collectionId) {
+        await dispatch.partialMutationHandler.handleClientMessage(message);
+      }
+      return;
+    default:
+      if (mid === dispatch.partialBridge.collectionId) {
+        await dispatch.partialBridge.handleClientMessage(message);
+      }
+  }
+}
+var QueryableSession = class extends StandardSchemaSession {
+  constructor(websocket, sessions, options, sessionSlot) {
+    const generatedClientId = crypto.randomUUID();
+    super(websocket, sessions, options, {
+      createData: () => ({ clientId: generatedClientId }),
+      handleValidatedMessage: async (message) => {
+        this.clientId = message.clientId;
+        const dispatch = this.sessionSlot.dispatch;
+        if (dispatch === void 0) {
+          this.sessionSlot.pending.push(message);
+          return;
+        }
+        await routeQueryableClientMessage(message, dispatch);
+      },
+      handleClose: async () => {
+        const dispatch = this.sessionSlot.dispatch;
+        if (dispatch !== void 0) {
+          dispatch.partialBridge.removeClient(this.clientId);
+        }
+      }
+    });
+    this.sessionSlot = sessionSlot;
+    this.clientId = generatedClientId;
+  }
+};
+var QueryableDurableObject = class extends StandardSchemaWebSocketDO {
+  constructor(ctx, env, config) {
+    let bridgeRef;
+    const sessionSlot = { pending: [] };
+    super(ctx, env, {
+      standardSchemaSessionOptions: (sessionCtx) => {
+        const useMsgpack = sessionCtx !== void 0 && new URL(sessionCtx.req.url).searchParams.get("transport") === "msgpack";
+        return createSessionCodecOptions(
+          useMsgpack,
+          config.serializeJson,
+          config.deserializeJson
+        );
+      },
+      createStandardSchemaSession: (_sessionCtx, websocket, options) => new QueryableSession(
+        websocket,
+        this.sessions,
+        options,
+        sessionSlot
+      )
+    });
+    this.app = this.getBaseApp().get("/health", (c) => c.text("ok"));
+    this.ctx.blockConcurrencyWhile(async () => {
+      const db = drizzle(ctx.storage, { schema: config.schema });
+      migrate(db, config.migrations);
+      this.db = db;
+      const queryByPredicate = this.queryByPredicate;
+      const getPredicateCount = this.getPredicateCount;
+      const changesSince = this.changesSince;
+      const store = config.createPartialSyncStore !== void 0 ? config.createPartialSyncStore(db) : {
+        queryRange: (options) => this.queryRange(options),
+        queryByOffset: (options) => this.queryByOffset(options),
+        getTotalCount: async () => this.getTotalCount(),
+        getSortValue: (row, column) => this.getSortValue(row, column),
+        ...queryByPredicate !== void 0 ? {
+          queryByPredicate: (opts) => queryByPredicate.call(this, opts)
+        } : {},
+        ...getPredicateCount !== void 0 ? {
+          getPredicateCount: (conditions) => getPredicateCount.call(this, conditions)
+        } : {},
+        ...changesSince !== void 0 ? {
+          changesSince: (opts) => changesSince.call(this, opts)
+        } : {}
+      };
+      const collectionId = config.collectionId ?? DEFAULT_SYNC_COLLECTION_ID;
+      bridgeRef = new PartialSyncServerBridge({
+        store,
+        sendToClient: (clientId, message) => this.sendToClient(clientId, message),
+        queryChunkSize: config.queryChunkSize,
+        collectionId,
+        ...config.resolveClientVisibility !== void 0 ? {
+          resolveClientVisibility: config.resolveClientVisibility
+        } : {},
+        ...config.resolveMovedHint !== void 0 ? { resolveMovedHint: config.resolveMovedHint } : {}
+      });
+      this.bridge = bridgeRef;
+      const mutationStore = this.createClientMutationSyncStore();
+      let partialMutationHandler;
+      if (mutationStore !== void 0) {
+        partialMutationHandler = new PartialSyncMutationHandler({
+          store: mutationStore,
+          partialBridge: bridgeRef,
+          sendToClient: (clientId, message) => this.sendToClient(clientId, message),
+          collectionId
+        });
+        this.partialMutationHandler = partialMutationHandler;
+      }
+      sessionSlot.dispatch = {
+        partialBridge: bridgeRef,
+        partialMutationHandler
+      };
+      for (const message of sessionSlot.pending) {
+        await routeQueryableClientMessage(message, sessionSlot.dispatch);
+      }
+      sessionSlot.pending.length = 0;
+      if (config.seedInBackground) {
+        void this.seedData().catch((error) => {
+          console.error("Background seedData failed", error);
+        });
+        return;
+      }
+      await this.seedData();
+    });
+  }
+  queryRange(_options) {
+    const message = "QueryableDurableObject: override queryRange() or pass createPartialSyncStore in config";
+    return {
+      [Symbol.asyncIterator]() {
+        return {
+          next: () => Promise.reject(new Error(message))
+        };
+      }
+    };
+  }
+  queryByOffset(_options) {
+    const message = "QueryableDurableObject: override queryByOffset() or pass createPartialSyncStore in config";
+    return {
+      [Symbol.asyncIterator]() {
+        return {
+          next: () => Promise.reject(new Error(message))
+        };
+      }
+    };
+  }
+  async getTotalCount() {
+    throw new Error(
+      "QueryableDurableObject: override getTotalCount() or pass createPartialSyncStore in config"
+    );
+  }
+  getSortValue(row, column) {
+    return row[column];
+  }
+  /**
+   * When overridden to return a store, `mutateBatch` is handled by {@link PartialSyncMutationHandler}
+   * (interest-scoped `rangePatch` + `ack` with `serverVersion: 0`). `syncHello` is not handled on this path.
+   * Range traffic stays on {@link PartialSyncServerBridge}.
+   */
+  createClientMutationSyncStore() {
+    return void 0;
+  }
+  async seedData() {
+  }
+  async pushServerChanges(changes) {
+    await this.bridge.pushServerChanges(changes);
+  }
+  sendToClient(clientId, message) {
+    for (const session of this.sessions.values()) {
+      const typedSession = session;
+      if (typedSession.clientId !== clientId) continue;
+      typedSession.send(message);
+    }
+  }
+  broadcastExcept(excludeClientId, message) {
+    for (const session of this.sessions.values()) {
+      const typedSession = session;
+      if (typedSession.clientId === excludeClientId) continue;
+      typedSession.send(message);
+    }
+  }
+};
+
+export { QueryableDurableObject };
+//# sourceMappingURL=chunk-3XAF3IZW.js.map
+//# sourceMappingURL=chunk-3XAF3IZW.js.map

package/dist/chunk-3XAF3IZW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queryable-durable-object.ts"],"names":[],"mappings":"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","file":"chunk-3XAF3IZW.js","sourcesContent":["import {\n\tPartialSyncMutationHandler,\n\tPartialSyncServerBridge,\n\tcreateClientMessageSchema,\n\tcreateServerMessageSchema,\n\tDEFAULT_SYNC_COLLECTION_ID,\n\ttype PartialSyncServerBridgeStore,\n\ttype PartialSyncRowShape,\n\ttype RangeCondition,\n\ttype SyncClientMessage,\n\ttype SyncRange,\n\ttype SyncRangeSort,\n\ttype SyncServerBridgeStore,\n\ttype SyncServerMessage,\n} from \"@firtoz/collection-sync\";\nimport type { SyncMessage } from \"@firtoz/db-helpers\";\nimport {\n\tStandardSchemaSession,\n\tStandardSchemaWebSocketDO,\n\ttype StandardSchemaSessionOptions,\n} from \"@firtoz/websocket-do\";\nimport type { DrizzleSqliteDODatabase } from \"drizzle-orm/durable-sqlite\";\nimport { drizzle } from \"drizzle-orm/durable-sqlite\";\nimport { migrate } from \"drizzle-orm/durable-sqlite/migrator\";\nimport type { Context } from \"hono\";\n\ntype SessionData = { clientId: string };\n\ntype MutationSyncRow = PartialSyncRowShape;\n\ntype SessionDispatch<TRow extends MutationSyncRow> = {\n\tpartialBridge: PartialSyncServerBridge<TRow>;\n\tpartialMutationHandler?: PartialSyncMutationHandler<TRow>;\n};\n\ntype SessionSlot<TRow extends MutationSyncRow> = {\n\tdispatch?: SessionDispatch<TRow>;\n\tpending: SyncClientMessage[];\n};\n\nfunction createSessionCodecOptions<TItem extends PartialSyncRowShape>(\n\tenableBufferMessages: boolean,\n\tserializeJson?: (value: unknown) => string,\n\tdeserializeJson?: (raw: string) => unknown,\n): StandardSchemaSessionOptions<SyncClientMessage, SyncServerMessage<TItem>> {\n\tconst clientSchema = createClientMessageSchema();\n\tconst serverSchema = createServerMessageSchema<TItem>();\n\tif (!enableBufferMessages) {\n\t\treturn {\n\t\t\tclientSchema,\n\t\t\tserverSchema,\n\t\t\tenableBufferMessages: false,\n\t\t\t...(serializeJson && deserializeJson\n\t\t\t\t? { serializeJson, deserializeJson }\n\t\t\t\t: {}),\n\t\t};\n\t}\n\treturn {\n\t\tclientSchema,\n\t\tserverSchema,\n\t\tenableBufferMessages: true,\n\t};\n}\n\nasync function routeQueryableClientMessage<TRow extends MutationSyncRow>(\n\tmessage: SyncClientMessage,\n\tdispatch: SessionDispatch<TRow>,\n): Promise<void> {\n\tconst mid = message.collectionId ?? DEFAULT_SYNC_COLLECTION_ID;\n\tswitch (message.type) {\n\t\tcase \"mutateBatch\":\n\t\tcase \"syncHello\":\n\t\t\tif (\n\t\t\t\tdispatch.partialMutationHandler !== undefined &&\n\t\t\t\tmid === dispatch.partialMutationHandler.collectionId\n\t\t\t) {\n\t\t\t\tawait dispatch.partialMutationHandler.handleClientMessage(message);\n\t\t\t}\n\t\t\treturn;\n\t\tdefault:\n\t\t\tif (mid === dispatch.partialBridge.collectionId) {\n\t\t\t\tawait dispatch.partialBridge.handleClientMessage(message);\n\t\t\t}\n\t}\n}\n\nclass QueryableSession<\n\tTItem extends PartialSyncRowShape,\n\tTEnv extends Cloudflare.Env,\n> extends StandardSchemaSession<\n\tSessionData,\n\tSyncServerMessage<TItem>,\n\tSyncClientMessage,\n\tTEnv\n> {\n\tpublic clientId: string;\n\n\tconstructor(\n\t\twebsocket: WebSocket,\n\t\tsessions: Map<WebSocket, QueryableSession<TItem, TEnv>>,\n\t\toptions: StandardSchemaSessionOptions<\n\t\t\tSyncClientMessage,\n\t\t\tSyncServerMessage<TItem>\n\t\t>,\n\t\tprivate readonly sessionSlot: SessionSlot<TItem>,\n\t) {\n\t\tconst generatedClientId = crypto.randomUUID();\n\t\tsuper(websocket, sessions, options, {\n\t\t\tcreateData: () => ({ clientId: generatedClientId }),\n\t\t\thandleValidatedMessage: async (message: SyncClientMessage) => {\n\t\t\t\tthis.clientId = message.clientId;\n\t\t\t\tconst dispatch = this.sessionSlot.dispatch;\n\t\t\t\tif (dispatch === undefined) {\n\t\t\t\t\tthis.sessionSlot.pending.push(message);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tawait routeQueryableClientMessage(message, dispatch);\n\t\t\t},\n\t\t\thandleClose: async () => {\n\t\t\t\tconst dispatch = this.sessionSlot.dispatch;\n\t\t\t\tif (dispatch !== undefined) {\n\t\t\t\t\tdispatch.partialBridge.removeClient(this.clientId);\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t\tthis.clientId = generatedClientId;\n\t}\n}\n\nexport type QueryableDurableObjectConfig<\n\tTSchema extends Record<string, unknown>,\n\tTRow extends PartialSyncRowShape = PartialSyncRowShape,\n> = {\n\tschema: TSchema;\n\tmigrations: Parameters<typeof migrate>[1];\n\tqueryChunkSize?: number;\n\tseedInBackground?: boolean;\n\tserializeJson?: (value: unknown) => string;\n\tdeserializeJson?: (raw: string) => unknown;\n\t/**\n\t * When set, used as the partial-sync store instead of overriding\n\t * {@link QueryableDurableObject.queryRange}, {@link QueryableDurableObject.queryByOffset},\n\t * and {@link QueryableDurableObject.getTotalCount}.\n\t */\n\tcreatePartialSyncStore?: (\n\t\tdb: DrizzleSqliteDODatabase<TSchema>,\n\t) => PartialSyncServerBridgeStore<TRow>;\n\t/**\n\t * Multiplex key for partial-sync WebSocket messages.\n\t * When using {@link PartialSyncMutationHandler} on the same socket, use the same id unless you multiplex multiple collections.\n\t */\n\tcollectionId?: string;\n\t/**\n\t * Server-side narrowing of client predicate viewports (e.g. fog of war). Passed to\n\t * {@link PartialSyncServerBridge}.\n\t */\n\tresolveClientVisibility?: (\n\t\tclientId: string,\n\t\trequestedConditions: RangeCondition[],\n\t) => RangeCondition[] | Promise<RangeCondition[]>;\n\t/**\n\t * Optional hints for rows that left the client's range during `rangeReconcile`. Return `null` for\n\t * fog of war (default when omitted).\n\t */\n\tresolveMovedHint?: (\n\t\trow: TRow,\n\t\trange: SyncRange,\n\t) => Record<string, unknown> | null | Promise<Record<string, unknown> | null>;\n};\n\nexport abstract class QueryableDurableObject<\n\tTRow extends PartialSyncRowShape,\n\tTSchema extends Record<string, unknown>,\n\tTEnv extends Cloudflare.Env = Cloudflare.Env,\n> extends StandardSchemaWebSocketDO<\n\tQueryableSession<TRow, TEnv>,\n\tSyncClientMessage,\n\tSyncServerMessage<TRow>,\n\tTEnv\n> {\n\tprotected db!: ReturnType<typeof drizzle>;\n\tprotected bridge!: PartialSyncServerBridge<TRow>;\n\tprotected partialMutationHandler?: PartialSyncMutationHandler<TRow>;\n\n\treadonly app = this.getBaseApp().get(\"/health\", (c: Context) => c.text(\"ok\"));\n\n\tconstructor(\n\t\tctx: DurableObjectState,\n\t\tenv: TEnv,\n\t\tconfig: QueryableDurableObjectConfig<TSchema, TRow>,\n\t) {\n\t\tlet bridgeRef!: PartialSyncServerBridge<TRow>;\n\t\tconst sessionSlot: SessionSlot<TRow> = { pending: [] };\n\t\tsuper(ctx, env, {\n\t\t\tstandardSchemaSessionOptions: (\n\t\t\t\tsessionCtx: Context<{ Bindings: TEnv }> | undefined,\n\t\t\t) => {\n\t\t\t\tconst useMsgpack =\n\t\t\t\t\tsessionCtx !== undefined &&\n\t\t\t\t\tnew URL(sessionCtx.req.url).searchParams.get(\"transport\") ===\n\t\t\t\t\t\t\"msgpack\";\n\t\t\t\treturn createSessionCodecOptions<TRow>(\n\t\t\t\t\tuseMsgpack,\n\t\t\t\t\tconfig.serializeJson,\n\t\t\t\t\tconfig.deserializeJson,\n\t\t\t\t);\n\t\t\t},\n\t\t\tcreateStandardSchemaSession: (\n\t\t\t\t_sessionCtx: Context<{ Bindings: TEnv }> | undefined,\n\t\t\t\twebsocket: WebSocket,\n\t\t\t\toptions: StandardSchemaSessionOptions<\n\t\t\t\t\tSyncClientMessage,\n\t\t\t\t\tSyncServerMessage<unknown>\n\t\t\t\t>,\n\t\t\t) =>\n\t\t\t\tnew QueryableSession<TRow, TEnv>(\n\t\t\t\t\twebsocket,\n\t\t\t\t\tthis.sessions,\n\t\t\t\t\toptions as StandardSchemaSessionOptions<\n\t\t\t\t\t\tSyncClientMessage,\n\t\t\t\t\t\tSyncServerMessage<TRow>\n\t\t\t\t\t>,\n\t\t\t\t\tsessionSlot,\n\t\t\t\t),\n\t\t});\n\n\t\tthis.ctx.blockConcurrencyWhile(async () => {\n\t\t\tconst db = drizzle(ctx.storage, { schema: config.schema });\n\t\t\tmigrate(db, config.migrations);\n\t\t\tthis.db = db;\n\n\t\t\tconst queryByPredicate = this.queryByPredicate;\n\t\t\tconst getPredicateCount = this.getPredicateCount;\n\t\t\tconst changesSince = this.changesSince;\n\n\t\t\tconst store: PartialSyncServerBridgeStore<TRow> =\n\t\t\t\tconfig.createPartialSyncStore !== undefined\n\t\t\t\t\t? config.createPartialSyncStore(db)\n\t\t\t\t\t: {\n\t\t\t\t\t\t\tqueryRange: (options) => this.queryRange(options),\n\t\t\t\t\t\t\tqueryByOffset: (options) => this.queryByOffset(options),\n\t\t\t\t\t\t\tgetTotalCount: async () => this.getTotalCount(),\n\t\t\t\t\t\t\tgetSortValue: (row, column) => this.getSortValue(row, column),\n\t\t\t\t\t\t\t...(queryByPredicate !== undefined\n\t\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t\tqueryByPredicate: (opts: {\n\t\t\t\t\t\t\t\t\t\t\tconditions: RangeCondition[];\n\t\t\t\t\t\t\t\t\t\t\tsort?: SyncRangeSort;\n\t\t\t\t\t\t\t\t\t\t\tlimit?: number;\n\t\t\t\t\t\t\t\t\t\t\tchunkSize: number;\n\t\t\t\t\t\t\t\t\t\t}) => queryByPredicate.call(this, opts),\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t\t...(getPredicateCount !== undefined\n\t\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t\tgetPredicateCount: (conditions: RangeCondition[]) =>\n\t\t\t\t\t\t\t\t\t\t\tgetPredicateCount.call(this, conditions),\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t\t...(changesSince !== undefined\n\t\t\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t\t\tchangesSince: (opts: {\n\t\t\t\t\t\t\t\t\t\t\trange: SyncRange;\n\t\t\t\t\t\t\t\t\t\t\tsinceVersion: number;\n\t\t\t\t\t\t\t\t\t\t\tchunkSize: number;\n\t\t\t\t\t\t\t\t\t\t}) => changesSince.call(this, opts),\n\t\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t};\n\t\t\tconst collectionId = config.collectionId ?? DEFAULT_SYNC_COLLECTION_ID;\n\t\t\tbridgeRef = new PartialSyncServerBridge<TRow>({\n\t\t\t\tstore,\n\t\t\t\tsendToClient: (clientId, message) =>\n\t\t\t\t\tthis.sendToClient(clientId, message),\n\t\t\t\tqueryChunkSize: config.queryChunkSize,\n\t\t\t\tcollectionId,\n\t\t\t\t...(config.resolveClientVisibility !== undefined\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tresolveClientVisibility: config.resolveClientVisibility,\n\t\t\t\t\t\t}\n\t\t\t\t\t: {}),\n\t\t\t\t...(config.resolveMovedHint !== undefined\n\t\t\t\t\t? { resolveMovedHint: config.resolveMovedHint }\n\t\t\t\t\t: {}),\n\t\t\t});\n\t\t\tthis.bridge = bridgeRef;\n\n\t\t\tconst mutationStore = this.createClientMutationSyncStore();\n\t\t\tlet partialMutationHandler: PartialSyncMutationHandler<TRow> | undefined;\n\t\t\tif (mutationStore !== undefined) {\n\t\t\t\tpartialMutationHandler = new PartialSyncMutationHandler<TRow>({\n\t\t\t\t\tstore: mutationStore,\n\t\t\t\t\tpartialBridge: bridgeRef,\n\t\t\t\t\tsendToClient: (clientId, message) =>\n\t\t\t\t\t\tthis.sendToClient(clientId, message),\n\t\t\t\t\tcollectionId,\n\t\t\t\t});\n\t\t\t\tthis.partialMutationHandler = partialMutationHandler;\n\t\t\t}\n\n\t\t\tsessionSlot.dispatch = {\n\t\t\t\tpartialBridge: bridgeRef,\n\t\t\t\tpartialMutationHandler,\n\t\t\t};\n\t\t\tfor (const message of sessionSlot.pending) {\n\t\t\t\tawait routeQueryableClientMessage(message, sessionSlot.dispatch);\n\t\t\t}\n\t\t\tsessionSlot.pending.length = 0;\n\t\t\tif (config.seedInBackground) {\n\t\t\t\tvoid this.seedData().catch((error: unknown) => {\n\t\t\t\t\tconsole.error(\"Background seedData failed\", error);\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait this.seedData();\n\t\t});\n\t}\n\n\tprotected queryRange(_options: {\n\t\tsort: { column: string; direction: \"asc\" | \"desc\" };\n\t\tlimit: number;\n\t\tafterCursor: unknown | null;\n\t\tchunkSize: number;\n\t}): AsyncIterable<TRow[]> {\n\t\tconst message =\n\t\t\t\"QueryableDurableObject: override queryRange() or pass createPartialSyncStore in config\";\n\t\treturn {\n\t\t\t[Symbol.asyncIterator](): AsyncIterator<TRow[]> {\n\t\t\t\treturn {\n\t\t\t\t\tnext: () => Promise.reject(new Error(message)),\n\t\t\t\t};\n\t\t\t},\n\t\t};\n\t}\n\n\tprotected queryByOffset(_options: {\n\t\tsort: { column: string; direction: \"asc\" | \"desc\" };\n\t\tlimit: number;\n\t\toffset: number;\n\t\tchunkSize: number;\n\t}): AsyncIterable<TRow[]> {\n\t\tconst message =\n\t\t\t\"QueryableDurableObject: override queryByOffset() or pass createPartialSyncStore in config\";\n\t\treturn {\n\t\t\t[Symbol.asyncIterator](): AsyncIterator<TRow[]> {\n\t\t\t\treturn {\n\t\t\t\t\tnext: () => Promise.reject(new Error(message)),\n\t\t\t\t};\n\t\t\t},\n\t\t};\n\t}\n\n\tprotected async getTotalCount(): Promise<number> {\n\t\tthrow new Error(\n\t\t\t\"QueryableDurableObject: override getTotalCount() or pass createPartialSyncStore in config\",\n\t\t);\n\t}\n\n\tprotected queryByPredicate?(_options: {\n\t\tconditions: RangeCondition[];\n\t\tsort?: SyncRangeSort;\n\t\tlimit?: number;\n\t\tchunkSize: number;\n\t}): AsyncIterable<TRow[]>;\n\n\tprotected getPredicateCount?(_conditions: RangeCondition[]): Promise<number>;\n\n\tprotected changesSince?(_options: {\n\t\trange: SyncRange;\n\t\tsinceVersion: number;\n\t\tchunkSize: number;\n\t}): Promise<{ changes: SyncMessage<TRow>[]; totalCount: number } | null>;\n\n\tprotected getSortValue(row: TRow, column: string): unknown {\n\t\treturn (row as Record<string, unknown>)[column];\n\t}\n\n\t/**\n\t * When overridden to return a store, `mutateBatch` is handled by {@link PartialSyncMutationHandler}\n\t * (interest-scoped `rangePatch` + `ack` with `serverVersion: 0`). `syncHello` is not handled on this path.\n\t * Range traffic stays on {@link PartialSyncServerBridge}.\n\t */\n\tprotected createClientMutationSyncStore():\n\t\t| SyncServerBridgeStore<TRow>\n\t\t| undefined {\n\t\treturn undefined;\n\t}\n\n\tprotected async seedData(): Promise<void> {}\n\n\tasync pushServerChanges(changes: SyncMessage<TRow>[]): Promise<void> {\n\t\tawait this.bridge.pushServerChanges(changes);\n\t}\n\n\tprotected sendToClient(\n\t\tclientId: string,\n\t\tmessage: SyncServerMessage<TRow>,\n\t): void {\n\t\tfor (const session of this.sessions.values()) {\n\t\t\tconst typedSession = session as QueryableSession<TRow, TEnv>;\n\t\t\tif (typedSession.clientId !== clientId) continue;\n\t\t\ttypedSession.send(message);\n\t\t}\n\t}\n\n\tprotected broadcastExcept(\n\t\texcludeClientId: string,\n\t\tmessage: SyncServerMessage<TRow>,\n\t): void {\n\t\tfor (const session of this.sessions.values()) {\n\t\t\tconst typedSession = session as QueryableSession<TRow, TEnv>;\n\t\t\tif (typedSession.clientId === excludeClientId) continue;\n\t\t\ttypedSession.send(message);\n\t\t}\n\t}\n}\n"]}

package/dist/chunk-DTRYQ3SF.js

@@ -0,0 +1,36 @@
+import { getTableColumns, gt } from 'drizzle-orm';
+
+// src/drizzle-partial-sync-changelog.ts
+function createDrizzleChangelogHelper(options) {
+  const cols = getTableColumns(options.changelogTable);
+  const rowIdCol = cols.rowId;
+  const operationCol = cols.operation;
+  const versionCol = cols.version;
+  if (rowIdCol === void 0 || operationCol === void 0 || versionCol === void 0) {
+    throw new Error(
+      "changelogTable must have rowId, operation, and version columns"
+    );
+  }
+  return {
+    append: async (operation, rowId, payload) => {
+      const version = /* @__PURE__ */ new Date();
+      await options.db.insert(options.changelogTable).values({
+        rowId,
+        operation,
+        version,
+        payloadJson: payload === null || payload === void 0 ? null : options.serializeJson(payload)
+      });
+    },
+    selectAfterVersion: async (sinceVersionMs) => {
+      const rows = await options.db.select().from(options.changelogTable).where(gt(versionCol, new Date(sinceVersionMs)));
+      return rows;
+    },
+    deleteAll: async () => {
+      await options.db.delete(options.changelogTable);
+    }
+  };
+}
+
+export { createDrizzleChangelogHelper };
+//# sourceMappingURL=chunk-DTRYQ3SF.js.map
+//# sourceMappingURL=chunk-DTRYQ3SF.js.map

package/dist/chunk-DTRYQ3SF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/drizzle-partial-sync-changelog.ts"],"names":[],"mappings":";;;AAcO,SAAS,6BAEd,OAAA,EAAiD;AAClD,EAAA,MAAM,IAAA,GAAO,eAAA,CAAgB,OAAA,CAAQ,cAAc,CAAA;AACnD,EAAA,MAAM,WAAW,IAAA,CAAK,KAAA;AACtB,EAAA,MAAM,eAAe,IAAA,CAAK,SAAA;AAC1B,EAAA,MAAM,aAAa,IAAA,CAAK,OAAA;AACxB,EAAA,IACC,QAAA,KAAa,MAAA,IACb,YAAA,KAAiB,MAAA,IACjB,eAAe,MAAA,EACd;AACD,IAAA,MAAM,IAAI,KAAA;AAAA,MACT;AAAA,KACD;AAAA,EACD;AAEA,EAAA,OAAO;AAAA,IACN,MAAA,EAAQ,OACP,SAAA,EACA,KAAA,EACA,OAAA,KACmB;AACnB,MAAA,MAAM,OAAA,uBAAc,IAAA,EAAK;AACzB,MAAA,MAAM,QAAQ,EAAA,CAAG,MAAA,CAAO,OAAA,CAAQ,cAAc,EAAE,MAAA,CAAO;AAAA,QACtD,KAAA;AAAA,QACA,SAAA;AAAA,QACA,OAAA;AAAA,QACA,WAAA,EACC,YAAY,IAAA,IAAQ,OAAA,KAAY,SAC7B,IAAA,GACA,OAAA,CAAQ,cAAc,OAAO;AAAA,OACN,CAAA;AAAA,IAC7B,CAAA;AAAA,IAEA,kBAAA,EAAoB,OAAO,cAAA,KAA2B;AACrD,MAAA,MAAM,OAAO,MAAM,OAAA,CAAQ,EAAA,CACzB,MAAA,GACA,IAAA,CAAK,OAAA,CAAQ,cAAc,CAAA,CAC3B,MAAM,EAAA,CAAG,UAAA,EAAY,IAAI,IAAA,CAAK,cAAc,CAAC,CAAC,CAAA;AAChD,MAAA,OAAO,IAAA;AAAA,IACR,CAAA;AAAA,IAEA,WAAW,YAA2B;AACrC,MAAA,MAAM,OAAA,CAAQ,EAAA,CAAG,MAAA,CAAO,OAAA,CAAQ,cAAc,CAAA;AAAA,IAC/C;AAAA,GACD;AACD","file":"chunk-DTRYQ3SF.js","sourcesContent":["import { getTableColumns, gt } from \"drizzle-orm\";\nimport type { SQLiteTable } from \"drizzle-orm/sqlite-core\";\nimport type { PartialSyncSqliteDatabase } from \"./partial-sync-sqlite-db\";\n\nexport type ChangelogOperation = \"insert\" | \"update\" | \"delete\";\n\nexport type DrizzleChangelogHelperOptions<\n\tTSchema extends Record<string, unknown>,\n> = {\n\tdb: PartialSyncSqliteDatabase<TSchema>;\n\tchangelogTable: SQLiteTable;\n\tserializeJson: (value: unknown) => string;\n};\n\nexport function createDrizzleChangelogHelper<\n\tTSchema extends Record<string, unknown>,\n>(options: DrizzleChangelogHelperOptions<TSchema>) {\n\tconst cols = getTableColumns(options.changelogTable);\n\tconst rowIdCol = cols.rowId;\n\tconst operationCol = cols.operation;\n\tconst versionCol = cols.version;\n\tif (\n\t\trowIdCol === undefined ||\n\t\toperationCol === undefined ||\n\t\tversionCol === undefined\n\t) {\n\t\tthrow new Error(\n\t\t\t\"changelogTable must have rowId, operation, and version columns\",\n\t\t);\n\t}\n\n\treturn {\n\t\tappend: async (\n\t\t\toperation: ChangelogOperation,\n\t\t\trowId: string,\n\t\t\tpayload: unknown,\n\t\t): Promise<void> => {\n\t\t\tconst version = new Date();\n\t\t\tawait options.db.insert(options.changelogTable).values({\n\t\t\t\trowId,\n\t\t\t\toperation,\n\t\t\t\tversion,\n\t\t\t\tpayloadJson:\n\t\t\t\t\tpayload === null || payload === undefined\n\t\t\t\t\t\t? null\n\t\t\t\t\t\t: options.serializeJson(payload),\n\t\t\t} as Record<string, unknown>);\n\t\t},\n\n\t\tselectAfterVersion: async (sinceVersionMs: number) => {\n\t\t\tconst rows = await options.db\n\t\t\t\t.select()\n\t\t\t\t.from(options.changelogTable)\n\t\t\t\t.where(gt(versionCol, new Date(sinceVersionMs)));\n\t\t\treturn rows;\n\t\t},\n\n\t\tdeleteAll: async (): Promise<void> => {\n\t\t\tawait options.db.delete(options.changelogTable);\n\t\t},\n\t};\n}\n\nexport type DrizzleChangelogHelper<TSchema extends Record<string, unknown>> =\n\tReturnType<typeof createDrizzleChangelogHelper<TSchema>>;\n"]}

package/dist/chunk-JHZRO76J.js

@@ -0,0 +1,288 @@
+import { sortColumnFromConfig, predicateWhereFromConditions } from './chunk-QHM6T5OI.js';
+import { compareInterestValues } from '@firtoz/collection-sync/partial-sync-interest';
+import { matchesPredicate, defaultPredicateColumnValue } from '@firtoz/collection-sync/partial-sync-predicate-match';
+import { exhaustiveGuard } from '@firtoz/maybe-error';
+import { getTableColumns, asc, desc, gt, lt, and, count, max, eq, or } from 'drizzle-orm';
+
+function createDrizzlePartialSyncStore(options) {
+  const { db, table, columnConfig, changelogHelper, deserializeJson } = options;
+  const tableColumns = getTableColumns(table);
+  const idCol = tableColumns.id;
+  const updatedAtCol = tableColumns[options.updatedAtColumnName];
+  if (idCol === void 0) {
+    throw new Error("Partial sync table must have an id column");
+  }
+  if (updatedAtCol === void 0) {
+    throw new Error(
+      `Partial sync table missing updatedAt column: ${String(options.updatedAtColumnName)}`
+    );
+  }
+  async function* queryRange(opts) {
+    let remaining = opts.limit;
+    let cursor = opts.afterCursor;
+    const sortColumn = sortColumnFromConfig(
+      table,
+      opts.sort.column,
+      columnConfig
+    );
+    while (remaining > 0) {
+      const currentLimit = Math.min(opts.chunkSize, remaining);
+      const directionExpr = opts.sort.direction === "asc" ? asc(sortColumn) : desc(sortColumn);
+      const whereCursor = cursor === null ? void 0 : opts.sort.direction === "asc" ? gt(sortColumn, cursor) : lt(sortColumn, cursor);
+      const rows = await db.select().from(table).where(whereCursor ? and(whereCursor) : void 0).orderBy(directionExpr, asc(idCol)).limit(currentLimit);
+      if (rows.length === 0) break;
+      yield rows;
+      remaining -= rows.length;
+      if (rows.length < currentLimit) break;
+      const last = rows[rows.length - 1];
+      cursor = last[opts.sort.column];
+    }
+  }
+  async function* queryByOffset(opts) {
+    let remaining = opts.limit;
+    let sqlOffset = opts.offset;
+    const sortColumn = sortColumnFromConfig(
+      table,
+      opts.sort.column,
+      columnConfig
+    );
+    while (remaining > 0) {
+      const currentLimit = Math.min(opts.chunkSize, remaining);
+      const directionExpr = opts.sort.direction === "asc" ? asc(sortColumn) : desc(sortColumn);
+      const rows = await db.select().from(table).orderBy(directionExpr, asc(idCol)).limit(currentLimit).offset(sqlOffset);
+      if (rows.length === 0) break;
+      yield rows;
+      remaining -= rows.length;
+      sqlOffset += rows.length;
+      if (rows.length < currentLimit) break;
+    }
+  }
+  async function getTotalCount() {
+    const rows = await db.select({ c: count() }).from(table);
+    return rows[0]?.c ?? 0;
+  }
+  function getSortValue(row, column) {
+    return row[column];
+  }
+  async function* queryByPredicate(opts) {
+    const limit = opts.limit ?? opts.chunkSize;
+    let remaining = limit;
+    let offset = 0;
+    const where = predicateWhereFromConditions(
+      table,
+      opts.conditions,
+      columnConfig
+    );
+    const sortColumnName = opts.sort?.column ?? columnConfig.sortableColumns[0];
+    if (sortColumnName === void 0) {
+      throw new Error("queryByPredicate requires sort or sortableColumns[0]");
+    }
+    const sortColumn = sortColumnFromConfig(
+      table,
+      sortColumnName,
+      columnConfig
+    );
+    const directionExpr = opts.sort?.direction === "desc" ? desc(sortColumn) : asc(sortColumn);
+    while (remaining > 0) {
+      const currentLimit = Math.min(opts.chunkSize, remaining);
+      const rows = await db.select().from(table).where(where).orderBy(directionExpr, asc(idCol)).limit(currentLimit).offset(offset);
+      if (rows.length === 0) break;
+      yield rows;
+      remaining -= rows.length;
+      offset += rows.length;
+      if (rows.length < currentLimit) break;
+    }
+  }
+  async function getPredicateCount(conditions) {
+    const where = predicateWhereFromConditions(table, conditions, columnConfig);
+    const rows = await db.select({ c: count() }).from(table).where(where);
+    return rows[0]?.c ?? 0;
+  }
+  function strictlyBeforeInSortOrder(sortCol, idColSQLite, rowSort, rowId, direction) {
+    if (direction === "asc") {
+      return or(
+        lt(sortCol, rowSort),
+        and(eq(sortCol, rowSort), lt(idColSQLite, rowId))
+      );
+    }
+    return or(
+      gt(sortCol, rowSort),
+      and(eq(sortCol, rowSort), lt(idColSQLite, rowId))
+    );
+  }
+  async function rowInIndexRange(row, indexRange) {
+    const sortName = indexRange.sort.column;
+    const rowRec = row;
+    const rowSort = rowRec[sortName];
+    const rowId = rowRec.id;
+    const sortCol = sortColumnFromConfig(table, sortName, columnConfig);
+    if (indexRange.mode === "cursor") {
+      const ac = indexRange.afterCursor;
+      if (ac !== null) {
+        const cmp = compareInterestValues(rowSort, ac);
+        if (indexRange.sort.direction === "asc" && cmp <= 0) return false;
+        if (indexRange.sort.direction === "desc" && cmp >= 0) return false;
+      }
+    }
+    const before = strictlyBeforeInSortOrder(
+      sortCol,
+      idCol,
+      rowSort,
+      rowId,
+      indexRange.sort.direction
+    );
+    let whereRank = before;
+    if (indexRange.mode === "cursor" && indexRange.afterCursor !== null) {
+      const eligible = indexRange.sort.direction === "asc" ? gt(sortCol, indexRange.afterCursor) : lt(sortCol, indexRange.afterCursor);
+      whereRank = and(eligible, before);
+    }
+    const rankRows = await db.select({ c: count() }).from(table).where(whereRank);
+    const rank = rankRows[0]?.c ?? 0;
+    if (indexRange.mode === "offset") {
+      return rank >= indexRange.offset && rank < indexRange.offset + indexRange.limit;
+    }
+    return rank < indexRange.limit;
+  }
+  async function changelogEntryMatchesRange(op, payloadJson, range) {
+    if (range.kind === "predicate") {
+      const conds = range.conditions;
+      switch (op) {
+        case "delete": {
+          if (payloadJson === null || typeof payloadJson !== "string") {
+            return false;
+          }
+          const prev = deserializeJson(payloadJson);
+          return matchesPredicate(prev, conds, defaultPredicateColumnValue);
+        }
+        case "insert": {
+          if (payloadJson === null || typeof payloadJson !== "string") {
+            return false;
+          }
+          const value = deserializeJson(payloadJson);
+          return matchesPredicate(value, conds, defaultPredicateColumnValue);
+        }
+        case "update": {
+          if (payloadJson === null || typeof payloadJson !== "string") {
+            return false;
+          }
+          const parsed = deserializeJson(payloadJson);
+          return matchesPredicate(
+            parsed.value,
+            conds,
+            defaultPredicateColumnValue
+          ) || matchesPredicate(
+            parsed.previousValue,
+            conds,
+            defaultPredicateColumnValue
+          );
+        }
+        default:
+          exhaustiveGuard(op);
+      }
+    }
+    if (range.kind === "index") {
+      switch (op) {
+        case "delete": {
+          if (payloadJson === null || typeof payloadJson !== "string") {
+            return false;
+          }
+          const prev = deserializeJson(payloadJson);
+          return rowInIndexRange(prev, range);
+        }
+        case "insert": {
+          if (payloadJson === null || typeof payloadJson !== "string") {
+            return false;
+          }
+          const value = deserializeJson(payloadJson);
+          return rowInIndexRange(value, range);
+        }
+        case "update": {
+          if (payloadJson === null || typeof payloadJson !== "string") {
+            return false;
+          }
+          const parsed = deserializeJson(payloadJson);
+          return await rowInIndexRange(parsed.value, range) || await rowInIndexRange(parsed.previousValue, range);
+        }
+        default:
+          exhaustiveGuard(op);
+      }
+    }
+    return false;
+  }
+  async function changesSince(opts) {
+    const totalCount = await getTotalCount();
+    const maxRow = await db.select({ m: max(updatedAtCol) }).from(table);
+    const m = maxRow[0]?.m;
+    const maxMs = m instanceof Date ? m.getTime() : Number(m ?? 0);
+    if (opts.sinceVersion >= maxMs) {
+      return { changes: [], totalCount };
+    }
+    const logRows = await changelogHelper.selectAfterVersion(opts.sinceVersion);
+    if (logRows.length === 0) {
+      return null;
+    }
+    const changes = [];
+    for (const entry of logRows) {
+      const row = entry;
+      const op = row.operation;
+      const rowId = row.rowId;
+      const payloadJson = row.payloadJson;
+      if (typeof op !== "string" || typeof rowId !== "string") {
+        throw new Error("Invalid changelog row shape");
+      }
+      if (op !== "insert" && op !== "update" && op !== "delete") {
+        throw new Error(`Unknown changelog operation: ${op}`);
+      }
+      if (!await changelogEntryMatchesRange(
+        op,
+        payloadJson,
+        opts.range
+      )) {
+        continue;
+      }
+      switch (op) {
+        case "delete":
+          changes.push({ type: "delete", key: rowId });
+          break;
+        case "insert": {
+          if (payloadJson === null || typeof payloadJson !== "string") break;
+          const value = deserializeJson(payloadJson);
+          changes.push({ type: "insert", value });
+          break;
+        }
+        case "update": {
+          if (payloadJson === null || typeof payloadJson !== "string") break;
+          const parsed = deserializeJson(payloadJson);
+          changes.push({
+            type: "update",
+            value: parsed.value,
+            previousValue: parsed.previousValue
+          });
+          break;
+        }
+        default:
+          exhaustiveGuard(op);
+      }
+    }
+    return { changes, totalCount };
+  }
+  async function getRow(key) {
+    const rows = await db.select().from(table).where(eq(idCol, key)).limit(1);
+    const r = rows[0];
+    return r !== void 0 ? r : void 0;
+  }
+  return {
+    queryRange,
+    queryByOffset,
+    getTotalCount,
+    getSortValue,
+    queryByPredicate,
+    getPredicateCount,
+    changesSince,
+    getRow
+  };
+}
+
+export { createDrizzlePartialSyncStore };
+//# sourceMappingURL=chunk-JHZRO76J.js.map
+//# sourceMappingURL=chunk-JHZRO76J.js.map