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

package/README.md

@@ -104,6 +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. |
 | `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, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
+import { FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, LunoraClient, SubscriptionErrorCallback, User, ConnectionStatus, Preloaded, LiveStreamSubscribeError, SubscribeLiveTopicOptions, 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';
@@ -680,6 +680,29 @@ declare function flags<T extends Record<string, FlagValue>>(client: LunoraClient
 declare const hydratePreloaded: <T>(preloaded: Preloaded<T>, client?: LunoraClient, options?: {
   onError?: SubscriptionErrorCallback;
 }) => Readable<T | undefined>;
+/**
+ * `liveTopic` — follow one live topic on the connection shared by its URL.
+ *
+ * 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 state a `liveTopic` store holds. */
+interface LiveTopicState {
+  /** 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;
+}
+/**
+ * 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.
+ */
+declare const liveTopic: (options: SubscribeLiveTopicOptions | Readable<SubscribeLiveTopicOptions>) => Readable<LiveTopicState>;
 /**
  * The reactive handle returned by {@link mutation} — the Svelte counterpart to
  * React's `useMutation`, re-expressed as stores you read with `$`. The surface
@@ -1239,7 +1262,7 @@ interface VoiceAgentHandle {
  */
 declare function voiceAgent(options: VoiceAgentOptions): VoiceAgentHandle;
 declare function voiceAgent(client: LunoraClient, options: VoiceAgentOptions): VoiceAgentHandle;
-export { type ActionHandle, type AgentApi, type AgentChatApi, type AgentChatHandle, type AgentChatMessage, type AgentChatOptions, type AgentHandle, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentStateApi, type AgentStateHandle, type AgentStateOptions, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsHandle, type AgentToolEventsOptions, type AuthGateStore, type AuthStore, type ConnectionStatusStore, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type MutationHandle, type MutatorHandleStore, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type ReactiveArgs, type ReactivePaginatedArgs, type StreamHandle, type StreamStatus, type StreamStoreOptions, type SubscriptionHandle, type SubscriptionStoreOptions, type VoiceAgentHandle, type VoiceAgentOptions, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, action, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags,
+export { type ActionHandle, type AgentApi, type AgentChatApi, type AgentChatHandle, type AgentChatMessage, type AgentChatOptions, type AgentHandle, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentStateApi, type AgentStateHandle, type AgentStateOptions, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsHandle, type AgentToolEventsOptions, type AuthGateStore, type AuthStore, type ConnectionStatusStore, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type LiveTopicState, type MutationHandle, type MutatorHandleStore, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type ReactiveArgs, type ReactivePaginatedArgs, type StreamHandle, type StreamStatus, type StreamStoreOptions, type SubscriptionHandle, type SubscriptionStoreOptions, type VoiceAgentHandle, type VoiceAgentOptions, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, action, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags,
 /**
  * Svelte adapter for Lunora (`@lunora/svelte`).
  *
@@ -1261,7 +1284,7 @@ export { type ActionHandle, type AgentApi, type AgentChatApi, type AgentChatHand
  * framework-neutral server contract) — import them there in your SvelteKit
  * `+page.ts` / `+layout.ts` load.
  */
-getLunoraClient, hydratePreloaded, infiniteQuery, mutation, mutator, paginatedQuery, presence, query, rateLimit,
+getLunoraClient, hydratePreloaded, infiniteQuery, liveTopic, mutation, mutator, paginatedQuery, presence, query, rateLimit,
 /**
  * Svelte adapter for Lunora (`@lunora/svelte`).
  *

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, LunoraClient, SubscriptionErrorCallback, User, ConnectionStatus, Preloaded, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
+import { FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, LunoraClient, SubscriptionErrorCallback, User, ConnectionStatus, Preloaded, LiveStreamSubscribeError, SubscribeLiveTopicOptions, 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';
@@ -680,6 +680,29 @@ declare function flags<T extends Record<string, FlagValue>>(client: LunoraClient
 declare const hydratePreloaded: <T>(preloaded: Preloaded<T>, client?: LunoraClient, options?: {
   onError?: SubscriptionErrorCallback;
 }) => Readable<T | undefined>;
+/**
+ * `liveTopic` — follow one live topic on the connection shared by its URL.
+ *
+ * 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 state a `liveTopic` store holds. */
+interface LiveTopicState {
+  /** 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;
+}
+/**
+ * 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.
+ */
+declare const liveTopic: (options: SubscribeLiveTopicOptions | Readable<SubscribeLiveTopicOptions>) => Readable<LiveTopicState>;
 /**
  * The reactive handle returned by {@link mutation} — the Svelte counterpart to
  * React's `useMutation`, re-expressed as stores you read with `$`. The surface
@@ -1239,7 +1262,7 @@ interface VoiceAgentHandle {
  */
 declare function voiceAgent(options: VoiceAgentOptions): VoiceAgentHandle;
 declare function voiceAgent(client: LunoraClient, options: VoiceAgentOptions): VoiceAgentHandle;
-export { type ActionHandle, type AgentApi, type AgentChatApi, type AgentChatHandle, type AgentChatMessage, type AgentChatOptions, type AgentHandle, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentStateApi, type AgentStateHandle, type AgentStateOptions, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsHandle, type AgentToolEventsOptions, type AuthGateStore, type AuthStore, type ConnectionStatusStore, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type MutationHandle, type MutatorHandleStore, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type ReactiveArgs, type ReactivePaginatedArgs, type StreamHandle, type StreamStatus, type StreamStoreOptions, type SubscriptionHandle, type SubscriptionStoreOptions, type VoiceAgentHandle, type VoiceAgentOptions, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, action, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags,
+export { type ActionHandle, type AgentApi, type AgentChatApi, type AgentChatHandle, type AgentChatMessage, type AgentChatOptions, type AgentHandle, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentStateApi, type AgentStateHandle, type AgentStateOptions, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsHandle, type AgentToolEventsOptions, type AuthGateStore, type AuthStore, type ConnectionStatusStore, type FlagValue, type HeartbeatReference, type InfiniteQueryHandle, type InfiniteQueryOptions, type ListPresentReference, type LiveTopicState, type MutationHandle, type MutatorHandleStore, type PageItemOf, type PaginatedArgs, type PaginatedQueryHandle, type PaginatedQueryOptions, type PresenceHandle, type PresenceOptions, type QueryStore, type QueryStoreOptions, type RateLimitHandle, type RateLimitOptions, type ReactiveArgs, type ReactivePaginatedArgs, type StreamHandle, type StreamStatus, type StreamStoreOptions, type SubscriptionHandle, type SubscriptionStoreOptions, type VoiceAgentHandle, type VoiceAgentOptions, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, action, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags,
 /**
  * Svelte adapter for Lunora (`@lunora/svelte`).
  *
@@ -1261,7 +1284,7 @@ export { type ActionHandle, type AgentApi, type AgentChatApi, type AgentChatHand
  * framework-neutral server contract) — import them there in your SvelteKit
  * `+page.ts` / `+layout.ts` load.
  */
-getLunoraClient, hydratePreloaded, infiniteQuery, mutation, mutator, paginatedQuery, presence, query, rateLimit,
+getLunoraClient, hydratePreloaded, infiniteQuery, liveTopic, mutation, mutator, paginatedQuery, presence, query, rateLimit,
 /**
  * Svelte adapter for Lunora (`@lunora/svelte`).
  *

package/dist/index.mjs

@@ -1 +1 @@
-import{action as t}from"./packem_shared/action-SjeZUGhX.mjs";import{agent as a}from"./packem_shared/agent-WMVWf1Ks.mjs";import{agentChat as f}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 L,flags as v}from"./packem_shared/flag-Csh9LBiO.mjs";import{hydratePreloaded as S}from"./packem_shared/hydratePreloaded-CNm2-Rha.mjs";import{mutation as q}from"./packem_shared/mutation-DLBr5Op1.mjs";import{mutator as E}from"./packem_shared/mutator-DECDuo94.mjs";import{infiniteQuery as P,paginatedQuery as T}from"./packem_shared/infiniteQuery-B6dobUkL.mjs";import{presence as k}from"./packem_shared/presence-C4ZgfGfr.mjs";import{query as z}from"./packem_shared/query-C6B__ZRN.mjs";import{rateLimit as D}from"./packem_shared/rateLimit-Cli38qWO.mjs";import{stream as H}from"./packem_shared/stream-Cxl8guzh.mjs";import{subscription as J}from"./packem_shared/subscription-BKRHURpA.mjs";import{voiceAgent as M}from"./packem_shared/voiceAgent-KSChAXsW.mjs";export{t as action,a as agent,f as agentChat,n as agentState,i as agentToolEvents,g as auth,s as authGate,l as connectionStatus,L as flag,v as flags,h as getLunoraClient,S as hydratePreloaded,P as infiniteQuery,q as mutation,E as mutator,T as paginatedQuery,k as presence,z as query,D as rateLimit,y as setLunoraClient,H as stream,J as subscription,M 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-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};

package/dist/packem_shared/liveTopic-DiHigDnv.mjs

@@ -0,0 +1 @@
+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};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/svelte",
-  "version": "1.0.0-alpha.266",
+  "version": "1.0.0-alpha.267",
   "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.227",
+    "@lunora/client": "1.0.0-alpha.228",
     "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
-    "@lunora/ratelimit": "1.0.0-alpha.150",
+    "@lunora/ratelimit": "1.0.0-alpha.151",
     "@lunora/wire": "1.0.0-alpha.1",
     "@visulima/storage-client": "1.0.9"
   },