@lunora/client 1.0.0-alpha.1 → 1.0.0-alpha.10

package/dist/packem_shared/{OfflineQueue-D5p_QgF_.mjs → offline-queue-7Wc4onA0.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
@@ -68,6 +90,12 @@ class OfflineQueue {
       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 +107,7 @@ class OfflineQueue {
       });
       shardKeys.add(mutation.shardKey);
     }
+    this.notifySize();
     return [...shardKeys];
   }
   /**
@@ -91,6 +120,7 @@ class OfflineQueue {
     if (!predicate) {
       const drained2 = [...this.items];
       this.items.length = 0;
+      this.notifySize();
       return drained2;
     }
     const drained = [];
@@ -100,6 +130,7 @@ class OfflineQueue {
     }
     this.items.length = 0;
     this.items.push(...kept);
+    this.notifySize();
     return drained;
   }
   /**
@@ -113,6 +144,7 @@ class OfflineQueue {
       return;
     }
     this.items.unshift(...items);
+    this.notifySize();
   }
   clear() {
     for (const item of this.items) {
@@ -121,7 +153,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-dSaRMuhL.d.mts → preload.d-3XJD-2hM.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-B5vWSgvD.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/{preload.d-BoDmFqSG.d.ts → preload.d-CKZR675M.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-B5vWSgvD.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/subscription-C1Jy7HiF.mjs

@@ -0,0 +1,55 @@
+const compareKeys = (a, b) => {
+  if (a < b) {
+    return -1;
+  }
+  return a > b ? 1 : 0;
+};
+const stableStringify = (value) => {
+  if (value === void 0) {
+    return "null";
+  }
+  if (value === null || typeof value !== "object") {
+    return JSON.stringify(value);
+  }
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  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) {
+    this.byKey.delete(SubscriptionRegistry.key(state.fn.__lunoraRef, state.args, state.shardKey));
+    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-B5vWSgvD.mjs";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-B5vWSgvD.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-B5vWSgvD.js";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-B5vWSgvD.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-B5vWSgvD.mjs";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-B5vWSgvD.mjs";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-3XJD-2hM.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-B5vWSgvD.js";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-B5vWSgvD.js";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-CKZR675M.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/serializePreloaded-C0eJTY_W.mjs';
-export { createServerClient } from '../packem_shared/createServerClient-DyFIHnWZ.mjs';
+export { deserializePreloaded, serializePreloaded } from '../packem_shared/deserializePreloaded-C0eJTY_W.mjs';
+export { createServerClient } from '../packem_shared/createServerClient-BxkNcRlR.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.1",
+  "version": "1.0.0-alpha.10",
   "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__"

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/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 };