@lunora/db 1.0.0-alpha.28 → 1.0.0-alpha.29

package/dist/packem_shared/{define-mutators.d-DTU85KL6.d.mts → define-mutators.d-DqkWcDks.d.ts}

@@ -1,11 +1,48 @@
 import { LunoraClient } from '@lunora/client';
 import { Collection, Transaction } from '@tanstack/db';
-import { C as CheckpointRegistry, R as Row } from "./collection-options.d-BPVkj5FW.mjs";
+import { C as CheckpointRegistry, R as Row } from "./collection-options.d-C03Rjjxn.js";
+/**
+ * TanStack DB's "direct transaction" marker.
+ *
+ * A completed transaction's optimistic rows are discarded as **stale** unless
+ * either a synced transaction for the same key is already queued, or the
+ * transaction carried this flag (`CollectionStateManager.recomputeOptimisticState`
+ * → `pendingOptimisticDirectUpserts`). Marked rows instead survive until a sync
+ * operation for that key actually lands, which is precisely the semantics a Lunora
+ * custom mutator needs: the server is the linearization point, so the prediction
+ * must stay visible until the authoritative row arrives. Without it, a text edit
+ * visibly reverts to the last synced value the moment the push is acked.
+ *
+ * The literal is pinned here because `@tanstack/db` does not re-export the constant
+ * from its package root (it lives in the unexported
+ * `collection/transaction-metadata` module). `__tests__/define-mutators.test.ts`
+ * reads that module off disk and fails if the upstream value ever changes.
+ */
+declare const DIRECT_TRANSACTION_METADATA_KEY = "__tanstack_db_direct";
 /** 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. */
   collections: Record<string, Collection<Row, string>>;
 }
