@lunora/svelte 1.0.0-alpha.32 → 1.0.0-alpha.34

package/dist/index.d.mts

@@ -307,8 +307,11 @@ interface PresenceHandle<L extends ListPresentReference> {
 * Svelte context (requires calling inside a component's `&lt;script>` block or
 * inside a function called during component initialisation).
 *
-* Call `teardown()` when the component is destroyed to stop heartbeats and
-* remove the visibility listener (`onDestroy(handle.teardown)`).
+* Teardown (stop heartbeats, remove the visibility listener, release the
+* connection context) is wired automatically to the component's `onDestroy`
+* when called during component initialisation. Outside a component call
+* `handle.teardown()` yourself. `teardown()` is idempotent, so an explicit
+* `onDestroy(handle.teardown)` on top of the auto-wiring is safe.
 */
 declare function presence<H extends HeartbeatReference, L extends ListPresentReference>(roomId: string, options: PresenceOptions<H, L>): PresenceHandle<L>;
 declare function presence<H extends HeartbeatReference, L extends ListPresentReference>(client: LunoraClient, roomId: string, options: PresenceOptions<H, L>): PresenceHandle<L>;
@@ -337,12 +340,16 @@ type QueryStore<F extends FunctionReference> = Readable<ReturnOf<F> | undefined>
 * store across several components shares a single underlying subscription
 * (the `LunoraClient` de-dupes by `(fn, args, shardKey)`).
 *
+* Pass `"skip"` as `args` to keep the store connected but the subscription
+* dormant (the value stays `undefined`, no socket opens) — useful for a query
+* gated on auth or a route param, matching React/Vue/Solid's `useQuery`.
+*
 * Pass `client` explicitly, or omit it to resolve the ambient client published
 * by `setLunoraClient` (which must therefore be called during component init,
 * before this runs).
 */
-declare function query<F extends FunctionReference>(function_: F, args: ArgsOf<F>, options?: QueryStoreOptions): QueryStore<F>;
-declare function query<F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: QueryStoreOptions): QueryStore<F>;
+declare function query<F extends FunctionReference>(function_: F, args: ArgsOf<F> | "skip", options?: QueryStoreOptions): QueryStore<F>;
+declare function query<F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F> | "skip", options?: QueryStoreOptions): QueryStore<F>;
 interface RateLimitOptions {
   /** Clock injection for tests. Defaults to `Date.now`. */
   now?: () => number;

package/dist/index.d.ts

@@ -307,8 +307,11 @@ interface PresenceHandle<L extends ListPresentReference> {
 * Svelte context (requires calling inside a component's `&lt;script>` block or
 * inside a function called during component initialisation).
 *
-* Call `teardown()` when the component is destroyed to stop heartbeats and
-* remove the visibility listener (`onDestroy(handle.teardown)`).
+* Teardown (stop heartbeats, remove the visibility listener, release the
+* connection context) is wired automatically to the component's `onDestroy`
+* when called during component initialisation. Outside a component call
+* `handle.teardown()` yourself. `teardown()` is idempotent, so an explicit
+* `onDestroy(handle.teardown)` on top of the auto-wiring is safe.
 */
 declare function presence<H extends HeartbeatReference, L extends ListPresentReference>(roomId: string, options: PresenceOptions<H, L>): PresenceHandle<L>;
 declare function presence<H extends HeartbeatReference, L extends ListPresentReference>(client: LunoraClient, roomId: string, options: PresenceOptions<H, L>): PresenceHandle<L>;
@@ -337,12 +340,16 @@ type QueryStore<F extends FunctionReference> = Readable<ReturnOf<F> | undefined>
 * store across several components shares a single underlying subscription
 * (the `LunoraClient` de-dupes by `(fn, args, shardKey)`).
 *
+* Pass `"skip"` as `args` to keep the store connected but the subscription
+* dormant (the value stays `undefined`, no socket opens) — useful for a query
+* gated on auth or a route param, matching React/Vue/Solid's `useQuery`.
+*
 * Pass `client` explicitly, or omit it to resolve the ambient client published
 * by `setLunoraClient` (which must therefore be called during component init,
 * before this runs).
 */
-declare function query<F extends FunctionReference>(function_: F, args: ArgsOf<F>, options?: QueryStoreOptions): QueryStore<F>;
-declare function query<F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: QueryStoreOptions): QueryStore<F>;
+declare function query<F extends FunctionReference>(function_: F, args: ArgsOf<F> | "skip", options?: QueryStoreOptions): QueryStore<F>;
+declare function query<F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F> | "skip", options?: QueryStoreOptions): QueryStore<F>;
 interface RateLimitOptions {
   /** Clock injection for tests. Defaults to `Date.now`. */
   now?: () => number;

package/dist/index.mjs

@@ -5,8 +5,8 @@ export { flag, flags } from './packem_shared/flag-CqMU07WH.mjs';
 export { hydratePreloaded } from './packem_shared/hydratePreloaded-Djsf_C8Q.mjs';
 export { mutation } from './packem_shared/mutation-BmkCZnTd.mjs';
 export { mutator } from './packem_shared/mutator-B5LchgMS.mjs';
-export { infiniteQuery, paginatedQuery } from './packem_shared/infiniteQuery-BFsBpXnS.mjs';
-export { presence } from './packem_shared/presence-UJKjdcKg.mjs';
-export { query } from './packem_shared/query-BsJHHnAK.mjs';
+export { infiniteQuery, paginatedQuery } from './packem_shared/infiniteQuery-DlnFVv-f.mjs';
+export { presence } from './packem_shared/presence-BvChXqiB.mjs';
+export { query } from './packem_shared/query-B-Gu6KQw.mjs';
 export { rateLimit } from './packem_shared/rateLimit-Cdw1kp8t.mjs';
-export { subscription } from './packem_shared/subscription-C121AbM_.mjs';
+export { subscription } from './packem_shared/subscription-COqqiMPX.mjs';

package/dist/packem_shared/{infiniteQuery-BFsBpXnS.mjs → infiniteQuery-DlnFVv-f.mjs}

@@ -1,5 +1,5 @@
 import { initialPages, derivePaginationStatus, rebalance, applyLoadMore } from '@lunora/client/pagination';
-import { derived, writable, readable } from 'svelte/store';
+import { derived, writable, readable, get } from 'svelte/store';
 import { getLunoraClient } from './getLunoraClient-Prczj1gU.mjs';
 import { i as isFunctionReference } from './is-function-reference-ycLAcI79.mjs';
 
@@ -17,22 +17,37 @@ const createPaginatedEngine = (client, function_, baseArgs, options) => {
   const resultsByKey = /* @__PURE__ */ new Map();
   const activeSubs = /* @__PURE__ */ new Map();
   const pendingPageKeys = /* @__PURE__ */ new Set();
-  let currentPages = initialPages(initialNumItems);
   const currentBaseArgs = baseArgs;
-  pagesStore.subscribe((pages) => {
-    currentPages = pages;
-  });
   const rebuildPageResults = () => {
     if (currentBaseArgs === "skip") {
       pageResultsInternal.set([]);
       return;
     }
-    const updated = currentPages.map((page) => {
+    const updated = get(pagesStore).map((page) => {
       const key = buildPageKey(function_["__lunoraRef"], buildPageArgs(page, currentBaseArgs));
       return resultsByKey.get(key);
     });
     pageResultsInternal.set(updated);
   };
+  const migrateResultsForRebalance = (oldPages, newPages) => {
+    if (currentBaseArgs === "skip") {
+      return;
+    }
+    const keyOf = (page) => buildPageKey(function_["__lunoraRef"], buildPageArgs(page, currentBaseArgs));
+    for (const newPage of newPages) {
+      const newKey = keyOf(newPage);
+      if (resultsByKey.has(newKey)) {
+        continue;
+      }
+      const donor = oldPages.find((op) => op.lower === newPage.lower);
+      if (donor) {
+        const carried = resultsByKey.get(keyOf(donor));
+        if (carried) {
+          resultsByKey.set(newKey, carried);
+        }
+      }
+    }
+  };
   const syncSubscriptions = () => {
     if (currentBaseArgs === "skip") {
       for (const unsub of activeSubs.values()) {
@@ -43,8 +58,9 @@ const createPaginatedEngine = (client, function_, baseArgs, options) => {
       return;
     }
     const baseArgsRecord = currentBaseArgs;
+    const pages = get(pagesStore);
     const wantedKeys = /* @__PURE__ */ new Set();
-    for (const page of currentPages) {
+    for (const page of pages) {
       wantedKeys.add(buildPageKey(function_["__lunoraRef"], buildPageArgs(page, baseArgsRecord)));
     }
     for (const [key, unsub] of activeSubs) {
@@ -52,9 +68,10 @@ const createPaginatedEngine = (client, function_, baseArgs, options) => {
         unsub();
         activeSubs.delete(key);
         pendingPageKeys.delete(key);
+        resultsByKey.delete(key);
       }
     }
-    for (const page of currentPages) {
+    for (const page of pages) {
       const pageArgs = buildPageArgs(page, baseArgsRecord);
       const key = buildPageKey(function_["__lunoraRef"], pageArgs);
       if (activeSubs.has(key)) {
@@ -69,12 +86,10 @@ const createPaginatedEngine = (client, function_, baseArgs, options) => {
           pendingPageKeys.delete(key);
           rebuildPageResults();
           if (pendingPageKeys.size === 0) {
-            let updatedResults = [];
-            pageResultsInternal.subscribe((results) => {
-              updatedResults = results;
-            })();
-            const next = rebalance(currentPages, updatedResults);
+            const latestPages = get(pagesStore);
+            const next = rebalance(latestPages, get(pageResultsInternal));
             if (next) {
+              migrateResultsForRebalance(latestPages, next);
               pagesStore.set(next);
               syncSubscriptions();
               rebuildPageResults();
@@ -115,14 +130,12 @@ const createPaginatedEngine = (client, function_, baseArgs, options) => {
     if (currentBaseArgs === "skip") {
       return;
     }
-    let currentResults = [];
-    pageResultsInternal.subscribe((results) => {
-      currentResults = results;
-    })();
+    const currentResults = get(pageResultsInternal);
     const { nextCursor, status: currentStatus } = derivePaginationStatus(false, currentResults);
     if (currentStatus !== "CanLoadMore") {
       return;
     }
+    const currentPages = get(pagesStore);
     const next = applyLoadMore(currentPages, nextCursor, numberItems);
     if (!next) {
       return;
@@ -136,6 +149,7 @@ const createPaginatedEngine = (client, function_, baseArgs, options) => {
         const carried = resultsByKey.get(oldKey);
         if (carried) {
           resultsByKey.set(newKey, carried);
+          resultsByKey.delete(oldKey);
         }
       }
     }

package/dist/packem_shared/{presence-UJKjdcKg.mjs → presence-BvChXqiB.mjs}

@@ -1,16 +1,24 @@
+import { onDestroy } from 'svelte';
 import { readable } from 'svelte/store';
 import { getLunoraClient } from './getLunoraClient-Prczj1gU.mjs';
 
-const makeSessionId = () => {
-  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
-    return crypto.randomUUID();
+const randomSessionId = (prefix = "sess") => {
+  if (typeof crypto !== "undefined") {
+    if (typeof crypto.randomUUID === "function") {
+      return crypto.randomUUID();
+    }
+    if (typeof crypto.getRandomValues === "function") {
+      const bytes = crypto.getRandomValues(new Uint8Array(16));
+      return `${prefix}-${Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+    }
   }
-  return `sess-${Math.random().toString(36).slice(2)}-${String(Date.now())}`;
+  return `${prefix}-${Date.now().toString(36)}`;
 };
+
 const DEFAULT_INTERVAL_MS = 1e4;
 const createPresenceHandle = (client, roomId, options) => {
   const { heartbeat, intervalMs = DEFAULT_INTERVAL_MS, listPresent, shardKey } = options;
-  const sessionId = options.sessionId ?? makeSessionId();
+  const sessionId = options.sessionId ?? randomSessionId();
   let latestData = options.data;
   const sendHeartbeat = () => {
     const args = {
@@ -46,13 +54,22 @@ const createPresenceHandle = (client, roomId, options) => {
     );
     return unsubscribe;
   });
+  let torndown = false;
   const teardown = () => {
+    if (torndown) {
+      return;
+    }
+    torndown = true;
     clearInterval(intervalHandle);
     if (typeof document !== "undefined") {
       document.removeEventListener("visibilitychange", onVisible);
     }
     releaseConnectionContext();
   };
+  try {
+    onDestroy(teardown);
+  } catch {
+  }
   return { present, sessionId, setData, teardown };
 };
 function presence(clientOrRoomId, roomIdOrOptions, maybeOptions) {

package/dist/packem_shared/{query-BsJHHnAK.mjs → query-B-Gu6KQw.mjs}

@@ -25,7 +25,13 @@ function query(clientOrFunction, functionOrArguments, argumentsOrOptions, maybeO
           onData: (value) => {
             set(value);
           },
-          onError: options.onError
+          onError: options.onError,
+          // `args === "skip"` short-circuits inside the shared helper and
+          // fires this reset — clear any prior value so a store that flips
+          // to `"skip"` does not retain stale data.
+          onReset: () => {
+            set(void 0);
+          }
         },
         { shardKey: options.shardKey }
       )

package/dist/packem_shared/{subscription-C121AbM_.mjs → subscription-COqqiMPX.mjs}

@@ -12,9 +12,6 @@ function subscription(clientOrFunction, functionOrArgs, argsOrOptions, maybeOpti
   const { shardKey, onError } = options;
   const errorStore = writable();
   const data = readable(void 0, (set) => {
-    if (args === "skip") {
-      return () => void 0;
-    }
     const unsubscribe = createQuerySubscription(
       client,
       functionRef,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/svelte",
-  "version": "1.0.0-alpha.32",
+  "version": "1.0.0-alpha.34",
   "description": "Svelte adapter for Lunora — live stores, optimistic mutations, and reactive loaders",
   "keywords": [
     "cloudflare",
@@ -54,10 +54,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.20",
-    "@lunora/errors": "1.0.0-alpha.3",
-    "@lunora/ratelimit": "1.0.0-alpha.6",
-    "@lunora/runtime": "1.0.0-alpha.22"
+    "@lunora/client": "1.0.0-alpha.21",
+    "@lunora/errors": "1.0.0-alpha.4",
+    "@lunora/ratelimit": "1.0.0-alpha.7",
+    "@lunora/runtime": "1.0.0-alpha.24"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"