@toyz/loom-rpc 0.1.0

package/README.md

@@ -0,0 +1,245 @@
+# @toyz/loom-rpc
+
+Type-safe, decorator-driven RPC for [Loom](https://github.com/Toyz/loom). Server-agnostic, transport-swappable.
+
+```
+npm install @toyz/loom-rpc
+```
+
+**One dependency:** `@toyz/loom`. That's it.
+
+---
+
+## Quick Start
+
+### 1. Define a Contract
+
+```ts
+// contracts/user.ts — shared between client and server
+export class UserRouter {
+  getUser(id: string): User {
+    return null!;
+  }
+  listUsers(page: number, limit: number): User[] {
+    return null!;
+  }
+  updateProfile(data: ProfileUpdate): User {
+    return null!;
+  }
+}
+```
+
+The class is the type contract. Methods have dummy bodies — they exist for TypeScript to extract parameter and return types. Nothing runs. Nothing ships to the client.
+
+### 2. Register a Transport
+
+```ts
+// main.tsx
+import { app } from "@toyz/loom";
+import { RpcTransport, HttpTransport } from "@toyz/loom-rpc";
+
+app.use(RpcTransport, new HttpTransport());
+// or: new HttpTransport("https://api.example.com/rpc")
+
+app.start();
+```
+
+### 3. Query with `@rpc`
+
+```ts
+import { rpc } from "@toyz/loom-rpc";
+import { UserRouter } from "../contracts/user";
+
+@component("user-profile")
+class UserProfile extends LoomElement {
+  @prop({ param: "id" }) accessor userId!: string;
+
+  @rpc(UserRouter, "getUser", {
+    fn: el => [el.userId],   // args from element state — re-fetches on change
+    staleTime: 60_000,       // SWR: cache for 1 minute
+  })
+  accessor user!: ApiState<User>;
+
+  update() {
+    return this.user.match({
+      loading: () => <div>Loading...</div>,
+      ok: (user) => <h1>{user.name}</h1>,
+      err: (e) => <div>Error: {e.message}</div>,
+    });
+  }
+}
+```
+
+### 4. Mutate with `@mutate`
+
+```ts
+import { mutate } from "@toyz/loom-rpc";
+
+@component("edit-profile")
+class EditProfile extends LoomElement {
+  @mutate(UserRouter, "updateProfile")
+  accessor save!: RpcMutator<[ProfileUpdate], User>;
+
+  async handleSubmit(data: ProfileUpdate) {
+    try {
+      const user = await this.save.call(data);
+      console.log("Saved:", user.name);
+    } catch (e) {
+      console.error("Failed:", e);
+    }
+  }
+
+  update() {
+    return (
+      <form onSubmit={() => this.handleSubmit({ name: "New Name" })}>
+        <button disabled={this.save.loading}>
+          {this.save.loading ? "Saving..." : "Save"}
+        </button>
+      </form>
+    );
+  }
+}
+```
+
+---
+
+## API
+
+### `@rpc(Router, method, opts?)`
+
+Auto-accessor decorator for queries. Returns `ApiState<T>` with `.match()`, `.unwrap()`, `.refetch()`, `.invalidate()`.
+
+| Option      | Type           | Default | Description                               |
+| ----------- | -------------- | ------- | ----------------------------------------- |
+| `fn`        | `(el) => Args` | `[]`    | Extract procedure args from element state |
+| `staleTime` | `number`       | `0`     | SWR cache duration (ms)                   |
+| `eager`     | `boolean`      | `true`  | Fetch on connect                          |
+| `retry`     | `number`       | `0`     | Retry count with exponential backoff      |
+
+### `@mutate(Router, method)`
+
+Auto-accessor decorator for mutations. Returns `RpcMutator<Args, Return>`.
+
+| Property         | Type             | Description            |
+| ---------------- | ---------------- | ---------------------- |
+| `.call(...args)` | `Promise<T>`     | Execute the mutation   |
+| `.loading`       | `boolean`        | In-flight state        |
+| `.error`         | `Error \| null`  | Last error             |
+| `.data`          | `T \| undefined` | Last successful result |
+| `.reset()`       | `void`           | Clear state            |
+
+### `RpcTransport`
+
+Abstract class — implement to control how RPC calls reach the server.
+
+```ts
+abstract class RpcTransport {
+  abstract call<T>(router: string, method: string, args: any[]): Promise<T>;
+}
+```
+
+### `HttpTransport`
+
+Default transport — `POST /rpc/{Router}/{Method}` with JSON body.
+
+```ts
+new HttpTransport(baseUrl?: string, headers?: Record<string, string>)
+```
+
+### `RpcError`
+
+Structured error with `.status`, `.router`, `.method`, `.code`.
+
+---
+
+## Wire Protocol
+
+```
+POST /rpc/{RouterName}/{MethodName}
+Content-Type: application/json
+
+Request:  { "args": [arg1, arg2, ...] }
+Response: { "data": <return value> }
+Error:    { "error": { "message": "...", "code": "..." } }
+```
+
+**Any server that follows this convention works.** Go, Rust, Python, Express, Hono, Cloudflare Workers — anything that accepts HTTP POST and returns JSON.
+
+---
+
+## Custom Transports
+
+Swap HTTP for WebSocket, gRPC-Web, or anything else:
+
+```ts
+class WsTransport extends RpcTransport {
+  constructor(private ws: WebSocket) {
+    super();
+  }
+
+  async call<T>(router: string, method: string, args: any[]): Promise<T> {
+    // Your WebSocket RPC logic here
+  }
+}
+
+app.use(RpcTransport, new WsTransport(ws));
+```
+
+One DI swap. Every `@rpc` and `@mutate` in the app uses the new transport. No component changes.
+
+---
+
+## Testing
+
+```ts
+import { MockTransport } from "@toyz/loom-rpc/testing";
+
+const transport = new MockTransport();
+
+// Static mocks
+transport.mock("UserRouter", "getUser", { id: "1", name: "Alice" });
+
+// Dynamic mocks
+transport.mock("UserRouter", "getUser", (id: string) => ({
+  id,
+  name: `User ${id}`,
+}));
+
+// Error mocks
+transport.mockError("UserRouter", "deleteUser", new Error("Forbidden"));
+
+// Delay simulation
+transport.delay("UserRouter", "getUser", 500);
+
+// Register and go
+app.use(RpcTransport, transport);
+
+// Assertions
+transport.assertCalled("UserRouter", "getUser", ["1"]);
+transport.assertNotCalled("UserRouter", "deleteUser");
+console.log(transport.history); // [{ router, method, args }]
+```
+
+---
+
+## Type Safety
+
+Everything is inferred from the contract class:
+
+```ts
+@rpc(UserRouter, "getUser", { fn: el => [el.userId] })
+//                 ↑ autocompleted        ↑ must be [string]
+accessor user!: ApiState<User>;
+//                       ↑ inferred from UserRouter.getUser return type
+```
+
+- Method names are autocompleted and type-checked
+- Argument types are inferred from the contract method parameters
+- Return types flow into `ApiState<T>` automatically
+- Pass the wrong types? Compile error.
+
+---
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LoomRPC — Barrel exports
+ *
+ * Type-safe, decorator-driven RPC for Loom.
+ * Server-agnostic, transport-swappable.
+ */
+export { rpc } from "./rpc";
+export { mutate } from "./mutate";
+export { RpcTransport, HttpTransport, RpcError } from "./transport";
+export type { RpcMethods, InferArgs, InferReturn, RpcQueryOptions, RpcMutator, RpcRequest, RpcResponse, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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;AAGlC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGpE,YAAY,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * LoomRPC — Barrel exports
+ *
+ * Type-safe, decorator-driven RPC for Loom.
+ * Server-agnostic, transport-swappable.
+ */
+// Decorators
+export { rpc } from "./rpc";
+export { mutate } from "./mutate";
+// Transport
+export { RpcTransport, HttpTransport, RpcError } from "./transport";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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;AAElC,YAAY;AACZ,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/mutate.d.ts

@@ -0,0 +1,31 @@
+/**
+ * LoomRPC — @mutate mutation decorator
+ *
+ * Auto-accessor decorator for type-safe RPC mutations.
+ * Unlike @rpc (queries), mutations are not auto-fetched —
+ * you call them manually via .call().
+ *
+ * ```ts
+ * @mutate(UserRouter, "updateProfile")
+ * accessor save!: RpcMutator<[ProfileUpdate], User>;
+ * ```
+ */
+import type { RpcMethods, InferArgs, InferReturn, RpcMutator } from "./types";
+/**
+ * @mutate(Router, method) — Mutation decorator
+ *
+ * Returns an RpcMutator with .call(), .loading, .error, .data.
+ *
+ * ```ts
+ * @mutate(UserRouter, "updateProfile")
+ * accessor save!: RpcMutator<[ProfileUpdate], User>;
+ *
+ * // In a handler:
+ * const result = await this.save.call({ name: "New Name" });
+ * ```
+ *
+ * @param router - The contract class (used for router name + type inference)
+ * @param method - The method name on the contract to call
+ */
+export declare function mutate<TRouter extends object, TMethod extends RpcMethods<TRouter>>(router: new (...args: any[]) => TRouter, method: TMethod): <This extends object>(_target: ClassAccessorDecoratorTarget<This, RpcMutator<InferArgs<TRouter, TMethod> extends any[] ? InferArgs<TRouter, TMethod> : [InferArgs<TRouter, TMethod>], InferReturn<TRouter, TMethod>>>, context: ClassAccessorDecoratorContext<This, RpcMutator<InferArgs<TRouter, TMethod> extends any[] ? InferArgs<TRouter, TMethod> : [InferArgs<TRouter, TMethod>], InferReturn<TRouter, TMethod>>>) => ClassAccessorDecoratorResult<This, RpcMutator<InferArgs<TRouter, TMethod> extends any[] ? InferArgs<TRouter, TMethod> : [InferArgs<TRouter, TMethod>], InferReturn<TRouter, TMethod>>>;
+//# sourceMappingURL=mutate.d.ts.map

package/dist/mutate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.d.ts","sourceRoot":"","sources":["../src/mutate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG9E;;;;;;;;;;;;;;;GAeG;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,IAMP,IAAI,SAAS,MAAM,EACzB,SAAS,4BAA4B,CAAC,IAAI,EAAE,UAAU,CAAC,oCAAc,GAAG,EAAE,iCAAW,6BAAO,gCAAU,CAAC,EACvG,SAAS,6BAA6B,CAAC,IAAI,EAAE,UAAU,CAAC,oCAAc,GAAG,EAAE,iCAAW,6BAAO,gCAAU,CAAC,KACvG,4BAA4B,CAAC,IAAI,EAAE,UAAU,CAAC,oCAAc,GAAG,EAAE,iCAAW,6BAAO,gCAAU,CAAC,CA2BlG"}

package/dist/mutate.js

@@ -0,0 +1,107 @@
+/**
+ * LoomRPC — @mutate mutation decorator
+ *
+ * Auto-accessor decorator for type-safe RPC mutations.
+ * Unlike @rpc (queries), mutations are not auto-fetched —
+ * you call them manually via .call().
+ *
+ * ```ts
+ * @mutate(UserRouter, "updateProfile")
+ * accessor save!: RpcMutator<[ProfileUpdate], User>;
+ * ```
+ */
+import { app } from "@toyz/loom";
+import { Reactive } from "@toyz/loom/store";
+import { RpcTransport } from "./transport";
+/**
+ * @mutate(Router, method) — Mutation decorator
+ *
+ * Returns an RpcMutator with .call(), .loading, .error, .data.
+ *
+ * ```ts
+ * @mutate(UserRouter, "updateProfile")
+ * accessor save!: RpcMutator<[ProfileUpdate], User>;
+ *
+ * // In a handler:
+ * const result = await this.save.call({ name: "New Name" });
+ * ```
+ *
+ * @param router - The contract class (used for router name + type inference)
+ * @param method - The method name on the contract to call
+ */
+export function mutate(router, method) {
+    const routerName = router.name;
+    return (_target, context) => {
+        const stateKey = Symbol(`mutate:${String(context.name)}`);
+        const traceKey = Symbol(`mutate:trace:${String(context.name)}`);
+        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] = createMutator(routerName, method, notify);
+                }
+                // Read sentinel so traced update() sees the dependency
+                this[traceKey].value;
+                return this[stateKey];
+            },
+            set(_val) {
+                // State is managed internally
+            },
+        };
+    };
+}
+/**
+ * Internal mutator factory.
+ */
+function createMutator(routerName, method, scheduleUpdate) {
+    let data;
+    let error = null;
+    let loading = false;
+    return {
+        async call(...args) {
+            let transport;
+            try {
+                transport = app.get(RpcTransport);
+            }
+            catch {
+                throw new Error("[LoomRPC] No RpcTransport registered. " +
+                    "Call app.use(RpcTransport, new HttpTransport()) before app.start().");
+            }
+            loading = true;
+            error = null;
+            scheduleUpdate();
+            try {
+                data = await transport.call(routerName, method, args);
+                loading = false;
+                error = null;
+                scheduleUpdate();
+                return data;
+            }
+            catch (e) {
+                loading = false;
+                error = e instanceof Error ? e : new Error(String(e));
+                scheduleUpdate();
+                throw error;
+            }
+        },
+        get loading() {
+            return loading;
+        },
+        get error() {
+            return error;
+        },
+        get data() {
+            return data;
+        },
+        reset() {
+            data = undefined;
+            error = null;
+            loading = false;
+            scheduleUpdate();
+        },
+    };
+}
+//# sourceMappingURL=mutate.js.map

