@parcae/sdk 0.0.1

package/dist/chunk-XAFYMW5P.js

@@ -0,0 +1,426 @@
+import SocketIO from 'socket.io-client';
+import pako from 'pako';
+import { decompress } from 'compress-json';
+import { EventEmitter } from 'eventemitter3';
+import ShortId from 'short-unique-id';
+import { Model, FrontendAdapter } from '@parcae/model';
+
+// src/transports/socket.ts
+var uid = new ShortId({ length: 10 });
+var SOCKET_CONNECTIONS = /* @__PURE__ */ new Map();
+var SocketTransport = class extends EventEmitter {
+  socket = null;
+  pendingHandlers = [];
+  apiKey;
+  key = null;
+  url;
+  version;
+  socketPath;
+  waitForAuth = null;
+  resolveAuth = null;
+  inflight = /* @__PURE__ */ new Map();
+  loading;
+  isLoading = true;
+  isConnected = false;
+  isConnecting = false;
+  authVersion = 0;
+  constructor(config) {
+    super();
+    this.url = config.url;
+    this.apiKey = config.key ?? null;
+    this.version = config.version ?? "v1";
+    this.socketPath = config.path ?? "/ws";
+    this.loading = this.init(this.apiKey);
+  }
+  // ── Auth ──────────────────────────────────────────────────────────────
+  async setKey(key) {
+    this.apiKey = key;
+    this.isLoading = true;
+    this.loading = this.init(key);
+    await this.loading;
+  }
+  // ── Init ──────────────────────────────────────────────────────────────
+  async init(key) {
+    this.isLoading = true;
+    this.isConnecting = true;
+    try {
+      this.key = typeof key === "function" ? await key() : key;
+      const socketKey = `${this.url}:${this.version}`;
+      if (!SOCKET_CONNECTIONS.has(socketKey)) {
+        SOCKET_CONNECTIONS.set(
+          socketKey,
+          SocketIO(this.url, {
+            path: this.socketPath,
+            agent: true,
+            transports: ["websocket"],
+            withCredentials: true,
+            query: { key: this.key ?? void 0, compression: true }
+          })
+        );
+      }
+      this.socket = SOCKET_CONNECTIONS.get(socketKey);
+      if (this.key) {
+        const prevResolve = this.resolveAuth;
+        this.waitForAuth = new Promise((resolve) => {
+          this.resolveAuth = resolve;
+          this.socket.emit("authenticate", this.key, () => {
+            this.waitForAuth = null;
+            this.resolveAuth = null;
+            this.authVersion++;
+            this.emit("authenticated");
+            if (prevResolve) prevResolve();
+            resolve();
+          });
+        });
+      } else {
+        this.waitForAuth = null;
+        this.resolveAuth = null;
+      }
+      this.isLoading = false;
+    } catch (error) {
+      this.isLoading = false;
+      this.isConnecting = false;
+      this.emit("error", error);
+      throw error;
+    }
+    this.setupEvents();
+  }
+  setupEvents() {
+    if (!this.socket) return;
+    for (const { event, handler } of this.pendingHandlers) {
+      this.socket.on(event, handler);
+    }
+    this.pendingHandlers = [];
+    let hasConnected = this.isConnected;
+    this.socket.off("connect");
+    this.socket.off("disconnect");
+    this.socket.off("error");
+    this.socket.on("connect", () => {
+      const wasDisconnected = !this.isConnected && hasConnected;
+      this.isConnected = true;
+      this.isConnecting = false;
+      hasConnected = true;
+      this.emit(wasDisconnected ? "reconnected" : "connected");
+    });
+    this.socket.on("disconnect", () => {
+      this.isConnected = false;
+      this.emit("disconnected");
+    });
+    this.socket.on("error", (error) => {
+      this.emit("error", error);
+    });
+  }
+  // ── Request/Response ──────────────────────────────────────────────────
+  async fetch(method, path, data = {}) {
+    await this.loading;
+    if (this.waitForAuth) await this.waitForAuth;
+    if (!this.socket) throw new Error("Socket not initialized");
+    const upper = method.toUpperCase();
+    if (upper === "GET") {
+      const dedupeKey = `GET:${path}:${this.authVersion}:${JSON.stringify(data)}`;
+      const existing = this.inflight.get(dedupeKey);
+      if (existing) return existing;
+      const req = this._doFetch(method, path, data);
+      this.inflight.set(dedupeKey, req);
+      req.finally(() => this.inflight.delete(dedupeKey));
+      return req;
+    }
+    return this._doFetch(method, path, data);
+  }
+  async _doFetch(method, path, data = {}) {
+    if (!this.isConnected) {
+      await new Promise((resolve, reject) => {
+        if (this.socket.connected) return resolve();
+        const timeout = setTimeout(() => {
+          cleanup();
+          reject(new Error("Connection timeout"));
+        }, 3e4);
+        const onConnect = () => {
+          cleanup();
+          resolve();
+        };
+        const onError = (err) => {
+          cleanup();
+          reject(new Error(`Connection failed: ${err.message}`));
+        };
+        const cleanup = () => {
+          clearTimeout(timeout);
+          this.socket.off("connect", onConnect);
+          this.socket.off("connect_error", onError);
+        };
+        this.socket.once("connect", onConnect);
+        this.socket.once("connect_error", onError);
+      });
+    }
+    const id = uid.rnd();
+    return new Promise((resolve, reject) => {
+      this.socket.once(id, (msg) => {
+        try {
+          const uncompressed = pako.ungzip(msg, { to: "string" });
+          const { success, result, message, error } = decompress(
+            JSON.parse(uncompressed)
+          );
+          if (success) resolve(result);
+          else
+            reject(
+              new Error(
+                message || error || `Request failed: ${method}:${path}`
+              )
+            );
+        } catch (err) {
+          reject(err);
+        }
+      });
+      this.socket.emit(
+        "call",
+        id,
+        method.toUpperCase(),
+        `/${this.version}${path}`,
+        data
+      );
+    });
+  }
+  async get(path, data) {
+    return this.fetch("get", path, data);
+  }
+  async post(path, data) {
+    return this.fetch("post", path, data);
+  }
+  async put(path, data) {
+    return this.fetch("put", path, data);
+  }
+  async patch(path, data) {
+    return this.fetch("patch", path, data);
+  }
+  async delete(path, data) {
+    return this.fetch("delete", path, data);
+  }
+  // ── Subscriptions ─────────────────────────────────────────────────────
+  subscribe(event, handler) {
+    if (this.socket) {
+      this.socket.on(event, handler);
+    } else {
+      this.pendingHandlers.push({ event, handler });
+    }
+    return () => this.unsubscribe(event, handler);
+  }
+  unsubscribe(event, handler) {
+    if (this.socket) this.socket.off(event, handler);
+    this.pendingHandlers = this.pendingHandlers.filter(
+      (h) => !(h.event === event && (!handler || h.handler === handler))
+    );
+  }
+  // ── Control messages ──────────────────────────────────────────────────
+  async send(event, ...args) {
+    if (!this.isConnected && this.socket) {
+      await new Promise((resolve) => {
+        if (this.socket.connected) return resolve();
+        this.socket.once("connect", () => resolve());
+      });
+    }
+    if (this.waitForAuth) await this.waitForAuth;
+    if (this.socket) this.socket.emit(event, ...args);
+  }
+  // ── Lifecycle ─────────────────────────────────────────────────────────
+  disconnect() {
+    if (this.socket) {
+      this.socket.disconnect();
+      SOCKET_CONNECTIONS.delete(`${this.url}:${this.version}`);
+      this.socket = null;
+      this.isConnected = false;
+    }
+  }
+  async reconnect() {
+    this.loading = this.init(this.apiKey);
+    await this.loading;
+  }
+};
+var SSETransport = class extends EventEmitter {
+  url;
+  version;
+  apiKey;
+  key = null;
+  eventSources = /* @__PURE__ */ new Map();
+  isConnected = true;
+  // HTTP is "always connected"
+  isLoading = true;
+  loading;
+  constructor(config) {
+    super();
+    this.url = config.url.replace(/\/$/, "");
+    this.version = config.version ?? "v1";
+    this.apiKey = config.key ?? null;
+    this.loading = this.resolveKey();
+  }
+  async resolveKey() {
+    try {
+      this.key = typeof this.apiKey === "function" ? await this.apiKey() : this.apiKey;
+      this.isLoading = false;
+      this.emit("connected");
+    } catch (err) {
+      this.isLoading = false;
+      this.emit("error", err);
+    }
+  }
+  headers() {
+    const h = { "Content-Type": "application/json" };
+    if (this.key) h["Authorization"] = `Bearer ${this.key}`;
+    return h;
+  }
+  fullUrl(path) {
+    return `${this.url}/${this.version}${path}`;
+  }
+  // ── Request/Response ──────────────────────────────────────────────────
+  async request(method, path, data) {
+    await this.loading;
+    const isGet = method.toUpperCase() === "GET";
+    let url = this.fullUrl(path);
+    if (isGet && data) {
+      const params = new URLSearchParams();
+      for (const [k, v] of Object.entries(data)) {
+        params.set(k, typeof v === "object" ? JSON.stringify(v) : String(v));
+      }
+      url += `?${params.toString()}`;
+    }
+    const res = await fetch(url, {
+      method: method.toUpperCase(),
+      headers: this.headers(),
+      body: isGet ? void 0 : JSON.stringify(data)
+    });
+    if (!res.ok) {
+      const body2 = await res.json().catch(() => ({ error: res.statusText }));
+      throw new Error(body2.error || body2.message || `HTTP ${res.status}`);
+    }
+    const body = await res.json();
+    if (body.success === false) throw new Error(body.error || "Request failed");
+    return body.result ?? body;
+  }
+  async get(path, data) {
+    return this.request("GET", path, data);
+  }
+  async post(path, data) {
+    return this.request("POST", path, data);
+  }
+  async put(path, data) {
+    return this.request("PUT", path, data);
+  }
+  async patch(path, data) {
+    return this.request("PATCH", path, data);
+  }
+  async delete(path, data) {
+    return this.request("DELETE", path, data);
+  }
+  // ── Subscriptions (via Server-Sent Events) ────────────────────────────
+  subscribe(event, handler) {
+    const url = `${this.url}/${this.version}/__events/${encodeURIComponent(event)}`;
+    const source = new EventSource(url, { withCredentials: true });
+    source.onmessage = (e) => {
+      try {
+        const data = JSON.parse(e.data);
+        handler(data);
+      } catch {
+        handler(e.data);
+      }
+    };
+    source.onerror = () => {
+    };
+    this.eventSources.set(event, source);
+    return () => {
+      source.close();
+      this.eventSources.delete(event);
+    };
+  }
+  unsubscribe(event) {
+    const source = this.eventSources.get(event);
+    if (source) {
+      source.close();
+      this.eventSources.delete(event);
+    }
+  }
+  // ── Control messages ──────────────────────────────────────────────────
+  async send(event, ...args) {
+    await this.request("POST", "/__control", { event, args });
+  }
+  // ── Lifecycle ─────────────────────────────────────────────────────────
+  disconnect() {
+    for (const [, source] of this.eventSources) source.close();
+    this.eventSources.clear();
+    this.isConnected = false;
+    this.emit("disconnected");
+  }
+  async reconnect() {
+    this.loading = this.resolveKey();
+    await this.loading;
+  }
+};
+function createClient(config) {
+  const version = config.version ?? "v1";
+  let transport;
+  if (config.transport && typeof config.transport === "object") {
+    transport = config.transport;
+  } else if (config.transport === "sse") {
+    transport = new SSETransport({
+      url: config.url,
+      key: config.key,
+      version
+    });
+  } else {
+    transport = new SocketTransport({
+      url: config.url,
+      key: config.key,
+      version
+    });
+  }
+  Model.use(new FrontendAdapter(transport));
+  const client = {
+    transport,
+    get: (path, data) => transport.get(path, data),
+    post: (path, data) => transport.post(path, data),
+    put: (path, data) => transport.put(path, data),
+    patch: (path, data) => transport.patch(path, data),
+    delete: (path, data) => transport.delete(path, data),
+    subscribe(event, handler) {
+      if (transport.subscribe) return transport.subscribe(event, handler);
+      return () => {
+      };
+    },
+    unsubscribe(event, handler) {
+      transport.unsubscribe?.(event, handler);
+    },
+    send(event, ...args) {
+      transport.send?.(event, ...args);
+    },
+    get isConnected() {
+      return transport.isConnected ?? false;
+    },
+    get isLoading() {
+      return transport.isLoading ?? false;
+    },
+    get loading() {
+      return transport.loading ?? Promise.resolve();
+    },
+    get authVersion() {
+      return transport.authVersion ?? 0;
+    },
+    async setKey(key) {
+      if (transport.setKey) await transport.setKey(key);
+    },
+    on(event, handler) {
+      transport.on?.(event, handler);
+    },
+    off(event, handler) {
+      transport.off?.(event, handler);
+    },
+    disconnect() {
+      transport.disconnect?.();
+    },
+    async reconnect() {
+      await transport.reconnect?.();
+    }
+  };
+  return client;
+}
+
+export { SSETransport, SocketTransport, createClient };
+//# sourceMappingURL=chunk-XAFYMW5P.js.map
+//# sourceMappingURL=chunk-XAFYMW5P.js.map

