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

package/README.md

@@ -85,7 +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.                |
+| `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.   |
@@ -94,7 +94,7 @@ 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.
+`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.
 

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, SubscribeLiveTopicOptions, LiveStreamSubscribeError, 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,33 +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 `subscribeLiveTopic` option except the two callbacks. */
-type ConnectionFields = Omit<SubscribeLiveTopicOptions, "onError" | "onEvent">;
+/** 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 `topic` or `url` re-subscribes. The callbacks
+ * `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 = Pick<SubscribeLiveTopicOptions, "onError" | "onEvent"> & { [K in keyof ConnectionFields]: MaybeRefOrGetter<ConnectionFields[K]>; };
-interface UseLiveTopicResult {
+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<unknown>;
+  lastEvent: ShallowRef<Payload | undefined>;
 }
 /**
  * `useLiveTopic` — follow one live topic of a `defineLiveStream` for the life of
- * the calling component's effect scope.
+ * 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 a reactive
- * connection field changes. Callbacks are read at call time, so they never
- * resubscribe.
+ * 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: (options: UseLiveTopicOptions) => UseLiveTopicResult;
+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

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, SubscribeLiveTopicOptions, LiveStreamSubscribeError, 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,33 +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 `subscribeLiveTopic` option except the two callbacks. */
-type ConnectionFields = Omit<SubscribeLiveTopicOptions, "onError" | "onEvent">;
+/** 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 `topic` or `url` re-subscribes. The callbacks
+ * `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 = Pick<SubscribeLiveTopicOptions, "onError" | "onEvent"> & { [K in keyof ConnectionFields]: MaybeRefOrGetter<ConnectionFields[K]>; };
-interface UseLiveTopicResult {
+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<unknown>;
+  lastEvent: ShallowRef<Payload | undefined>;
 }
 /**
  * `useLiveTopic` — follow one live topic of a `defineLiveStream` for the life of
- * the calling component's effect scope.
+ * 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 a reactive
- * connection field changes. Callbacks are read at call time, so they never
- * resubscribe.
+ * 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: (options: UseLiveTopicOptions) => UseLiveTopicResult;
+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

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 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};
+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.268",
+  "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.228",
+    "@lunora/client": "1.0.0-alpha.229",
     "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
-    "@lunora/ratelimit": "1.0.0-alpha.151",
+    "@lunora/ratelimit": "1.0.0-alpha.152",
     "@lunora/wire": "1.0.0-alpha.1",
     "@visulima/storage-client": "1.0.9"
   },

package/dist/packem_shared/useLiveTopic-Bcz34mfU.mjs

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