@lunora/vue 1.0.0-alpha.267 → 1.0.0-alpha.268

package/README.md

@@ -85,6 +85,7 @@ const { mutate, pending } = useMutation(api.messages.send);
 | `useInfiniteQuery`    | `useInfiniteQuery`    | Infinite-scroll variant of `usePaginatedQuery`.                                   |
 | `useAuth`             | `useAuth`             | Reactive auth: readonly `token`/`user`/`status` refs plus `setToken`.             |
 | `usePresence`         | `usePresence`         | Collaborative-awareness — heartbeat + live present-members `ShallowRef`.          |
+| `useLiveTopic`        | `useLiveTopic`        | Follow one `defineLiveStream` topic as `lastEvent` / `error` refs.                |
 | `useFlag`             | `useFlag`             | Live OpenFeature flag as a readonly `Ref` — holds `default` until resolved.       |
 | `useFlags`            | `useFlags`            | Batch variant — a readonly `Ref` of one value per key in the defaults map.        |
 | `useRateLimit`        | `useRateLimit`        | Client-side rate-limit mirror — `ok`, `disabled`, `retryAfter` as ComputedRefs.   |
@@ -93,6 +94,8 @@ const { mutate, pending } = useMutation(api.messages.send);
 | `useAgentToolEvents`  | `useAgentToolEvents`  | One agent thread's tool lifecycle as a `ComputedRef` of discriminated events.     |
 | `useVoiceAgent`       | `useVoiceAgent`       | Full-duplex voice call — refs for status/transcript/level, `startCall`/`endCall`. |
 
