@lunora/angular 1.0.0-alpha.35 → 1.0.0-alpha.36

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { DestroyRef, Signal, InjectionToken, EnvironmentProviders } from '@angular/core';
-import { FunctionReference, LunoraClient, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, MutationCallOptions, MutatorHandle } from '@lunora/client';
+import { FunctionReference, LunoraClient, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, MutationCallOptions, MutatorHandle, ActionCallOptions } from '@lunora/client';
 export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, LunoraClientOptions, MutationCallOptions, Preloaded, ReturnOf, SubscriptionError, Unsubscribe } from '@lunora/client';
 import { PaginationStatus } from '@lunora/client/pagination';
 import { RateLimitStatus, RateLimitConfig } from '@lunora/ratelimit';
@@ -1065,6 +1065,43 @@ interface RateLimitResult {
  * @experimental
  */
 declare const rateLimit: (config: RateLimitConfig, options?: RateLimitOptions) => RateLimitResult;
+/**
+ * `RunActionOptions` is part of the experimental `@lunora/angular` API and may change without a major version bump.
+ * @experimental
+ */
+interface RunActionOptions extends ActionCallOptions {
+  /**
+   * Client to run the action on. Defaults to the injected `LUNORA_CLIENT`.
+   * Because actions usually fire from event handlers — which run *outside* an
+   * injection context — capture the client once (`injectLunoraClient()` in a
+   * field) and pass it here, or call `client.action(...)` directly.
+   */
+  client?: LunoraClient;
+}
+/**
+ * Run a Lunora action and resolve with the server result (rejects on failure).
+ *
+ * The sibling of `mutate`, and a plain function for the same reason: Angular's
+ * adapter models writes as calls rather than reactive handles, because they fire
+ * from event handlers where a signal-returning primitive has nothing to bind to.
+ * The other adapters return a reactive `{ call, pending, … }` handle because
+ * their idioms make that natural; this one does not.
+ *
+ * Unlike `mutate` there are no `optimistic` / `optimisticUpdate` options. An
+ * optimistic update patches the subscription cache on the assumption a write
+ * will land; an action is not a write — it runs in the Worker, may call a third
+ * party, and has no declared effect on any query.
+ *
+ * ```ts
+ * private readonly client = injectLunoraClient();
+ * verify = () => runAction(api.commands.run, { command: "lunora", args: ["verify"] }, { client: this.client });
+ * ```
+ *
+ * When called from within an injection context you may omit `client` and let it
+ * resolve from the injector.
+ * @experimental
+ */
+declare const runAction: <F extends FunctionReference>(reference: F, args: ArgsOf<F>, options?: RunActionOptions) => Promise<ReturnOf<F>>;
 /**
  * The lifecycle of a stream the primitive is observing.
  * @experimental
@@ -1352,4 +1389,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 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, 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, mutate, mutator, paginatedQuery, presence, provideLunora, rateLimit, runAction, stream, subscription, voiceAgent };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { DestroyRef, Signal, InjectionToken, EnvironmentProviders } from '@angular/core';
-import { FunctionReference, LunoraClient, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, MutationCallOptions, MutatorHandle } from '@lunora/client';
+import { FunctionReference, LunoraClient, SubscriptionError, User, LunoraClientOptions, ConnectionStatus, Preloaded, ArgsOf, ReturnOf, MutationCallOptions, MutatorHandle, ActionCallOptions } from '@lunora/client';
 export type { ArgsOf, ConnectionStatus, FunctionReference, LunoraClient, LunoraClientOptions, MutationCallOptions, Preloaded, ReturnOf, SubscriptionError, Unsubscribe } from '@lunora/client';
 import { PaginationStatus } from '@lunora/client/pagination';
 import { RateLimitStatus, RateLimitConfig } from '@lunora/ratelimit';
@@ -1065,6 +1065,43 @@ interface RateLimitResult {
  * @experimental
  */
 declare const rateLimit: (config: RateLimitConfig, options?: RateLimitOptions) => RateLimitResult;
+/**
+ * `RunActionOptions` is part of the experimental `@lunora/angular` API and may change without a major version bump.
+ * @experimental
+ */
+interface RunActionOptions extends ActionCallOptions {
+  /**
+   * Client to run the action on. Defaults to the injected `LUNORA_CLIENT`.
+   * Because actions usually fire from event handlers — which run *outside* an
+   * injection context — capture the client once (`injectLunoraClient()` in a
+   * field) and pass it here, or call `client.action(...)` directly.
+   */
+  client?: LunoraClient;
+}
+/**
+ * Run a Lunora action and resolve with the server result (rejects on failure).
+ *
+ * The sibling of `mutate`, and a plain function for the same reason: Angular's
+ * adapter models writes as calls rather than reactive handles, because they fire
+ * from event handlers where a signal-returning primitive has nothing to bind to.
+ * The other adapters return a reactive `{ call, pending, … }` handle because
+ * their idioms make that natural; this one does not.
+ *
+ * Unlike `mutate` there are no `optimistic` / `optimisticUpdate` options. An
+ * optimistic update patches the subscription cache on the assumption a write
+ * will land; an action is not a write — it runs in the Worker, may call a third
+ * party, and has no declared effect on any query.
+ *
+ * ```ts
+ * private readonly client = injectLunoraClient();
+ * verify = () => runAction(api.commands.run, { command: "lunora", args: ["verify"] }, { client: this.client });
+ * ```
+ *
+ * When called from within an injection context you may omit `client` and let it
+ * resolve from the injector.
+ * @experimental
+ */
+declare const runAction: <F extends FunctionReference>(reference: F, args: ArgsOf<F>, options?: RunActionOptions) => Promise<ReturnOf<F>>;
 /**
  * The lifecycle of a stream the primitive is observing.
  * @experimental
@@ -1352,4 +1389,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 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, 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, mutate, mutator, paginatedQuery, presence, provideLunora, rateLimit, runAction, stream, subscription, voiceAgent };

package/dist/index.mjs

@@ -1 +1 @@
-import{agent as e}from"./packem_shared/agent-DcC06SOO.mjs";import{agentChat as m}from"./packem_shared/agentChat-Cit2jdK_.mjs";import{agentState as a}from"./packem_shared/agentState-CBH9dKb7.mjs";import{agentToolEvents as x}from"./packem_shared/agentToolEvents-DSNEBf37.mjs";import{auth as i,authGate as u}from"./packem_shared/auth-BgwruT_M.mjs";import{LUNORA_CLIENT as s,injectLunoraClient as c,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-orUoJY7A.mjs";import{hydratePreloaded as Q}from"./packem_shared/hydratePreloaded-DYqgj4Y1.mjs";import{liveQuery as A}from"./packem_shared/liveQuery-DR3i-aOo.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-C1vVL3Nk.mjs";import{presence as K}from"./packem_shared/presence-BfPC_yqX.mjs";import{rateLimit as R}from"./packem_shared/rateLimit-B3h9qzh-.mjs";import{stream as _}from"./packem_shared/stream-CcjYdpzt.mjs";import{subscription as q}from"./packem_shared/subscription-CWp5w6K4.mjs";import{voiceAgent as z}from"./packem_shared/voiceAgent-CzyUcUKj.mjs";import{SKIP as D}from"@lunora/client/query";export{s as LUNORA_CLIENT,D as SKIP,e as agent,m as agentChat,a as agentState,x as agentToolEvents,i as auth,u as authGate,L as connectionStatus,v as flag,y as flags,Q as hydratePreloaded,b as infiniteQuery,c as injectLunoraClient,A as liveQuery,I as mutate,P as mutator,j as paginatedQuery,K as presence,l as provideLunora,R as rateLimit,_ as stream,q as subscription,z as voiceAgent};
+import{agent as t}from"./packem_shared/agent-DcC06SOO.mjs";import{agentChat as m}from"./packem_shared/agentChat-Cit2jdK_.mjs";import{agentState as f}from"./packem_shared/agentState-CBH9dKb7.mjs";import{agentToolEvents as n}from"./packem_shared/agentToolEvents-DSNEBf37.mjs";import{auth as i,authGate as u}from"./packem_shared/auth-BgwruT_M.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-orUoJY7A.mjs";import{hydratePreloaded as C}from"./packem_shared/hydratePreloaded-DYqgj4Y1.mjs";import{liveQuery as S}from"./packem_shared/liveQuery-DR3i-aOo.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-C1vVL3Nk.mjs";import{presence as K}from"./packem_shared/presence-BfPC_yqX.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-CcjYdpzt.mjs";import{subscription as z}from"./packem_shared/subscription-CWp5w6K4.mjs";import{voiceAgent as D}from"./packem_shared/voiceAgent-CzyUcUKj.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};

package/dist/packem_shared/runAction-BfiPq4Xz.mjs

@@ -0,0 +1 @@
+import{resolveLunoraClient as e}from"./LUNORA_CLIENT-B0toApHY.mjs";const l=(n,o,t={})=>{const{client:r,...c}=t;return e(r).action(n,o,c)};export{l as runAction};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/angular",
-  "version": "1.0.0-alpha.35",
+  "version": "1.0.0-alpha.36",
   "description": "Angular reactive adapter for Lunora — signal-based live queries and mutations",
   "keywords": [
     "angular",
@@ -53,7 +53,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.51",
+    "@lunora/client": "1.0.0-alpha.52",
     "@lunora/ratelimit": "1.0.0-alpha.23",
     "@visulima/storage-client": "1.0.2"
   },