@lunora/angular 1.0.0-alpha.212 → 1.0.0-alpha.214

package/README.md

@@ -82,6 +82,27 @@ liveQuery(api.messages.list, () => ({ channelId: this.channelId() }), {
 });
 ```
 
+## Live topics
+
+`liveTopic` follows one topic on the connection shared by its URL, and mirrors
+the last payload and any refusal into two signals: `lastEvent` and `error`. It
+subscribes when the component is created and unsubscribes on `DestroyRef`.
+
+```ts
+import { input } from "@angular/core";
+import { liveTopic } from "@lunora/angular";
+
+export class PostComponent {
+    readonly postId = input.required<string>();
+
+    readonly comments = liveTopic(() => ({ url: "/live/posts/connect", topic: `comments:${this.postId()}` }));
+}
+```
+
+A new topic resubscribes; a new `onEvent` or `onError` callback is read at call
+time and does not. Pass `{ destroyRef, injector }` as the second argument when
+calling outside an injection context, as with `liveQuery`.
+
 ## Mutations
 
 ```ts

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { DestroyRef, Signal, InjectionToken, EnvironmentProviders, Injector } from '@angular/core';
-import { FunctionReference, LunoraClient, SubscriptionErrorCallback, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, MutationCallOptions, MutatorHandle, ActionCallOptions } from '@lunora/client';
+import { FunctionReference, LunoraClient, SubscriptionErrorCallback, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, SubscribeLiveTopicOptions, LiveStreamSubscribeError, MutationCallOptions, MutatorHandle, ActionCallOptions } from '@lunora/client';
 export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, LunoraClientOptions, MutationCallOptions, Preloaded, ReturnOf, SubscriptionError, Unsubscribe } from '@lunora/client';
 import { AuthStatus } from '@lunora/client/auth';
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -840,6 +840,50 @@ interface LiveQueryOptions {
  * @experimental
  */
 declare const liveQuery: <F extends FunctionReference>(reference: F, args: ArgsOf<F> | "skip" | (() => ArgsOf<F> | "skip"), options?: LiveQueryOptions) => Signal<ReturnOf<F> | undefined>;
+/**
+ * `LiveTopicOptions` is part of the experimental `@lunora/angular` API and may change without a major version bump.
+ * @experimental
+ */
+interface LiveTopicOptions {
+  /**
+   * `DestroyRef` whose `onDestroy` tears the subscription down. Defaults to
+   * `inject(DestroyRef)` — the calling component/service.
+   */
+  destroyRef?: DestroyRef;
+  /**
+   * `Injector` to create the reactive-args `effect()` from. Only needed when the
+   * options are a function AND `liveTopic` is called outside an injection context
+   * with an explicit `destroyRef`. Unused for the static form.
+   */
+  injector?: Injector;
+}
+/**
+ * Follow one live topic on the connection shared by its URL, and mirror its
+ * payloads into an Angular `signal`.
+ *
+ * `lastEvent` reads `undefined` until the first event lands; `error` carries the
+ * shard's refusal of the subscription. The subscription is torn down when the
+ * owning `DestroyRef` fires, so there is no leaked subscriber.
+ *
+ * ```ts
+ * export class PostComponent {
+ *     readonly postId = input.required<string>();
+ *
+ *     readonly comments = liveTopic(() => ({ url: "/live/posts/connect", topic: `comments:${this.postId()}` }));
+ * }
+ * ```
+ *
+ * Pass a function when the options read a signal, as above: an input is not bound
+ * while a field initializer runs, so the plain-object form would read `this.postId`
+ * too early. An options change (a new topic, say) resubscribes, while a new
+ * `onEvent` / `onError` identity is read at call time and does not reopen the
+ * subscription.
+ * @experimental
+ */
+declare const liveTopic: (source: SubscribeLiveTopicOptions | (() => SubscribeLiveTopicOptions), options?: LiveTopicOptions) => {
+  error: Signal<LiveStreamSubscribeError | undefined>;
+  lastEvent: Signal<unknown>;
+};
 /**
  * `MutateOptions` is part of the experimental `@lunora/angular` API and may change without a major version bump.
  * @experimental
@@ -1499,7 +1543,7 @@ interface VoiceAgentResult {
  * @experimental
  */
 declare const voiceAgent: (options: VoiceAgentOptions) => VoiceAgentResult;
-export { type AgentApi, type AgentChatApi, type AgentChatMessage, type AgentChatOptions, type AgentChatResult, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentResult, type AgentStateApi, type AgentStateOptions, type AgentStateResult, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentTokenStreamReference, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsOptions, type AgentToolEventsResult, type AuthGateResult, type AuthOptions, type AuthResult, type ConnectionStatusOptions, type FlagOptions, type FlagValue, type FlagsOptions, type HeartbeatReference, type HydratePreloadedOptions, type HydratePreloadedResult, type InfiniteQueryResult, LUNORA_CLIENT, type ListPresentReference, type LiveQueryOptions, type MutateOptions, type MutatorResult, type PaginatedQueryOptions, type PaginatedQueryResult, type PresenceOptions, type PresenceResult,
+export { type AgentApi, type AgentChatApi, type AgentChatMessage, type AgentChatOptions, type AgentChatResult, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentResult, type AgentStateApi, type AgentStateOptions, type AgentStateResult, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentTokenStreamReference, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsOptions, type AgentToolEventsResult, type AuthGateResult, type AuthOptions, type AuthResult, type ConnectionStatusOptions, type FlagOptions, type FlagValue, type FlagsOptions, type HeartbeatReference, type HydratePreloadedOptions, type HydratePreloadedResult, type InfiniteQueryResult, LUNORA_CLIENT, type ListPresentReference, type LiveQueryOptions, type LiveTopicOptions, type MutateOptions, type MutatorResult, type PaginatedQueryOptions, type PaginatedQueryResult, type PresenceOptions, type PresenceResult,
 /**
  * The Angular adapter for Lunora.
  *
@@ -1515,4 +1559,4 @@ export { type AgentApi, type AgentChatApi, type AgentChatMessage, type AgentChat
  * queue pass through to the client). `connectionStatus` is a `signal` of the
  * aggregate live-socket status.
  */
-type ProvideLunoraOptions, type RateLimitOptions, type RateLimitResult, type RunActionOptions, type StreamOptions, type StreamResult, type StreamStatus, type SubscriptionOptions, type SubscriptionResult, type VoiceAgentOptions, type VoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags, hydratePreloaded, infiniteQuery, injectLunoraClient, liveQuery, mutate, mutator, paginatedQuery, presence, provideLunora, rateLimit, runAction, stream, subscription, voiceAgent };
+type ProvideLunoraOptions, type RateLimitOptions, type RateLimitResult, type RunActionOptions, type StreamOptions, type StreamResult, type StreamStatus, type SubscriptionOptions, type SubscriptionResult, type VoiceAgentOptions, type VoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags, hydratePreloaded, infiniteQuery, injectLunoraClient, liveQuery, liveTopic, mutate, mutator, paginatedQuery, presence, provideLunora, rateLimit, runAction, stream, subscription, voiceAgent };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { DestroyRef, Signal, InjectionToken, EnvironmentProviders, Injector } from '@angular/core';
-import { FunctionReference, LunoraClient, SubscriptionErrorCallback, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, MutationCallOptions, MutatorHandle, ActionCallOptions } from '@lunora/client';
+import { FunctionReference, LunoraClient, SubscriptionErrorCallback, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, SubscribeLiveTopicOptions, LiveStreamSubscribeError, MutationCallOptions, MutatorHandle, ActionCallOptions } from '@lunora/client';
 export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, LunoraClientOptions, MutationCallOptions, Preloaded, ReturnOf, SubscriptionError, Unsubscribe } from '@lunora/client';
 import { AuthStatus } from '@lunora/client/auth';
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -840,6 +840,50 @@ interface LiveQueryOptions {
  * @experimental
  */
 declare const liveQuery: <F extends FunctionReference>(reference: F, args: ArgsOf<F> | "skip" | (() => ArgsOf<F> | "skip"), options?: LiveQueryOptions) => Signal<ReturnOf<F> | undefined>;
+/**
+ * `LiveTopicOptions` is part of the experimental `@lunora/angular` API and may change without a major version bump.
+ * @experimental
+ */
+interface LiveTopicOptions {
+  /**
+   * `DestroyRef` whose `onDestroy` tears the subscription down. Defaults to
+   * `inject(DestroyRef)` — the calling component/service.
+   */
+  destroyRef?: DestroyRef;
+  /**
+   * `Injector` to create the reactive-args `effect()` from. Only needed when the
+   * options are a function AND `liveTopic` is called outside an injection context
+   * with an explicit `destroyRef`. Unused for the static form.
+   */
+  injector?: Injector;
+}
+/**
+ * Follow one live topic on the connection shared by its URL, and mirror its
+ * payloads into an Angular `signal`.
+ *
+ * `lastEvent` reads `undefined` until the first event lands; `error` carries the
+ * shard's refusal of the subscription. The subscription is torn down when the
+ * owning `DestroyRef` fires, so there is no leaked subscriber.
+ *
+ * ```ts
+ * export class PostComponent {
+ *     readonly postId = input.required<string>();
+ *
+ *     readonly comments = liveTopic(() => ({ url: "/live/posts/connect", topic: `comments:${this.postId()}` }));
+ * }
+ * ```
+ *
+ * Pass a function when the options read a signal, as above: an input is not bound
+ * while a field initializer runs, so the plain-object form would read `this.postId`
+ * too early. An options change (a new topic, say) resubscribes, while a new
+ * `onEvent` / `onError` identity is read at call time and does not reopen the
+ * subscription.
+ * @experimental
+ */
+declare const liveTopic: (source: SubscribeLiveTopicOptions | (() => SubscribeLiveTopicOptions), options?: LiveTopicOptions) => {
+  error: Signal<LiveStreamSubscribeError | undefined>;
+  lastEvent: Signal<unknown>;
+};
 /**
  * `MutateOptions` is part of the experimental `@lunora/angular` API and may change without a major version bump.
  * @experimental
@@ -1499,7 +1543,7 @@ interface VoiceAgentResult {
  * @experimental
  */
 declare const voiceAgent: (options: VoiceAgentOptions) => VoiceAgentResult;
-export { type AgentApi, type AgentChatApi, type AgentChatMessage, type AgentChatOptions, type AgentChatResult, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentResult, type AgentStateApi, type AgentStateOptions, type AgentStateResult, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentTokenStreamReference, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsOptions, type AgentToolEventsResult, type AuthGateResult, type AuthOptions, type AuthResult, type ConnectionStatusOptions, type FlagOptions, type FlagValue, type FlagsOptions, type HeartbeatReference, type HydratePreloadedOptions, type HydratePreloadedResult, type InfiniteQueryResult, LUNORA_CLIENT, type ListPresentReference, type LiveQueryOptions, type MutateOptions, type MutatorResult, type PaginatedQueryOptions, type PaginatedQueryResult, type PresenceOptions, type PresenceResult,
+export { type AgentApi, type AgentChatApi, type AgentChatMessage, type AgentChatOptions, type AgentChatResult, type AgentLiveEvent, type AgentOptions, type AgentProgressEvent, type AgentResult, type AgentStateApi, type AgentStateOptions, type AgentStateResult, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentTokenStreamReference, type AgentToolEvent, type AgentToolEventsApi, type AgentToolEventsOptions, type AgentToolEventsResult, type AuthGateResult, type AuthOptions, type AuthResult, type ConnectionStatusOptions, type FlagOptions, type FlagValue, type FlagsOptions, type HeartbeatReference, type HydratePreloadedOptions, type HydratePreloadedResult, type InfiniteQueryResult, LUNORA_CLIENT, type ListPresentReference, type LiveQueryOptions, type LiveTopicOptions, type MutateOptions, type MutatorResult, type PaginatedQueryOptions, type PaginatedQueryResult, type PresenceOptions, type PresenceResult,
 /**
  * The Angular adapter for Lunora.
  *
@@ -1515,4 +1559,4 @@ export { type AgentApi, type AgentChatApi, type AgentChatMessage, type AgentChat
  * queue pass through to the client). `connectionStatus` is a `signal` of the
  * aggregate live-socket status.
  */
-type ProvideLunoraOptions, type RateLimitOptions, type RateLimitResult, type RunActionOptions, type StreamOptions, type StreamResult, type StreamStatus, type SubscriptionOptions, type SubscriptionResult, type VoiceAgentOptions, type VoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags, hydratePreloaded, infiniteQuery, injectLunoraClient, liveQuery, mutate, mutator, paginatedQuery, presence, provideLunora, rateLimit, runAction, stream, subscription, voiceAgent };
+type ProvideLunoraOptions, type RateLimitOptions, type RateLimitResult, type RunActionOptions, type StreamOptions, type StreamResult, type StreamStatus, type SubscriptionOptions, type SubscriptionResult, type VoiceAgentOptions, type VoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, agent, agentChat, agentState, agentToolEvents, auth, authGate, connectionStatus, flag, flags, hydratePreloaded, infiniteQuery, injectLunoraClient, liveQuery, liveTopic, mutate, mutator, paginatedQuery, presence, provideLunora, rateLimit, runAction, stream, subscription, voiceAgent };

package/dist/index.mjs

@@ -1 +1 @@
-import{agent as t}from"./packem_shared/agent-DjMQf-yE.mjs";import{agentChat as m}from"./packem_shared/agentChat-DyJrje49.mjs";import{agentState as f}from"./packem_shared/agentState-Bjqf9q2f.mjs";import{agentToolEvents as n}from"./packem_shared/agentToolEvents-VuBRpS6v.mjs";import{auth as i,authGate as u}from"./packem_shared/auth-C3dB8sYS.mjs";import{LUNORA_CLIENT as c,injectLunoraClient as s,provideLunora as l}from"./packem_shared/LUNORA_CLIENT-B0toApHY.mjs";import{connectionStatus as L}from"./packem_shared/connectionStatus-UhmuwzMa.mjs";import{flag as v,flags as y}from"./packem_shared/flag-BDKBQGos.mjs";import{hydratePreloaded as C}from"./packem_shared/hydratePreloaded-QPAo50Am.mjs";import{liveQuery as S}from"./packem_shared/liveQuery-eE9zMaxo.mjs";import{mutate as I}from"./packem_shared/mutate-BZvLQLyu.mjs";import{mutator as P}from"./packem_shared/mutator-DjG1yGk8.mjs";import{infiniteQuery as b,paginatedQuery as j}from"./packem_shared/infiniteQuery-DGYdgFHW.mjs";import{presence as K}from"./packem_shared/presence-1T4-U8ij.mjs";import{rateLimit as R}from"./packem_shared/rateLimit-B3h9qzh-.mjs";import{runAction as _}from"./packem_shared/runAction-BfiPq4Xz.mjs";import{stream as q}from"./packem_shared/stream-BuhiwhIH.mjs";import{subscription as z}from"./packem_shared/subscription-zJv48q6C.mjs";import{voiceAgent as D}from"./packem_shared/voiceAgent-CH--tRWP.mjs";import{SKIP as H}from"@lunora/client/query";export{c as LUNORA_CLIENT,H as SKIP,t as agent,m as agentChat,f as agentState,n as agentToolEvents,i as auth,u as authGate,L as connectionStatus,v as flag,y as flags,C as hydratePreloaded,b as infiniteQuery,s as injectLunoraClient,S as liveQuery,I as mutate,P as mutator,j as paginatedQuery,K as presence,l as provideLunora,R as rateLimit,_ as runAction,q as stream,z as subscription,D as voiceAgent};
+import{agent as e}from"./packem_shared/agent-DjMQf-yE.mjs";import{agentChat as p}from"./packem_shared/agentChat-DyJrje49.mjs";import{agentState as f}from"./packem_shared/agentState-Bjqf9q2f.mjs";import{agentToolEvents as x}from"./packem_shared/agentToolEvents-VuBRpS6v.mjs";import{auth as i,authGate as u}from"./packem_shared/auth-C3dB8sYS.mjs";import{LUNORA_CLIENT as g,injectLunoraClient as l,provideLunora as s}from"./packem_shared/LUNORA_CLIENT-B0toApHY.mjs";import{connectionStatus as v}from"./packem_shared/connectionStatus-UhmuwzMa.mjs";import{flag as h,flags as y}from"./packem_shared/flag-BDKBQGos.mjs";import{hydratePreloaded as C}from"./packem_shared/hydratePreloaded-QPAo50Am.mjs";import{liveQuery as S}from"./packem_shared/liveQuery-eE9zMaxo.mjs";import{liveTopic as E}from"./packem_shared/liveTopic-rphiqpWi.mjs";import{mutate as N}from"./packem_shared/mutate-BZvLQLyu.mjs";import{mutator as b}from"./packem_shared/mutator-DjG1yGk8.mjs";import{infiniteQuery as G,paginatedQuery as K}from"./packem_shared/infiniteQuery-DGYdgFHW.mjs";import{presence as R}from"./packem_shared/presence-1T4-U8ij.mjs";import{rateLimit as _}from"./packem_shared/rateLimit-B3h9qzh-.mjs";import{runAction as q}from"./packem_shared/runAction-BfiPq4Xz.mjs";import{stream as z}from"./packem_shared/stream-BuhiwhIH.mjs";import{subscription as D}from"./packem_shared/subscription-zJv48q6C.mjs";import{voiceAgent as H}from"./packem_shared/voiceAgent-CH--tRWP.mjs";import{SKIP as M}from"@lunora/client/query";export{g as LUNORA_CLIENT,M as SKIP,e as agent,p as agentChat,f as agentState,x as agentToolEvents,i as auth,u as authGate,v as connectionStatus,h as flag,y as flags,C as hydratePreloaded,G as infiniteQuery,l as injectLunoraClient,S as liveQuery,E as liveTopic,N as mutate,b as mutator,K as paginatedQuery,R as presence,s as provideLunora,_ as rateLimit,q as runAction,z as stream,D as subscription,H as voiceAgent};

package/dist/packem_shared/liveTopic-rphiqpWi.mjs

@@ -0,0 +1 @@
+import{inject as m,DestroyRef as R,signal as y}from"@angular/core";import{subscribeLiveTopic as h}from"@lunora/client";import{s as u,a as D}from"./platform-DGTu4Ucl.mjs";const d=e=>({headers:e.headers,maxDelayMs:e.maxDelayMs,retryDelay:e.retryDelay,sessionKey:e.sessionKey,topic:e.topic,url:e.url,withCredentials:e.withCredentials}),p=(e,o={})=>{const l=o.destroyRef===void 0,c=o.destroyRef??m(R),n=y(void 0),r=y(void 0),s=typeof e=="function"?e:()=>e,a=(i,f)=>{n.set(void 0),r.set(void 0);const v=h({...i,onError:t=>{r.set(t),s().onError?.(t)},onEvent:t=>{n.set(t),r.set(void 0),s().onEvent?.(t)}});f(v)};return u(l)&&(typeof e=="function"?D(()=>d(s()),{destroyRef:c,injector:o.injector},a):a(d(e),i=>c.onDestroy(i))),{error:r.asReadonly(),lastEvent:n.asReadonly()}};export{p as liveTopic};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/angular",
-  "version": "1.0.0-alpha.212",
+  "version": "1.0.0-alpha.214",
   "description": "Angular reactive adapter for Lunora — signal-based live queries and mutations",
   "keywords": [
     "angular",
@@ -53,8 +53,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.226",
-    "@lunora/ratelimit": "1.0.0-alpha.150",
+    "@lunora/client": "1.0.0-alpha.228",
+    "@lunora/ratelimit": "1.0.0-alpha.151",
     "@lunora/wire": "1.0.0-alpha.1",
     "@visulima/storage-client": "1.0.9"
   },