package/dist/mutate.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,36 @@
+/**
+ * LoomRPC — @rpc query decorator
+ *
+ * Auto-accessor decorator for type-safe RPC queries.
+ * Reuses Loom's ApiState pattern under the hood.
+ *
+ * ```ts
+ * @rpc(UserRouter, "getUser", {
+ *   fn: el => [el.userId],
+ *   staleTime: 60_000,
+ * })
+ * accessor user!: ApiState<User>;
+ * ```
+ *
+ * The contract class is passed as a runtime value (not just a type)
+ * so the router name survives TypeScript erasure.
+ */
+import type { ApiState } from "@toyz/loom";
+import type { RpcMethods, InferReturn, RpcQueryOptions } from "./types";
+/**
+ * @rpc(Router, method, opts?) — Query decorator
+ *
+ * Fetches data from the server via the registered RpcTransport.
+ * Returns an ApiState<T> with .match(), .unwrap(), .refetch(), etc.
+ *
+ * ```ts
+ * @rpc(UserRouter, "getUser", { fn: el => [el.userId], staleTime: 60_000 })
+ * accessor user!: ApiState<User>;
+ * ```
+ *
+ * @param router - The contract class (used for router name + type inference)
+ * @param method - The method name on the contract to call
+ * @param opts - Optional configuration (fn, staleTime, retry, eager)
+ */
+export declare function rpc<TRouter extends object, TMethod extends RpcMethods<TRouter>>(router: new (...args: any[]) => TRouter, method: TMethod, opts?: RpcQueryOptions<TRouter, TMethod>): <This extends object>(_target: ClassAccessorDecoratorTarget<This, ApiState<InferReturn<TRouter, TMethod>>>, context: ClassAccessorDecoratorContext<This, ApiState<InferReturn<TRouter, TMethod>>>) => ClassAccessorDecoratorResult<This, ApiState<InferReturn<TRouter, TMethod>>>;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGxE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,GAAG,CACjB,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,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAKhC,IAAI,SAAS,MAAM,EACzB,SAAS,4BAA4B,CAAC,IAAI,EAAE,QAAQ,+BAAS,CAAC,EAC9D,SAAS,6BAA6B,CAAC,IAAI,EAAE,QAAQ,+BAAS,CAAC,KAC9D,4BAA4B,CAAC,IAAI,EAAE,QAAQ,+BAAS,CAAC,CA6BzD"}

