@lunora/svelte 1.0.0-alpha.267 → 1.0.0-alpha.269

package/README.md

@@ -104,7 +104,7 @@ All functions that require a component lifecycle (presence, rate-limit) return a
 | `query`            | `useQuery`            | Live readable store — updates on every server delta.                                   |
 | `mutation`         | `useMutation`         | Optimistic mutation handle (`data`, `error`, `pending`, `mutate`, `reset` stores).     |
 | `subscription`     | `useSubscription`     | Raw subscription readable — unbounded live stream.                                     |
-| `liveTopic`        | `useLiveTopic`        | One live topic on the shared stream — readable of `{ lastEvent, error }`, no teardown. |
+| `liveTopic`        | `useLiveTopic`        | One declared live topic — readable of `{ lastEvent, error }`, no teardown.             |
 | `paginatedQuery`   | `usePaginatedQuery`   | Cursor-paginated query with `loadMore`, `status`, `results`, and `error` stores.       |
 | `infiniteQuery`    | `useInfiniteQuery`    | Infinite-scroll variant of `paginatedQuery`.                                           |
 | `auth`             | `useAuth`             | Reactive auth stores (`user`, `token`, `status`) plus `setToken`.                      |

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, LunoraClient, SubscriptionErrorCallback, User, ConnectionStatus, Preloaded, LiveStreamSubscribeError, SubscribeLiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
+import { FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, LunoraClient, SubscriptionErrorCallback, User, ConnectionStatus, Preloaded, LiveStreamSubscribeError, LiveTopicRef, LiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
 export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, MutationCallOptions, MutatorHandle, MutatorTransaction, Preloaded, ReturnOf } from '@lunora/client';
 import { Readable } from 'svelte/store';
 import { AuthStatus } from '@lunora/client/auth';
@@ -681,28 +681,33 @@ declare const hydratePreloaded: <T>(preloaded: Preloaded<T>, client?: LunoraClie
   onError?: SubscriptionErrorCallback;
 }) => Readable<T | undefined>;
 /**
- * `liveTopic` — follow one live topic on the connection shared by its URL.
+ * `liveTopic` — follow one live topic on the connection shared by its stream's route.
  *
  * A thin lifecycle wrapper over `subscribeLiveTopic` from `@lunora/client`. The
  * subscription opens when the store gets its first subscriber and closes when it
  * loses its last one, so there is no `teardown()` to call. Like the other stores
  * here, a server render subscribes and opens nothing.
+ *
+ * The `LunoraClient` is read from context when `liveTopic` is CALLED, so call it while a
+ * component initialises: `getContext` throws outside that window.
  */
 /** The state a `liveTopic` store holds. */
