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

package/README.md

@@ -102,6 +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 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, 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';
@@ -613,6 +613,30 @@ declare const createFlag: <T extends FlagValue>(key: MaybeAccessor<string>, defa
  * reactive — the subscriptions open on mount and tear down on cleanup.
  */
 declare const createFlags: <T extends Record<string, FlagValue>>(flags: T) => Accessor<T>;
+/**
+ * `createLiveTopic` — follow one live topic on the connection shared by its URL.
+ *
+ * A thin lifecycle wrapper over `subscribeLiveTopic` from `@lunora/client`: it
+ * subscribes when the owner mounts, unsubscribes on cleanup, and resubscribes when
+ * 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<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<Payload | undefined>;
+}
+/**
+ * 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.
+ */
+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>;
@@ -1189,7 +1213,7 @@ interface LunoraProviderProps {
  * itself is resolved per-major by {@link providerOf}.
  */
 declare const LunoraProvider: (props: LunoraProviderProps) => SolidElement;
-export { type ActionClient, type ActionHandle, type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, Authenticated, type CreateAgentApi, type CreateAgentChatApi, type CreateAgentChatOptions, type CreateAgentChatResult, type CreateAgentOptions, type CreateAgentResult, type CreateAgentStateApi, type CreateAgentStateOptions, type CreateAgentStateResult, type CreateAgentToolEventsApi, type CreateAgentToolEventsOptions, type CreateAgentToolEventsResult, type CreateInfiniteQueryOptions, type CreateInfiniteQueryResult, type CreatePaginatedQueryOptions, type CreatePaginatedQueryResult, type CreatePresenceOptions, type CreatePresenceResult, type CreateQueryOptions, type CreateRateLimitOptions, type CreateRateLimitResult, type CreateStreamOptions, type CreateStreamResult, type CreateStreamStatus, type CreateSubscriptionResult, type CreateVoiceAgentOptions, type CreateVoiceAgentResult, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraContext, LunoraProvider,
+export { type ActionClient, type ActionHandle, type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, Authenticated, type CreateAgentApi, type CreateAgentChatApi, type CreateAgentChatOptions, type CreateAgentChatResult, type CreateAgentOptions, type CreateAgentResult, type CreateAgentStateApi, type CreateAgentStateOptions, type CreateAgentStateResult, type CreateAgentToolEventsApi, type CreateAgentToolEventsOptions, type CreateAgentToolEventsResult, type CreateInfiniteQueryOptions, type CreateInfiniteQueryResult, type CreateLiveTopicResult, type CreatePaginatedQueryOptions, type CreatePaginatedQueryResult, type CreatePresenceOptions, type CreatePresenceResult, type CreateQueryOptions, type CreateRateLimitOptions, type CreateRateLimitResult, type CreateStreamOptions, type CreateStreamResult, type CreateStreamStatus, type CreateSubscriptionResult, type CreateVoiceAgentOptions, type CreateVoiceAgentResult, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraContext, LunoraProvider,
 /**
  * SolidJS adapter for Lunora.
  *
@@ -1208,4 +1232,4 @@ export { type ActionClient, type ActionHandle, type AgentChatMessage, type Agent
  * framework-neutral server contract) — call it from your SolidStart route loader
  * and hand the resulting `Preloaded` token to `hydratePreloaded`.
  */
-type LunoraProviderProps, type MutationClient, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, type SolidChildren, Unauthenticated, type UseAuthResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, createAction, createActionForClient, createAgent, createAgentChat, createAgentState, createAgentToolEvents, createAuth, createConnectionStatus, createFlag, createFlags, createInfiniteQuery, createMutation, createMutationForClient, createMutator, createPaginatedQuery, createPresence, createQuery, createRateLimit, createStream, createSubscription, createVoiceAgent, hydratePreloaded, useLunora };
+type LunoraProviderProps, type MutationClient, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, type SolidChildren, Unauthenticated, type UseAuthResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, createAction, createActionForClient, createAgent, createAgentChat, createAgentState, createAgentToolEvents, createAuth, createConnectionStatus, createFlag, createFlags, createInfiniteQuery, createLiveTopic, createMutation, createMutationForClient, createMutator, createPaginatedQuery, createPresence, createQuery, createRateLimit, createStream, createSubscription, createVoiceAgent, hydratePreloaded, useLunora };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { LunoraClient, FunctionReference, ArgsOf, ActionCallOptions, ReturnOf, SubscriptionErrorCallback, User, ConnectionStatus, 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';
@@ -613,6 +613,30 @@ declare const createFlag: <T extends FlagValue>(key: MaybeAccessor<string>, defa
  * reactive — the subscriptions open on mount and tear down on cleanup.
  */
 declare const createFlags: <T extends Record<string, FlagValue>>(flags: T) => Accessor<T>;
+/**
+ * `createLiveTopic` — follow one live topic on the connection shared by its URL.
+ *
+ * A thin lifecycle wrapper over `subscribeLiveTopic` from `@lunora/client`: it
+ * subscribes when the owner mounts, unsubscribes on cleanup, and resubscribes when
+ * 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<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<Payload | undefined>;
+}
+/**
+ * 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.
+ */
+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>;
@@ -1189,7 +1213,7 @@ interface LunoraProviderProps {
  * itself is resolved per-major by {@link providerOf}.
  */
 declare const LunoraProvider: (props: LunoraProviderProps) => SolidElement;
-export { type ActionClient, type ActionHandle, type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, Authenticated, type CreateAgentApi, type CreateAgentChatApi, type CreateAgentChatOptions, type CreateAgentChatResult, type CreateAgentOptions, type CreateAgentResult, type CreateAgentStateApi, type CreateAgentStateOptions, type CreateAgentStateResult, type CreateAgentToolEventsApi, type CreateAgentToolEventsOptions, type CreateAgentToolEventsResult, type CreateInfiniteQueryOptions, type CreateInfiniteQueryResult, type CreatePaginatedQueryOptions, type CreatePaginatedQueryResult, type CreatePresenceOptions, type CreatePresenceResult, type CreateQueryOptions, type CreateRateLimitOptions, type CreateRateLimitResult, type CreateStreamOptions, type CreateStreamResult, type CreateStreamStatus, type CreateSubscriptionResult, type CreateVoiceAgentOptions, type CreateVoiceAgentResult, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraContext, LunoraProvider,
+export { type ActionClient, type ActionHandle, type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, Authenticated, type CreateAgentApi, type CreateAgentChatApi, type CreateAgentChatOptions, type CreateAgentChatResult, type CreateAgentOptions, type CreateAgentResult, type CreateAgentStateApi, type CreateAgentStateOptions, type CreateAgentStateResult, type CreateAgentToolEventsApi, type CreateAgentToolEventsOptions, type CreateAgentToolEventsResult, type CreateInfiniteQueryOptions, type CreateInfiniteQueryResult, type CreateLiveTopicResult, type CreatePaginatedQueryOptions, type CreatePaginatedQueryResult, type CreatePresenceOptions, type CreatePresenceResult, type CreateQueryOptions, type CreateRateLimitOptions, type CreateRateLimitResult, type CreateStreamOptions, type CreateStreamResult, type CreateStreamStatus, type CreateSubscriptionResult, type CreateVoiceAgentOptions, type CreateVoiceAgentResult, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraContext, LunoraProvider,
 /**
  * SolidJS adapter for Lunora.
  *
@@ -1208,4 +1232,4 @@ export { type ActionClient, type ActionHandle, type AgentChatMessage, type Agent
  * framework-neutral server contract) — call it from your SolidStart route loader
  * and hand the resulting `Preloaded` token to `hydratePreloaded`.
  */
-type LunoraProviderProps, type MutationClient, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, type SolidChildren, Unauthenticated, type UseAuthResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, createAction, createActionForClient, createAgent, createAgentChat, createAgentState, createAgentToolEvents, createAuth, createConnectionStatus, createFlag, createFlags, createInfiniteQuery, createMutation, createMutationForClient, createMutator, createPaginatedQuery, createPresence, createQuery, createRateLimit, createStream, createSubscription, createVoiceAgent, hydratePreloaded, useLunora };
+type LunoraProviderProps, type MutationClient, type MutationHandle, type MutatorHook, type PageItemOf, type PaginatedArgs, type SolidChildren, Unauthenticated, type UseAuthResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, createAction, createActionForClient, createAgent, createAgentChat, createAgentState, createAgentToolEvents, createAuth, createConnectionStatus, createFlag, createFlags, createInfiniteQuery, createLiveTopic, createMutation, createMutationForClient, createMutator, createPaginatedQuery, createPresence, createQuery, createRateLimit, createStream, createSubscription, createVoiceAgent, hydratePreloaded, useLunora };

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 C}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{createMutation as Q,createMutationForClient as v}from"./packem_shared/createMutation-DM2mXpq3.mjs";import{createMutator as E}from"./packem_shared/createMutator-q9cMjGKv.mjs";import{createInfiniteQuery as R,createPaginatedQuery as T}from"./packem_shared/createInfiniteQuery-CwGPFeuc.mjs";import{createPresence as V}from"./packem_shared/createPresence-DkTotieP.mjs";import{createQuery as k}from"./packem_shared/createQuery-oNQqVGjE.mjs";import{createRateLimit as w}from"./packem_shared/createRateLimit-CIVWrD5H.mjs";import{createStream as B}from"./packem_shared/createStream-CCAOb9q1.mjs";import{createSubscription as G}from"./packem_shared/createSubscription-DiyhxkoK.mjs";import{createVoiceAgent as J}from"./packem_shared/createVoiceAgent-BtRfW4lS.mjs";import{default as N}from"./packem_shared/hydratePreloaded-DCi296oW.mjs";import{LunoraProvider as W}from"./packem_shared/LunoraProvider-DMhpuxvx.mjs";export{l as AuthLoading,s as Authenticated,r as LunoraContext,W as LunoraProvider,h as Unauthenticated,c as createAction,n as createActionForClient,m as createAgent,x as createAgentChat,u as createAgentState,A as createAgentToolEvents,C as createAuth,y as createConnectionStatus,P as createFlag,S as createFlags,R as createInfiniteQuery,Q as createMutation,v as createMutationForClient,E as createMutator,T as createPaginatedQuery,V as createPresence,k as createQuery,w as createRateLimit,B as createStream,G as createSubscription,J as createVoiceAgent,N 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.236",
+  "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.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"
   },