@lunora/db 1.0.0-alpha.20 → 1.0.0-alpha.21

package/dist/collections/index.d.mts

@@ -1,5 +1,5 @@
-export { type C as CheckpointRegistry, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, c as createCheckpointRegistry, l as lunoraCollectionOptions } from "../packem_shared/collection-options.d-lJBOVJgq.mjs";
-export { type C as CollectionDef, type I as InsertBinding, type L as LunoraDb, d as defineCollections } from "../packem_shared/define-collections.d-Cc1p0x3t.mjs";
+export { type C as CheckpointRegistry, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, c as createCheckpointRegistry, l as lunoraCollectionOptions } from "../packem_shared/collection-options.d-DgAuvqvn.mjs";
+export { type C as CollectionDef, type I as InsertBinding, type L as LunoraDb, d as defineCollections } from "../packem_shared/define-collections.d-1z8QtQW8.mjs";
 import '@lunora/client';
 import '@tanstack/db';
 import '@tanstack/offline-transactions';

package/dist/collections/index.d.ts

@@ -1,5 +1,5 @@
-export { type C as CheckpointRegistry, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, c as createCheckpointRegistry, l as lunoraCollectionOptions } from "../packem_shared/collection-options.d-lJBOVJgq.js";
-export { type C as CollectionDef, type I as InsertBinding, type L as LunoraDb, d as defineCollections } from "../packem_shared/define-collections.d-C01DaKJO.js";
+export { type C as CheckpointRegistry, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, c as createCheckpointRegistry, l as lunoraCollectionOptions } from "../packem_shared/collection-options.d-DgAuvqvn.js";
+export { type C as CollectionDef, type I as InsertBinding, type L as LunoraDb, d as defineCollections } from "../packem_shared/define-collections.d-DPgIHAtd.js";
 import '@lunora/client';
 import '@tanstack/db';
 import '@tanstack/offline-transactions';

package/dist/collections/index.mjs

@@ -1,2 +1,2 @@
-export { createCheckpointRegistry, lunoraCollectionOptions } from '../packem_shared/createCheckpointRegistry-DkfPWFWz.mjs';
-export { defineCollections } from '../packem_shared/defineCollections--aaoqJCd.mjs';
+export { createCheckpointRegistry, lunoraCollectionOptions } from '../packem_shared/createCheckpointRegistry-Bf4JtkVH.mjs';
+export { defineCollections } from '../packem_shared/defineCollections-yLxJvEsu.mjs';

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-export { type C as CheckpointRegistry, type E as ExecutorOutboxSinkOptions, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, O as OUTBOX_MUTATION_FN_NAME, type b as OutboxExecutor, type d as OutboxMutationMetadata, type R as Row, type S as SyncWriter, c as createCheckpointRegistry, e as createExecutorOutboxSink, f as createOptimisticOnlineDetector, l as lunoraCollectionOptions, m as makeDiffEmit, r as runOutboxMutation, t as toMap } from "./packem_shared/collection-options.d-lJBOVJgq.mjs";
-export { type C as CollectionDef, type D as DefineCollectionsOptions, type I as InsertBinding, type L as LunoraDb, type W as WriteRejectedEvent, d as defineCollections } from "./packem_shared/define-collections.d-Cc1p0x3t.mjs";
-export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "./packem_shared/define-mutators.d-HWj94_nL.mjs";
+export { type C as CheckpointRegistry, type E as ExecutorOutboxSinkOptions, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, O as OUTBOX_MUTATION_FN_NAME, type b as OutboxExecutor, type d as OutboxMutationMetadata, type R as Row, type S as SyncWriter, c as createCheckpointRegistry, e as createExecutorOutboxSink, f as createOptimisticOnlineDetector, l as lunoraCollectionOptions, m as makeDiffEmit, r as runOutboxMutation, t as toMap } from "./packem_shared/collection-options.d-DgAuvqvn.mjs";
+export { type C as CollectionDef, type D as DefineCollectionsOptions, type I as InsertBinding, type L as LunoraDb, type W as WriteRejectedEvent, d as defineCollections } from "./packem_shared/define-collections.d-1z8QtQW8.mjs";
+export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "./packem_shared/define-mutators.d-Cq_qr5Z1.mjs";
 import '@lunora/client';
 import '@tanstack/db';
 import '@tanstack/offline-transactions';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { type C as CheckpointRegistry, type E as ExecutorOutboxSinkOptions, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, O as OUTBOX_MUTATION_FN_NAME, type b as OutboxExecutor, type d as OutboxMutationMetadata, type R as Row, type S as SyncWriter, c as createCheckpointRegistry, e as createExecutorOutboxSink, f as createOptimisticOnlineDetector, l as lunoraCollectionOptions, m as makeDiffEmit, r as runOutboxMutation, t as toMap } from "./packem_shared/collection-options.d-lJBOVJgq.js";
