@lunora/solid 1.0.0-alpha.237 → 1.0.0-alpha.238

package/README.md

@@ -102,7 +102,7 @@ render(
 | `createQuery`                                       | `useQuery`            | Live query signal — returns `() => T \| undefined`, re-subscribes on arg change.  |
 | `createMutation`                                    | `useMutation`         | Optimistic mutation handle (`data`, `error`, `pending`, `mutate`, `reset`).       |
 | `createSubscription`                                | `useSubscription`     | Raw subscription signal — unbounded live stream.                                  |
-| `createLiveTopic`                                   | `useLiveTopic`        | One live topic on the shared stream — `lastEvent` and `error` accessors.          |
+| `createLiveTopic`                                   | `useLiveTopic`        | One declared live topic — `lastEvent` and `error` accessors.                      |
 | `createPaginatedQuery`                              | `usePaginatedQuery`   | Cursor-paginated query with `loadMore`, `status`, `results`, and `error` signals. |
 | `createInfiniteQuery`                               | `useInfiniteQuery`    | Infinite-scroll variant of `createPaginatedQuery`.                                |
 | `createAuth`                                        | `useAuth`             | Reactive auth state (`token`, `user`, `status` signals + `setToken`).             |

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, SubscriptionErrorCallback, User, ConnectionStatus, LiveStreamSubscribeError, SubscribeLiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError, Preloaded } from '@lunora/client';
+import { LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, SubscriptionErrorCallback, User, ConnectionStatus, LiveStreamSubscribeError, LiveTopicRef, LiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError, Preloaded } from '@lunora/client';
 export type { ArgsOf, FunctionReference, MutatorHandle, MutatorTransaction, OptimisticUpdate, Preloaded, ReturnOf, SubscriptionError, SubscriptionErrorCallback, Unsubscribe } from '@lunora/client';
 import { Context, Accessor } from 'solid-js';
 import { AuthStatus } from '@lunora/client/auth';
@@ -618,22 +618,25 @@ declare const createFlags: <T extends Record<string, FlagValue>>(flags: T) => Ac
  *
  * A thin lifecycle wrapper over `subscribeLiveTopic` from `@lunora/client`: it
  * subscribes when the owner mounts, unsubscribes on cleanup, and resubscribes when
- * the url, topic or connection options change. Callbacks are not part of that
+ * the topic or the connection options change. Callbacks are not part of that
  * identity, so a new `onEvent` / `onError` never reopens the subscription.
  */
