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

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-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";
+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-Cd6j65i-.mjs";
+export { type C as CollectionDef, type I as InsertBinding, type L as LunoraDb, d as defineCollections } from "../packem_shared/define-collections.d-CSpxihIj.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-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";
+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-Cd6j65i-.js";
+export { type C as CollectionDef, type I as InsertBinding, type L as LunoraDb, d as defineCollections } from "../packem_shared/define-collections.d-CNkWbDe0.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-Bf4JtkVH.mjs';
-export { defineCollections } from '../packem_shared/defineCollections-yLxJvEsu.mjs';
+export { createCheckpointRegistry, lunoraCollectionOptions } from '../packem_shared/createCheckpointRegistry-BtIEm2Kh.mjs';
+export { defineCollections } from '../packem_shared/defineCollections-C_F-42rS.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-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";
+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-Cd6j65i-.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-CSpxihIj.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-B4FIhFEy.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-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";
+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-Cd6j65i-.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-CNkWbDe0.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-Cg_oXn60.js";
 import '@lunora/client';
 import '@tanstack/db';
 import '@tanstack/offline-transactions';

package/dist/index.mjs

@@ -1,7 +1,7 @@
-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';
+export { createCheckpointRegistry, lunoraCollectionOptions } from './packem_shared/createCheckpointRegistry-BtIEm2Kh.mjs';
+export { defineCollections } from './packem_shared/defineCollections-C_F-42rS.mjs';
+export { bindMutators, defineMutator } from './packem_shared/bindMutators-B_RaNgel.mjs';
+export { OUTBOX_MUTATION_FN_NAME, createExecutorOutboxSink, createOptimisticOnlineDetector, makeDiffEmit, runOutboxMutation, toMap } from './packem_shared/OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs';
 
 const VERSION = "0.0.0";
 

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-Cq_qr5Z1.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-B4FIhFEy.mjs";
 import '@lunora/client';
 import '@tanstack/db';
-import "../packem_shared/collection-options.d-DgAuvqvn.mjs";
+import "../packem_shared/collection-options.d-Cd6j65i-.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-10NiOBqm.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-Cg_oXn60.js";
 import '@lunora/client';
 import '@tanstack/db';
-import "../packem_shared/collection-options.d-DgAuvqvn.js";
+import "../packem_shared/collection-options.d-Cd6j65i-.js";
 import '@tanstack/offline-transactions';

package/dist/mutators/index.mjs

@@ -1 +1 @@
-export { bindMutators, defineMutator } from '../packem_shared/bindMutators-BseARPYg.mjs';
+export { bindMutators, defineMutator } from '../packem_shared/bindMutators-B_RaNgel.mjs';

package/dist/packem_shared/{OUTBOX_MUTATION_FN_NAME-Cf8iP6Wa.mjs → OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs}

@@ -1,7 +1,26 @@
+import { createCollection, safeRandomUUID } from '@tanstack/db';
 import { NonRetriableError } from '@tanstack/offline-transactions';
 
 const OUTBOX_DRAIN_INTERVAL_MS = 1e3;
 const OUTBOX_MUTATION_FN_NAME = "__lunora_outbox__";
+const outboxCarriers = /* @__PURE__ */ new WeakMap();
+const createOutboxCarrier = () => createCollection({
+  // eslint-disable-next-line no-underscore-dangle -- `_id` is the Lunora document-id field
+  getKey: (row) => row._id,
+  id: `${OUTBOX_MUTATION_FN_NAME}:${safeRandomUUID()}`,
+  startSync: true,
+  sync: {
+    // Nothing syncs into the carrier — mark it ready immediately.
+    sync: (writer) => {
+      writer.markReady();
+      return () => void 0;
+    }
+  }
+});
+const registerOutboxCarrier = (executor, carrier) => {
+  outboxCarriers.set(executor, carrier);
+};
+let warnedMissingCarrier = false;
 const createExecutorOutboxSink = (executor, options = {}) => {
   const maxItems = options.maxItems ?? 1e3;
   const mutationFunctionName = options.mutationFnName ?? OUTBOX_MUTATION_FN_NAME;
@@ -23,13 +42,23 @@ const createExecutorOutboxSink = (executor, options = {}) => {
         mutationId: mutation.mutationId,
         shardKey: mutation.shardKey
       };
+      const carrier = outboxCarriers.get(executor);
+      if (!carrier && !warnedMissingCarrier) {
+        warnedMissingCarrier = true;
+        console.warn(
+          "[@lunora/db] createExecutorOutboxSink: no outbox carrier is registered for this executor. On a TanStack OfflineExecutor a zero-mutation transaction is silently dropped, so offline writes may be lost — wire the sink to the executor returned by defineCollections()."
+        );
+      }
       const transaction = executor.createOfflineTransaction({
-        autoCommit: true,
+        autoCommit: false,
         idempotencyKey: mutation.idempotencyKey,
         metadata,
         mutationFnName: mutationFunctionName
       });
-      transaction.mutate(() => void 0);
+      transaction.mutate(() => {
+        carrier?.insert({ _id: mutation.idempotencyKey });
+      });
+      transaction.commit?.().catch(() => void 0);
       return Promise.resolve();
     }
   };
@@ -99,4 +128,4 @@ const createOptimisticOnlineDetector = () => {
   };
 };
 