package/dist/chunk-XAFYMW5P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transports/socket.ts","../src/transports/sse.ts","../src/client.ts"],"names":["EventEmitter","body"],"mappings":"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","file":"chunk-XAFYMW5P.js","sourcesContent":["/**\n * SocketTransport — Socket.IO implementation of the Transport interface.\n *\n * Bidirectional, full-duplex. Best for apps that need realtime subscriptions\n * (live query updates, collaborative editing, chat, etc.).\n *\n * Extracted from Dollhouse Studio's Dollhouse.ts (667 lines).\n */\n\nimport SocketIO from \"socket.io-client\";\nimport pako from \"pako\";\nimport { decompress } from \"compress-json\";\nimport { EventEmitter } from \"eventemitter3\";\nimport ShortId from \"short-unique-id\";\nimport type { Transport } from \"@parcae/model\";\n\nconst uid = new ShortId({ length: 10 });\nconst SOCKET_CONNECTIONS = new Map<string, any>();\n\nexport interface SocketTransportConfig {\n  url: string;\n  key?: string | null | (() => Promise<string | null>);\n  version?: string;\n  /** Socket.IO path. Default: \"/ws\" */\n  path?: string;\n}\n\nexport class SocketTransport extends EventEmitter implements Transport {\n  private socket: any = null;\n  private pendingHandlers: Array<{\n    event: string;\n    handler: (...args: any[]) => void;\n  }> = [];\n  private apiKey: string | null | (() => Promise<string | null>);\n  private key: string | null = null;\n  private url: string;\n  private version: string;\n  private socketPath: string;\n  private waitForAuth: Promise<void> | null = null;\n  private resolveAuth: (() => void) | null = null;\n  private inflight = new Map<string, Promise<any>>();\n\n  public loading: Promise<void>;\n  public isLoading = true;\n  public isConnected = false;\n  public isConnecting = false;\n  public authVersion = 0;\n\n  constructor(config: SocketTransportConfig) {\n    super();\n    this.url = config.url;\n    this.apiKey = config.key ?? null;\n    this.version = config.version ?? \"v1\";\n    this.socketPath = config.path ?? \"/ws\";\n    this.loading = this.init(this.apiKey);\n  }\n\n  // ── Auth ──────────────────────────────────────────────────────────────\n\n  async setKey(\n    key: string | null | (() => Promise<string | null>),\n  ): Promise<void> {\n    this.apiKey = key;\n    this.isLoading = true;\n    this.loading = this.init(key);\n    await this.loading;\n  }\n\n  // ── Init ──────────────────────────────────────────────────────────────\n\n  private async init(\n    key: string | null | (() => Promise<string | null>),\n  ): Promise<void> {\n    this.isLoading = true;\n    this.isConnecting = true;\n\n    try {\n      this.key = typeof key === \"function\" ? await key() : key;\n      const socketKey = `${this.url}:${this.version}`;\n\n      if (!SOCKET_CONNECTIONS.has(socketKey)) {\n        SOCKET_CONNECTIONS.set(\n          socketKey,\n          SocketIO(this.url, {\n            path: this.socketPath,\n            agent: true,\n            transports: [\"websocket\"],\n            withCredentials: true,\n            query: { key: this.key ?? undefined, compression: true },\n          }),\n        );\n      }\n\n      this.socket = SOCKET_CONNECTIONS.get(socketKey);\n\n      if (this.key) {\n        const prevResolve = this.resolveAuth;\n        this.waitForAuth = new Promise<void>((resolve) => {\n          this.resolveAuth = resolve;\n          this.socket.emit(\"authenticate\", this.key, () => {\n            this.waitForAuth = null;\n            this.resolveAuth = null;\n            this.authVersion++;\n            this.emit(\"authenticated\");\n            if (prevResolve) prevResolve();\n            resolve();\n          });\n        });\n      } else {\n        this.waitForAuth = null;\n        this.resolveAuth = null;\n      }\n\n      this.isLoading = false;\n    } catch (error) {\n      this.isLoading = false;\n      this.isConnecting = false;\n      this.emit(\"error\", error);\n      throw error;\n    }\n\n    this.setupEvents();\n  }\n\n  private setupEvents(): void {\n    if (!this.socket) return;\n\n    for (const { event, handler } of this.pendingHandlers) {\n      this.socket.on(event, handler);\n    }\n    this.pendingHandlers = [];\n\n    let hasConnected = this.isConnected;\n    this.socket.off(\"connect\");\n    this.socket.off(\"disconnect\");\n    this.socket.off(\"error\");\n\n    this.socket.on(\"connect\", () => {\n      const wasDisconnected = !this.isConnected && hasConnected;\n      this.isConnected = true;\n      this.isConnecting = false;\n      hasConnected = true;\n      this.emit(wasDisconnected ? \"reconnected\" : \"connected\");\n    });\n\n    this.socket.on(\"disconnect\", () => {\n      this.isConnected = false;\n      this.emit(\"disconnected\");\n    });\n\n    this.socket.on(\"error\", (error: Error) => {\n      this.emit(\"error\", error);\n    });\n  }\n\n  // ── Request/Response ──────────────────────────────────────────────────\n\n  private async fetch(\n    method: string,\n    path: string,\n    data: any = {},\n  ): Promise<any> {\n    await this.loading;\n    if (this.waitForAuth) await this.waitForAuth;\n    if (!this.socket) throw new Error(\"Socket not initialized\");\n\n    const upper = method.toUpperCase();\n    if (upper === \"GET\") {\n      const dedupeKey = `GET:${path}:${this.authVersion}:${JSON.stringify(data)}`;\n      const existing = this.inflight.get(dedupeKey);\n      if (existing) return existing;\n      const req = this._doFetch(method, path, data);\n      this.inflight.set(dedupeKey, req);\n      req.finally(() => this.inflight.delete(dedupeKey));\n      return req;\n    }\n\n    return this._doFetch(method, path, data);\n  }\n\n  private async _doFetch(\n    method: string,\n    path: string,\n    data: any = {},\n  ): Promise<any> {\n    if (!this.isConnected) {\n      await new Promise<void>((resolve, reject) => {\n        if (this.socket.connected) return resolve();\n        const timeout = setTimeout(() => {\n          cleanup();\n          reject(new Error(\"Connection timeout\"));\n        }, 30000);\n        const onConnect = () => {\n          cleanup();\n          resolve();\n        };\n        const onError = (err: Error) => {\n          cleanup();\n          reject(new Error(`Connection failed: ${err.message}`));\n        };\n        const cleanup = () => {\n          clearTimeout(timeout);\n          this.socket.off(\"connect\", onConnect);\n          this.socket.off(\"connect_error\", onError);\n        };\n        this.socket.once(\"connect\", onConnect);\n        this.socket.once(\"connect_error\", onError);\n      });\n    }\n\n    const id = uid.rnd();\n\n    return new Promise((resolve, reject) => {\n      this.socket.once(id, (msg: any) => {\n        try {\n          const uncompressed = pako.ungzip(msg, { to: \"string\" });\n          const { success, result, message, error } = decompress(\n            JSON.parse(uncompressed),\n          );\n          if (success) resolve(result);\n          else\n            reject(\n              new Error(\n                message || error || `Request failed: ${method}:${path}`,\n              ),\n            );\n        } catch (err) {\n          reject(err);\n        }\n      });\n      this.socket.emit(\n        \"call\",\n        id,\n        method.toUpperCase(),\n        `/${this.version}${path}`,\n        data,\n      );\n    });\n  }\n\n  async get(path: string, data?: any): Promise<any> {\n    return this.fetch(\"get\", path, data);\n  }\n  async post(path: string, data?: any): Promise<any> {\n    return this.fetch(\"post\", path, data);\n  }\n  async put(path: string, data?: any): Promise<any> {\n    return this.fetch(\"put\", path, data);\n  }\n  async patch(path: string, data?: any): Promise<any> {\n    return this.fetch(\"patch\", path, data);\n  }\n  async delete(path: string, data?: any): Promise<any> {\n    return this.fetch(\"delete\", path, data);\n  }\n\n  // ── Subscriptions ─────────────────────────────────────────────────────\n\n  subscribe(event: string, handler: (...args: any[]) => void): () => void {\n    if (this.socket) {\n      this.socket.on(event, handler);\n    } else {\n      this.pendingHandlers.push({ event, handler });\n    }\n    return () => this.unsubscribe(event, handler);\n  }\n\n  unsubscribe(event: string, handler?: (...args: any[]) => void): void {\n    if (this.socket) this.socket.off(event, handler);\n    this.pendingHandlers = this.pendingHandlers.filter(\n      (h) => !(h.event === event && (!handler || h.handler === handler)),\n    );\n  }\n\n  // ── Control messages ──────────────────────────────────────────────────\n\n  async send(event: string, ...args: any[]): Promise<void> {\n    if (!this.isConnected && this.socket) {\n      await new Promise<void>((resolve) => {\n        if (this.socket.connected) return resolve();\n        this.socket.once(\"connect\", () => resolve());\n      });\n    }\n    if (this.waitForAuth) await this.waitForAuth;\n    if (this.socket) this.socket.emit(event, ...args);\n  }\n\n  // ── Lifecycle ─────────────────────────────────────────────────────────\n\n  disconnect(): void {\n    if (this.socket) {\n      this.socket.disconnect();\n      SOCKET_CONNECTIONS.delete(`${this.url}:${this.version}`);\n      this.socket = null;\n      this.isConnected = false;\n    }\n  }\n\n  async reconnect(): Promise<void> {\n    this.loading = this.init(this.apiKey);\n    await this.loading;\n  }\n}\n\nexport default SocketTransport;\n","/**\n * SSETransport — HTTP + Server-Sent Events implementation of the Transport interface.\n *\n * Request/response via standard fetch(). Subscriptions via EventSource.\n * Simpler than Socket.IO — no websocket infra needed. Good for read-heavy\n * apps, serverless backends, or environments where WebSocket isn't available.\n *\n * Trade-offs vs SocketTransport:\n * - Simpler infra (no sticky sessions, works behind any CDN/proxy)\n * - Server → client streaming only (no client → server streaming)\n * - Request/response is standard HTTP (cacheable, observable, debuggable)\n * - No compression (relies on HTTP gzip)\n * - No request deduplication (relies on HTTP/2 multiplexing)\n */\n\nimport { EventEmitter } from \"eventemitter3\";\nimport type { Transport } from \"@parcae/model\";\n\nexport interface SSETransportConfig {\n  /** Base URL of the Parcae backend. */\n  url: string;\n  /** API key or async function returning a key. */\n  key?: string | null | (() => Promise<string | null>);\n  /** API version prefix. Default: \"v1\" */\n  version?: string;\n}\n\nexport class SSETransport extends EventEmitter implements Transport {\n  private url: string;\n  private version: string;\n  private apiKey: string | null | (() => Promise<string | null>);\n  private key: string | null = null;\n  private eventSources = new Map<string, EventSource>();\n\n  public isConnected = true; // HTTP is \"always connected\"\n  public isLoading = true;\n  public loading: Promise<void>;\n\n  constructor(config: SSETransportConfig) {\n    super();\n    this.url = config.url.replace(/\\/$/, \"\");\n    this.version = config.version ?? \"v1\";\n    this.apiKey = config.key ?? null;\n    this.loading = this.resolveKey();\n  }\n\n  private async resolveKey(): Promise<void> {\n    try {\n      this.key =\n        typeof this.apiKey === \"function\" ? await this.apiKey() : this.apiKey;\n      this.isLoading = false;\n      this.emit(\"connected\");\n    } catch (err) {\n      this.isLoading = false;\n      this.emit(\"error\", err);\n    }\n  }\n\n  private headers(): Record<string, string> {\n    const h: Record<string, string> = { \"Content-Type\": \"application/json\" };\n    if (this.key) h[\"Authorization\"] = `Bearer ${this.key}`;\n    return h;\n  }\n\n  private fullUrl(path: string): string {\n    return `${this.url}/${this.version}${path}`;\n  }\n\n  // ── Request/Response ──────────────────────────────────────────────────\n\n  private async request(\n    method: string,\n    path: string,\n    data?: any,\n  ): Promise<any> {\n    await this.loading;\n\n    const isGet = method.toUpperCase() === \"GET\";\n    let url = this.fullUrl(path);\n\n    if (isGet && data) {\n      const params = new URLSearchParams();\n      for (const [k, v] of Object.entries(data)) {\n        params.set(k, typeof v === \"object\" ? JSON.stringify(v) : String(v));\n      }\n      url += `?${params.toString()}`;\n    }\n\n    const res = await fetch(url, {\n      method: method.toUpperCase(),\n      headers: this.headers(),\n      body: isGet ? undefined : JSON.stringify(data),\n    });\n\n    if (!res.ok) {\n      const body = await res.json().catch(() => ({ error: res.statusText }));\n      throw new Error(body.error || body.message || `HTTP ${res.status}`);\n    }\n\n    const body = await res.json();\n    if (body.success === false) throw new Error(body.error || \"Request failed\");\n    return body.result ?? body;\n  }\n\n  async get(path: string, data?: any): Promise<any> {\n    return this.request(\"GET\", path, data);\n  }\n  async post(path: string, data?: any): Promise<any> {\n    return this.request(\"POST\", path, data);\n  }\n  async put(path: string, data?: any): Promise<any> {\n    return this.request(\"PUT\", path, data);\n  }\n  async patch(path: string, data?: any): Promise<any> {\n    return this.request(\"PATCH\", path, data);\n  }\n  async delete(path: string, data?: any): Promise<any> {\n    return this.request(\"DELETE\", path, data);\n  }\n\n  // ── Subscriptions (via Server-Sent Events) ────────────────────────────\n\n  subscribe(event: string, handler: (...args: any[]) => void): () => void {\n    const url = `${this.url}/${this.version}/__events/${encodeURIComponent(event)}`;\n    const source = new EventSource(url, { withCredentials: true });\n\n    source.onmessage = (e) => {\n      try {\n        const data = JSON.parse(e.data);\n        handler(data);\n      } catch {\n        handler(e.data);\n      }\n    };\n\n    source.onerror = () => {\n      // EventSource auto-reconnects\n    };\n\n    this.eventSources.set(event, source);\n\n    return () => {\n      source.close();\n      this.eventSources.delete(event);\n    };\n  }\n\n  unsubscribe(event: string): void {\n    const source = this.eventSources.get(event);\n    if (source) {\n      source.close();\n      this.eventSources.delete(event);\n    }\n  }\n\n  // ── Control messages ──────────────────────────────────────────────────\n\n  async send(event: string, ...args: any[]): Promise<void> {\n    await this.request(\"POST\", \"/__control\", { event, args });\n  }\n\n  // ── Lifecycle ─────────────────────────────────────────────────────────\n\n  disconnect(): void {\n    for (const [, source] of this.eventSources) source.close();\n    this.eventSources.clear();\n    this.isConnected = false;\n    this.emit(\"disconnected\");\n  }\n\n  async reconnect(): Promise<void> {\n    this.loading = this.resolveKey();\n    await this.loading;\n  }\n}\n\nexport default SSETransport;\n","/**\n * @parcae/sdk — createClient()\n *\n * Creates a Parcae client with a pluggable transport layer.\n * Default: Socket.IO (bidirectional, realtime).\n * Alternative: SSE (HTTP + Server-Sent Events, simpler).\n *\n * The transport is abstracted — the client exposes the same API\n * regardless of which transport is used underneath.\n */\n\nimport { Model, FrontendAdapter } from \"@parcae/model\";\nimport type { Transport } from \"@parcae/model\";\nimport { SocketTransport } from \"./transports/socket\";\nimport type { SocketTransportConfig } from \"./transports/socket\";\nimport { SSETransport } from \"./transports/sse\";\nimport type { SSETransportConfig } from \"./transports/sse\";\n\n// ─── Configuration ───────────────────────────────────────────────────────────\n\nexport interface ClientConfig {\n  /** URL of the Parcae backend. */\n  url: string;\n  /** API key — string or async function that returns a key. */\n  key?: string | null | (() => Promise<string | null>);\n  /** API version prefix. Default: \"v1\" */\n  version?: string;\n  /**\n   * Transport type. Default: \"socket\"\n   * - \"socket\": Socket.IO (bidirectional, realtime subscriptions)\n   * - \"sse\": HTTP + Server-Sent Events (read-heavy, simpler infra)\n   * - Transport instance: provide your own Transport implementation\n   */\n  transport?: \"socket\" | \"sse\" | Transport;\n}\n\nexport interface ParcaeClient {\n  /** The underlying transport instance. */\n  transport: Transport;\n  /** Shorthand for transport methods. */\n  get(path: string, data?: any): Promise<any>;\n  post(path: string, data?: any): Promise<any>;\n  put(path: string, data?: any): Promise<any>;\n  patch(path: string, data?: any): Promise<any>;\n  delete(path: string, data?: any): Promise<any>;\n  /** Subscribe to a named event. Returns dispose function. */\n  subscribe(event: string, handler: (...args: any[]) => void): () => void;\n  /** Unsubscribe from a named event. */\n  unsubscribe(event: string, handler?: (...args: any[]) => void): void;\n  /** Send a control message. */\n  send(event: string, ...args: any[]): void;\n  /** Connection state. */\n  readonly isConnected: boolean;\n  readonly isLoading: boolean;\n  /** Promise that resolves when the client is ready. */\n  loading: Promise<void>;\n  /** Update the auth key. */\n  setKey(key: string | null | (() => Promise<string | null>)): Promise<void>;\n  /** Listen for transport events. */\n  on(event: string, handler: (...args: any[]) => void): void;\n  off(event: string, handler?: (...args: any[]) => void): void;\n  /** Disconnect from the server. */\n  disconnect(): void;\n  /** Reconnect. */\n  reconnect(): Promise<void>;\n  /** Auth version — incremented on auth changes. Useful for cache invalidation. */\n  readonly authVersion: number;\n}\n\n// ─── createClient ────────────────────────────────────────────────────────────\n\nexport function createClient(config: ClientConfig): ParcaeClient {\n  const version = config.version ?? \"v1\";\n\n  // Create the transport\n  let transport: Transport & {\n    loading?: Promise<void>;\n    isLoading?: boolean;\n    isConnected?: boolean;\n    authVersion?: number;\n    setKey?: (key: any) => Promise<void>;\n    on?: (event: string, handler: (...args: any[]) => void) => void;\n    off?: (event: string, handler?: (...args: any[]) => void) => void;\n    disconnect?: () => void;\n    reconnect?: () => Promise<void>;\n  };\n\n  if (config.transport && typeof config.transport === \"object\") {\n    // Custom transport instance\n    transport = config.transport as any;\n  } else if (config.transport === \"sse\") {\n    transport = new SSETransport({\n      url: config.url,\n      key: config.key,\n      version,\n    });\n  } else {\n    // Default: Socket.IO\n    transport = new SocketTransport({\n      url: config.url,\n      key: config.key,\n      version,\n    });\n  }\n\n  // Wire up FrontendAdapter so Model.where(), .findById() etc work\n  Model.use(new FrontendAdapter(transport));\n\n  const client: ParcaeClient = {\n    transport,\n\n    get: (path, data) => transport.get(path, data),\n    post: (path, data) => transport.post(path, data),\n    put: (path, data) => transport.put(path, data),\n    patch: (path, data) => transport.patch(path, data),\n    delete: (path, data) => transport.delete(path, data),\n\n    subscribe(event, handler) {\n      if (transport.subscribe) return transport.subscribe(event, handler);\n      return () => {}; // no-op if transport doesn't support subscriptions\n    },\n\n    unsubscribe(event, handler) {\n      transport.unsubscribe?.(event, handler);\n    },\n\n    send(event, ...args) {\n      (transport as any).send?.(event, ...args);\n    },\n\n    get isConnected() {\n      return transport.isConnected ?? false;\n    },\n    get isLoading() {\n      return transport.isLoading ?? false;\n    },\n    get loading() {\n      return (transport as any).loading ?? Promise.resolve();\n    },\n    get authVersion() {\n      return (transport as any).authVersion ?? 0;\n    },\n\n    async setKey(key) {\n      if ((transport as any).setKey) await (transport as any).setKey(key);\n    },\n\n    on(event, handler) {\n      transport.on?.(event, handler);\n    },\n    off(event, handler) {\n      transport.off?.(event, handler);\n    },\n\n    disconnect() {\n      transport.disconnect?.();\n    },\n    async reconnect() {\n      await transport.reconnect?.();\n    },\n  };\n\n  return client;\n}\n"]}

