@toyz/loom-rpc 0.3.4 → 0.5.0

package/dist/index.d.ts

@@ -6,7 +6,8 @@
  */
 export { rpc } from "./rpc";
 export { mutate } from "./mutate";
+export { stream, onStream, RPC_STREAMS } from "./stream";
 export { service, SERVICE_NAME } from "./service";
 export { RpcTransport, HttpTransport, RpcError } from "./transport";
-export type { RpcMethods, InferArgs, InferReturn, RpcQueryOptions, RpcMutator, RpcQuery, RpcRequest, RpcResponse, } from "./types";
+export type { RpcMethods, InferArgs, InferReturn, RpcQueryOptions, RpcStreamOptions, RpcMutator, RpcQuery, RpcStream, RpcRequest, RpcResponse, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGpE,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,UAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGpE,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -7,6 +7,7 @@
 // Decorators
 export { rpc } from "./rpc";
 export { mutate } from "./mutate";
+export { stream, onStream, RPC_STREAMS } from "./stream";
 export { service, SERVICE_NAME } from "./service";
 // Transport
 export { RpcTransport, HttpTransport, RpcError } from "./transport";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/stream.d.ts

@@ -0,0 +1,65 @@
+/**
+ * LoomRPC — @stream / @onStream decorators
+ *
+ * @stream — Auto-accessor decorator for server-push streams.
+ * @onStream — Method decorator that wires a stream handler on a LoomElement.
+ *
+ * ```ts
+ * import { stream, onStream } from "@toyz/loom-rpc";
+ *
+ * // eager (default) — opens automatically on connectedCallback
+ * @stream(ChatRouter, "messages", { fn: el => [el.roomId] })
+ * accessor chatMessages!: RpcStream<ChatMessage>;
+ *
+ * // callback-style (component)
+ * @onStream("chatMessages")
+ * onMessage(msg: ChatMessage) {
+ *   this.msgs.push(msg);
+ *   this.scheduleUpdate();
+ * }
+ *
+ * // direct iteration (service / advanced)
+ * for await (const msg of this.chatMessages) { ... }
+ *
+ * // manual — must call open() yourself
+ * @stream(ChatRouter, "history", { fn: el => [el.roomId], eager: false })
+ * accessor history!: RpcStream<ChatMessage>;
+ * this.history.open();
+ * ```
+ */
+import type { RpcMethods, RpcStream, RpcStreamOptions } from "./types";
+/** Symbol for inspect() introspection */
+export declare const RPC_STREAMS: import("@toyz/loom").LoomSymbol<unknown>;
+/**
+ * @stream(Router, method, opts?) — streaming auto-accessor decorator.
+ *
+ * Returns an `RpcStream<T>` which is also directly iterable:
+ *   `for await (const x of this.myStream) { ... }`
+ *
+ * By default (`eager: true`) the stream opens automatically in
+ * `connectedCallback`. Set `eager: false` and call `.open()` manually.
+ *
+ * Requires the registered `RpcTransport` to implement `stream()`.
+ */
+export declare function stream<TRouter extends object, TMethod extends RpcMethods<TRouter>>(router: new (...args: any[]) => TRouter, method: TMethod, opts?: RpcStreamOptions<TRouter, TMethod>): <This extends object>(_target: ClassAccessorDecoratorTarget<This, RpcStream<TRouter[TMethod] extends (...args: any[]) => AsyncIterable<infer U> ? U : TRouter[TMethod] extends (...args: any[]) => Promise<infer U_1> ? U_1 : unknown>>, context: ClassAccessorDecoratorContext<This, RpcStream<TRouter[TMethod] extends (...args: any[]) => AsyncIterable<infer U> ? U : TRouter[TMethod] extends (...args: any[]) => Promise<infer U_1> ? U_1 : unknown>>) => ClassAccessorDecoratorResult<This, RpcStream<TRouter[TMethod] extends (...args: any[]) => AsyncIterable<infer U> ? U : TRouter[TMethod] extends (...args: any[]) => Promise<infer U_1> ? U_1 : unknown>>;
+/** @internal — exported so tests can create state directly without decorators */
+export declare function createStreamState<T>(routerName: string, method: string, opts: RpcStreamOptions<any, any> | undefined, scheduleUpdate: () => void, host: any): RpcStream<T> & {
+    _subscribe(cb: (e: T) => void): () => void;
+};
+/**
+ * Wire a method as a handler for an `RpcStream` accessor on a `LoomElement`.
+ *
+ * - Subscribes to the shared pump in `connectedCallback` (via `CONNECT_HOOKS`)
+ * - Auto-opens the stream if still idle
+ * - Unsubscribes and closes on disconnect (cleanup fn returned to `CONNECT_HOOKS`)
+ *
+ * ```ts
+ * @onStream("chatMessages")
+ * onMessage(msg: ChatMessage) {
+ *   this.msgs.push(msg);
+ *   this.scheduleUpdate();
+ * }
+ * ```
+ */
+export declare function onStream(accessorName: string): <This extends object>(_target: (this: This, value: any) => void, context: ClassMethodDecoratorContext<This>) => void;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIvE,yCAAyC;AACzC,eAAO,MAAM,WAAW,0CAA8B,CAAC;AAMvD;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CACpB,OAAO,SAAS,MAAM,EACtB,OAAO,SAAS,UAAU,CAAC,OAAO,CAAC,EAEnC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,EACvC,MAAM,EAAE,OAAO,EACf,IAAI,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,IAUjC,IAAI,SAAS,MAAM,EACzB,SAAS,4BAA4B,CAAC,IAAI,EAAE,SAAS,oCATX,GAAG,EAAE,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC,0CAErC,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,GAAC,CAAC,iBAOP,CAAC,EACzD,SAAS,6BAA6B,CAAC,IAAI,EAAE,SAAS,oCAVZ,GAAG,EAAE,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC,0CAErC,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,GAAC,CAAC,iBAQN,CAAC,KACzD,4BAA4B,CAAC,IAAI,EAAE,SAAS,oCAXH,GAAG,EAAE,KAAK,aAAa,CAAC,MAAM,CAAC,CAAC,0CAErC,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,GAAC,CAAC,iBASf,CAAC,CAuCpD;AAMD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,EAC5C,cAAc,EAAE,MAAM,IAAI,EAC1B,IAAI,EAAE,GAAG,GACR,SAAS,CAAC,CAAC,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CAAE,CAmK/D;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,YAAY,EAAE,MAAM,IAC1B,IAAI,SAAS,MAAM,EAClC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,EACzC,SAAS,2BAA2B,CAAC,IAAI,CAAC,UA+B7C"}

package/dist/stream.js

@@ -0,0 +1,289 @@
+/**
+ * LoomRPC — @stream / @onStream decorators
+ *
+ * @stream — Auto-accessor decorator for server-push streams.
+ * @onStream — Method decorator that wires a stream handler on a LoomElement.
+ *
+ * ```ts
+ * import { stream, onStream } from "@toyz/loom-rpc";
+ *
+ * // eager (default) — opens automatically on connectedCallback
+ * @stream(ChatRouter, "messages", { fn: el => [el.roomId] })
+ * accessor chatMessages!: RpcStream<ChatMessage>;
+ *
+ * // callback-style (component)
+ * @onStream("chatMessages")
+ * onMessage(msg: ChatMessage) {
+ *   this.msgs.push(msg);
+ *   this.scheduleUpdate();
+ * }
+ *
+ * // direct iteration (service / advanced)
+ * for await (const msg of this.chatMessages) { ... }
+ *
+ * // manual — must call open() yourself
+ * @stream(ChatRouter, "history", { fn: el => [el.roomId], eager: false })
+ * accessor history!: RpcStream<ChatMessage>;
+ * this.history.open();
+ * ```
+ */
+import { app, createSymbol } from "@toyz/loom";
+import { Reactive } from "@toyz/loom/store";
+import { RpcTransport } from "./transport";
+import { resolveServiceName } from "./service";
+/** Symbol for inspect() introspection */
+export const RPC_STREAMS = createSymbol("rpc:streams");
+// ──────────────────────────────────────────────────────────────────────────────
+// @stream decorator
+// ──────────────────────────────────────────────────────────────────────────────
+/**
+ * @stream(Router, method, opts?) — streaming auto-accessor decorator.
+ *
+ * Returns an `RpcStream<T>` which is also directly iterable:
+ *   `for await (const x of this.myStream) { ... }`
+ *
+ * By default (`eager: true`) the stream opens automatically in
+ * `connectedCallback`. Set `eager: false` and call `.open()` manually.
+ *
+ * Requires the registered `RpcTransport` to implement `stream()`.
+ */
+export function stream(router, method, opts) {
+    const routerName = resolveServiceName(router);
+    return (_target, context) => {
+        const stateKey = Symbol(`stream:${String(context.name)}`);
+        const traceKey = Symbol(`stream:trace:${String(context.name)}`);
+        const accessorName = String(context.name);
+        context.addInitializer(function () {
+            const ctor = this.constructor;
+            ctor[RPC_STREAMS.key] ??= [];
+            ctor[RPC_STREAMS.key].push({
+                accessor: accessorName,
+                router: routerName,
+                method: String(method),
+            });
+        });
+        return {
+            get() {
+                if (!this[stateKey]) {
+                    const sentinel = new Reactive(0);
+                    this[traceKey] = sentinel;
+                    sentinel.subscribe(() => this.scheduleUpdate?.());
+                    const notify = () => { sentinel.set((v) => v + 1); };
+                    this[stateKey] = createStreamState(routerName, method, opts, notify, this);
+                }
+                this[traceKey].value;
+                return this[stateKey];
+            },
+            set(_val) {
+                // State is managed internally
+            },
+        };
+    };
+}
+// ──────────────────────────────────────────────────────────────────────────────
+// Internal state factory
+// ──────────────────────────────────────────────────────────────────────────────
+/** @internal — exported so tests can create state directly without decorators */
+export function createStreamState(routerName, method, opts, scheduleUpdate, host) {
+    let status = "idle";
+    let error = null;
+    // Subscriber callbacks registered by @onStream — fed by the shared pump
+    const subscribers = new Set();
+    // Active iterator — held so close() can terminate the pump
+    let activeIterator = null;
+    function setStatus(s) {
+        status = s;
+        scheduleUpdate();
+    }
+    function getTransport() {
+        try {
+            return { transport: app.get(RpcTransport), ok: true };
+        }
+        catch {
+            return {
+                ok: false,
+                error: new Error("[LoomRPC] No RpcTransport registered. " +
+                    "Call app.use(RpcTransport, ...) before app.start()."),
+            };
+        }
+    }
+    /**
+     * Shared pump — one connection per RpcStream, fans out to all @onStream subscribers.
+     * Called by open(). No-op if already streaming.
+     */
+    async function pump() {
+        if (status === "streaming")
+            return;
+        const result = getTransport();
+        if (!result.ok) {
+            error = result.error;
+            setStatus("error");
+            return;
+        }
+        const { transport } = result;
+        if (!transport.stream) {
+            error = new Error("[LoomRPC] The registered RpcTransport does not implement stream(). " +
+                "Use a transport that supports streaming (e.g. WsTransport).");
+            setStatus("error");
+            return;
+        }
+        const args = opts?.fn ? opts.fn(host) : [];
+        let iterable;
+        try {
+            iterable = transport.stream(routerName, method, args);
+        }
+        catch (e) {
+            error = e instanceof Error ? e : new Error(String(e));
+            setStatus("error");
+            return;
+        }
+        setStatus("streaming");
+        try {
+            activeIterator = iterable[Symbol.asyncIterator]();
+            while (true) {
+                const { value, done } = await activeIterator.next();
+                if (done)
+                    break;
+                for (const cb of subscribers)
+                    cb(value);
+            }
+            setStatus("closed");
+        }
+        catch (e) {
+            if (status !== "closed") {
+                error = e instanceof Error ? e : new Error(String(e));
+                setStatus("error");
+            }
+        }
+        finally {
+            activeIterator = null;
+        }
+    }
+    /**
+     * Raw iterable — each call creates an independent generator, separate from
+     * the pump. Used for `for await (const x of stream)` and `.events`.
+     */
+    function makeIterable() {
+        return {
+            [Symbol.asyncIterator]() {
+                const r = getTransport();
+                if (!r.ok) {
+                    return {
+                        async next() {
+                            error = r.error;
+                            setStatus("error");
+                            return { value: undefined, done: true };
+                        },
+                    };
+                }
+                const { transport } = r;
+                if (!transport.stream) {
+                    return {
+                        async next() {
+                            error = new Error("[LoomRPC] Transport does not implement stream().");
+                            setStatus("error");
+                            return { value: undefined, done: true };
+                        },
+                    };
+                }
+                const args = opts?.fn ? opts.fn(host) : [];
+                setStatus("streaming");
+                const inner = transport.stream(routerName, method, args)[Symbol.asyncIterator]();
+                return {
+                    async next() {
+                        try {
+                            const result = await inner.next();
+                            if (result.done)
+                                setStatus("closed");
+                            return result;
+                        }
+                        catch (e) {
+                            if (status !== "closed") {
+                                error = e instanceof Error ? e : new Error(String(e));
+                                setStatus("error");
+                            }
+                            return { value: undefined, done: true };
+                        }
+                    },
+                    return() {
+                        setStatus("closed");
+                        return inner.return?.() ?? Promise.resolve({ value: undefined, done: true });
+                    },
+                };
+            },
+        };
+    }
+    const iterable = makeIterable();
+    const state = {
+        get status() { return status; },
+        get error() { return error; },
+        open() { pump(); },
+        close() {
+            if (activeIterator) {
+                activeIterator.return?.();
+                activeIterator = null;
+            }
+            setStatus("closed");
+        },
+        get events() { return iterable; },
+        [Symbol.asyncIterator]() {
+            return iterable[Symbol.asyncIterator]();
+        },
+        /** @internal — used by @onStream */
+        _subscribe(cb) {
+            subscribers.add(cb);
+            return () => subscribers.delete(cb);
+        },
+    };
+    return state;
+}
+// ──────────────────────────────────────────────────────────────────────────────
+// @onStream decorator
+// ──────────────────────────────────────────────────────────────────────────────
+/** @internal — same singleton key that LoomElement.connectedCallback reads */
+const CONNECT_HOOKS = createSymbol("connect:hooks");
+/**
+ * Wire a method as a handler for an `RpcStream` accessor on a `LoomElement`.
+ *
+ * - Subscribes to the shared pump in `connectedCallback` (via `CONNECT_HOOKS`)
+ * - Auto-opens the stream if still idle
+ * - Unsubscribes and closes on disconnect (cleanup fn returned to `CONNECT_HOOKS`)
+ *
+ * ```ts
+ * @onStream("chatMessages")
+ * onMessage(msg: ChatMessage) {
+ *   this.msgs.push(msg);
+ *   this.scheduleUpdate();
+ * }
+ * ```
+ */
+export function onStream(accessorName) {
+    return function (_target, context) {
+        const handlerKey = context.name;
+        context.addInitializer(function () {
+            // Use the same CONNECT_HOOKS array that LoomElement.connectedCallback reads.
+            // createSymbol is a singleton registry so "connect:hooks" always resolves
+            // to the same LoomSymbol regardless of which package calls it.
+            if (!this[CONNECT_HOOKS.key])
+                this[CONNECT_HOOKS.key] = [];
+            this[CONNECT_HOOKS.key].push((el) => {
+                const s = el[accessorName];
+                if (!s)
+                    return;
+                if (typeof s._subscribe === "function") {
+                    const unsub = s._subscribe((event) => {
+                        el[handlerKey].call(el, event);
+                    });
+                    // Return cleanup — LoomElement.disconnectedCallback calls these
+                    return () => {
+                        unsub();
+                        el[accessorName]?.close();
+                    };
+                }
+                if (s.status === "idle")
+                    s.open();
+            });
+        });
+    };
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -15,6 +15,13 @@
  */
 export declare abstract class RpcTransport {
     abstract call<T>(router: string, method: string, args: any[], signal?: AbortSignal): Promise<T>;
+    /**
+     * Optional — implement to support @stream / RpcStream.
+     * Returns an AsyncIterable the consumer drives via `for await`.
+     * The transport controls the connection (WebSocket, SSE, etc.).
+     * Teardown happens automatically when the iterator is returned/thrown.
+     */
+    stream?<T>(router: string, method: string, args: any[]): AsyncIterable<T>;
 }
 /**
  * Default HTTP transport — POST JSON to `/rpc/{router}/{method}`.

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,8BAAsB,YAAY;IAChC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAChG;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,SAAS,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAO5D,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAsC7F;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,MAAM,CAAC,EAAE,MAAM;aACf,MAAM,CAAC,EAAE,MAAM;aACf,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;gBAJ7B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,8BAAsB,YAAY;IAChC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IAE/F;;;;;OAKG;IACH,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC;CAC1E;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,OAAO,SAAS,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAO5D,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;CAsC7F;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,MAAM,CAAC,EAAE,MAAM;aACf,MAAM,CAAC,EAAE,MAAM;aACf,MAAM,CAAC,EAAE,MAAM;aACf,IAAI,CAAC,EAAE,MAAM;gBAJ7B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC"}

package/dist/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,MAAM,OAAgB,YAAY;CAEjC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC5B,OAAO,CAAS;IAChB,OAAO,CAAyB;IAEjD,YAAY,OAAO,GAAG,MAAM,EAAE,UAAkC,EAAE;QAChE,KAAK,EAAE,CAAC;QACR,uBAAuB;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,MAAc,EAAE,MAAc,EAAE,IAAW,EAAE,MAAoB;QAC7E,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QAClD,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,CAAC;QAElC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,IAAI,CAAC,OAAO;aAChB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,IAAI,QAAQ,CAChB,OAAO,MAAM,IAAI,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,EACvD,GAAG,CAAC,MAAM,EACV,MAAM,EACN,MAAM,CACP,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAmB,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAElD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,QAAQ,CAChB,QAAQ,CAAC,KAAK,CAAC,OAAO,EACtB,SAAS,EACT,MAAM,EACN,MAAM,EACN,QAAQ,CAAC,KAAK,CAAC,IAAI,CACpB,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAS,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,MAAe,EACf,MAAe,EACf,MAAe,EACf,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,WAAM,GAAN,MAAM,CAAS;QACf,WAAM,GAAN,MAAM,CAAS;QACf,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;GAIG;AACH,MAAM,OAAgB,YAAY;CAUjC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC5B,OAAO,CAAS;IAChB,OAAO,CAAyB;IAEjD,YAAY,OAAO,GAAG,MAAM,EAAE,UAAkC,EAAE;QAChE,KAAK,EAAE,CAAC;QACR,uBAAuB;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,MAAc,EAAE,MAAc,EAAE,IAAW,EAAE,MAAoB;QAC7E,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QAClD,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,CAAC;QAElC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,IAAI,CAAC,OAAO;aAChB;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,IAAI,QAAQ,CAChB,OAAO,MAAM,IAAI,MAAM,YAAY,GAAG,CAAC,MAAM,IAAI,IAAI,EAAE,EACvD,GAAG,CAAC,MAAM,EACV,MAAM,EACN,MAAM,CACP,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAmB,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAElD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,QAAQ,CAChB,QAAQ,CAAC,KAAK,CAAC,OAAO,EACtB,SAAS,EACT,MAAM,EACN,MAAM,EACN,QAAQ,CAAC,KAAK,CAAC,IAAI,CACpB,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAS,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,MAAe,EACf,MAAe,EACf,MAAe,EACf,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,WAAM,GAAN,MAAM,CAAS;QACf,WAAM,GAAN,MAAM,CAAS;QACf,WAAM,GAAN,MAAM,CAAS;QACf,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/types.d.ts

@@ -57,6 +57,51 @@ export interface RpcMutator<TArgs extends any[], TReturn> {
     /** Reset the mutator state (clear data, error, loading) */
     reset(): void;
 }
+/**
+ * Configuration for @stream decorator.
+ */
+export interface RpcStreamOptions<TRouter, TMethod extends RpcMethods<TRouter>> {
+    /** Extract procedure args from element/service state. Called once when the stream opens. */
+    fn?: (el: any) => InferArgs<TRouter, TMethod>;
+    /**
+     * Whether to open the stream automatically when the element connects.
+     * When false, call `stream.open()` manually to start receiving events.
+     * Default: true
+     */
+    eager?: boolean;
+}
+/**
+ * State container for a server-push stream.
+ *
+ * Implements `AsyncIterable<T>` so you can iterate directly:
+ * ```ts
+ * for await (const msg of this.chatMessages) { ... }
+ * ```
+ * Or use `.events` for the same iterable, or `.open()` + `@onStream` for
+ * component-level callback wiring.
+ */
+export interface RpcStream<T> extends AsyncIterable<T> {
+    /** Current state of the stream connection */
+    readonly status: "idle" | "streaming" | "error" | "closed";
+    /** Error if status === "error", otherwise null */
+    readonly error: Error | null;
+    /**
+     * Open the stream and start pumping events to `@onStream` callbacks.
+     * Called automatically on connect when `eager: true` (the default).
+     * Call manually when `eager: false`.
+     */
+    open(): void;
+    /** Close the stream and release the connection */
+    close(): void;
+    /**
+     * Named alias for `[Symbol.asyncIterator]()` — same iterable, explicit name.
+     * Prefer iterating the stream directly (`for await (const x of stream)`)
+     * unless you need to hold a reference to the iterable separately.
+     */
+    readonly events: AsyncIterable<T>;
+    /** Required by AsyncIterable — delegates to .events */
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
 /**
  * State container for a query — auto-fetched, reactive, with SWR.
  * Extends ApiState for backwards compatibility.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK;CACjE,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IACxC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAC1C,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GACrD,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,EAAE,OAAO,SAAS,UAAU,CAAC,OAAO,CAAC;IAC3E,mFAAmF;IACnF,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO;IACtD,oDAAoD;IACpD,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,2DAA2D;IAC3D,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,CAAE,SAAQ,QAAQ,CAAC,OAAO,CAAC;CAKhF;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,8 +1,2 @@
-/**
- * LoomRPC — Type utilities
- *
- * Extract method names, parameter types, and return types from contract classes.
- * Powers the type-safe @rpc and @mutate decorators.
- */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toyz/loom-rpc",
-  "version": "0.3.4",
+  "version": "0.5.0",
   "type": "module",
   "description": "Type-safe, decorator-driven RPC for Loom — server-agnostic, transport-swappable",
   "license": "MIT",