package/dist/rpc.js

@@ -0,0 +1,205 @@
+/**
+ * LoomRPC — @rpc query decorator
+ *
+ * Auto-accessor decorator for type-safe RPC queries.
+ * Reuses Loom's ApiState pattern under the hood.
+ *
+ * ```ts
+ * @rpc(UserRouter, "getUser", {
+ *   fn: el => [el.userId],
+ *   staleTime: 60_000,
+ * })
+ * accessor user!: ApiState<User>;
+ * ```
+ *
+ * The contract class is passed as a runtime value (not just a type)
+ * so the router name survives TypeScript erasure.
+ */
+import { app } from "@toyz/loom";
+import { Reactive } from "@toyz/loom/store";
+import { LoomResult } from "@toyz/loom";
+import { RpcTransport } from "./transport";
+/**
+ * @rpc(Router, method, opts?) — Query decorator
+ *
+ * Fetches data from the server via the registered RpcTransport.
+ * Returns an ApiState<T> with .match(), .unwrap(), .refetch(), etc.
+ *
+ * ```ts
+ * @rpc(UserRouter, "getUser", { fn: el => [el.userId], staleTime: 60_000 })
+ * accessor user!: ApiState<User>;
+ * ```
+ *
+ * @param router - The contract class (used for router name + type inference)
+ * @param method - The method name on the contract to call
+ * @param opts - Optional configuration (fn, staleTime, retry, eager)
+ */
+export function rpc(router, method, opts) {
+    const routerName = router.name;
+    return (_target, context) => {
+        const stateKey = Symbol(`rpc:${String(context.name)}`);
+        const traceKey = Symbol(`rpc:trace:${String(context.name)}`);
+        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] = createRpcState(routerName, method, opts, notify, this);
+                }
+                // Read sentinel so traced update() sees the dependency
+                this[traceKey].value;
+                return this[stateKey];
+            },
+            set(_val) {
+                // State is managed internally
+            },
+        };
+    };
+}
+/**
+ * Internal state factory — mirrors createApiState but uses RpcTransport.
+ */
+function createRpcState(routerName, method, opts, scheduleUpdate, host) {
+    let data;
+    let error;
+    let loading = true;
+    let stale = false;
+    let lastFetchTime = 0;
+    let lastArgs;
+    let fetching = false;
+    const staleTime = opts?.staleTime ?? 0;
+    const maxRetries = opts?.retry ?? 0;
+    const eager = opts?.eager ?? true;
+    async function runFetch() {
+        let transport;
+        try {
+            transport = app.get(RpcTransport);
+        }
+        catch {
+            error = new Error("[LoomRPC] No RpcTransport registered. " +
+                "Call app.use(RpcTransport, new HttpTransport()) before app.start().");
+            loading = false;
+            scheduleUpdate();
+            return;
+        }
+        // Resolve args from element state
+        const args = opts?.fn ? opts.fn(host) : [];
+        // Check if args changed (SWR key)
+        const argsKey = JSON.stringify(args);
+        if (argsKey === lastArgs && !stale && data !== undefined && !fetching) {
+            return; // Same args, data is fresh — skip
+        }
+        lastArgs = argsKey;
+        loading = data === undefined; // SWR: only show loading if no cached data
+        error = undefined;
+        stale = false;
+        fetching = true;
+        scheduleUpdate();
+        let attempt = 0;
+        while (true) {
+            try {
+                data = await transport.call(routerName, method, args);
+                error = undefined;
+                loading = false;
+                fetching = false;
+                lastFetchTime = Date.now();
+                scheduleUpdate();
+                return;
+            }
+            catch (e) {
+                attempt++;
+                if (attempt > maxRetries) {
+                    error = e instanceof Error ? e : new Error(String(e));
+                    loading = false;
+                    fetching = false;
+                    scheduleUpdate();
+                    return;
+                }
+                // Exponential backoff: 200ms, 400ms, 800ms...
+                await new Promise((r) => setTimeout(r, 200 * Math.pow(2, attempt - 1)));
+            }
+        }
+    }
+    function checkStale() {
+        if (staleTime > 0 && lastFetchTime > 0 && !stale) {
+            if (Date.now() - lastFetchTime > staleTime) {
+                stale = true;
+            }
+        }
+    }
+    const state = {
+        get ok() {
+            return data !== undefined && error === undefined;
+        },
+        get data() {
+            checkStale();
+            // Re-derive args and refetch if they changed
+            if (opts?.fn) {
+                const newArgs = JSON.stringify(opts.fn(host));
+                if (newArgs !== lastArgs) {
+                    runFetch();
+                }
+            }
+            return data;
+        },
+        get error() {
+            return error;
+        },
+        get loading() {
+            return loading;
+        },
+        get stale() {
+            checkStale();
+            return stale;
+        },
+        async refetch() {
+            lastArgs = undefined; // Force refetch
+            await runFetch();
+        },
+        invalidate() {
+            stale = true;
+            lastArgs = undefined;
+            runFetch();
+        },
+        // ── LoomResult combinators ──
+        unwrap() {
+            if (data !== undefined && error === undefined)
+                return data;
+            throw error ?? new Error("unwrap() called on loading RPC state");
+        },
+        unwrap_or(fallback) {
+            return (data !== undefined && error === undefined) ? data : fallback;
+        },
+        map(fn) {
+            if (data !== undefined && error === undefined)
+                return LoomResult.ok(fn(data));
+            return LoomResult.err(error ?? new Error("No data"));
+        },
+        map_err(fn) {
+            if (data !== undefined && error === undefined)
+                return LoomResult.ok(data);
+            return LoomResult.err(fn(error ?? new Error("No data")));
+        },
+        and_then(fn) {
+            if (data !== undefined && error === undefined)
+                return fn(data);
+            return LoomResult.err(error ?? new Error("No data"));
+        },
+        match(cases) {
+            if (loading && data === undefined && error === undefined && cases.loading) {
+                return cases.loading();
+            }
+            return (data !== undefined && error === undefined)
+                ? cases.ok(data)
+                : cases.err(error ?? new Error("No data"));
+        },
+    };
+    // Fire initial fetch if eager
+    if (eager) {
+        runFetch();
+    }
+    return state;
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,43 @@
+/**
+ * LoomRPC — MockTransport for testing
+ *
+ * Drop-in RpcTransport replacement that returns pre-configured responses.
+ * No network. No server. Just mocks.
+ *
+ * ```ts
+ * import { MockTransport } from "@toyz/loom-rpc/testing";
+ *
+ * const transport = new MockTransport();
+ * transport.mock("UserRouter", "getUser", { id: "1", name: "Test" });
+ * transport.mockError("UserRouter", "deleteUser", new Error("Forbidden"));
+ *
+ * app.provide(RpcTransport, transport);
+ * ```
+ */
+import { RpcTransport } from "./transport";
+export declare class MockTransport extends RpcTransport {
+    private mocks;
+    private errors;
+    private calls;
+    private delays;
+    /** Register a mock response for a specific router.method */
+    mock<T>(router: string, method: string, response: T): this;
+    /** Register a mock error for a specific router.method */
+    mockError(router: string, method: string, error: Error): this;
+    /** Add an artificial delay (ms) for a specific router.method */
+    delay(router: string, method: string, ms: number): this;
+    /** All calls that have been made through this transport */
+    get history(): {
+        router: string;
+        method: string;
+        args: any[];
+    }[];
+    /** Clear all mocks and call history */
+    reset(): void;
+    /** Assert a specific call was made */
+    assertCalled(router: string, method: string, args?: any[]): void;
+    /** Assert a specific call was NOT made */
+    assertNotCalled(router: string, method: string): void;
+    call<T>(router: string, method: string, args: any[]): Promise<T>;
+}
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,KAAK,CAA8D;IAC3E,OAAO,CAAC,MAAM,CAA6B;IAE3C,4DAA4D;IAC5D,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI;IAK1D,yDAAyD;IACzD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAK7D,gEAAgE;IAChE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAKvD,2DAA2D;IAC3D,IAAI,OAAO;gBAtBoB,MAAM;gBAAU,MAAM;cAAQ,GAAG,EAAE;QAwBjE;IAED,uCAAuC;IACvC,KAAK,IAAI,IAAI;IAOb,sCAAsC;IACtC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI;IAahE,0CAA0C;IAC1C,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAW/C,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;CA0BvE"}

package/dist/testing.js

@@ -0,0 +1,87 @@
+/**
+ * LoomRPC — MockTransport for testing
+ *
+ * Drop-in RpcTransport replacement that returns pre-configured responses.
+ * No network. No server. Just mocks.
+ *
+ * ```ts
+ * import { MockTransport } from "@toyz/loom-rpc/testing";
+ *
+ * const transport = new MockTransport();
+ * transport.mock("UserRouter", "getUser", { id: "1", name: "Test" });
+ * transport.mockError("UserRouter", "deleteUser", new Error("Forbidden"));
+ *
+ * app.provide(RpcTransport, transport);
+ * ```
+ */
+import { RpcTransport } from "./transport";
+export class MockTransport extends RpcTransport {
+    mocks = new Map();
+    errors = new Map();
+    calls = [];
+    delays = new Map();
+    /** Register a mock response for a specific router.method */
+    mock(router, method, response) {
+        this.mocks.set(`${router}.${method}`, response);
+        return this;
+    }
+    /** Register a mock error for a specific router.method */
+    mockError(router, method, error) {
+        this.errors.set(`${router}.${method}`, error);
+        return this;
+    }
+    /** Add an artificial delay (ms) for a specific router.method */
+    delay(router, method, ms) {
+        this.delays.set(`${router}.${method}`, ms);
+        return this;
+    }
+    /** All calls that have been made through this transport */
+    get history() {
+        return this.calls;
+    }
+    /** Clear all mocks and call history */
+    reset() {
+        this.mocks.clear();
+        this.errors.clear();
+        this.calls.length = 0;
+        this.delays.clear();
+    }
+    /** Assert a specific call was made */
+    assertCalled(router, method, args) {
+        const match = this.calls.find((c) => c.router === router && c.method === method &&
+            (args === undefined || JSON.stringify(c.args) === JSON.stringify(args)));
+        if (!match) {
+            throw new Error(`Expected ${router}.${method}(${args ? JSON.stringify(args) : "..."}) to have been called. ` +
+                `Calls: ${JSON.stringify(this.calls)}`);
+        }
+    }
+    /** Assert a specific call was NOT made */
+    assertNotCalled(router, method) {
+        const match = this.calls.find((c) => c.router === router && c.method === method);
+        if (match) {
+            throw new Error(`Expected ${router}.${method} to NOT have been called, but it was.`);
+        }
+    }
+    async call(router, method, args) {
+        this.calls.push({ router, method, args });
+        const key = `${router}.${method}`;
+        // Simulate network delay if configured
+        const delayMs = this.delays.get(key);
+        if (delayMs) {
+            await new Promise((r) => setTimeout(r, delayMs));
+        }
+        // Check for mock error first
+        const err = this.errors.get(key);
+        if (err)
+            throw err;
+        // Check for mock response
+        if (this.mocks.has(key)) {
+            const value = this.mocks.get(key);
+            // If it's a function, call it with args (dynamic mocks)
+            return typeof value === "function" ? value(...args) : value;
+        }
+        throw new Error(`[MockTransport] No mock registered for ${key}. ` +
+            `Register one with: transport.mock("${router}", "${method}", responseData)`);
+    }
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,47 @@
+/**
+ * LoomRPC — Transport layer
+ *
+ * RpcTransport is the interface for how @rpc talks to the server.
+ * HttpTransport is the default implementation — plain fetch to
+ * POST /rpc/{router}/{method}.
+ *
+ * Swap transports via Loom's DI container:
+ *   app.provide(RpcTransport, new WsTransport(...));
+ */
+/**
+ * Abstract transport — implement this to control how RPC calls reach the server.
+ *
+ * Registered as a DI service via `app.provide(RpcTransport, impl)`.
+ */
+export declare abstract class RpcTransport {
+    abstract call<T>(router: string, method: string, args: any[]): Promise<T>;
+}
+/**
+ * Default HTTP transport — POST JSON to `/rpc/{router}/{method}`.
+ *
+ * ```ts
+ * import { app } from "@toyz/loom";
+ * import { RpcTransport, HttpTransport } from "@toyz/loom-rpc";
+ *
+ * app.provide(RpcTransport, new HttpTransport());
+ * // or with a custom base URL:
+ * app.provide(RpcTransport, new HttpTransport("https://api.example.com/rpc"));
+ * ```
+ */
+export declare class HttpTransport extends RpcTransport {
+    private readonly baseUrl;
+    private readonly headers;
+    constructor(baseUrl?: string, headers?: Record<string, string>);
+    call<T>(router: string, method: string, args: any[]): Promise<T>;
+}
+/**
+ * Structured error from an RPC call.
+ */
+export declare class RpcError extends Error {
+    readonly status?: number | undefined;
+    readonly router?: string | undefined;
+    readonly method?: string | undefined;
+    readonly code?: string | undefined;
+    constructor(message: string, status?: number | undefined, router?: string | undefined, method?: string | undefined, code?: string | undefined);
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +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,GAAG,OAAO,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,GAAG,OAAO,CAAC,CAAC,CAAC;CAqCvE;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

@@ -0,0 +1,78 @@
+/**
+ * LoomRPC — Transport layer
+ *
+ * RpcTransport is the interface for how @rpc talks to the server.
+ * HttpTransport is the default implementation — plain fetch to
+ * POST /rpc/{router}/{method}.
+ *
+ * Swap transports via Loom's DI container:
+ *   app.provide(RpcTransport, new WsTransport(...));
+ */
+/**
+ * Abstract transport — implement this to control how RPC calls reach the server.
+ *
+ * Registered as a DI service via `app.provide(RpcTransport, impl)`.
+ */
+export class RpcTransport {
+}
+/**
+ * Default HTTP transport — POST JSON to `/rpc/{router}/{method}`.
+ *
+ * ```ts
+ * import { app } from "@toyz/loom";
+ * import { RpcTransport, HttpTransport } from "@toyz/loom-rpc";
+ *
+ * app.provide(RpcTransport, new HttpTransport());
+ * // or with a custom base URL:
+ * app.provide(RpcTransport, new HttpTransport("https://api.example.com/rpc"));
+ * ```
+ */
+export class HttpTransport extends RpcTransport {
+    baseUrl;
+    headers;
+    constructor(baseUrl = "/rpc", headers = {}) {
+        super();
+        // Strip trailing slash
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.headers = headers;
+    }
+    async call(router, method, args) {
+        const url = `${this.baseUrl}/${router}/${method}`;
+        const body = { args };
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...this.headers,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => res.statusText);
+            throw new RpcError(`RPC ${router}.${method} failed: ${res.status} ${text}`, res.status, router, method);
+        }
+        const envelope = await res.json();
+        if (envelope.error) {
+            throw new RpcError(envelope.error.message, undefined, router, method, envelope.error.code);
+        }
+        return envelope.data;
+    }
+}
+/**
+ * Structured error from an RPC call.
+ */
+export class RpcError extends Error {
+    status;
+    router;
+    method;
+    code;
+    constructor(message, status, router, method, code) {
+        super(message);
+        this.status = status;
+        this.router = router;
+        this.method = method;
+        this.code = code;
+        this.name = "RpcError";
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +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;QACvD,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;SAC3B,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

@@ -0,0 +1,75 @@
+/**
+ * LoomRPC — Type utilities
+ *
+ * Extract method names, parameter types, and return types from contract classes.
+ * Powers the type-safe @rpc and @mutate decorators.
+ */
+/**
+ * Extract callable method names from a contract class.
+ * Filters out non-function properties so only procedure names are valid.
+ */
+export type RpcMethods<T> = {
+    [K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;
+}[keyof T] & string;
+/**
+ * Extract the parameter types for a specific method on a contract class.
+ *
+ * ```ts
+ * type Args = InferArgs<UserRouter, "getUser">; // [id: string]
+ * ```
+ */
+export type InferArgs<T, M extends keyof T> = T[M] extends (...args: infer A) => any ? A : never;
+/**
+ * Extract the return type for a specific method on a contract class.
+ * Unwraps Promise<T> to T automatically.
+ *
+ * ```ts
+ * type Result = InferReturn<UserRouter, "getUser">; // User
+ * ```
+ */
+export type InferReturn<T, M extends keyof T> = T[M] extends (...args: any[]) => Promise<infer R> ? R : T[M] extends (...args: any[]) => infer R ? R : never;
+/**
+ * Configuration for @rpc query decorator.
+ */
+export interface RpcQueryOptions<TRouter, TMethod extends RpcMethods<TRouter>> {
+    /** Extract procedure args from element state. Re-evaluates on reactive changes. */
+    fn?: (el: any) => InferArgs<TRouter, TMethod>;
+    /** SWR cache duration in ms (default: 0 = always refetch) */
+    staleTime?: number;
+    /** Whether to fetch on connect (default: true) */
+    eager?: boolean;
+    /** Number of retries on failure with exponential backoff (default: 0) */
+    retry?: number;
+}
+/**
+ * State container for a mutation — manual `.call()`, tracks loading/error.
+ */
+export interface RpcMutator<TArgs extends any[], TReturn> {
+    /** Execute the mutation with the given arguments */
+    call(...args: TArgs): Promise<TReturn>;
+    /** True while the mutation is in flight */
+    readonly loading: boolean;
+    /** Error from the last mutation attempt, or null */
+    readonly error: Error | null;
+    /** Data from the last successful mutation, or undefined */
+    readonly data: TReturn | undefined;
+    /** Reset the mutator state (clear data, error, loading) */
+    reset(): void;
+}
+/**
+ * Wire protocol envelope for RPC requests.
+ */
+export interface RpcRequest {
+    args: any[];
+}
+/**
+ * Wire protocol envelope for RPC responses.
+ */
+export interface RpcResponse<T = any> {
+    data?: T;
+    error?: {
+        message: string;
+        code?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;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;;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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * 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

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@toyz/loom-rpc",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Type-safe, decorator-driven RPC for Loom — server-agnostic, transport-swappable",
+  "license": "MIT",
+  "author": "toyz",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Toyz/loom.git",
+    "directory": "loom-rpc"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@toyz/loom": "^0.12.0"
+  },
+  "devDependencies": {
+    "happy-dom": "^17.4.4",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "loom",
+    "rpc",
+    "decorators",
+    "type-safe",
+    "web-components"
+  ]
+}