package/dist/client-uWUdynht.d.ts

@@ -0,0 +1,63 @@
+import { Transport } from '@parcae/model';
+
+/**
+ * @parcae/sdk — createClient()
+ *
+ * Creates a Parcae client with a pluggable transport layer.
+ * Default: Socket.IO (bidirectional, realtime).
+ * Alternative: SSE (HTTP + Server-Sent Events, simpler).
+ *
+ * The transport is abstracted — the client exposes the same API
+ * regardless of which transport is used underneath.
+ */
+
+interface ClientConfig {
+    /** URL of the Parcae backend. */
+    url: string;
+    /** API key — string or async function that returns a key. */
+    key?: string | null | (() => Promise<string | null>);
+    /** API version prefix. Default: "v1" */
+    version?: string;
+    /**
+     * Transport type. Default: "socket"
+     * - "socket": Socket.IO (bidirectional, realtime subscriptions)
+     * - "sse": HTTP + Server-Sent Events (read-heavy, simpler infra)
+     * - Transport instance: provide your own Transport implementation
+     */
+    transport?: "socket" | "sse" | Transport;
+}
+interface ParcaeClient {
+    /** The underlying transport instance. */
+    transport: Transport;
+    /** Shorthand for transport methods. */
+    get(path: string, data?: any): Promise<any>;
+    post(path: string, data?: any): Promise<any>;
+    put(path: string, data?: any): Promise<any>;
+    patch(path: string, data?: any): Promise<any>;
+    delete(path: string, data?: any): Promise<any>;
+    /** Subscribe to a named event. Returns dispose function. */
+    subscribe(event: string, handler: (...args: any[]) => void): () => void;
+    /** Unsubscribe from a named event. */
+    unsubscribe(event: string, handler?: (...args: any[]) => void): void;
+    /** Send a control message. */
+    send(event: string, ...args: any[]): void;
+    /** Connection state. */
+    readonly isConnected: boolean;
+    readonly isLoading: boolean;
+    /** Promise that resolves when the client is ready. */
+    loading: Promise<void>;
+    /** Update the auth key. */
+    setKey(key: string | null | (() => Promise<string | null>)): Promise<void>;
+    /** Listen for transport events. */
+    on(event: string, handler: (...args: any[]) => void): void;
+    off(event: string, handler?: (...args: any[]) => void): void;
+    /** Disconnect from the server. */
+    disconnect(): void;
+    /** Reconnect. */
+    reconnect(): Promise<void>;
+    /** Auth version — incremented on auth changes. Useful for cache invalidation. */
+    readonly authVersion: number;
+}
+declare function createClient(config: ClientConfig): ParcaeClient;
+
+export { type ClientConfig as C, type ParcaeClient as P, createClient as c };

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+export { C as ClientConfig, P as ParcaeClient, c as createClient } from './client-uWUdynht.js';
+import { EventEmitter } from 'eventemitter3';
+import { Transport } from '@parcae/model';
+export { FrontendAdapter, Model, Transport } from '@parcae/model';
+
+/**
+ * SocketTransport — Socket.IO implementation of the Transport interface.
+ *
+ * Bidirectional, full-duplex. Best for apps that need realtime subscriptions
+ * (live query updates, collaborative editing, chat, etc.).
+ *
+ * Extracted from Dollhouse Studio's Dollhouse.ts (667 lines).
+ */
+
+interface SocketTransportConfig {
+    url: string;
+    key?: string | null | (() => Promise<string | null>);
+    version?: string;
+    /** Socket.IO path. Default: "/ws" */
+    path?: string;
+}
+declare class SocketTransport extends EventEmitter implements Transport {
+    private socket;
+    private pendingHandlers;
+    private apiKey;
+    private key;
+    private url;
+    private version;
+    private socketPath;
+    private waitForAuth;
+    private resolveAuth;
+    private inflight;
+    loading: Promise<void>;
+    isLoading: boolean;
+    isConnected: boolean;
+    isConnecting: boolean;
+    authVersion: number;
+    constructor(config: SocketTransportConfig);
+    setKey(key: string | null | (() => Promise<string | null>)): Promise<void>;
+    private init;
+    private setupEvents;
+    private fetch;
+    private _doFetch;
+    get(path: string, data?: any): Promise<any>;
+    post(path: string, data?: any): Promise<any>;
+    put(path: string, data?: any): Promise<any>;
+    patch(path: string, data?: any): Promise<any>;
+    delete(path: string, data?: any): Promise<any>;
+    subscribe(event: string, handler: (...args: any[]) => void): () => void;
+    unsubscribe(event: string, handler?: (...args: any[]) => void): void;
+    send(event: string, ...args: any[]): Promise<void>;
+    disconnect(): void;
+    reconnect(): Promise<void>;
+}
+
+/**
+ * SSETransport — HTTP + Server-Sent Events implementation of the Transport interface.
+ *
+ * Request/response via standard fetch(). Subscriptions via EventSource.
+ * Simpler than Socket.IO — no websocket infra needed. Good for read-heavy
+ * apps, serverless backends, or environments where WebSocket isn't available.
+ *
+ * Trade-offs vs SocketTransport:
+ * - Simpler infra (no sticky sessions, works behind any CDN/proxy)
+ * - Server → client streaming only (no client → server streaming)
+ * - Request/response is standard HTTP (cacheable, observable, debuggable)
+ * - No compression (relies on HTTP gzip)
+ * - No request deduplication (relies on HTTP/2 multiplexing)
+ */
+
+interface SSETransportConfig {
+    /** Base URL of the Parcae backend. */
+    url: string;
+    /** API key or async function returning a key. */
+    key?: string | null | (() => Promise<string | null>);
+    /** API version prefix. Default: "v1" */
+    version?: string;
+}
+declare class SSETransport extends EventEmitter implements Transport {
+    private url;
+    private version;
+    private apiKey;
+    private key;
+    private eventSources;
+    isConnected: boolean;
+    isLoading: boolean;
+    loading: Promise<void>;
+    constructor(config: SSETransportConfig);
+    private resolveKey;
+    private headers;
+    private fullUrl;
+    private request;
+    get(path: string, data?: any): Promise<any>;
+    post(path: string, data?: any): Promise<any>;
+    put(path: string, data?: any): Promise<any>;
+    patch(path: string, data?: any): Promise<any>;
+    delete(path: string, data?: any): Promise<any>;
+    subscribe(event: string, handler: (...args: any[]) => void): () => void;
+    unsubscribe(event: string): void;
+    send(event: string, ...args: any[]): Promise<void>;
+    disconnect(): void;
+    reconnect(): Promise<void>;
+}
+
+export { SSETransport, type SSETransportConfig, SocketTransport, type SocketTransportConfig };