+/**
+ * A generated mutator reference (`api.mutators.sendMessage`), accepted by
+ * {@link defineMutator} in place of a hand-written path string.
+ *
+ * Declared structurally rather than imported from `@lunora/client` so this module
+ * keeps its narrow dependency surface; the shape matches `FunctionReference`, and
+ * the phantom marker carries the server mutator's arg type so the client body's
+ * args are **inferred** instead of restated.
+ */
+interface MutatorReference<TArgs = unknown> {
+  readonly __lunoraPhantom?: {
+    args: TArgs;
+    kind: unknown;
+    returns: unknown;
+  };
+  readonly __lunoraRef: string;
+}
+/** Args type carried by a {@link MutatorReference}. */
+type ArgsOfReference<R> = R extends MutatorReference<infer A> ? A : never;
 /** A client-side custom mutator: an optimistic body plus the path of its authoritative server impl. */
 interface ClientMutatorDef<TArgs> {
   /** Brand so codegen / `bindMutators` can recognize a mutator definition. */
@@ -20,24 +57,55 @@ interface ClientMutatorDef<TArgs> {
  * local TanStack collections; `serverRef` names the authoritative server mutator
  * the write is pushed to over the watermark protocol. The server impl is the
  * linearization point — this body is a prediction the server can override.
+ *
+ * **Pass a generated reference, not a string.** `serverRef: api.mutators.sendMessage`
+ * both binds the path at compile time — a rename, a typo, or a moved file becomes a
+ * type error instead of a mutation that silently fails at runtime — and **infers
+ * `TArgs` from the server mutator's own validators**, so the arg type is declared
+ * once on the server rather than restated in every client body:
+ *
+ * ```ts
+ * // Typed + checked: args inferred from the server mutator.
+ * defineMutator({
+ *     apply: ({ collections }, args) => { … },   // args: { channelId: Id<"channels">; text: string }
+ *     serverRef: api.mutators.sendMessage,
+ * });
+ *
+ * // Escape hatch: a path string still works, but nothing checks it and you must
+ * // restate the args yourself.
+ * defineMutator<{ text: string }>({ apply, serverRef: "mutators:sendMessage" });
+ * ```
  */
-declare const defineMutator: <TArgs = Record<string, unknown>>(definition: {
-  apply: (context: ClientMutatorContext, args: TArgs) => void;
-  serverRef: string;
-}) => ClientMutatorDef<TArgs>;
+declare const defineMutator: {
+  <TArgs = Record<string, unknown>>(definition: {
+    apply: (context: ClientMutatorContext, args: TArgs) => void;
+    serverRef: string;
+  }): ClientMutatorDef<TArgs>;
+  <R extends MutatorReference<never>>(definition: {
+    apply: (context: ClientMutatorContext, args: ArgsOfReference<R>) => void;
+    serverRef: R;
+  }): ClientMutatorDef<ArgsOfReference<R>>;
+};
 type AnyMutatorMap = Record<string, ClientMutatorDef<any>>;
 /** Args type of a mutator definition. */
 type ArgsOf<M> = M extends ClientMutatorDef<infer A> ? A : never;
 /** Inputs `bindMutators` needs to run a mutator: the local store + how the overlay drops. */
 interface BindMutatorsContext {
   /**
-   * Resolves the optimistic-overlay drop against confirmed server watermarks.
-   * When supplied, a mutation's overlay is held until the sync stream echoes
-   * `lastMutationId >= clientSeq` (via {@link CheckpointRegistry.resolve}) — no
-   * flicker. When omitted, the overlay drops as soon as the server accepts the
-   * write (the by-value sync diff then converges the synced row in place).
+   * Resolves the optimistic-overlay drop against confirmed server watermarks: a
+   * mutation's overlay is held until the sync stream echoes
+   * `lastMutationId >= clientSeq` (via {@link CheckpointRegistry.resolve}), so the
+   * row never flashes out and back.
+   *
+   * Defaults to the shared per-shard registry for `client` + {@link shardKey}
+   * ({@link getShardCheckpoints}) — the same one
+   * {@link import("./collection-options").lunoraCollectionOptions} defaults to, so
+   * a shard's collections and its mutators gate on one watermark line without the
+   * caller wiring them together. Pass `false` to drop the overlay as soon as the
+   * server accepts the write (the by-value sync diff then converges the synced row
+   * in place).
    */
-  checkpoints?: CheckpointRegistry;
+  checkpoints?: CheckpointRegistry | false;
   /** The wired collections the optimistic bodies write against. */
   collections: Record<string, Collection<Row, string>>;
   /** Optional shard key the mutator's server push is routed to. */
@@ -77,4 +145,4 @@ type BoundMutators<M extends AnyMutatorMap> = { [K in keyof M]: (args: ArgsOf<M[
  * reclaims the same `watermark + 1` instead of leaving a hole the DO waits on.
  */
 declare const bindMutators: <M extends AnyMutatorMap>(client: LunoraClient, context: BindMutatorsContext, mutators: M) => BoundMutators<M>;
-export { BindMutatorsContext as B, ClientMutatorContext as C, BoundMutators as a, ClientMutatorDef as b, bindMutators as c, defineMutator as d };
+export { BindMutatorsContext as B, ClientMutatorContext as C, DIRECT_TRANSACTION_METADATA_KEY as D, MutatorReference as M, BoundMutators as a, ClientMutatorDef as b, bindMutators as c, defineMutator as d };

package/dist/packem_shared/{define-mutators.d-DukVT0Y3.d.ts → define-mutators.d-tPb72T4I.d.mts}

@@ -1,11 +1,48 @@
 import { LunoraClient } from '@lunora/client';
 import { Collection, Transaction } from '@tanstack/db';
-import { C as CheckpointRegistry, R as Row } from "./collection-options.d-BPVkj5FW.js";
+import { C as CheckpointRegistry, R as Row } from "./collection-options.d-C03Rjjxn.mjs";
+/**
+ * TanStack DB's "direct transaction" marker.
+ *
+ * A completed transaction's optimistic rows are discarded as **stale** unless
+ * either a synced transaction for the same key is already queued, or the
+ * transaction carried this flag (`CollectionStateManager.recomputeOptimisticState`
+ * → `pendingOptimisticDirectUpserts`). Marked rows instead survive until a sync
+ * operation for that key actually lands, which is precisely the semantics a Lunora
+ * custom mutator needs: the server is the linearization point, so the prediction
+ * must stay visible until the authoritative row arrives. Without it, a text edit
+ * visibly reverts to the last synced value the moment the push is acked.
+ *
+ * The literal is pinned here because `@tanstack/db` does not re-export the constant
+ * from its package root (it lives in the unexported
+ * `collection/transaction-metadata` module). `__tests__/define-mutators.test.ts`
+ * reads that module off disk and fails if the upstream value ever changes.
+ */
+declare const DIRECT_TRANSACTION_METADATA_KEY = "__tanstack_db_direct";
 /** 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. */
   collections: Record<string, Collection<Row, string>>;
 }
+/**
+ * A generated mutator reference (`api.mutators.sendMessage`), accepted by
+ * {@link defineMutator} in place of a hand-written path string.
+ *
+ * Declared structurally rather than imported from `@lunora/client` so this module
+ * keeps its narrow dependency surface; the shape matches `FunctionReference`, and
+ * the phantom marker carries the server mutator's arg type so the client body's
+ * args are **inferred** instead of restated.
+ */
+interface MutatorReference<TArgs = unknown> {
+  readonly __lunoraPhantom?: {
+    args: TArgs;
+    kind: unknown;
+    returns: unknown;
+  };
+  readonly __lunoraRef: string;
+}
+/** Args type carried by a {@link MutatorReference}. */
+type ArgsOfReference<R> = R extends MutatorReference<infer A> ? A : never;
 /** A client-side custom mutator: an optimistic body plus the path of its authoritative server impl. */
 interface ClientMutatorDef<TArgs> {
   /** Brand so codegen / `bindMutators` can recognize a mutator definition. */
@@ -20,24 +57,55 @@ interface ClientMutatorDef<TArgs> {
  * local TanStack collections; `serverRef` names the authoritative server mutator
  * the write is pushed to over the watermark protocol. The server impl is the
  * linearization point — this body is a prediction the server can override.
+ *
+ * **Pass a generated reference, not a string.** `serverRef: api.mutators.sendMessage`
+ * both binds the path at compile time — a rename, a typo, or a moved file becomes a
+ * type error instead of a mutation that silently fails at runtime — and **infers
+ * `TArgs` from the server mutator's own validators**, so the arg type is declared
+ * once on the server rather than restated in every client body:
+ *
+ * ```ts
+ * // Typed + checked: args inferred from the server mutator.
+ * defineMutator({
+ *     apply: ({ collections }, args) => { … },   // args: { channelId: Id<"channels">; text: string }
+ *     serverRef: api.mutators.sendMessage,
+ * });
+ *
+ * // Escape hatch: a path string still works, but nothing checks it and you must
+ * // restate the args yourself.
+ * defineMutator<{ text: string }>({ apply, serverRef: "mutators:sendMessage" });
+ * ```
  */
-declare const defineMutator: <TArgs = Record<string, unknown>>(definition: {
-  apply: (context: ClientMutatorContext, args: TArgs) => void;
-  serverRef: string;
-}) => ClientMutatorDef<TArgs>;
+declare const defineMutator: {
+  <TArgs = Record<string, unknown>>(definition: {
+    apply: (context: ClientMutatorContext, args: TArgs) => void;
+    serverRef: string;
+  }): ClientMutatorDef<TArgs>;
+  <R extends MutatorReference<never>>(definition: {
+    apply: (context: ClientMutatorContext, args: ArgsOfReference<R>) => void;
+    serverRef: R;
+  }): ClientMutatorDef<ArgsOfReference<R>>;
+};
 type AnyMutatorMap = Record<string, ClientMutatorDef<any>>;
 /** Args type of a mutator definition. */
 type ArgsOf<M> = M extends ClientMutatorDef<infer A> ? A : never;
 /** Inputs `bindMutators` needs to run a mutator: the local store + how the overlay drops. */
 interface BindMutatorsContext {
   /**
-   * Resolves the optimistic-overlay drop against confirmed server watermarks.
-   * When supplied, a mutation's overlay is held until the sync stream echoes
-   * `lastMutationId >= clientSeq` (via {@link CheckpointRegistry.resolve}) — no
-   * flicker. When omitted, the overlay drops as soon as the server accepts the
-   * write (the by-value sync diff then converges the synced row in place).
+   * Resolves the optimistic-overlay drop against confirmed server watermarks: a
+   * mutation's overlay is held until the sync stream echoes
+   * `lastMutationId >= clientSeq` (via {@link CheckpointRegistry.resolve}), so the
+   * row never flashes out and back.
+   *
+   * Defaults to the shared per-shard registry for `client` + {@link shardKey}
+   * ({@link getShardCheckpoints}) — the same one
+   * {@link import("./collection-options").lunoraCollectionOptions} defaults to, so
+   * a shard's collections and its mutators gate on one watermark line without the
+   * caller wiring them together. Pass `false` to drop the overlay as soon as the
+   * server accepts the write (the by-value sync diff then converges the synced row
+   * in place).
    */
-  checkpoints?: CheckpointRegistry;
+  checkpoints?: CheckpointRegistry | false;
   /** The wired collections the optimistic bodies write against. */
   collections: Record<string, Collection<Row, string>>;
   /** Optional shard key the mutator's server push is routed to. */
@@ -77,4 +145,4 @@ type BoundMutators<M extends AnyMutatorMap> = { [K in keyof M]: (args: ArgsOf<M[
  * reclaims the same `watermark + 1` instead of leaving a hole the DO waits on.
  */
 declare const bindMutators: <M extends AnyMutatorMap>(client: LunoraClient, context: BindMutatorsContext, mutators: M) => BoundMutators<M>;
-export { BindMutatorsContext as B, ClientMutatorContext as C, BoundMutators as a, ClientMutatorDef as b, bindMutators as c, defineMutator as d };
+export { BindMutatorsContext as B, ClientMutatorContext as C, DIRECT_TRANSACTION_METADATA_KEY as D, MutatorReference as M, BoundMutators as a, ClientMutatorDef as b, bindMutators as c, defineMutator as d };

package/dist/packem_shared/defineCollections-CnFdW1Ff.mjs

@@ -0,0 +1 @@
+import{createCollection as I,safeRandomUUID as R}from"@tanstack/db";import{startOfflineExecutor as U,NonRetriableError as w}from"@tanstack/offline-transactions";import{lunoraCollectionOptions as _}from"./CHECKPOINT_FALLBACK_MS-CtPxAU9J.mjs";import{createOutboxCarrier as b,createOptimisticOnlineDetector as E,OUTBOX_MUTATION_FN_NAME as C,registerOutboxCarrier as M,runOutboxMutation as N}from"./OUTBOX_MUTATION_FN_NAME-CebgkYw2.mjs";const S=(a,K,e={})=>{const c={},p={},l={},y=Object.entries(K);for(const[t,o]of y){const n=o.insert,{config:d,scope:m}=_({client:a,getKey:o.getKey,id:t,list:o.list,...o.load===void 0?{}:{load:o.load},onError:o.onError,scopeBy:o.scopeBy,shardKey:o.shardKey});c[t]=I(d),o.scopeBy!==void 0&&(p[t]=m),n&&(l[t]=async({idempotencyKey:r,transaction:i})=>{for(const[f,x]of i.mutations.entries()){const O=x.modified,F=`${r}:${String(f)}`;try{await N(()=>a.mutation(n.mutation,n.toArgs(O),{mutationId:F}))}catch(u){if(u instanceof w&&e.onWriteRejected)try{e.onWriteRejected({code:u.code,collection:t,error:u,row:O})}catch{}throw u}}})}l[C]=async({transaction:t})=>{const o=t.metadata;if(o){if(o.identity!==a.currentIdentity())throw new w("outbox write dropped: identity changed since it was queued");await N(()=>a.mutation({__lunoraRef:o.functionPath},o.args,{mutationId:o.idempotencyKey,shardKey:o.shardKey}))}};const g=b(),s=U({collections:{...c,[C]:g},mutationFns:l,onlineDetector:E(),...e.onLeadershipChange?{onLeadershipChange:e.onLeadershipChange}:{},...e.onStorageFailure?{onStorageFailure:e.onStorageFailure}:{},onUnknownMutationFn:(t,o)=>{try{e.onWriteRejected?.({code:"UNKNOWN_MUTATION_FN",collection:t,error:new Error(`offline write dropped: mutation "${t}" no longer exists (removed or renamed in a deploy?)`),row:o.mutations[0]?.modified})}catch{}}});M(s,g);const h={};for(const[t,o]of y){const n=o.insert,d=c[t];if(!n||!d)continue;const m=s.createOfflineAction({mutationFnName:t,onMutate:({id:r,input:i})=>{d.insert(n.optimistic(i,r))}});h[t]=r=>{const i=R(),f=m({id:i,input:r});return{id:i,transaction:f}}}return{actions:h,collections:c,executor:s,pendingCount:()=>s.getPendingCount(),scope:p}};export{S as defineCollections};

package/package.json

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

package/dist/packem_shared/OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs

@@ -1,131 +0,0 @@
-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;
-  return {
-    enqueue(mutation) {
-      if (executor.getPendingCount() >= maxItems) {
-        const error = new Error("offline outbox is full");
-        error.code = "OFFLINE_QUEUE_OVERFLOW";
-        return Promise.reject(error);
-      }
-      const metadata = {
-        args: mutation.args,
-        clientId: mutation.clientId,
-        functionPath: mutation.functionPath,
-        // Persist the stable replay key so a committed-but-unacked retry
-        // resends the same `x-lunora-mutation-id` and the server dedups it.
-        idempotencyKey: mutation.idempotencyKey,
-        identity: mutation.identity,
-        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: false,
-        idempotencyKey: mutation.idempotencyKey,
-        metadata,
-        mutationFnName: mutationFunctionName
-      });
-      transaction.mutate(() => {
-        carrier?.insert({ _id: mutation.idempotencyKey });
-      });
-      transaction.commit?.().catch(() => void 0);
-      return Promise.resolve();
-    }
-  };
-};
-const toMap = (rows, getKey) => {
-  const map = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    map.set(getKey(row), row);
-  }
-  return map;
-};
-const makeDiffEmit = (syncedJson, writer) => (next) => {
-  writer.begin();
-  const nextJson = /* @__PURE__ */ new Map();
-  for (const [key, value] of next) {
-    const valueJson = JSON.stringify(value);
-    nextJson.set(key, valueJson);
-    if (!syncedJson.has(key)) {
-      writer.write({ type: "insert", value });
-    } else if (syncedJson.get(key) !== valueJson) {
-      writer.write({ type: "update", value });
-    }
-  }
-  for (const key of syncedJson.keys()) {
-    if (!next.has(key)) {
-      writer.write({ key, type: "delete" });
-    }
-  }
-  writer.commit();
-  syncedJson.clear();
-  for (const [key, valueJson] of nextJson) {
-    syncedJson.set(key, valueJson);
-  }
-};
-const runOutboxMutation = async (mutate) => {
-  try {
-    await mutate();
-  } catch (error) {
-    if (typeof error.code === "string") {
-      const nonRetriable = new NonRetriableError(error instanceof Error ? error.message : String(error));
-      nonRetriable.code = error.code;
-      throw nonRetriable;
-    }
-    throw error;
-  }
-};
-const createOptimisticOnlineDetector = () => {
-  const intervals = /* @__PURE__ */ new Set();
-  return {
-    dispose: () => {
-      for (const handle of intervals) {
-        clearInterval(handle);
-      }
-      intervals.clear();
-    },
-    isOnline: () => true,
-    notifyOnline: () => {
-    },
-    subscribe: (callback) => {
-      const handle = setInterval(callback, OUTBOX_DRAIN_INTERVAL_MS);
-      intervals.add(handle);
-      return () => {
-        clearInterval(handle);
-        intervals.delete(handle);
-      };
-    }
-  };
-};
-
-export { OUTBOX_MUTATION_FN_NAME, createExecutorOutboxSink, createOptimisticOnlineDetector, createOutboxCarrier, makeDiffEmit, registerOutboxCarrier, runOutboxMutation, toMap };

package/dist/packem_shared/bindMutators-B_RaNgel.mjs

@@ -1,70 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { createTransaction } from '@tanstack/db';
-import { runOutboxMutation } from './OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs';
-
-const defineMutator = (definition) => {
-  return {
-    __lunoraClientMutator: true,
-    apply: definition.apply,
-    serverRef: definition.serverRef
-  };
-};
-const bindMutators = (client, context, mutators) => {
-  const maxReissues = 32;
-  let counter = 0;
-  const nextClientSeq = () => {
-    counter = Math.max(counter, client.confirmedMutationWatermark(context.shardKey)) + 1;
-    return counter;
-  };
-  let pushChain = Promise.resolve();
-  const pushSerialized = (serverRef, args) => {
-    const run = pushChain.then(async () => {
-      for (let attempt = 0; ; attempt += 1) {
-        const clientSeq = nextClientSeq();
-        const { applied } = await client.callMutator(serverRef, args, {
-          clientSeq,
-          shardKey: context.shardKey
-        });
-        if (applied) {
-          return clientSeq;
-        }
-        if (attempt >= maxReissues) {
-          throw new LunoraError(
-            "INTERNAL",
-            `lunora: custom mutator "${serverRef}" could not claim a fresh client sequence after ${String(maxReissues)} attempts`
-          );
-        }
-      }
-    });
-    pushChain = run.then(
-      () => void 0,
-      () => void 0
-    );
-    return run;
-  };
-  const bound = {};
-  for (const [name, mutator] of Object.entries(mutators)) {
-    bound[name] = (args) => {
-      const transaction = createTransaction({
-        autoCommit: true,
-        metadata: { serverRef: mutator.serverRef },
-        mutationFn: async () => {
-          let appliedSeq = 0;
-          await runOutboxMutation(async () => {
-            appliedSeq = await pushSerialized(mutator.serverRef, args);
-          });
-          if (context.checkpoints) {
-            await context.checkpoints.awaitMutationId(appliedSeq);
-          }
-        }
-      });
-      transaction.mutate(() => {
-        mutator.apply({ collections: context.collections }, args);
-      });
-      return transaction;
-    };
-  }
-  return bound;
-};
-
-export { bindMutators, defineMutator };

package/dist/packem_shared/createCheckpointRegistry-BtIEm2Kh.mjs

@@ -1,136 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { BTreeIndex } from '@tanstack/db';
-import { toMap, makeDiffEmit } from './OUTBOX_MUTATION_FN_NAME-9fqK7rND.mjs';
-
-const createGate = () => {
-  let highest = Number.NEGATIVE_INFINITY;
-  const waiters = [];
-  return {
-    advance: (value) => {
-      if (value <= highest) {
-        return;
-      }
-      highest = value;
-      for (let index = waiters.length - 1; index >= 0; index -= 1) {
-        const waiter = waiters[index];
-        if (waiter && waiter.threshold <= highest) {
-          waiter.resolve();
-          waiters.splice(index, 1);
-        }
-      }
-    },
-    await: (threshold) => {
-      if (threshold <= highest) {
-        return Promise.resolve();
-      }
-      return new Promise((resolve) => {
-        waiters.push({ resolve, threshold });
-      });
-    }
-  };
-};
-const createCheckpointRegistry = () => {
-  const checkpointGate = createGate();
-  const mutationGate = createGate();
-  return {
-    awaitCheckpoint: (cursor) => checkpointGate.await(cursor),
-    awaitMutationId: (id) => mutationGate.await(id),
-    resolve: ({ checkpoint, mutationId }) => {
-      if (checkpoint !== void 0) {
-        checkpointGate.advance(checkpoint);
-      }
-      if (mutationId !== void 0) {
-        mutationGate.advance(mutationId);
-      }
-    }
-  };
-};
-const lunoraCollectionOptions = (options) => {
-  if (options.list === void 0 === (options.shape === void 0)) {
-    throw new LunoraError("INTERNAL", "lunoraCollectionOptions: pass exactly one of `list` or `shape`");
-  }
-  const getKey = options.getKey ?? ((row) => row._id);
-  const checkpoints = createCheckpointRegistry();
-  const syncedJson = /* @__PURE__ */ new Map();
-  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(options.shardKey) });
-      }
-    };
-    const onError = (error) => onErrorHandler?.(error);
-    const onCheckpoint = (watermark) => {
-      checkpoints.resolve(watermark);
-    };
-    if (options.shape !== void 0) {
-      return options.client.subscribeShape({ args, name: options.shape.name }, onRows, {
-        onCheckpoint,
-        onError,
-        shardKey: options.shape.shardKey
-      });
-    }
-    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
-    // join / filter / sort on, so they stay fast as the dataset grows.
-    autoIndex: "eager",
-    defaultIndexType: BTreeIndex,
-    getKey,
-    id: options.id ?? options.list?.__lunoraRef ?? `shape:${options.shape?.name ?? ""}`,
-    // `"eager"` syncs at creation; omitted otherwise so the wire stays
-    // byte-identical to the lazy default (sync on first subscriber).
-    ...options.load === "eager" ? { startSync: true } : {},
-    sync: {
-      sync: (writer) => {
-        emit = makeDiffEmit(syncedJson, writer);
-        const onError = (error) => {
-          writer.markReady();
-          options.onError?.(error);
-        };
-        onErrorHandler = onError;
-        if (options.scopeBy === void 0) {
-          unsubscribe = openSubscription(options.shape?.args ?? {}, () => {
-            writer.markReady();
-          });
-        } 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();
-        };
-      }
-    }
-  };
-  const scope = (args) => {
-    if (options.scopeBy === void 0) {
-      return;
-    }
-    scopedArgs = args;
-    unsubscribe?.();
-    unsubscribe = void 0;
-    emit?.(/* @__PURE__ */ new Map());
-    if (args === void 0) {
-      return;
-    }
-    if (emit !== void 0) {
-      unsubscribe = openSubscription(args, void 0);
-    }
-  };
-  return { checkpoints, config, scope };
-};
-
-export { createCheckpointRegistry, lunoraCollectionOptions };