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

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 declared live 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(topic, options?)` takes the reference `_generated/live.ts` hands out, e.g. `useLiveTopic(live.posts.post({ postId }), { onEvent })`, as a value, a ref or a getter, so a reactive `postId` resubscribes. The stream's route is resolved against the injected `LunoraClient`, and `lastEvent` and `onEvent` are typed by the payload the topic declares. Each connection option (`shardKey`, `sessionKey`, `headers`, `withCredentials`, `retryDelay`, `maxDelayMs`) may be a plain value, a ref, or a getter. `onEvent` and `onError` are plain functions and never trigger a resubscribe. The SSE connection is shared by stream route, 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, LiveTopicOptions, LiveStreamSubscribeError, LiveTopicRef, 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,36 @@ 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 {@link LiveTopicOptions} field except the two callbacks. */
+type ConnectionFields = Omit<LiveTopicOptions, "onError" | "onEvent">;
+/**
+ * Options for {@link useLiveTopic}. Each connection field may be a plain value, a
+ * `ref`, or a getter, so a reactive `shardKey` or `headers` re-subscribes. The callbacks
+ * are plain functions: a getter would be called by `toValue`, so they are never wrapped.
+ */
+type UseLiveTopicOptions<Payload = unknown> = Pick<LiveTopicOptions<Payload>, "onError" | "onEvent"> & { [K in keyof ConnectionFields]: MaybeRefOrGetter<ConnectionFields[K]>; };
+interface UseLiveTopicResult<Payload = unknown> {
+  /** 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<Payload | undefined>;
+}
+/**
+ * `useLiveTopic` — follow one live topic of a `defineLiveStream` for the life of
+ * the calling component's effect scope. Pass the reference `_generated/live.ts` hands
+ * out (`live.posts.post({ postId })`), as a value, a `ref` or a getter: the stream's
+ * route is resolved against the injected `LunoraClient`, and `lastEvent` and `onEvent`
+ * are typed by the payload the topic declares.
+ *
+ * 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 the reference
+ * or 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: <Payload>(topic: MaybeRefOrGetter<LiveTopicRef<Payload>>, options?: UseLiveTopicOptions<Payload>) => UseLiveTopicResult<Payload>;
 /**
  * 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 +1211,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 +1249,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, LiveTopicOptions, LiveStreamSubscribeError, LiveTopicRef, 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,36 @@ 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 {@link LiveTopicOptions} field except the two callbacks. */
+type ConnectionFields = Omit<LiveTopicOptions, "onError" | "onEvent">;
+/**
+ * Options for {@link useLiveTopic}. Each connection field may be a plain value, a
+ * `ref`, or a getter, so a reactive `shardKey` or `headers` re-subscribes. The callbacks
+ * are plain functions: a getter would be called by `toValue`, so they are never wrapped.
+ */
+type UseLiveTopicOptions<Payload = unknown> = Pick<LiveTopicOptions<Payload>, "onError" | "onEvent"> & { [K in keyof ConnectionFields]: MaybeRefOrGetter<ConnectionFields[K]>; };
+interface UseLiveTopicResult<Payload = unknown> {
+  /** 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<Payload | undefined>;
+}
+/**
+ * `useLiveTopic` — follow one live topic of a `defineLiveStream` for the life of
+ * the calling component's effect scope. Pass the reference `_generated/live.ts` hands
+ * out (`live.posts.post({ postId })`), as a value, a `ref` or a getter: the stream's
+ * route is resolved against the injected `LunoraClient`, and `lastEvent` and `onEvent`
+ * are typed by the payload the topic declares.
+ *
+ * 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 the reference
+ * or 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: <Payload>(topic: MaybeRefOrGetter<LiveTopicRef<Payload>>, options?: UseLiveTopicOptions<Payload>) => UseLiveTopicResult<Payload>;
 /**
  * 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 +1211,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 +1249,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-B0HA04MY.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-B0HA04MY.mjs

@@ -0,0 +1 @@
+import{subscribeLiveTopic as b,liveTopicSubscription as y}from"@lunora/client";import{stableWireKey as E}from"@lunora/wire";import{shallowRef as a,watch as w,toValue as l}from"vue";import{i as h}from"./is-browser-BEdfLJHK.mjs";import{useLunora as K}from"./LUNORA_INJECTION_KEY-Bct9tKCj.mjs";import{o as T}from"./scope-dispose-Mq3k4nvP.mjs";const D=i=>{const r={};for(const[o,t]of Object.entries(i))o!=="onError"&&o!=="onEvent"&&(r[o]=l(t));return r},_=(i,r={})=>{const o=a(void 0),t=a(void 0);if(h()){const p=K(),c=()=>y(p,l(i),D(r)),m=w(()=>{const{headers:u,maxDelayMs:v,retryDelay:n,sessionKey:s,topic:e,url:f,withCredentials:d}=c();return E({headers:u,maxDelayMs:v,retryDelay:n,sessionKey:s,topic:e,url:f,withCredentials:d})},(u,v,n)=>{o.value=void 0,t.value=void 0;const s=b({...c(),onError:e=>{t.value=e,r.onError?.(e)},onEvent:e=>{o.value=e,t.value=void 0,r.onEvent?.(e)}});n(s)},{immediate:!0});T(m)}return{error:t,lastEvent:o}};export{_ as useLiveTopic};

package/package.json

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