+`useLiveTopic(options)` takes the `subscribeLiveTopic` options. Each connection field may be a plain value, a ref, or a getter, so a reactive `topic` resubscribes when it changes. `onEvent` and `onError` are plain functions and never trigger a resubscribe. The SSE connection is shared by `url`, and it opens nothing during SSR.
+
 `useVoiceAgent` opens nothing until `startCall()` — that call is what requests the microphone, so it must run from a user gesture. `endCall()` releases the socket, the mic tracks and the Web Audio graph, and `onScopeDispose` runs it for you on unmount.
 
 ## Related

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Component, Ref, InjectionKey, App, MaybeRefOrGetter, ComputedRef, DeepReadonly, ShallowRef } from 'vue';
-import { Preloaded, SubscriptionErrorCallback, LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, User, ConnectionStatus, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
+import { Preloaded, SubscriptionErrorCallback, LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, User, ConnectionStatus, SubscribeLiveTopicOptions, LiveStreamSubscribeError, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
 export type { ArgsOf, FunctionReference, LunoraClient, MutationCallOptions, MutatorHandle, MutatorTransaction, OptimisticLocalStore, OptimisticUpdate, Preloaded, ReturnOf, SubscriptionError, SubscriptionErrorCallback, Unsubscribe, User } from '@lunora/client';
 import { AuthStatus } from '@lunora/client/auth';
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -654,6 +654,33 @@ declare const useFlag: <T extends FlagValue>(key: MaybeRefOrGetter<string>, defa
  * composable's lifetime, so nothing here is reactive.
  */
 declare const useFlags: <T extends Record<string, FlagValue>>(flags: T) => Readonly<Ref<T>>;
+/** The connection-level fields: every `subscribeLiveTopic` option except the two callbacks. */
+type ConnectionFields = Omit<SubscribeLiveTopicOptions, "onError" | "onEvent">;
+/**
+ * Options for {@link useLiveTopic}. Each connection field may be a plain value, a
+ * `ref`, or a getter, so a reactive `topic` or `url` re-subscribes. The callbacks
+ * are plain functions: a getter would be called by `toValue`, so they are never wrapped.
+ */
+type UseLiveTopicOptions = Pick<SubscribeLiveTopicOptions, "onError" | "onEvent"> & { [K in keyof ConnectionFields]: MaybeRefOrGetter<ConnectionFields[K]>; };
+interface UseLiveTopicResult {
+  /** Set when the shard refuses the subscription (403, 409, 429 and similar). */
+  error: ShallowRef<LiveStreamSubscribeError | undefined>;
+  /** The last payload delivered on the topic, or `undefined` until the first event. */
+  lastEvent: ShallowRef<unknown>;
+}
+/**
+ * `useLiveTopic` — follow one live topic of a `defineLiveStream` for the life of
+ * the calling component's effect scope.
+ *
+ * A lifecycle wrapper over `subscribeLiveTopic`: the connection is shared by URL,
+ * so several composables on one page still open one stream. It subscribes on
+ * setup, unsubscribes when the scope disposes, and resubscribes when a reactive
+ * connection field changes. Callbacks are read at call time, so they never
+ * resubscribe.
+ *
+ * Client-only: nothing opens during SSR, and the refs stay at their initial values there.
+ */
+declare const useLiveTopic: (options: UseLiveTopicOptions) => UseLiveTopicResult;
 /**
  * The reactive handle returned by {@link useMutation} — the Vue counterpart to
  * React's `useMutation`, re-expressed with refs. The surface is identical across
@@ -1181,7 +1208,7 @@ export { type ActionHandle, type AgentChatMessage, type AgentLiveEvent, type Age
  * composition (Lunora mounted inside Nitro) is `@lunora/nuxt`, not this
  * package — see [Bring your framework](/docs/frameworks/bring-your-framework).
  */
-LUNORA_INJECTION_KEY, type ListPresentReference, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus,
+LUNORA_INJECTION_KEY, type ListPresentReference, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseLiveTopicOptions, type UseLiveTopicResult, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus,
 /**
  * `@lunora/vue` — the Vue adapter for Lunora.
  *
@@ -1219,7 +1246,7 @@ createLunora, hydratePreloaded,
  * composition (Lunora mounted inside Nitro) is `@lunora/nuxt`, not this
  * package — see [Bring your framework](/docs/frameworks/bring-your-framework).
  */
-provideLunora, subscribeToQuery, useAction, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useConnectionStatus, useFlag, useFlags, useInfiniteQuery,
+provideLunora, subscribeToQuery, useAction, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLiveTopic,
 /**
  * `@lunora/vue` — the Vue adapter for Lunora.
  *

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Component, Ref, InjectionKey, App, MaybeRefOrGetter, ComputedRef, DeepReadonly, ShallowRef } from 'vue';
-import { Preloaded, SubscriptionErrorCallback, LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, User, ConnectionStatus, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
+import { Preloaded, SubscriptionErrorCallback, LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, User, ConnectionStatus, SubscribeLiveTopicOptions, LiveStreamSubscribeError, MutationCallOptions, MutatorHandle, SubscriptionError } from '@lunora/client';
 export type { ArgsOf, FunctionReference, LunoraClient, MutationCallOptions, MutatorHandle, MutatorTransaction, OptimisticLocalStore, OptimisticUpdate, Preloaded, ReturnOf, SubscriptionError, SubscriptionErrorCallback, Unsubscribe, User } from '@lunora/client';
 import { AuthStatus } from '@lunora/client/auth';
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -654,6 +654,33 @@ declare const useFlag: <T extends FlagValue>(key: MaybeRefOrGetter<string>, defa
  * composable's lifetime, so nothing here is reactive.
  */
 declare const useFlags: <T extends Record<string, FlagValue>>(flags: T) => Readonly<Ref<T>>;
+/** The connection-level fields: every `subscribeLiveTopic` option except the two callbacks. */
+type ConnectionFields = Omit<SubscribeLiveTopicOptions, "onError" | "onEvent">;
+/**
+ * Options for {@link useLiveTopic}. Each connection field may be a plain value, a
+ * `ref`, or a getter, so a reactive `topic` or `url` re-subscribes. The callbacks
+ * are plain functions: a getter would be called by `toValue`, so they are never wrapped.
+ */
+type UseLiveTopicOptions = Pick<SubscribeLiveTopicOptions, "onError" | "onEvent"> & { [K in keyof ConnectionFields]: MaybeRefOrGetter<ConnectionFields[K]>; };
+interface UseLiveTopicResult {
+  /** Set when the shard refuses the subscription (403, 409, 429 and similar). */
+  error: ShallowRef<LiveStreamSubscribeError | undefined>;
+  /** The last payload delivered on the topic, or `undefined` until the first event. */
+  lastEvent: ShallowRef<unknown>;
+}
+/**
+ * `useLiveTopic` — follow one live topic of a `defineLiveStream` for the life of
+ * the calling component's effect scope.
+ *
+ * A lifecycle wrapper over `subscribeLiveTopic`: the connection is shared by URL,
+ * so several composables on one page still open one stream. It subscribes on
+ * setup, unsubscribes when the scope disposes, and resubscribes when a reactive
+ * connection field changes. Callbacks are read at call time, so they never
+ * resubscribe.
+ *
+ * Client-only: nothing opens during SSR, and the refs stay at their initial values there.
+ */
+declare const useLiveTopic: (options: UseLiveTopicOptions) => UseLiveTopicResult;
 /**
  * The reactive handle returned by {@link useMutation} — the Vue counterpart to
  * React's `useMutation`, re-expressed with refs. The surface is identical across
@@ -1181,7 +1208,7 @@ export { type ActionHandle, type AgentChatMessage, type AgentLiveEvent, type Age
  * composition (Lunora mounted inside Nitro) is `@lunora/nuxt`, not this
  * package — see [Bring your framework](/docs/frameworks/bring-your-framework).
  */
-LUNORA_INJECTION_KEY, type ListPresentReference, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus,
+LUNORA_INJECTION_KEY, type ListPresentReference, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseLiveTopicOptions, type UseLiveTopicResult, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus,
 /**
  * `@lunora/vue` — the Vue adapter for Lunora.
  *
@@ -1219,7 +1246,7 @@ createLunora, hydratePreloaded,
  * composition (Lunora mounted inside Nitro) is `@lunora/nuxt`, not this
  * package — see [Bring your framework](/docs/frameworks/bring-your-framework).
  */
-provideLunora, subscribeToQuery, useAction, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useConnectionStatus, useFlag, useFlags, useInfiniteQuery,
+provideLunora, subscribeToQuery, useAction, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLiveTopic,
 /**
  * `@lunora/vue` — the Vue adapter for Lunora.
  *

package/dist/index.mjs

@@ -1 +1 @@
-import{AuthLoading as r,Authenticated as t,Unauthenticated as u}from"./packem_shared/AuthLoading-ZXVgXos1.mjs";import{hydratePreloaded as a}from"./packem_shared/hydratePreloaded-DicHNxhB.mjs";import{LUNORA_INJECTION_KEY as f,createLunora as m,provideLunora as p,useLunora as x}from"./packem_shared/LUNORA_INJECTION_KEY-Bct9tKCj.mjs";import{useAction as A}from"./packem_shared/useAction-C4VLsh4M.mjs";import{useAgent as d}from"./packem_shared/useAgent-CH-s5x_8.mjs";import{useAgentChat as h}from"./packem_shared/useAgentChat-EOyd090T.mjs";import{useAgentState as l}from"./packem_shared/useAgentState-DYGMiZea.mjs";import{useAgentToolEvents as Q}from"./packem_shared/useAgentToolEvents-CXaLK5pE.mjs";import{useAuth as b}from"./packem_shared/useAuth-QDllAwZL.mjs";import{default as E}from"./packem_shared/useConnectionStatus-CCUbKnj2.mjs";import{useFlag as N,useFlags as P}from"./packem_shared/useFlag-xVfWC_c6.mjs";import{useMutation as v}from"./packem_shared/useMutation-D6PkaNaE.mjs";import{useMutator as M}from"./packem_shared/useMutator-CO7nXlRf.mjs";import{useInfiniteQuery as R,usePaginatedQuery as U}from"./packem_shared/useInfiniteQuery-Clqt_MYU.mjs";import{usePresence as J}from"./packem_shared/usePresence-Dpnb4kjv.mjs";import{subscribeToQuery as V,useQuery as Y}from"./packem_shared/subscribeToQuery-BvnA8ErG.mjs";import{useRateLimit as k}from"./packem_shared/useRateLimit-zoPsflSG.mjs";import{useStream as w}from"./packem_shared/useStream-COVzNdKq.mjs";import{useSubscription as B}from"./packem_shared/useSubscription-BMJ1kYm8.mjs";import{useVoiceAgent as G}from"./packem_shared/useVoiceAgent-BEGHhbmX.mjs";export{r as AuthLoading,t as Authenticated,f as LUNORA_INJECTION_KEY,u as Unauthenticated,m as createLunora,a as hydratePreloaded,p as provideLunora,V as subscribeToQuery,A as useAction,d as useAgent,h as useAgentChat,l as useAgentState,Q as useAgentToolEvents,b as useAuth,E as useConnectionStatus,N as useFlag,P as useFlags,R as useInfiniteQuery,x as useLunora,v as useMutation,M as useMutator,U as usePaginatedQuery,J as usePresence,Y as useQuery,k as useRateLimit,w as useStream,B as useSubscription,G as useVoiceAgent};
+import{AuthLoading as r,Authenticated as t,Unauthenticated as u}from"./packem_shared/AuthLoading-ZXVgXos1.mjs";import{hydratePreloaded as p}from"./packem_shared/hydratePreloaded-DicHNxhB.mjs";import{LUNORA_INJECTION_KEY as f,createLunora as m,provideLunora as n,useLunora as x}from"./packem_shared/LUNORA_INJECTION_KEY-Bct9tKCj.mjs";import{useAction as c}from"./packem_shared/useAction-C4VLsh4M.mjs";import{useAgent as d}from"./packem_shared/useAgent-CH-s5x_8.mjs";import{useAgentChat as L}from"./packem_shared/useAgentChat-EOyd090T.mjs";import{useAgentState as l}from"./packem_shared/useAgentState-DYGMiZea.mjs";import{useAgentToolEvents as Q}from"./packem_shared/useAgentToolEvents-CXaLK5pE.mjs";import{useAuth as T}from"./packem_shared/useAuth-QDllAwZL.mjs";import{default as v}from"./packem_shared/useConnectionStatus-CCUbKnj2.mjs";import{useFlag as E,useFlags as I}from"./packem_shared/useFlag-xVfWC_c6.mjs";import{useLiveTopic as P}from"./packem_shared/useLiveTopic-Bcz34mfU.mjs";import{useMutation as M}from"./packem_shared/useMutation-D6PkaNaE.mjs";import{useMutator as R}from"./packem_shared/useMutator-CO7nXlRf.mjs";import{useInfiniteQuery as _,usePaginatedQuery as J}from"./packem_shared/useInfiniteQuery-Clqt_MYU.mjs";import{usePresence as V}from"./packem_shared/usePresence-Dpnb4kjv.mjs";import{subscribeToQuery as j,useQuery as k}from"./packem_shared/subscribeToQuery-BvnA8ErG.mjs";import{useRateLimit as w}from"./packem_shared/useRateLimit-zoPsflSG.mjs";import{useStream as B}from"./packem_shared/useStream-COVzNdKq.mjs";import{useSubscription as G}from"./packem_shared/useSubscription-BMJ1kYm8.mjs";import{useVoiceAgent as W}from"./packem_shared/useVoiceAgent-BEGHhbmX.mjs";export{r as AuthLoading,t as Authenticated,f as LUNORA_INJECTION_KEY,u as Unauthenticated,m as createLunora,p as hydratePreloaded,n as provideLunora,j as subscribeToQuery,c as useAction,d as useAgent,L as useAgentChat,l as useAgentState,Q as useAgentToolEvents,T as useAuth,v as useConnectionStatus,E as useFlag,I as useFlags,_ as useInfiniteQuery,P as useLiveTopic,x as useLunora,M as useMutation,R as useMutator,J as usePaginatedQuery,V as usePresence,k as useQuery,w as useRateLimit,B as useStream,G as useSubscription,W as useVoiceAgent};

package/dist/packem_shared/useLiveTopic-Bcz34mfU.mjs

@@ -0,0 +1 @@
+import{subscribeLiveTopic as u}from"@lunora/client";import{stableWireKey as a}from"@lunora/wire";import{shallowRef as i,watch as l,toValue as m}from"vue";import{i as f}from"./is-browser-BEdfLJHK.mjs";import{o as p}from"./scope-dispose-Mq3k4nvP.mjs";const s=e=>{const r={};for(const[o,t]of Object.entries(e))o!=="onError"&&o!=="onEvent"&&(r[o]=m(t));return r},L=e=>{const r=i(void 0),o=i(void 0);if(f()){const t=l(()=>a(s(e)),(d,E,c)=>{r.value=void 0,o.value=void 0;const v=u({...s(e),onError:n=>{o.value=n,e.onError?.(n)},onEvent:n=>{r.value=n,o.value=void 0,e.onEvent?.(n)}});c(v)},{immediate:!0});p(t)}return{error:o,lastEvent:r}};export{L as useLiveTopic};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/vue",
-  "version": "1.0.0-alpha.267",
+  "version": "1.0.0-alpha.268",
   "description": "Vue adapter for Lunora — live composables, 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"
   },