-interface LiveTopicState {
+interface LiveTopicState<Payload = unknown> {
   /** The shard's refusal of this subscription (403, 409, 429 and similar), or `undefined`. */
   error: LiveStreamSubscribeError | undefined;
   /** The last payload delivered on the topic, or `undefined` until the first event. */
-  lastEvent: unknown;
+  lastEvent: Payload | undefined;
 }
 /**
- * Follow `options.topic` on the shared live connection for `options.url`.
- *
- * `options` may also be a `Readable` store. A new emission resubscribes only when
- * its url, topic or connection options change; a new `onEvent` / `onError` is
- * picked up on the next call without reopening the subscription.
+ * Follow the topic `topic` names on the shared live connection for its stream's route. Pass the
+ * reference `_generated/live.ts` hands out (`live.posts.post({ postId })`), or a `Readable` of one.
+ * `options` may be a `Readable` too, e.g. to move to a new `sessionKey` on sign-out. A new emission
+ * resubscribes only when the topic or the connection options (including `sessionKey`) change;
+ * `onEvent` and `onError` are read at call time, so a new identity never reopens the subscription.
+ * The route is resolved against the `LunoraClient` from context, and `lastEvent` and `onEvent` are
+ * typed by the payload the topic declares.
  */
-declare const liveTopic: (options: SubscribeLiveTopicOptions | Readable<SubscribeLiveTopicOptions>) => Readable<LiveTopicState>;
+declare const liveTopic: <Payload>(topic: LiveTopicRef<Payload> | Readable<LiveTopicRef<Payload>>, options?: LiveTopicOptions<Payload> | Readable<LiveTopicOptions<Payload>>) => Readable<LiveTopicState<Payload>>;
 /**
  * The reactive handle returned by {@link mutation} — the Svelte counterpart to
  * React's `useMutation`, re-expressed as stores you read with `$`. The surface

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, LunoraClient, SubscriptionErrorCallback, User, ConnectionStatus, Preloaded, LiveStreamSubscribeError, SubscribeLiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
+import { FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, LunoraClient, SubscriptionErrorCallback, User, ConnectionStatus, Preloaded, LiveStreamSubscribeError, LiveTopicRef, LiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
 export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, MutationCallOptions, MutatorHandle, MutatorTransaction, Preloaded, ReturnOf } from '@lunora/client';
 import { Readable } from 'svelte/store';
 import { AuthStatus } from '@lunora/client/auth';
@@ -681,28 +681,33 @@ declare const hydratePreloaded: <T>(preloaded: Preloaded<T>, client?: LunoraClie
   onError?: SubscriptionErrorCallback;
 }) => Readable<T | undefined>;
 /**
- * `liveTopic` — follow one live topic on the connection shared by its URL.
+ * `liveTopic` — follow one live topic on the connection shared by its stream's route.
  *
  * A thin lifecycle wrapper over `subscribeLiveTopic` from `@lunora/client`. The
  * subscription opens when the store gets its first subscriber and closes when it
  * loses its last one, so there is no `teardown()` to call. Like the other stores
  * here, a server render subscribes and opens nothing.
+ *
+ * The `LunoraClient` is read from context when `liveTopic` is CALLED, so call it while a
+ * component initialises: `getContext` throws outside that window.
  */
 /** The state a `liveTopic` store holds. */
-interface LiveTopicState {
+interface LiveTopicState<Payload = unknown> {
   /** The shard's refusal of this subscription (403, 409, 429 and similar), or `undefined`. */
   error: LiveStreamSubscribeError | undefined;
   /** The last payload delivered on the topic, or `undefined` until the first event. */
-  lastEvent: unknown;
+  lastEvent: Payload | undefined;
 }
 /**
- * Follow `options.topic` on the shared live connection for `options.url`.
- *
- * `options` may also be a `Readable` store. A new emission resubscribes only when
- * its url, topic or connection options change; a new `onEvent` / `onError` is
- * picked up on the next call without reopening the subscription.
+ * Follow the topic `topic` names on the shared live connection for its stream's route. Pass the
+ * reference `_generated/live.ts` hands out (`live.posts.post({ postId })`), or a `Readable` of one.
+ * `options` may be a `Readable` too, e.g. to move to a new `sessionKey` on sign-out. A new emission
+ * resubscribes only when the topic or the connection options (including `sessionKey`) change;
+ * `onEvent` and `onError` are read at call time, so a new identity never reopens the subscription.
+ * The route is resolved against the `LunoraClient` from context, and `lastEvent` and `onEvent` are
+ * typed by the payload the topic declares.
  */
-declare const liveTopic: (options: SubscribeLiveTopicOptions | Readable<SubscribeLiveTopicOptions>) => Readable<LiveTopicState>;
+declare const liveTopic: <Payload>(topic: LiveTopicRef<Payload> | Readable<LiveTopicRef<Payload>>, options?: LiveTopicOptions<Payload> | Readable<LiveTopicOptions<Payload>>) => Readable<LiveTopicState<Payload>>;
 /**
  * The reactive handle returned by {@link mutation} — the Svelte counterpart to
  * React's `useMutation`, re-expressed as stores you read with `$`. The surface

package/dist/index.mjs

@@ -1 +1 @@
-import{action as t}from"./packem_shared/action-SjeZUGhX.mjs";import{agent as m}from"./packem_shared/agent-WMVWf1Ks.mjs";import{agentChat as a}from"./packem_shared/agentChat-CX6dTMoY.mjs";import{agentState as n}from"./packem_shared/agentState-DQC-OIi6.mjs";import{agentToolEvents as i}from"./packem_shared/agentToolEvents-BD98xaGH.mjs";import{auth as g,authGate as s}from"./packem_shared/auth-Z0G_aZYz.mjs";import{connectionStatus as l}from"./packem_shared/connectionStatus-DMx3BE5Q.mjs";import{getLunoraClient as h,setLunoraClient as y}from"./packem_shared/getLunoraClient-DU7BmZy1.mjs";import{flag as C,flags as L}from"./packem_shared/flag-Csh9LBiO.mjs";import{hydratePreloaded as S}from"./packem_shared/hydratePreloaded-CNm2-Rha.mjs";import{liveTopic as b}from"./packem_shared/liveTopic-DiHigDnv.mjs";import{mutation as A}from"./packem_shared/mutation-DLBr5Op1.mjs";import{mutator as G}from"./packem_shared/mutator-DECDuo94.mjs";import{infiniteQuery as j,paginatedQuery as k}from"./packem_shared/infiniteQuery-B6dobUkL.mjs";import{presence as z}from"./packem_shared/presence-C4ZgfGfr.mjs";import{query as D}from"./packem_shared/query-C6B__ZRN.mjs";import{rateLimit as H}from"./packem_shared/rateLimit-Cli38qWO.mjs";import{stream as J}from"./packem_shared/stream-Cxl8guzh.mjs";import{subscription as M}from"./packem_shared/subscription-BKRHURpA.mjs";import{voiceAgent as O}from"./packem_shared/voiceAgent-KSChAXsW.mjs";export{t as action,m as agent,a as agentChat,n as agentState,i as agentToolEvents,g as auth,s as authGate,l as connectionStatus,C as flag,L as flags,h as getLunoraClient,S as hydratePreloaded,j as infiniteQuery,b as liveTopic,A as mutation,G as mutator,k as paginatedQuery,z as presence,D as query,H as rateLimit,y as setLunoraClient,J as stream,M as subscription,O as voiceAgent};
+import{action as t}from"./packem_shared/action-SjeZUGhX.mjs";import{agent as m}from"./packem_shared/agent-WMVWf1Ks.mjs";import{agentChat as a}from"./packem_shared/agentChat-CX6dTMoY.mjs";import{agentState as n}from"./packem_shared/agentState-DQC-OIi6.mjs";import{agentToolEvents as i}from"./packem_shared/agentToolEvents-BD98xaGH.mjs";import{auth as g,authGate as s}from"./packem_shared/auth-Z0G_aZYz.mjs";import{connectionStatus as l}from"./packem_shared/connectionStatus-DMx3BE5Q.mjs";import{getLunoraClient as h,setLunoraClient as y}from"./packem_shared/getLunoraClient-DU7BmZy1.mjs";import{flag as C,flags as L}from"./packem_shared/flag-Csh9LBiO.mjs";import{hydratePreloaded as S}from"./packem_shared/hydratePreloaded-CNm2-Rha.mjs";import{liveTopic as b}from"./packem_shared/liveTopic-DKHSwXiX.mjs";import{mutation as A}from"./packem_shared/mutation-DLBr5Op1.mjs";import{mutator as G}from"./packem_shared/mutator-DECDuo94.mjs";import{infiniteQuery as j,paginatedQuery as k}from"./packem_shared/infiniteQuery-B6dobUkL.mjs";import{presence as z}from"./packem_shared/presence-C4ZgfGfr.mjs";import{query as D}from"./packem_shared/query-C6B__ZRN.mjs";import{rateLimit as H}from"./packem_shared/rateLimit-Cli38qWO.mjs";import{stream as J}from"./packem_shared/stream-Cxl8guzh.mjs";import{subscription as M}from"./packem_shared/subscription-BKRHURpA.mjs";import{voiceAgent as O}from"./packem_shared/voiceAgent-KSChAXsW.mjs";export{t as action,m as agent,a as agentChat,n as agentState,i as agentToolEvents,g as auth,s as authGate,l as connectionStatus,C as flag,L as flags,h as getLunoraClient,S as hydratePreloaded,j as infiniteQuery,b as liveTopic,A as mutation,G as mutator,k as paginatedQuery,z as presence,D as query,H as rateLimit,y as setLunoraClient,J as stream,M as subscription,O as voiceAgent};

package/dist/packem_shared/liveTopic-DKHSwXiX.mjs

@@ -0,0 +1 @@
+import{liveTopicSubscription as p,subscribeLiveTopic as y}from"@lunora/client";import{readable as c,derived as f}from"svelte/store";import{i as E}from"./is-browser-BEdfLJHK.mjs";import{getLunoraClient as h}from"./getLunoraClient-DU7BmZy1.mjs";import{i as l,s as D}from"./subscribe-reactive-args-D0fSbP1k.mjs";const S=r=>({headers:r.headers,maxDelayMs:r.maxDelayMs,retryDelay:r.retryDelay,sessionKey:r.sessionKey,topic:r.topic,url:r.url,withCredentials:r.withCredentials}),g=(r,i={})=>{const v=h();return c({error:void 0,lastEvent:void 0},s=>{if(!E())return;const u=l(r)?r:c(r),a=l(i)?i:c(i);let n={};const d=a.subscribe(t=>{n=t}),m=t=>{let e;return s({error:void 0,lastEvent:e}),y({...t,onError:o=>{s({error:o,lastEvent:e}),n.onError?.(o)},onEvent:o=>{e=o,s({error:void 0,lastEvent:e}),n.onEvent?.(o)}})},b=D(f([u,a],([t,e])=>S(p(v,t,e))),m);return()=>{b(),d()}})};export{g as liveTopic};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/svelte",
-  "version": "1.0.0-alpha.267",
+  "version": "1.0.0-alpha.269",
   "description": "Svelte adapter for Lunora — live stores, optimistic mutations, and reactive loaders",
   "keywords": [
     "cloudflare",
@@ -54,9 +54,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.228",
+    "@lunora/client": "1.0.0-alpha.230",
     "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
-    "@lunora/ratelimit": "1.0.0-alpha.151",
+    "@lunora/ratelimit": "1.0.0-alpha.153",
     "@lunora/wire": "1.0.0-alpha.1",
     "@visulima/storage-client": "1.0.9"
   },

package/dist/packem_shared/liveTopic-DiHigDnv.mjs

@@ -1 +0,0 @@
-import{subscribeLiveTopic as d}from"@lunora/client";import{readable as c,derived as m}from"svelte/store";import{i as u}from"./is-browser-BEdfLJHK.mjs";import{i as b,s as y}from"./subscribe-reactive-args-D0fSbP1k.mjs";const E=r=>({headers:r.headers,maxDelayMs:r.maxDelayMs,retryDelay:r.retryDelay,sessionKey:r.sessionKey,topic:r.topic,url:r.url,withCredentials:r.withCredentials}),w=r=>c({error:void 0,lastEvent:void 0},o=>{if(!u())return;const a=b(r)?r:c(r);let s;const n=a.subscribe(i=>{s=i}),l=i=>{let t;return o({error:void 0,lastEvent:t}),d({...i,onError:e=>{o({error:e,lastEvent:t}),s?.onError?.(e)},onEvent:e=>{t=e,o({error:void 0,lastEvent:t}),s?.onEvent?.(e)}})},v=y(m(a,E),l);return()=>{v(),n()}});export{w as liveTopic};