package/dist/index.js

@@ -0,0 +1,4 @@
+export { SSETransport, SocketTransport, createClient } from './chunk-XAFYMW5P.js';
+export { FrontendAdapter, Model } from '@parcae/model';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/react/index.d.ts

@@ -0,0 +1,83 @@
+import * as React from 'react';
+import React__default from 'react';
+import { P as ParcaeClient, C as ClientConfig } from '../client-uWUdynht.js';
+import '@parcae/model';
+
+interface ParcaeProviderProps {
+    /** Pre-created client instance. If provided, url/key/transport are ignored. */
+    client?: ParcaeClient;
+    /** API base URL (required if no client provided). */
+    url?: string;
+    /** Bearer token or null (pre-auth). */
+    apiKey?: string | null;
+    /** Stable user ID — triggers re-auth when it changes. */
+    userId?: string | null;
+    /** API version. Default: "v1" */
+    version?: string;
+    /** Transport type. Default: "socket" */
+    transport?: ClientConfig["transport"];
+    children: React__default.ReactNode;
+    onReady?: (client: ParcaeClient) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * ParcaeProvider — creates the SDK client once and re-authenticates on userId change.
+ *
+ * Usage with pre-created client:
+ * ```tsx
+ * const client = createClient({ url: "...", transport: "socket" });
+ * <ParcaeProvider client={client}><App /></ParcaeProvider>
+ * ```
+ *
+ * Usage with inline config:
+ * ```tsx
+ * <ParcaeProvider url="http://localhost:3000" apiKey={token} userId={user.id}>
+ *   <App />
+ * </ParcaeProvider>
+ * ```
+ */
+declare const ParcaeProvider: React__default.FC<ParcaeProviderProps>;
+
+declare const ParcaeContext: React.Context<ParcaeClient | null>;
+declare function useParcae(): ParcaeClient;
+
+interface QueryChain<T> {
+    find(): Promise<T[]>;
+    __steps?: any[];
+    __modelType?: string;
+    __modelClass?: any;
+    __adapter?: any;
+    __debounceMs?: number;
+}
+interface UseQueryResult<T> {
+    items: T[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => void;
+}
+declare function useQuery<T>(chain: QueryChain<T> | null | undefined): UseQueryResult<T>;
+
+declare function useApi(): {
+    get: (path: string, data?: any) => Promise<any>;
+    post: (path: string, data?: any) => Promise<any>;
+    put: (path: string, data?: any) => Promise<any>;
+    patch: (path: string, data?: any) => Promise<any>;
+    delete: (path: string, data?: any) => Promise<any>;
+};
+/**
+ * useSDK — raw client instance.
+ */
+declare function useSDK(): ParcaeClient;
+/**
+ * useConnectionStatus — reactive connection state.
+ */
+declare function useConnectionStatus(): {
+    isConnected: boolean;
+    isLoading: boolean;
+};
+
+declare function useSetting<T = string>(key: string, defaultValue: T): [T, (value: T) => Promise<void>, {
+    isLoading: boolean;
+}];
+
+export { ParcaeContext, ParcaeProvider, type ParcaeProviderProps, useApi, useConnectionStatus, useParcae, useQuery, useSDK, useSetting };

package/dist/react/index.js

@@ -0,0 +1,260 @@
+import { createClient } from '../chunk-XAFYMW5P.js';
+import { createContext, useContext, useMemo, useRef, useEffect, useCallback, useSyncExternalStore, useState } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var ParcaeContext = createContext(null);
+function useParcae() {
+  const client = useContext(ParcaeContext);
+  if (!client) {
+    throw new Error("useParcae must be used within a <ParcaeProvider>");
+  }
+  return client;
+}
+var ParcaeProvider = ({
+  client: externalClient,
+  url,
+  apiKey,
+  userId,
+  version = "v1",
+  transport = "socket",
+  children,
+  onReady,
+  onError
+}) => {
+  const client = useMemo(() => {
+    if (externalClient) return externalClient;
+    if (!url)
+      throw new Error(
+        "ParcaeProvider requires either a `client` prop or a `url` prop"
+      );
+    return createClient({ url, version, transport, key: null });
+  }, [externalClient, url, version, transport]);
+  const apiKeyRef = useRef(apiKey);
+  apiKeyRef.current = apiKey;
+  const onReadyRef = useRef(onReady);
+  onReadyRef.current = onReady;
+  const onErrorRef = useRef(onError);
+  onErrorRef.current = onError;
+  useEffect(() => {
+    client.setKey(apiKeyRef.current ?? null).then(() => onReadyRef.current?.(client)).catch((err) => onErrorRef.current?.(err));
+  }, [userId, client]);
+  useEffect(() => {
+    const onErr = (err) => onErrorRef.current?.(err);
+    client.on("error", onErr);
+    return () => {
+      client.off("error", onErr);
+    };
+  }, [client]);
+  return /* @__PURE__ */ jsx(ParcaeContext.Provider, { value: client, children });
+};
+var CACHE_TIMEOUT_MS = 6e4;
+var DEFAULT_DEBOUNCE_MS = 100;
+var queryCache = /* @__PURE__ */ new Map();
+function buildCacheKey(chain, authVersion) {
+  const type = chain.__modelType ?? "unknown";
+  const steps = JSON.stringify(chain.__steps ?? []);
+  return `${type}:${authVersion}:${steps}`;
+}
+function useQuery(chain) {
+  const client = useParcae();
+  const authVersion = client.authVersion;
+  const cacheKey = chain ? buildCacheKey(chain, authVersion) : "__null__";
+  if (!queryCache.has(cacheKey) && chain) {
+    queryCache.set(cacheKey, {
+      items: [],
+      itemMap: /* @__PURE__ */ new Map(),
+      loading: true,
+      error: null,
+      refCount: 0,
+      timeoutHandle: null,
+      version: 0,
+      stateVersion: 0,
+      listeners: /* @__PURE__ */ new Set(),
+      subscriptionHash: null,
+      pendingOps: [],
+      debounceTimer: null,
+      debounceMs: chain.__debounceMs ?? DEFAULT_DEBOUNCE_MS,
+      disposeSubscription: null
+    });
+  }
+  const entry = queryCache.get(cacheKey);
+  const subscribe = useCallback(
+    (listener) => {
+      if (!entry) return () => {
+      };
+      entry.listeners.add(listener);
+      entry.refCount++;
+      if (entry.timeoutHandle) {
+        clearTimeout(entry.timeoutHandle);
+        entry.timeoutHandle = null;
+      }
+      return () => {
+        entry.listeners.delete(listener);
+        entry.refCount--;
+        if (entry.refCount <= 0) {
+          entry.timeoutHandle = setTimeout(() => {
+            entry.disposeSubscription?.();
+            queryCache.delete(cacheKey);
+          }, CACHE_TIMEOUT_MS);
+        }
+      };
+    },
+    [entry, cacheKey]
+  );
+  const getSnapshot = useCallback(() => entry?.stateVersion ?? 0, [entry]);
+  useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+  const refetch = useCallback(() => {
+    if (!chain || !entry) return;
+    entry.loading = true;
+    notifyListeners(entry);
+    chain.find().then((items) => {
+      entry.items = items;
+      entry.itemMap = new Map(items.map((item) => [item.id, item]));
+      entry.loading = false;
+      entry.error = null;
+      entry.version++;
+      notifyListeners(entry);
+    }).catch((err) => {
+      entry.error = err;
+      entry.loading = false;
+      notifyListeners(entry);
+    });
+    if (!entry.disposeSubscription && chain.__modelType) {
+      const subEvent = `query:${cacheKey}`;
+      client.send("subscribe:query", {
+        hash: cacheKey,
+        modelType: chain.__modelType,
+        steps: chain.__steps ?? []
+      });
+      const dispose = client.subscribe(subEvent, (ops) => {
+        if (!entry) return;
+        entry.pendingOps.push(...ops);
+        if (entry.debounceTimer) clearTimeout(entry.debounceTimer);
+        entry.debounceTimer = setTimeout(() => {
+          applyDiffOps(entry, chain);
+          entry.debounceTimer = null;
+        }, entry.debounceMs);
+      });
+      entry.subscriptionHash = cacheKey;
+      entry.disposeSubscription = () => {
+        dispose();
+        client.send("unsubscribe:query", { hash: cacheKey });
+      };
+    }
+  }, [chain, entry, cacheKey, client]);
+  useEffect(() => {
+    if (chain) refetch();
+  }, [cacheKey]);
+  if (!entry) {
+    return { items: [], loading: false, error: null, refetch: () => {
+    } };
+  }
+  return {
+    items: entry.items,
+    loading: entry.loading,
+    error: entry.error,
+    refetch
+  };
+}
+function notifyListeners(entry) {
+  entry.stateVersion++;
+  for (const listener of entry.listeners) listener();
+}
+function applyDiffOps(entry, chain) {
+  const ops = entry.pendingOps.splice(0);
+  if (!ops.length) return;
+  const ModelClass = chain.__modelClass;
+  const adapter = chain.__adapter;
+  let changed = false;
+  for (const op of ops) {
+    switch (op.op) {
+      case "add": {
+        if (!entry.itemMap.has(op.id) && op.data && ModelClass && adapter) {
+          const instance = new ModelClass(adapter, op.data);
+          entry.items.push(instance);
+          entry.itemMap.set(op.id, instance);
+          changed = true;
+        }
+        break;
+      }
+      case "remove": {
+        if (entry.itemMap.has(op.id)) {
+          entry.items = entry.items.filter((item) => item.id !== op.id);
+          entry.itemMap.delete(op.id);
+          changed = true;
+        }
+        break;
+      }
+      case "update": {
+        const existing = entry.itemMap.get(op.id);
+        if (existing && op.data) {
+          for (const [key, value] of Object.entries(op.data)) {
+            existing.__data[key] = value;
+          }
+          changed = true;
+        }
+        break;
+      }
+    }
+  }
+  if (changed) {
+    entry.version++;
+    notifyListeners(entry);
+  }
+}
+function useApi() {
+  const client = useParcae();
+  return useMemo(
+    () => ({
+      get: client.get.bind(client),
+      post: client.post.bind(client),
+      put: client.put.bind(client),
+      patch: client.patch.bind(client),
+      delete: client.delete.bind(client)
+    }),
+    [client]
+  );
+}
+function useSDK() {
+  return useParcae();
+}
+function useConnectionStatus() {
+  const client = useParcae();
+  return {
+    isConnected: client.isConnected,
+    isLoading: client.isLoading
+  };
+}
+function useSetting(key, defaultValue) {
+  const client = useParcae();
+  const [value, setValue] = useState(defaultValue);
+  const [isLoading, setIsLoading] = useState(true);
+  useEffect(() => {
+    let cancelled = false;
+    client.get(`/settings/${encodeURIComponent(key)}`).then((result) => {
+      if (!cancelled && result?.value !== void 0) {
+        setValue(result.value);
+      }
+    }).catch(() => {
+    }).finally(() => {
+      if (!cancelled) setIsLoading(false);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [key, client]);
+  const update = useCallback(
+    async (newValue) => {
+      setValue(newValue);
+      await client.put(`/settings/${encodeURIComponent(key)}`, {
+        value: newValue
+      });
+    },
+    [key, client]
+  );
+  return [value, update, { isLoading }];
+}
+
+export { ParcaeContext, ParcaeProvider, useApi, useConnectionStatus, useParcae, useQuery, useSDK, useSetting };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/context.ts","../../src/react/Provider.tsx","../../src/react/useQuery.ts","../../src/react/useApi.ts","../../src/react/useSetting.ts"],"names":["useEffect","useMemo","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, useContext } from \"react\";\nimport type { ParcaeClient } from \"../client\";\n\nexport const ParcaeContext = createContext<ParcaeClient | null>(null);\n\nexport function useParcae(): ParcaeClient {\n  const client = useContext(ParcaeContext);\n  if (!client) {\n    throw new Error(\"useParcae must be used within a <ParcaeProvider>\");\n  }\n  return client;\n}\n","\"use client\";\n\nimport React, { useEffect, useMemo, useRef } from \"react\";\nimport { createClient } from \"../client\";\nimport type { ParcaeClient, ClientConfig } from \"../client\";\nimport { ParcaeContext } from \"./context\";\n\nexport interface ParcaeProviderProps {\n  /** Pre-created client instance. If provided, url/key/transport are ignored. */\n  client?: ParcaeClient;\n  /** API base URL (required if no client provided). */\n  url?: string;\n  /** Bearer token or null (pre-auth). */\n  apiKey?: string | null;\n  /** Stable user ID — triggers re-auth when it changes. */\n  userId?: string | null;\n  /** API version. Default: \"v1\" */\n  version?: string;\n  /** Transport type. Default: \"socket\" */\n  transport?: ClientConfig[\"transport\"];\n  children: React.ReactNode;\n  onReady?: (client: ParcaeClient) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * ParcaeProvider — creates the SDK client once and re-authenticates on userId change.\n *\n * Usage with pre-created client:\n * ```tsx\n * const client = createClient({ url: \"...\", transport: \"socket\" });\n * <ParcaeProvider client={client}><App /></ParcaeProvider>\n * ```\n *\n * Usage with inline config:\n * ```tsx\n * <ParcaeProvider url=\"http://localhost:3000\" apiKey={token} userId={user.id}>\n *   <App />\n * </ParcaeProvider>\n * ```\n */\nexport const ParcaeProvider: React.FC<ParcaeProviderProps> = ({\n  client: externalClient,\n  url,\n  apiKey,\n  userId,\n  version = \"v1\",\n  transport = \"socket\",\n  children,\n  onReady,\n  onError,\n}) => {\n  // Create client once per url+version+transport (or use external)\n  const client = useMemo(() => {\n    if (externalClient) return externalClient;\n    if (!url)\n      throw new Error(\n        \"ParcaeProvider requires either a `client` prop or a `url` prop\",\n      );\n    return createClient({ url, version, transport, key: null });\n  }, [externalClient, url, version, transport]);\n\n  // Refs for callbacks to avoid re-running effects on unstable inline functions\n  const apiKeyRef = useRef(apiKey);\n  apiKeyRef.current = apiKey;\n  const onReadyRef = useRef(onReady);\n  onReadyRef.current = onReady;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n\n  // Re-authenticate when userId changes\n  useEffect(() => {\n    client\n      .setKey(apiKeyRef.current ?? null)\n      .then(() => onReadyRef.current?.(client))\n      .catch((err) => onErrorRef.current?.(err));\n  }, [userId, client]);\n\n  // Forward transport errors\n  useEffect(() => {\n    const onErr = (err: Error) => onErrorRef.current?.(err);\n    client.on(\"error\", onErr);\n    return () => {\n      client.off(\"error\", onErr);\n    };\n  }, [client]);\n\n  return (\n    <ParcaeContext.Provider value={client}>{children}</ParcaeContext.Provider>\n  );\n};\n\nexport default ParcaeProvider;\n","\"use client\";\n\n/**\n * useQuery — reactive data fetching with realtime subscriptions.\n *\n * Takes a query chain, returns an array of typed model instances.\n * Subscribes to realtime updates — the server diffs queries on model changes\n * and pushes surgical add/remove/update ops.\n *\n * @example\n * ```tsx\n * const { items, loading } = useQuery(Post.where({ published: true }));\n * ```\n */\n\nimport { useCallback, useEffect, useSyncExternalStore } from \"react\";\nimport { useParcae } from \"./context\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\ninterface QueryChain<T> {\n  find(): Promise<T[]>;\n  __steps?: any[];\n  __modelType?: string;\n  __modelClass?: any;\n  __adapter?: any;\n  __debounceMs?: number;\n}\n\ninterface UseQueryResult<T> {\n  items: T[];\n  loading: boolean;\n  error: Error | null;\n  refetch: () => void;\n}\n\ninterface DiffOp {\n  op: \"add\" | \"remove\" | \"update\";\n  id: string;\n  data?: Record<string, any>;\n}\n\n// ─── Query Cache ─────────────────────────────────────────────────────────────\n\nconst CACHE_TIMEOUT_MS = 60_000;\nconst DEFAULT_DEBOUNCE_MS = 100;\n\ninterface CacheEntry<T = any> {\n  items: T[];\n  itemMap: Map<string, T>;\n  loading: boolean;\n  error: Error | null;\n  refCount: number;\n  timeoutHandle: ReturnType<typeof setTimeout> | null;\n  version: number;\n  stateVersion: number;\n  listeners: Set<() => void>;\n  subscriptionHash: string | null;\n  pendingOps: DiffOp[];\n  debounceTimer: ReturnType<typeof setTimeout> | null;\n  debounceMs: number;\n  disposeSubscription: (() => void) | null;\n}\n\nconst queryCache = new Map<string, CacheEntry>();\n\nfunction buildCacheKey(chain: QueryChain<any>, authVersion: number): string {\n  const type = chain.__modelType ?? \"unknown\";\n  const steps = JSON.stringify(chain.__steps ?? []);\n  return `${type}:${authVersion}:${steps}`;\n}\n\n// ─── useQuery ────────────────────────────────────────────────────────────────\n\nexport function useQuery<T>(\n  chain: QueryChain<T> | null | undefined,\n): UseQueryResult<T> {\n  const client = useParcae();\n  const authVersion = client.authVersion;\n\n  const cacheKey = chain ? buildCacheKey(chain, authVersion) : \"__null__\";\n\n  // ── Get or create cache entry ──────────────────────────────────────\n\n  if (!queryCache.has(cacheKey) && chain) {\n    queryCache.set(cacheKey, {\n      items: [],\n      itemMap: new Map(),\n      loading: true,\n      error: null,\n      refCount: 0,\n      timeoutHandle: null,\n      version: 0,\n      stateVersion: 0,\n      listeners: new Set(),\n      subscriptionHash: null,\n      pendingOps: [],\n      debounceTimer: null,\n      debounceMs: chain.__debounceMs ?? DEFAULT_DEBOUNCE_MS,\n      disposeSubscription: null,\n    });\n  }\n\n  const entry = queryCache.get(cacheKey);\n\n  // ── useSyncExternalStore for tear-safe rendering ───────────────────\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      if (!entry) return () => {};\n      entry.listeners.add(listener);\n      entry.refCount++;\n\n      // Cancel pending GC\n      if (entry.timeoutHandle) {\n        clearTimeout(entry.timeoutHandle);\n        entry.timeoutHandle = null;\n      }\n\n      return () => {\n        entry.listeners.delete(listener);\n        entry.refCount--;\n\n        // GC: if no subscribers left, schedule cleanup\n        if (entry.refCount <= 0) {\n          entry.timeoutHandle = setTimeout(() => {\n            entry.disposeSubscription?.();\n            queryCache.delete(cacheKey);\n          }, CACHE_TIMEOUT_MS);\n        }\n      };\n    },\n    [entry, cacheKey],\n  );\n\n  const getSnapshot = useCallback(() => entry?.stateVersion ?? 0, [entry]);\n\n  useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n  // ── Fetch + subscribe ──────────────────────────────────────────────\n\n  const refetch = useCallback(() => {\n    if (!chain || !entry) return;\n\n    entry.loading = true;\n    notifyListeners(entry);\n\n    chain\n      .find()\n      .then((items) => {\n        entry.items = items;\n        entry.itemMap = new Map(items.map((item: any) => [item.id, item]));\n        entry.loading = false;\n        entry.error = null;\n        entry.version++;\n        notifyListeners(entry);\n      })\n      .catch((err) => {\n        entry.error = err;\n        entry.loading = false;\n        notifyListeners(entry);\n      });\n\n    // Set up realtime subscription if transport supports it\n    if (!entry.disposeSubscription && chain.__modelType) {\n      const subEvent = `query:${cacheKey}`;\n\n      // Ask server to subscribe to this query\n      client.send(\"subscribe:query\", {\n        hash: cacheKey,\n        modelType: chain.__modelType,\n        steps: chain.__steps ?? [],\n      });\n\n      // Listen for diff ops from the server\n      const dispose = client.subscribe(subEvent, (ops: DiffOp[]) => {\n        if (!entry) return;\n        entry.pendingOps.push(...ops);\n\n        // Debounce application of ops\n        if (entry.debounceTimer) clearTimeout(entry.debounceTimer);\n        entry.debounceTimer = setTimeout(() => {\n          applyDiffOps(entry, chain);\n          entry.debounceTimer = null;\n        }, entry.debounceMs);\n      });\n\n      entry.subscriptionHash = cacheKey;\n      entry.disposeSubscription = () => {\n        dispose();\n        client.send(\"unsubscribe:query\", { hash: cacheKey });\n      };\n    }\n  }, [chain, entry, cacheKey, client]);\n\n  // Initial fetch on mount / chain change\n  useEffect(() => {\n    if (chain) refetch();\n  }, [cacheKey]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  if (!entry) {\n    return { items: [], loading: false, error: null, refetch: () => {} };\n  }\n\n  return {\n    items: entry.items,\n    loading: entry.loading,\n    error: entry.error,\n    refetch,\n  };\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nfunction notifyListeners(entry: CacheEntry): void {\n  entry.stateVersion++;\n  for (const listener of entry.listeners) listener();\n}\n\nfunction applyDiffOps<T>(entry: CacheEntry<T>, chain: QueryChain<T>): void {\n  const ops = entry.pendingOps.splice(0);\n  if (!ops.length) return;\n\n  const ModelClass = chain.__modelClass;\n  const adapter = chain.__adapter;\n  let changed = false;\n\n  for (const op of ops) {\n    switch (op.op) {\n      case \"add\": {\n        if (!entry.itemMap.has(op.id) && op.data && ModelClass && adapter) {\n          const instance = new ModelClass(adapter, op.data);\n          entry.items.push(instance);\n          entry.itemMap.set(op.id, instance);\n          changed = true;\n        }\n        break;\n      }\n      case \"remove\": {\n        if (entry.itemMap.has(op.id)) {\n          entry.items = entry.items.filter((item: any) => item.id !== op.id);\n          entry.itemMap.delete(op.id);\n          changed = true;\n        }\n        break;\n      }\n      case \"update\": {\n        const existing = entry.itemMap.get(op.id) as any;\n        if (existing && op.data) {\n          for (const [key, value] of Object.entries(op.data)) {\n            existing.__data[key] = value;\n          }\n          changed = true;\n        }\n        break;\n      }\n    }\n  }\n\n  if (changed) {\n    entry.version++;\n    notifyListeners(entry);\n  }\n}\n","\"use client\";\n\n/**\n * useApi — pre-bound HTTP methods from the Parcae client.\n *\n * @example\n * ```tsx\n * const { get, post } = useApi();\n * const data = await get(\"/custom-endpoint\");\n * ```\n */\n\nimport { useMemo } from \"react\";\nimport { useParcae } from \"./context\";\n\nexport function useApi() {\n  const client = useParcae();\n\n  return useMemo(\n    () => ({\n      get: client.get.bind(client),\n      post: client.post.bind(client),\n      put: client.put.bind(client),\n      patch: client.patch.bind(client),\n      delete: client.delete.bind(client),\n    }),\n    [client],\n  );\n}\n\n/**\n * useSDK — raw client instance.\n */\nexport function useSDK() {\n  return useParcae();\n}\n\n/**\n * useConnectionStatus — reactive connection state.\n */\nexport function useConnectionStatus() {\n  const client = useParcae();\n  // This is a snapshot — for true reactivity, components should\n  // listen to client.on(\"connected\"/\"disconnected\") events.\n  return {\n    isConnected: client.isConnected,\n    isLoading: client.isLoading,\n  };\n}\n","\"use client\";\n\n/**\n * useSetting — key-value user settings stored as a Setting model.\n *\n * @example\n * ```tsx\n * const [theme, setTheme, { isLoading }] = useSetting(\"theme\", \"light\");\n * ```\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useParcae } from \"./context\";\n\nexport function useSetting<T = string>(\n  key: string,\n  defaultValue: T,\n): [T, (value: T) => Promise<void>, { isLoading: boolean }] {\n  const client = useParcae();\n  const [value, setValue] = useState<T>(defaultValue);\n  const [isLoading, setIsLoading] = useState(true);\n\n  useEffect(() => {\n    let cancelled = false;\n\n    client\n      .get(`/settings/${encodeURIComponent(key)}`)\n      .then((result) => {\n        if (!cancelled && result?.value !== undefined) {\n          setValue(result.value);\n        }\n      })\n      .catch(() => {\n        // Setting doesn't exist yet — use default\n      })\n      .finally(() => {\n        if (!cancelled) setIsLoading(false);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [key, client]);\n\n  const update = useCallback(\n    async (newValue: T) => {\n      setValue(newValue);\n      await client.put(`/settings/${encodeURIComponent(key)}`, {\n        value: newValue,\n      });\n    },\n    [key, client],\n  );\n\n  return [value, update, { isLoading }];\n}\n"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@parcae/sdk",
+  "version": "0.0.1",
+  "description": "Parcae SDK — client transport and React hooks for Parcae backends",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@parcae/model": "^0.0.1",
+    "compress-json": "^3.1.0",
+    "eventemitter3": "^5.0.1",
+    "pako": "^2.1.0",
+    "short-unique-id": "^5.2.0",
+    "socket.io-client": "^4.8.0"
+  },
+  "devDependencies": {
+    "@types/pako": "^2.0.3",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "license": "MIT"
+}