-interface CreateLiveTopicResult {
+interface CreateLiveTopicResult<Payload = unknown> {
   /** The shard's refusal of this subscription (403, 409, 429 and similar), or `undefined`. */
   error: Accessor<LiveStreamSubscribeError | undefined>;
   /** The last payload delivered on the topic, or `undefined` until the first event. */
-  lastEvent: Accessor<unknown>;
+  lastEvent: Accessor<Payload | undefined>;
 }
 /**
- * Follow `options.topic` on the shared live connection for `options.url`.
+ * Follow the topic `topic` names on the live connection shared by its stream's route. Pass the
+ * reference `_generated/live.ts` hands out (`live.posts.post({ postId })`), plain or as an
+ * accessor; the route is resolved against the `LunoraClient` from the nearest `LunoraContext`,
+ * and `lastEvent` and `onEvent` are typed by the payload the topic declares.
  *
- * `options` may be a plain object or an accessor. The `onEvent` and `onError`
- * callbacks are read at call time, so the latest identity is always the one invoked.
+ * `options` may be a plain object or an accessor. The `onEvent` and `onError` callbacks are
+ * read at call time, so the latest identity is always the one invoked.
  */
-declare const createLiveTopic: (options: SubscribeLiveTopicOptions | Accessor<SubscribeLiveTopicOptions>) => CreateLiveTopicResult;
+declare const createLiveTopic: <Payload>(topic: LiveTopicRef<Payload> | Accessor<LiveTopicRef<Payload>>, options?: LiveTopicOptions<Payload> | Accessor<LiveTopicOptions<Payload>>) => CreateLiveTopicResult<Payload>;
 interface MutationHandle<F extends FunctionReference> {
   /** The latest invocation's resolved value, or `undefined` before the first success. */
   data: Accessor<ReturnOf<F> | undefined>;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, SubscriptionErrorCallback, User, ConnectionStatus, LiveStreamSubscribeError, SubscribeLiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError, Preloaded } from '@lunora/client';
+import { LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, SubscriptionErrorCallback, User, ConnectionStatus, LiveStreamSubscribeError, LiveTopicRef, LiveTopicOptions, MutationCallOptions, MutatorHandle, SubscriptionError, Preloaded } from '@lunora/client';
 export type { ArgsOf, FunctionReference, MutatorHandle, MutatorTransaction, OptimisticUpdate, Preloaded, ReturnOf, SubscriptionError, SubscriptionErrorCallback, Unsubscribe } from '@lunora/client';
 import { Context, Accessor } from 'solid-js';
 import { AuthStatus } from '@lunora/client/auth';
@@ -618,22 +618,25 @@ declare const createFlags: <T extends Record<string, FlagValue>>(flags: T) => Ac
  *
  * A thin lifecycle wrapper over `subscribeLiveTopic` from `@lunora/client`: it
  * subscribes when the owner mounts, unsubscribes on cleanup, and resubscribes when
- * the url, topic or connection options change. Callbacks are not part of that
+ * the topic or the connection options change. Callbacks are not part of that
  * identity, so a new `onEvent` / `onError` never reopens the subscription.
  */
-interface CreateLiveTopicResult {
+interface CreateLiveTopicResult<Payload = unknown> {
   /** The shard's refusal of this subscription (403, 409, 429 and similar), or `undefined`. */
   error: Accessor<LiveStreamSubscribeError | undefined>;
   /** The last payload delivered on the topic, or `undefined` until the first event. */
-  lastEvent: Accessor<unknown>;
+  lastEvent: Accessor<Payload | undefined>;
 }
 /**
- * Follow `options.topic` on the shared live connection for `options.url`.
+ * Follow the topic `topic` names on the live connection shared by its stream's route. Pass the
+ * reference `_generated/live.ts` hands out (`live.posts.post({ postId })`), plain or as an
+ * accessor; the route is resolved against the `LunoraClient` from the nearest `LunoraContext`,
+ * and `lastEvent` and `onEvent` are typed by the payload the topic declares.
  *
- * `options` may be a plain object or an accessor. The `onEvent` and `onError`
- * callbacks are read at call time, so the latest identity is always the one invoked.
+ * `options` may be a plain object or an accessor. The `onEvent` and `onError` callbacks are
+ * read at call time, so the latest identity is always the one invoked.
  */
-declare const createLiveTopic: (options: SubscribeLiveTopicOptions | Accessor<SubscribeLiveTopicOptions>) => CreateLiveTopicResult;
+declare const createLiveTopic: <Payload>(topic: LiveTopicRef<Payload> | Accessor<LiveTopicRef<Payload>>, options?: LiveTopicOptions<Payload> | Accessor<LiveTopicOptions<Payload>>) => CreateLiveTopicResult<Payload>;
 interface MutationHandle<F extends FunctionReference> {
   /** The latest invocation's resolved value, or `undefined` before the first success. */
   data: Accessor<ReturnOf<F> | undefined>;

package/dist/index.mjs

@@ -1 +1 @@
-import{LunoraContext as r,useLunora as o}from"./packem_shared/LunoraContext-BWsj_3CK.mjs";import{createAction as c,createActionForClient as n}from"./packem_shared/createAction-BZkayM2R.mjs";import{createAgent as m}from"./packem_shared/createAgent-BN_C_ztD.mjs";import{createAgentChat as x}from"./packem_shared/createAgentChat-BWtnorVh.mjs";import{createAgentState as u}from"./packem_shared/createAgentState-Cl09r0tX.mjs";import{createAgentToolEvents as A}from"./packem_shared/createAgentToolEvents-on8XD92W.mjs";import{AuthLoading as l,Authenticated as s,Unauthenticated as h,createAuth as L}from"./packem_shared/AuthLoading-DjUnIaP5.mjs";import{default as y}from"./packem_shared/createConnectionStatus-D8bC05Jn.mjs";import{createFlag as P,createFlags as S}from"./packem_shared/createFlag-Bww9WQUu.mjs";import{createLiveTopic as M}from"./packem_shared/createLiveTopic-EjgSMydg.mjs";import{createMutation as T,createMutationForClient as b}from"./packem_shared/createMutation-DM2mXpq3.mjs";import{createMutator as I}from"./packem_shared/createMutator-q9cMjGKv.mjs";import{createInfiniteQuery as U,createPaginatedQuery as V}from"./packem_shared/createInfiniteQuery-CwGPFeuc.mjs";import{createPresence as k}from"./packem_shared/createPresence-DkTotieP.mjs";import{createQuery as w}from"./packem_shared/createQuery-oNQqVGjE.mjs";import{createRateLimit as B}from"./packem_shared/createRateLimit-CIVWrD5H.mjs";import{createStream as G}from"./packem_shared/createStream-CCAOb9q1.mjs";import{createSubscription as J}from"./packem_shared/createSubscription-DiyhxkoK.mjs";import{createVoiceAgent as N}from"./packem_shared/createVoiceAgent-BtRfW4lS.mjs";import{default as W}from"./packem_shared/hydratePreloaded-DCi296oW.mjs";import{LunoraProvider as Y}from"./packem_shared/LunoraProvider-DMhpuxvx.mjs";export{l as AuthLoading,s as Authenticated,r as LunoraContext,Y as LunoraProvider,h as Unauthenticated,c as createAction,n as createActionForClient,m as createAgent,x as createAgentChat,u as createAgentState,A as createAgentToolEvents,L as createAuth,y as createConnectionStatus,P as createFlag,S as createFlags,U as createInfiniteQuery,M as createLiveTopic,T as createMutation,b as createMutationForClient,I as createMutator,V as createPaginatedQuery,k as createPresence,w as createQuery,B as createRateLimit,G as createStream,J as createSubscription,N as createVoiceAgent,W as hydratePreloaded,o as useLunora};
+import{LunoraContext as r,useLunora as o}from"./packem_shared/LunoraContext-BWsj_3CK.mjs";import{createAction as c,createActionForClient as n}from"./packem_shared/createAction-BZkayM2R.mjs";import{createAgent as m}from"./packem_shared/createAgent-BN_C_ztD.mjs";import{createAgentChat as x}from"./packem_shared/createAgentChat-BWtnorVh.mjs";import{createAgentState as u}from"./packem_shared/createAgentState-Cl09r0tX.mjs";import{createAgentToolEvents as A}from"./packem_shared/createAgentToolEvents-on8XD92W.mjs";import{AuthLoading as l,Authenticated as s,Unauthenticated as h,createAuth as L}from"./packem_shared/AuthLoading-DjUnIaP5.mjs";import{default as y}from"./packem_shared/createConnectionStatus-D8bC05Jn.mjs";import{createFlag as P,createFlags as S}from"./packem_shared/createFlag-Bww9WQUu.mjs";import{createLiveTopic as M}from"./packem_shared/createLiveTopic-CgkjI8l8.mjs";import{createMutation as T,createMutationForClient as b}from"./packem_shared/createMutation-DM2mXpq3.mjs";import{createMutator as I}from"./packem_shared/createMutator-q9cMjGKv.mjs";import{createInfiniteQuery as U,createPaginatedQuery as V}from"./packem_shared/createInfiniteQuery-CwGPFeuc.mjs";import{createPresence as k}from"./packem_shared/createPresence-DkTotieP.mjs";import{createQuery as w}from"./packem_shared/createQuery-oNQqVGjE.mjs";import{createRateLimit as B}from"./packem_shared/createRateLimit-CIVWrD5H.mjs";import{createStream as G}from"./packem_shared/createStream-CCAOb9q1.mjs";import{createSubscription as J}from"./packem_shared/createSubscription-DiyhxkoK.mjs";import{createVoiceAgent as N}from"./packem_shared/createVoiceAgent-BtRfW4lS.mjs";import{default as W}from"./packem_shared/hydratePreloaded-DCi296oW.mjs";import{LunoraProvider as Y}from"./packem_shared/LunoraProvider-DMhpuxvx.mjs";export{l as AuthLoading,s as Authenticated,r as LunoraContext,Y as LunoraProvider,h as Unauthenticated,c as createAction,n as createActionForClient,m as createAgent,x as createAgentChat,u as createAgentState,A as createAgentToolEvents,L as createAuth,y as createConnectionStatus,P as createFlag,S as createFlags,U as createInfiniteQuery,M as createLiveTopic,T as createMutation,b as createMutationForClient,I as createMutator,V as createPaginatedQuery,k as createPresence,w as createQuery,B as createRateLimit,G as createStream,J as createSubscription,N as createVoiceAgent,W as hydratePreloaded,o as useLunora};

package/dist/packem_shared/createLiveTopic-CgkjI8l8.mjs

@@ -0,0 +1 @@
+import{subscribeLiveTopic as m,liveTopicSubscription as d}from"@lunora/client";import{createSignal as i}from"solid-js";import{useLunora as y}from"./LunoraContext-BWsj_3CK.mjs";import{t as E}from"./reactive-args-qKMBsFpd.mjs";const p=e=>({headers:e.headers,maxDelayMs:e.maxDelayMs,retryDelay:e.retryDelay,sessionKey:e.sessionKey,topic:e.topic,url:e.url,withCredentials:e.withCredentials}),T=(e,t={})=>{const c=y(),a=typeof e=="function"?e:()=>e,v=typeof t=="function"?t:()=>t,o=()=>d(c,a(),v()),[l,s]=i(void 0),[u,n]=i(void 0);return E(()=>p(o()),f=>(s(()=>{}),n(()=>{}),m({...f,onError:r=>{n(()=>r),o().onError?.(r)},onEvent:r=>{s(()=>r),n(()=>{}),o().onEvent?.(r)}}))),{error:u,lastEvent:l}};export{T as createLiveTopic};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/solid",
-  "version": "1.0.0-alpha.237",
+  "version": "1.0.0-alpha.238",
   "description": "SolidJS adapter for Lunora — live queries, 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/createLiveTopic-EjgSMydg.mjs

@@ -1 +0,0 @@
-import{subscribeLiveTopic as v}from"@lunora/client";import{createSignal as s}from"solid-js";import{t as d}from"./reactive-args-qKMBsFpd.mjs";const l=e=>({headers:e.headers,maxDelayMs:e.maxDelayMs,retryDelay:e.retryDelay,sessionKey:e.sessionKey,topic:e.topic,url:e.url,withCredentials:e.withCredentials}),f=e=>{const t=typeof e=="function"?e:()=>e,[c,n]=s(void 0),[i,o]=s(void 0);return d(()=>l(t()),a=>(n(()=>{}),o(()=>{}),v({...a,onError:r=>{o(()=>r),t().onError?.(r)},onEvent:r=>{n(()=>r),o(()=>{}),t().onEvent?.(r)}}))),{error:i,lastEvent:c}};export{f as createLiveTopic};