-export { type C as CollectionDef, type D as DefineCollectionsOptions, type I as InsertBinding, type L as LunoraDb, type W as WriteRejectedEvent, d as defineCollections } from "./packem_shared/define-collections.d-C01DaKJO.js";
-export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "./packem_shared/define-mutators.d-DhO8mWz0.js";
+export { type C as CheckpointRegistry, type E as ExecutorOutboxSinkOptions, type L as LunoraCollectionConfig, type a as LunoraCollectionOptions, O as OUTBOX_MUTATION_FN_NAME, type b as OutboxExecutor, type d as OutboxMutationMetadata, type R as Row, type S as SyncWriter, c as createCheckpointRegistry, e as createExecutorOutboxSink, f as createOptimisticOnlineDetector, l as lunoraCollectionOptions, m as makeDiffEmit, r as runOutboxMutation, t as toMap } from "./packem_shared/collection-options.d-DgAuvqvn.js";
+export { type C as CollectionDef, type D as DefineCollectionsOptions, type I as InsertBinding, type L as LunoraDb, type W as WriteRejectedEvent, d as defineCollections } from "./packem_shared/define-collections.d-DPgIHAtd.js";
+export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "./packem_shared/define-mutators.d-10NiOBqm.js";
 import '@lunora/client';
 import '@tanstack/db';
 import '@tanstack/offline-transactions';

package/dist/index.mjs

@@ -1,5 +1,5 @@
-export { createCheckpointRegistry, lunoraCollectionOptions } from './packem_shared/createCheckpointRegistry-DkfPWFWz.mjs';
-export { defineCollections } from './packem_shared/defineCollections--aaoqJCd.mjs';
+export { createCheckpointRegistry, lunoraCollectionOptions } from './packem_shared/createCheckpointRegistry-Bf4JtkVH.mjs';
+export { defineCollections } from './packem_shared/defineCollections-yLxJvEsu.mjs';
 export { bindMutators, defineMutator } from './packem_shared/bindMutators-BseARPYg.mjs';
 export { OUTBOX_MUTATION_FN_NAME, createExecutorOutboxSink, createOptimisticOnlineDetector, makeDiffEmit, runOutboxMutation, toMap } from './packem_shared/OUTBOX_MUTATION_FN_NAME-Cf8iP6Wa.mjs';
 

package/dist/mutators/index.d.mts

@@ -1,5 +1,5 @@
-export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "../packem_shared/define-mutators.d-HWj94_nL.mjs";
+export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "../packem_shared/define-mutators.d-Cq_qr5Z1.mjs";
 import '@lunora/client';
 import '@tanstack/db';
-import "../packem_shared/collection-options.d-lJBOVJgq.mjs";
+import "../packem_shared/collection-options.d-DgAuvqvn.mjs";
 import '@tanstack/offline-transactions';

package/dist/mutators/index.d.ts

@@ -1,5 +1,5 @@
-export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "../packem_shared/define-mutators.d-DhO8mWz0.js";
+export { type B as BindMutatorsContext, type a as BoundMutators, type C as ClientMutatorContext, type b as ClientMutatorDef, c as bindMutators, d as defineMutator } from "../packem_shared/define-mutators.d-10NiOBqm.js";
 import '@lunora/client';
 import '@tanstack/db';
