@lunora/client 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/packem_shared/{OfflineQueue-D5p_QgF_.mjs → offline-queue-B9vfdSqp.mjs}

@@ -1,10 +1,16 @@
+const isStaleVersion = (current, stamped) => current !== void 0 && stamped !== current;
+
 let idCounter = 0;
 const nextId = () => {
   if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
     return crypto.randomUUID();
   }
   idCounter += 1;
-  return `m_${Date.now().toString(36)}_${idCounter.toString(36)}`;
+  const entropy = typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function" ? [...crypto.getRandomValues(new Uint8Array(8))].map((byte) => byte.toString(16).padStart(2, "0")).join("") : (
+    // eslint-disable-next-line sonarjs/pseudo-random -- non-cryptographic uniqueness entropy, not a security token; only reached when neither crypto.randomUUID nor crypto.getRandomValues exists
+    Math.random().toString(16).slice(2, 12)
+  );
+  return `m_${Date.now().toString(36)}_${idCounter.toString(36)}_${entropy}`;
 };
 const reportPersistenceError = (handler, operation, error, mutationId) => {
   if (handler) {
@@ -19,12 +25,19 @@ class OfflineQueue {
   maxItems;
   onPersistenceError;
   persistence;
+  onEvict;
+  onSizeChange;
+  /** App/schema version stamped on persisted writes; mismatched records are purged on hydrate. */
+  version;
   items = [];
-  constructor(options = {}, persistence) {
+  constructor(options = {}, deps = {}) {
     this.maxItems = options.maxItems ?? 1e3;
     this.queueBeforeFirstConnect = options.queueBeforeFirstConnect ?? false;
     this.onPersistenceError = options.onPersistenceError;
-    this.persistence = persistence;
+    this.persistence = deps.persistence;
+    this.onEvict = deps.onEvict;
+    this.onSizeChange = deps.onSizeChange;
+    this.version = deps.version;
   }
   get size() {
     return this.items.length;
@@ -33,7 +46,14 @@ class OfflineQueue {
     const item = entry;
     item.id ??= nextId();
     this.items.push(item);
-    this.persistence?.append({ args: item.args, functionPath: item.functionPath, id: item.id, identity: item.identity, shardKey: item.shardKey }).catch((error) => {
+    this.persistence?.append({
+      args: item.args,
+      functionPath: item.functionPath,
+      id: item.id,
+      identity: item.identity,
+      shardKey: item.shardKey,
+      ...this.version === void 0 ? {} : { version: this.version }
+    }).catch((error) => {
       reportPersistenceError(this.onPersistenceError, "append", error, item.id);
     });
     while (this.items.length > this.maxItems) {
@@ -47,8 +67,10 @@ class OfflineQueue {
         const error = new Error("offline queue overflow");
         error.code = "OFFLINE_QUEUE_OVERFLOW";
         dropped.reject(error);
+        this.onEvict?.(dropped, error);
       }
     }
+    this.notifySize();
   }
   /**
    * Restore mutations persisted in a prior session and re-queue them in FIFO
@@ -62,12 +84,24 @@ class OfflineQueue {
     if (!this.persistence) {
       return [];
     }
-    const persisted = await this.persistence.load();
+    let persisted;
+    try {
+      persisted = await this.persistence.load();
+    } catch (error) {
+      reportPersistenceError(this.onPersistenceError, "load", error);
+      throw error;
+    }
     const shardKeys = /* @__PURE__ */ new Set();
     for (const mutation of persisted) {
       if (this.items.some((item) => item.id === mutation.id)) {
         continue;
       }
+      if (isStaleVersion(this.version, mutation.version)) {
+        this.persistence.remove(mutation.id).catch((error) => {
+          reportPersistenceError(this.onPersistenceError, "remove", error, mutation.id);
+        });
+        continue;
+      }
       this.items.push({
         args: mutation.args,
         functionPath: mutation.functionPath,
@@ -79,6 +113,7 @@ class OfflineQueue {
       });
       shardKeys.add(mutation.shardKey);
     }
+    this.notifySize();
     return [...shardKeys];
   }
   /**
@@ -91,6 +126,7 @@ class OfflineQueue {
     if (!predicate) {
       const drained2 = [...this.items];
       this.items.length = 0;
+      this.notifySize();
       return drained2;
     }
     const drained = [];
@@ -100,6 +136,7 @@ class OfflineQueue {
     }
     this.items.length = 0;
     this.items.push(...kept);
+    this.notifySize();
     return drained;
   }
   /**
@@ -113,6 +150,7 @@ class OfflineQueue {
       return;
     }
     this.items.unshift(...items);
+    this.notifySize();
   }
   clear() {
     for (const item of this.items) {
@@ -121,7 +159,12 @@ class OfflineQueue {
       item.reject(error);
     }
     this.items.length = 0;
+    this.notifySize();
+  }
+  /** Notify the size observer (the client's pending-sync count) after any change. */
+  notifySize() {
+    this.onSizeChange?.(this.items.length);
   }
 }
 
-export { OfflineQueue, nextId, reportPersistenceError };
+export { OfflineQueue as O, isStaleVersion as i, nextId as n, reportPersistenceError as r };

package/dist/packem_shared/{preload.d-BoDmFqSG.d.ts → preload.d-B-vyHnml.d.ts}

@@ -1,4 +1,4 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-DGvyuJ_p.js";
+import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-BYkEjCEJ.js";
 /**
 * Run a query once on the server (during SSR) and capture its result in a
 * serializable {@link Preloaded} token. Embed the token in the rendered HTML and

package/dist/packem_shared/{preload.d-dSaRMuhL.d.mts → preload.d-DrfuisCE.d.mts}

@@ -1,4 +1,4 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-DGvyuJ_p.mjs";
+import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-BYkEjCEJ.mjs";
 /**
 * Run a query once on the server (during SSR) and capture its result in a
 * serializable {@link Preloaded} token. Embed the token in the rendered HTML and

package/dist/packem_shared/subscription-BjynOXCU.mjs

@@ -0,0 +1,68 @@
+const compareKeys = (a, b) => {
+  if (a < b) {
+    return -1;
+  }
+  return a > b ? 1 : 0;
+};
+const stableStringify = (value) => {
+  if (value === void 0) {
+    return "null";
+  }
+  if (typeof value === "bigint") {
+    throw new TypeError("stableStringify: cannot use a bigint in a cache key (query/subscription/shape args) — pass it as a string");
+  }
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && proto !== Object.prototype) {
+    const name = value.constructor?.name ?? "value";
+    throw new TypeError(
+      `stableStringify: cannot use a ${name} in a cache key (query/subscription/shape args) — only plain objects, arrays, and JSON primitives are supported`
+    );
+  }
+  const record = value;
+  const keys = Object.keys(record).toSorted(compareKeys);
+  const parts = [];
+  for (const key of keys) {
+    const raw = record[key];
+    if (raw === void 0) {
+      continue;
+    }
+    parts.push(`${JSON.stringify(key)}:${stableStringify(raw)}`);
+  }
+  return `{${parts.join(",")}}`;
+};
+
+class SubscriptionRegistry {
+  static key(functionPath, args, shardKey) {
+    return `${functionPath}::${stableStringify(args)}::${shardKey ?? ""}`;
+  }
+  byKey = /* @__PURE__ */ new Map();
+  byId = /* @__PURE__ */ new Map();
+  get(key) {
+    return this.byKey.get(key);
+  }
+  getById(id) {
+    return this.byId.get(id);
+  }
+  add(state) {
+    this.byKey.set(SubscriptionRegistry.key(state.fn.__lunoraRef, state.args, state.shardKey), state);
+    this.byId.set(state.id, state);
+  }
+  remove(state) {
+    const key = SubscriptionRegistry.key(state.fn.__lunoraRef, state.args, state.shardKey);
+    if (this.byKey.get(key) === state) {
+      this.byKey.delete(key);
+    }
+    this.byId.delete(state.id);
+  }
+  all() {
+    return [...this.byKey.values()];
+  }
+}
+
+export { SubscriptionRegistry as S, stableStringify as s };

package/dist/query/index.d.mts

@@ -1,5 +1,5 @@
-import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-DGvyuJ_p.mjs";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-DGvyuJ_p.mjs";
+import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-BYkEjCEJ.mjs";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-BYkEjCEJ.mjs";
 import '@lunora/runtime';
 /**
 * The sentinel a framework adapter resolves its reactive args to when it wants

package/dist/query/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-DGvyuJ_p.js";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-DGvyuJ_p.js";
+import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-BYkEjCEJ.js";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-BYkEjCEJ.js";
 import '@lunora/runtime';
 /**
 * The sentinel a framework adapter resolves its reactive args to when it wants

package/dist/ssr/index.d.mts

@@ -1,6 +1,6 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-DGvyuJ_p.mjs";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-DGvyuJ_p.mjs";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-dSaRMuhL.mjs";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-BYkEjCEJ.mjs";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-BYkEjCEJ.mjs";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-DrfuisCE.mjs";
 import '@lunora/runtime';
 /**
 * Structural shape of a better-auth `getSession` call's resolved value.

package/dist/ssr/index.d.ts

@@ -1,6 +1,6 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-DGvyuJ_p.js";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-DGvyuJ_p.js";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-BoDmFqSG.js";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-BYkEjCEJ.js";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-BYkEjCEJ.js";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-B-vyHnml.js";
 import '@lunora/runtime';
 /**
 * Structural shape of a better-auth `getSession` call's resolved value.

package/dist/ssr/index.mjs

@@ -1,4 +1,4 @@
 export { getServerSession } from '../packem_shared/getServerSession-8jXewqxd.mjs';
 export { deserializePreloaded, serializePreloaded } from '../packem_shared/deserializePreloaded-C0eJTY_W.mjs';
-export { createServerClient } from '../packem_shared/createServerClient-BjZc3gD8.mjs';
+export { createServerClient } from '../packem_shared/createServerClient-DF-3mLmb.mjs';
 export { preloadQuery, preloadedQueryResult } from '../packem_shared/preloadQuery-lobFkD2Z.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/client",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.21",
   "description": "Lunora browser SDK: WebSocket transport, optimistic updates, and an offline mutation queue",
   "keywords": [
     "cloudflare",
@@ -25,7 +25,7 @@
     "directory": "packages/client"
   },
   "files": [
-    "dist",
+    "./dist",
     "README.md",
     "LICENSE.md",
     "__assets__"
@@ -61,6 +61,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@lunora/errors": "1.0.0-alpha.4"
+  },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"
   }

package/dist/packem_shared/CONFLICT_ERROR_CODE-aUdVbEDw.mjs

@@ -1,4 +0,0 @@
-const CONFLICT_ERROR_CODE = "CONFLICT";
-const isConflictError = (error) => error instanceof Error && error.code === CONFLICT_ERROR_CODE;
-
-export { CONFLICT_ERROR_CODE, isConflictError };

package/dist/packem_shared/SubscriptionRegistry-B-Qx_Gux.mjs

@@ -1,26 +0,0 @@
-class SubscriptionRegistry {
-  static key(functionPath, args, shardKey) {
-    return `${functionPath}::${JSON.stringify(args)}::${shardKey ?? ""}`;
-  }
-  byKey = /* @__PURE__ */ new Map();
-  byId = /* @__PURE__ */ new Map();
-  get(key) {
-    return this.byKey.get(key);
-  }
-  getById(id) {
-    return this.byId.get(id);
-  }
-  add(state) {
-    this.byKey.set(SubscriptionRegistry.key(state.fn.__lunoraRef, state.args, state.shardKey), state);
-    this.byId.set(state.id, state);
-  }
-  remove(state) {
-    this.byKey.delete(SubscriptionRegistry.key(state.fn.__lunoraRef, state.args, state.shardKey));
-    this.byId.delete(state.id);
-  }
-  all() {
-    return [...this.byKey.values()];
-  }
-}
-
-export { SubscriptionRegistry };

package/dist/packem_shared/createInMemoryPersistence-CW82inU5.mjs

@@ -1,105 +0,0 @@
-const createInMemoryPersistence = () => {
-  const entries = /* @__PURE__ */ new Map();
-  const clone = (mutation) => {
-    return {
-      args: { ...mutation.args },
-      functionPath: mutation.functionPath,
-      id: mutation.id,
-      identity: mutation.identity,
-      shardKey: mutation.shardKey
-    };
-  };
-  return {
-    append: (mutation) => {
-      entries.set(mutation.id, clone(mutation));
-      return Promise.resolve();
-    },
-    clear: () => {
-      entries.clear();
-      return Promise.resolve();
-    },
-    load: () => Promise.resolve([...entries.values()].map((mutation) => clone(mutation))),
-    remove: (id) => {
-      entries.delete(id);
-      return Promise.resolve();
-    }
-  };
-};
-const DEFAULT_DATABASE = "lunora";
-const DEFAULT_STORE = "offline-mutations";
-const ID_INDEX = "by_id";
-const promisifyRequest = (request) => new Promise((resolve, reject) => {
-  request.addEventListener("success", () => {
-    resolve(request.result);
-  });
-  request.addEventListener("error", () => {
-    reject(request.error ?? new Error("IndexedDB request failed"));
-  });
-});
-const createIndexedDbPersistence = (options = {}) => {
-  const factory = options.indexedDB ?? (typeof indexedDB === "undefined" ? void 0 : indexedDB);
-  if (!factory) {
-    throw new Error("createIndexedDbPersistence: no IndexedDB available — pass `indexedDB` or use createInMemoryPersistence()");
-  }
-  const databaseName = options.databaseName ?? DEFAULT_DATABASE;
-  const storeName = options.storeName ?? DEFAULT_STORE;
-  let databasePromise;
-  const openDatabase = () => {
-    if (databasePromise) {
-      return databasePromise;
-    }
-    databasePromise = new Promise((resolve, reject) => {
-      const request = factory.open(databaseName, 1);
-      request.addEventListener("upgradeneeded", () => {
-        const database = request.result;
-        if (!database.objectStoreNames.contains(storeName)) {
-          const store = database.createObjectStore(storeName, { autoIncrement: true });
-          store.createIndex(ID_INDEX, "id", { unique: true });
-        }
-      });
-      request.addEventListener("success", () => {
-        resolve(request.result);
-      });
-      request.addEventListener("error", () => {
-        reject(request.error ?? new Error("IndexedDB open failed"));
-      });
-    });
-    return databasePromise;
-  };
-  const withStore = async (mode, run) => {
-    const database = await openDatabase();
-    const transaction = database.transaction(storeName, mode);
-    const result = await run(transaction.objectStore(storeName));
-    await new Promise((resolve, reject) => {
-      transaction.addEventListener("complete", () => {
-        resolve();
-      });
-      transaction.addEventListener("error", () => {
-        reject(transaction.error ?? new Error("IndexedDB transaction failed"));
-      });
-      transaction.addEventListener("abort", () => {
-        reject(transaction.error ?? new Error("IndexedDB transaction aborted"));
-      });
-    });
-    return result;
-  };
-  return {
-    append: async (mutation) => {
-      await withStore("readwrite", (store) => promisifyRequest(store.add(mutation)));
-    },
-    clear: async () => {
-      await withStore("readwrite", (store) => promisifyRequest(store.clear()));
-    },
-    load: async () => withStore("readonly", (store) => promisifyRequest(store.getAll())),
-    remove: async (id) => {
-      await withStore("readwrite", async (store) => {
-        const key = await promisifyRequest(store.index(ID_INDEX).getKey(id));
-        if (key !== void 0) {
-          await promisifyRequest(store.delete(key));
-        }
-      });
-    }
-  };
-};
-
-export { createInMemoryPersistence, createIndexedDbPersistence };

package/dist/packem_shared/createLocalStore-DSUfoLqY.mjs

@@ -1,36 +0,0 @@
-const createLocalStore = (subscriptions, shardKey, write, stableStringify) => {
-  const rollbacks = [];
-  const findState = (functionRef, argsKey) => {
-    for (const state of subscriptions.all()) {
-      if (state.fn.__lunoraRef === functionRef && state.shardKey === shardKey && state.argsKey === argsKey) {
-        return state;
-      }
-    }
-    return void 0;
-  };
-  const store = {
-    getAllQueries: (function_) => {
-      const matches = [];
-      for (const state of subscriptions.all()) {
-        if (state.fn.__lunoraRef === function_.__lunoraRef && state.shardKey === shardKey) {
-          matches.push({ args: state.args, value: state.lastValue });
-        }
-      }
-      return matches;
-    },
-    getQuery: (function_, args) => {
-      const state = findState(function_.__lunoraRef, stableStringify(args ?? {}));
-      return state?.lastValue;
-    },
-    setQuery: (function_, args, value) => {
-      const state = findState(function_.__lunoraRef, stableStringify(args ?? {}));
-      if (!state) {
-        return;
-      }
-      rollbacks.push(write(state, value));
-    }
-  };
-  return { rollbacks, store };
-};
-
-export { createLocalStore };