-export { OUTBOX_MUTATION_FN_NAME, createExecutorOutboxSink, createOptimisticOnlineDetector, makeDiffEmit, runOutboxMutation, toMap };
+export { OUTBOX_MUTATION_FN_NAME, createExecutorOutboxSink, createOptimisticOnlineDetector, createOutboxCarrier, makeDiffEmit, registerOutboxCarrier, runOutboxMutation, toMap };

package/dist/packem_shared/{bindMutators-BseARPYg.mjs → bindMutators-B_RaNgel.mjs}

@@ -1,6 +1,6 @@
 import { LunoraError } from '@lunora/errors';
 import { createTransaction } from '@tanstack/db';
-import { runOutboxMutation } from './OUTBOX_MUTATION_FN_NAME-Cf8iP6Wa.mjs';
+import { runOutboxMutation } from './OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs';
 
 const defineMutator = (definition) => {
   return {

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

@@ -23,6 +23,7 @@ interface OutboxMutationMetadata extends Record<string, unknown> {
 }
 /** A committable outbox transaction handle (the `OfflineTransaction` the executor mints). */
 interface OutboxTransaction {
+  commit?: () => Promise<unknown>;
   mutate: (callback: () => void) => unknown;
 }
 /**

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

@@ -23,6 +23,7 @@ interface OutboxMutationMetadata extends Record<string, unknown> {
 }
 /** A committable outbox transaction handle (the `OfflineTransaction` the executor mints). */
 interface OutboxTransaction {
+  commit?: () => Promise<unknown>;
   mutate: (callback: () => void) => unknown;
 }
 /**

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

@@ -1,6 +1,6 @@
 import { LunoraError } from '@lunora/errors';
 import { BTreeIndex } from '@tanstack/db';
-import { toMap, makeDiffEmit } from './OUTBOX_MUTATION_FN_NAME-Cf8iP6Wa.mjs';
+import { toMap, makeDiffEmit } from './OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs';
 
 const createGate = () => {
   let highest = Number.NEGATIVE_INFINITY;

package/dist/packem_shared/{define-collections.d-DPgIHAtd.d.ts → define-collections.d-CNkWbDe0.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-DgAuvqvn.js";
+import { R as Row } from "./collection-options.d-Cd6j65i-.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. */

package/dist/packem_shared/{define-collections.d-1z8QtQW8.d.mts → define-collections.d-CSpxihIj.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-DgAuvqvn.mjs";
+import { R as Row } from "./collection-options.d-Cd6j65i-.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. */

package/dist/packem_shared/{define-mutators.d-Cq_qr5Z1.d.mts → define-mutators.d-B4FIhFEy.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-DgAuvqvn.mjs";
+import { C as CheckpointRegistry, R as Row } from "./collection-options.d-Cd6j65i-.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/{define-mutators.d-10NiOBqm.d.ts → define-mutators.d-Cg_oXn60.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-DgAuvqvn.js";
+import { C as CheckpointRegistry, R as Row } from "./collection-options.d-Cd6j65i-.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/{defineCollections-yLxJvEsu.mjs → defineCollections-C_F-42rS.mjs}

@@ -1,7 +1,7 @@
 import { createCollection, safeRandomUUID } from '@tanstack/db';
 import { startOfflineExecutor, NonRetriableError } from '@tanstack/offline-transactions';
-import { lunoraCollectionOptions } from './createCheckpointRegistry-Bf4JtkVH.mjs';
-import { createOptimisticOnlineDetector, runOutboxMutation, OUTBOX_MUTATION_FN_NAME } from './OUTBOX_MUTATION_FN_NAME-Cf8iP6Wa.mjs';
+import { lunoraCollectionOptions } from './createCheckpointRegistry-BtIEm2Kh.mjs';
+import { createOutboxCarrier, createOptimisticOnlineDetector, OUTBOX_MUTATION_FN_NAME, registerOutboxCarrier, runOutboxMutation } from './OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs';
 
 const defineCollections = (client, defs, options = {}) => {
   const collections = {};
@@ -57,8 +57,9 @@ const defineCollections = (client, defs, options = {}) => {
       () => client.mutation({ __lunoraRef: meta.functionPath }, meta.args, { mutationId: meta.idempotencyKey, shardKey: meta.shardKey })
     );
   };
+  const outboxCarrier = createOutboxCarrier();
   const executor = startOfflineExecutor({
-    collections,
+    collections: { ...collections, [OUTBOX_MUTATION_FN_NAME]: outboxCarrier },
     mutationFns,
     onlineDetector: createOptimisticOnlineDetector(),
     ...options.onLeadershipChange ? { onLeadershipChange: options.onLeadershipChange } : {},
@@ -82,6 +83,7 @@ const defineCollections = (client, defs, options = {}) => {
       }
     }
   });
+  registerOutboxCarrier(executor, outboxCarrier);
   const actions = {};
   for (const [name, definition] of entries) {
     const insert = definition.insert;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/db",
-  "version": "1.0.0-alpha.21",
+  "version": "1.0.0-alpha.23",
   "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.21",
-    "@lunora/errors": "1.0.0-alpha.4"
+    "@lunora/client": "1.0.0-alpha.23",
+    "@lunora/errors": "1.0.0-alpha.5"
   },
   "peerDependencies": {
     "@tanstack/db": "^0.6.0",