-import "../packem_shared/collection-options.d-lJBOVJgq.js";
+import "../packem_shared/collection-options.d-DgAuvqvn.js";
 import '@tanstack/offline-transactions';

package/dist/packem_shared/{collection-options.d-lJBOVJgq.d.mts → collection-options.d-DgAuvqvn.d.mts}

@@ -191,6 +191,16 @@ interface LunoraCollectionConfig<TRow extends Row> {
   scopeBy?: string;
   /** A replication shape as the sync source (partial replication). Mutually exclusive with {@link LunoraCollectionConfig.list}. */
   shape?: ShapeSource;
+  /**
+  * Routes the `list` subscription — and the confirmed-mutation watermark its
+  * data/`settled` frames advance the checkpoint gate from — to a specific
+  * shard's DO. Applies to the `list` source; a `shape` carries its own
+  * {@link ShapeSource.shardKey}. Without it the list path falls back to the
+  * default ("") watermark bucket, which must not be compared against a
+  * per-shard mutator's sequence line (it would drop a sharded overlay early or
+  * hang it forever).
+  */
+  shardKey?: string;
 }
 /** The result of {@link lunoraCollectionOptions}: a TanStack collection config plus its sync controls. */
 interface LunoraCollectionOptions<TRow extends Row> {

package/dist/packem_shared/{collection-options.d-lJBOVJgq.d.ts → collection-options.d-DgAuvqvn.d.ts}

@@ -191,6 +191,16 @@ interface LunoraCollectionConfig<TRow extends Row> {
   scopeBy?: string;
   /** A replication shape as the sync source (partial replication). Mutually exclusive with {@link LunoraCollectionConfig.list}. */
   shape?: ShapeSource;
+  /**
+  * Routes the `list` subscription — and the confirmed-mutation watermark its
+  * data/`settled` frames advance the checkpoint gate from — to a specific
+  * shard's DO. Applies to the `list` source; a `shape` carries its own
+  * {@link ShapeSource.shardKey}. Without it the list path falls back to the
+  * default ("") watermark bucket, which must not be compared against a
+  * per-shard mutator's sequence line (it would drop a sharded overlay early or
+  * hang it forever).
+  */
+  shardKey?: string;
 }
 /** The result of {@link lunoraCollectionOptions}: a TanStack collection config plus its sync controls. */
 interface LunoraCollectionOptions<TRow extends Row> {

package/dist/packem_shared/{createCheckpointRegistry-DkfPWFWz.mjs → createCheckpointRegistry-Bf4JtkVH.mjs}

@@ -55,12 +55,13 @@ const lunoraCollectionOptions = (options) => {
   let emit;
   let unsubscribe;
   let onErrorHandler;
+  let scopedArgs;
   const openSubscription = (args, onReady) => {
     const onRows = (data) => {
       emit?.(toMap(data, getKey));
       onReady?.();
       if (options.shape === void 0) {
-        checkpoints.resolve({ mutationId: options.client.confirmedMutationWatermark() });
+        checkpoints.resolve({ mutationId: options.client.confirmedMutationWatermark(options.shardKey) });
       }
     };
     const onError = (error) => onErrorHandler?.(error);
@@ -74,7 +75,7 @@ const lunoraCollectionOptions = (options) => {
         shardKey: options.shape.shardKey
       });
     }
-    return options.client.subscribe(options.list, args, onRows, { onCheckpoint, onError });
+    return options.client.subscribe(options.list, args, onRows, { onCheckpoint, onError, shardKey: options.shardKey });
   };
   const config = {
     // Auto-build ordered (B-tree) indexes for whatever the app's live queries
@@ -100,12 +101,16 @@ const lunoraCollectionOptions = (options) => {
           });
         } else {
           writer.markReady();
+          if (scopedArgs !== void 0) {
+            unsubscribe = openSubscription(scopedArgs, void 0);
+          }
         }
         return () => {
           emit = void 0;
           onErrorHandler = void 0;
           unsubscribe?.();
           unsubscribe = void 0;
+          syncedJson.clear();
         };
       }
     }
@@ -114,13 +119,16 @@ const lunoraCollectionOptions = (options) => {
     if (options.scopeBy === void 0) {
       return;
     }
+    scopedArgs = args;
     unsubscribe?.();
     unsubscribe = void 0;
     emit?.(/* @__PURE__ */ new Map());
     if (args === void 0) {
       return;
     }
-    unsubscribe = openSubscription(args, void 0);
+    if (emit !== void 0) {
+      unsubscribe = openSubscription(args, void 0);
+    }
   };
   return { checkpoints, config, scope };
 };

package/dist/packem_shared/{define-collections.d-C01DaKJO.d.ts → define-collections.d-1z8QtQW8.d.mts}

@@ -1,7 +1,7 @@
 import { FunctionReference, SubscriptionError, LunoraClient } from '@lunora/client';
 import { Transaction, Collection } from '@tanstack/db';
 import { OfflineExecutor, StorageDiagnostic } from '@tanstack/offline-transactions';
-import { R as Row } from "./collection-options.d-lJBOVJgq.js";
+import { R as Row } from "./collection-options.d-DgAuvqvn.mjs";
 /** Element type of an array (the row type a `list` query returns). */
 type Element<T> = T extends ReadonlyArray<infer E> ? E : never;
 /** `true` for the `any` type, `false` otherwise. */
@@ -48,6 +48,13 @@ interface CollectionDef<TList extends FunctionReference, TInput = never> {
   onError?: (error: SubscriptionError) => void;
   /** A field that scopes the list (e.g. a shard key); makes the collection re-pointable via `scope`. */
   scopeBy?: string;
+  /**
+  * Routes the `list` subscription (and the confirmed-mutation watermark its
+  * frames advance the checkpoint gate from) to a specific shard's DO — so a
+  * sharded collection's overlay gate compares against that shard's mutator
+  * sequence line, not the default ("") watermark bucket.
+  */
+  shardKey?: string;
 }
 type AnyDef = CollectionDef<any, any>;
 /**

package/dist/packem_shared/{define-collections.d-Cc1p0x3t.d.mts → define-collections.d-DPgIHAtd.d.ts}

@@ -1,7 +1,7 @@
 import { FunctionReference, SubscriptionError, LunoraClient } from '@lunora/client';
 import { Transaction, Collection } from '@tanstack/db';
 import { OfflineExecutor, StorageDiagnostic } from '@tanstack/offline-transactions';
-import { R as Row } from "./collection-options.d-lJBOVJgq.mjs";
+import { R as Row } from "./collection-options.d-DgAuvqvn.js";
 /** Element type of an array (the row type a `list` query returns). */
 type Element<T> = T extends ReadonlyArray<infer E> ? E : never;
 /** `true` for the `any` type, `false` otherwise. */
@@ -48,6 +48,13 @@ interface CollectionDef<TList extends FunctionReference, TInput = never> {
   onError?: (error: SubscriptionError) => void;
   /** A field that scopes the list (e.g. a shard key); makes the collection re-pointable via `scope`. */
   scopeBy?: string;
+  /**
+  * Routes the `list` subscription (and the confirmed-mutation watermark its
+  * frames advance the checkpoint gate from) to a specific shard's DO — so a
+  * sharded collection's overlay gate compares against that shard's mutator
+  * sequence line, not the default ("") watermark bucket.
+  */
+  shardKey?: string;
 }
 type AnyDef = CollectionDef<any, any>;
 /**

package/dist/packem_shared/{define-mutators.d-DhO8mWz0.d.ts → define-mutators.d-10NiOBqm.d.ts}

@@ -1,6 +1,6 @@
 import { LunoraClient } from '@lunora/client';
 import { Collection, Transaction } from '@tanstack/db';
-import { C as CheckpointRegistry, R as Row } from "./collection-options.d-lJBOVJgq.js";
+import { C as CheckpointRegistry, R as Row } from "./collection-options.d-DgAuvqvn.js";
 /** The local store a client mutator's optimistic body writes against. */
 interface ClientMutatorContext {
   /** The wired collections, keyed by name — apply optimistic inserts/updates/deletes here. */

package/dist/packem_shared/{define-mutators.d-HWj94_nL.d.mts → define-mutators.d-Cq_qr5Z1.d.mts}

@@ -1,6 +1,6 @@
 import { LunoraClient } from '@lunora/client';
 import { Collection, Transaction } from '@tanstack/db';
-import { C as CheckpointRegistry, R as Row } from "./collection-options.d-lJBOVJgq.mjs";
+import { C as CheckpointRegistry, R as Row } from "./collection-options.d-DgAuvqvn.mjs";
 /** The local store a client mutator's optimistic body writes against. */
 interface ClientMutatorContext {
   /** The wired collections, keyed by name — apply optimistic inserts/updates/deletes here. */

package/dist/packem_shared/{defineCollections--aaoqJCd.mjs → defineCollections-yLxJvEsu.mjs}

@@ -1,6 +1,6 @@
-import { createCollection } from '@tanstack/db';
+import { createCollection, safeRandomUUID } from '@tanstack/db';
 import { startOfflineExecutor, NonRetriableError } from '@tanstack/offline-transactions';
-import { lunoraCollectionOptions } from './createCheckpointRegistry-DkfPWFWz.mjs';
+import { lunoraCollectionOptions } from './createCheckpointRegistry-Bf4JtkVH.mjs';
 import { createOptimisticOnlineDetector, runOutboxMutation, OUTBOX_MUTATION_FN_NAME } from './OUTBOX_MUTATION_FN_NAME-Cf8iP6Wa.mjs';
 
 const defineCollections = (client, defs, options = {}) => {
@@ -18,18 +18,20 @@ const defineCollections = (client, defs, options = {}) => {
       list: definition.list,
       ...definition.load === void 0 ? {} : { load: definition.load },
       onError: definition.onError,
-      scopeBy: definition.scopeBy
+      scopeBy: definition.scopeBy,
+      shardKey: definition.shardKey
     });
     collections[name] = createCollection(config);
     if (definition.scopeBy !== void 0) {
       scope[name] = scopeFunction;
     }
     if (insert) {
-      mutationFns[name] = async ({ transaction }) => {
-        for (const mutation of transaction.mutations) {
+      mutationFns[name] = async ({ idempotencyKey, transaction }) => {
+        for (const [mutationIndex, mutation] of transaction.mutations.entries()) {
           const row = mutation.modified;
+          const mutationId = `${idempotencyKey}:${String(mutationIndex)}`;
           try {
-            await runOutboxMutation(() => client.mutation(insert.mutation, insert.toArgs(row)));
+            await runOutboxMutation(() => client.mutation(insert.mutation, insert.toArgs(row), { mutationId }));
           } catch (error) {
             if (error instanceof NonRetriableError && options.onWriteRejected) {
               try {
@@ -94,7 +96,7 @@ const defineCollections = (client, defs, options = {}) => {
       }
     });
     actions[name] = (input) => {
-      const id = crypto.randomUUID();
+      const id = safeRandomUUID();
       const transaction = action({ id, input });
       return { id, transaction };
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/db",
-  "version": "1.0.0-alpha.20",
+  "version": "1.0.0-alpha.21",
   "description": "TanStack DB binding: typed, live-synced collections and a durable offline outbox over the Lunora client",
   "keywords": [
     "cloudflare",
@@ -54,8 +54,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.20",
-    "@lunora/errors": "1.0.0-alpha.3"
+    "@lunora/client": "1.0.0-alpha.21",
+    "@lunora/errors": "1.0.0-alpha.4"
   },
   "peerDependencies": {
     "@tanstack/db": "^0.6.0",