@omniaura/solid-pulse 0.1.0

package/dist/chunk-TVSI7G5S.js

@@ -0,0 +1,414 @@
+import {
+  DEFAULT_PATH,
+  PROTOCOL_VERSION,
+  isPageFrame
+} from "./chunk-4QA2G6S3.js";
+
+// src/bridge/server.ts
+import { createServer } from "http";
+import { WebSocketServer } from "ws";
+
+// src/core/ring-buffer.ts
+var RingBuffer = class {
+  constructor(capacity) {
+    this.capacity = capacity;
+    if (!Number.isInteger(capacity) || capacity <= 0) {
+      throw new RangeError(`RingBuffer capacity must be a positive integer, got ${capacity}`);
+    }
+    this.items = new Array(capacity);
+  }
+  capacity;
+  items;
+  head = 0;
+  count = 0;
+  /** Total number of pushes since creation (dropped + retained). */
+  pushed = 0;
+  get size() {
+    return this.count;
+  }
+  get dropped() {
+    return this.pushed - this.count;
+  }
+  push(item) {
+    const idx = (this.head + this.count) % this.capacity;
+    if (this.count === this.capacity) {
+      this.items[this.head] = item;
+      this.head = (this.head + 1) % this.capacity;
+    } else {
+      this.items[idx] = item;
+      this.count++;
+    }
+    this.pushed++;
+  }
+  /** Oldest → newest. */
+  toArray() {
+    const out = new Array(this.count);
+    for (let i = 0; i < this.count; i++) {
+      out[i] = this.items[(this.head + i) % this.capacity];
+    }
+    return out;
+  }
+  clear() {
+    this.items = new Array(this.capacity);
+    this.head = 0;
+    this.count = 0;
+  }
+};
+
+// src/core/events.ts
+var KIND_GROUPS = {
+  solid: [
+    "solid.flush",
+    "solid.computation",
+    "solid.component.mount",
+    "solid.component.dispose",
+    "solid.component.remount",
+    "solid.root"
+  ],
+  dom: ["dom.mutation", "dom.detach", "dom.reattach", "focus.lost"],
+  net: [
+    "net.fetch.start",
+    "net.fetch.end",
+    "net.fetch.error",
+    "net.ws.open",
+    "net.ws.message",
+    "net.ws.close",
+    "net.ws.error",
+    "net.sse.open",
+    "net.sse.message",
+    "net.sse.error",
+    "net.sse.close"
+  ],
+  query: [
+    "query.added",
+    "query.removed",
+    "query.observe",
+    "query.unobserve",
+    "query.fetch.start",
+    "query.fetch.success",
+    "query.fetch.error",
+    "query.invalidate",
+    "query.update",
+    "mutation.start",
+    "mutation.success",
+    "mutation.error"
+  ],
+  pulse: ["pulse.note"]
+};
+var ALL_KINDS = Object.values(KIND_GROUPS).flat();
+function expandKinds(filters) {
+  const out = /* @__PURE__ */ new Set();
+  for (const raw of filters) {
+    const f = raw.trim();
+    if (!f) continue;
+    if (f === "*" || f === "all") {
+      for (const k of ALL_KINDS) out.add(k);
+      continue;
+    }
+    const group = KIND_GROUPS[f];
+    if (group) {
+      for (const k of group) out.add(k);
+      continue;
+    }
+    if (f.endsWith("*")) {
+      const prefix = f.slice(0, -1);
+      for (const k of ALL_KINDS) if (k.startsWith(prefix)) out.add(k);
+      continue;
+    }
+    if (ALL_KINDS.includes(f)) out.add(f);
+  }
+  return out;
+}
+
+// src/bridge/server.ts
+var LOOPBACK = /* @__PURE__ */ new Set(["127.0.0.1", "::1", "::ffff:127.0.0.1", "localhost"]);
+function hostIsLocal(host) {
+  if (!host) return false;
+  const h = host.replace(/^\[/, "").replace(/\]?(:\d+)?$/, "");
+  return LOOPBACK.has(h) || h.endsWith(".localhost");
+}
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    let data = "";
+    req.on("data", (c) => {
+      data += c.toString();
+      if (data.length > 1e6) reject(new Error("body too large"));
+    });
+    req.on("end", () => resolve(data));
+    req.on("error", reject);
+  });
+}
+function json(res, status, body) {
+  res.writeHead(status, { "content-type": "application/json", "cache-control": "no-store" });
+  res.end(JSON.stringify(body));
+}
+var BridgeServer = class {
+  path;
+  clients = /* @__PURE__ */ new Map();
+  wss;
+  listeners = /* @__PURE__ */ new Set();
+  nextCommand = 1;
+  startedWall = Date.now();
+  opts;
+  constructor(options = {}) {
+    this.path = (options.path ?? DEFAULT_PATH).replace(/\/$/, "");
+    this.opts = {
+      path: this.path,
+      allowRemote: options.allowRemote ?? false,
+      bufferSize: options.bufferSize ?? 5e3,
+      commandTimeoutMs: options.commandTimeoutMs ?? 1e4,
+      log: options.log ?? (() => {
+      })
+    };
+    this.wss = new WebSocketServer({ noServer: true });
+    this.wss.on("connection", (ws) => this.onConnection(ws));
+  }
+  /** Attach the WebSocket upgrade handler to an existing http server (e.g. Vite's). */
+  attach(server) {
+    server.on("upgrade", (req, socket, head) => {
+      const url = req.url ?? "";
+      if (url.split("?")[0] !== `${this.path}/ws`) return;
+      if (!this.isAllowed(req)) {
+        socket.write("HTTP/1.1 403 Forbidden\r\n\r\n");
+        socket.destroy();
+        return;
+      }
+      this.wss.handleUpgrade(req, socket, head, (ws) => this.wss.emit("connection", ws, req));
+    });
+  }
+  isAllowed(req) {
+    if (this.opts.allowRemote) return true;
+    const remote = req.socket.remoteAddress ?? "";
+    return LOOPBACK.has(remote) && hostIsLocal(req.headers.host);
+  }
+  /** Connect middleware: handles `<path>/api/*`; returns false when the URL is not ours. */
+  handleHttp(req, res) {
+    const raw = req.url ?? "";
+    if (!raw.startsWith(`${this.path}/api`)) return false;
+    void this.route(req, res).catch((err) => json(res, 500, { error: String(err instanceof Error ? err.message : err) }));
+    return true;
+  }
+  async route(req, res) {
+    if (!this.isAllowed(req)) return json(res, 403, { error: "solid-pulse bridge is loopback-only (set allowRemote to override)" });
+    const url = new URL(req.url ?? "/", "http://localhost");
+    const route = url.pathname.slice(`${this.path}/api`.length).replace(/\/$/, "") || "/";
+    const method = req.method ?? "GET";
+    const clientParam = url.searchParams.get("client") ?? void 0;
+    if (route === "/status" && method === "GET") return json(res, 200, this.status());
+    if (route === "/clients" && method === "GET") return json(res, 200, this.listClients());
+    if (route === "/commands" && method === "GET") {
+      const c = this.pick(clientParam);
+      return c ? json(res, 200, { client: c.summary.clientId, commands: c.commands }) : json(res, 404, { error: this.noClientMessage(clientParam) });
+    }
+    if (route === "/command" && (method === "POST" || method === "GET")) {
+      let name;
+      let args = {};
+      let client = clientParam;
+      if (method === "POST") {
+        const body = JSON.parse(await readBody(req) || "{}");
+        name = body.name;
+        args = body.args ?? {};
+        client = body.client ?? client;
+      } else {
+        name = url.searchParams.get("name") ?? void 0;
+        const a = url.searchParams.get("args");
+        args = a ? JSON.parse(a) : {};
+      }
+      if (!name) return json(res, 400, { error: "name is required" });
+      const c = this.pick(client);
+      if (!c) return json(res, 404, { error: this.noClientMessage(client) });
+      const result = await this.command(c.summary.clientId, name, args);
+      return json(res, result.ok ? 200 : 400, { client: c.summary.clientId, name, ...result });
+    }
+    if (route === "/events" && method === "GET") {
+      const c = this.pick(clientParam);
+      if (!c) return json(res, 404, { error: this.noClientMessage(clientParam) });
+      const events = this.events(c.summary.clientId, {
+        since: Number(url.searchParams.get("since") ?? 0),
+        kinds: url.searchParams.get("kinds")?.split(",").filter(Boolean),
+        limit: Number(url.searchParams.get("limit") ?? 200)
+      });
+      return json(res, 200, { client: c.summary.clientId, count: events.length, last: events.at(-1)?.seq ?? 0, events });
+    }
+    if (route === "/events/stream" && method === "GET") {
+      const c = this.pick(clientParam);
+      const kinds = url.searchParams.get("kinds")?.split(",").filter(Boolean);
+      const kindSet = kinds && kinds.length ? expandKinds(kinds) : null;
+      const target = c?.summary.clientId ?? clientParam;
+      res.writeHead(200, { "content-type": "text/event-stream", "cache-control": "no-store", connection: "keep-alive" });
+      res.write(`: solid-pulse stream client=${target ?? "*"}
+
+`);
+      const listener = (clientId, events) => {
+        if (target && clientId !== target) return;
+        for (const e of events) {
+          if (kindSet && !kindSet.has(e.kind)) continue;
+          res.write(`event: pulse
+data: ${JSON.stringify({ client: clientId, ...e })}
+
+`);
+        }
+      };
+      this.listeners.add(listener);
+      const ka = setInterval(() => res.write(":keepalive\n\n"), 15e3);
+      req.on("close", () => {
+        clearInterval(ka);
+        this.listeners.delete(listener);
+      });
+      return;
+    }
+    json(res, 404, { error: `unknown route ${method} ${route}` });
+  }
+  noClientMessage(requested) {
+    return requested ? `no connected page with client id "${requested}" (see /api/clients)` : "no page connected to the bridge \u2014 open the app in a browser with solid-pulse enabled";
+  }
+  onConnection(ws) {
+    let state = null;
+    ws.on("message", (raw) => {
+      let frame;
+      try {
+        frame = JSON.parse(raw.toString());
+      } catch {
+        return;
+      }
+      if (!isPageFrame(frame)) return;
+      if (frame.type === "hello") {
+        const existing = this.clients.get(frame.clientId);
+        if (existing && existing.ws !== ws) existing.ws.close(4e3, "replaced by a newer connection");
+        state = {
+          ws,
+          summary: { clientId: frame.clientId, url: frame.url, title: frame.title, userAgent: frame.userAgent, connectedWall: Date.now(), lastSeenWall: Date.now(), events: 0, commands: frame.commands.length },
+          commands: frame.commands,
+          buffer: existing?.buffer ?? new RingBuffer(this.opts.bufferSize),
+          pending: /* @__PURE__ */ new Map()
+        };
+        this.clients.set(frame.clientId, state);
+        ws.send(JSON.stringify({ type: "welcome", clientId: frame.clientId, protocol: PROTOCOL_VERSION }));
+        this.opts.log(`client connected ${frame.clientId} ${frame.url}`);
+        return;
+      }
+      if (!state) return;
+      state.summary.lastSeenWall = Date.now();
+      if (frame.type === "events") {
+        const fresh = [];
+        for (const e of frame.events) {
+          const last = state.buffer.size ? state.buffer.toArray().at(-1).seq : 0;
+          if (e.seq <= last) continue;
+          state.buffer.push(e);
+          fresh.push(e);
+        }
+        state.summary.events += fresh.length;
+        if (fresh.length) for (const l of this.listeners) l(state.summary.clientId, fresh);
+      } else if (frame.type === "result") {
+        const p = state.pending.get(frame.id);
+        if (p) {
+          clearTimeout(p.timer);
+          state.pending.delete(frame.id);
+          p.resolve(frame.result);
+        }
+      }
+    });
+    ws.on("close", () => {
+      if (state && this.clients.get(state.summary.clientId)?.ws === ws) {
+        this.clients.delete(state.summary.clientId);
+        for (const p of state.pending.values()) {
+          clearTimeout(p.timer);
+          p.resolve({ ok: false, error: "page disconnected" });
+        }
+        this.opts.log(`client disconnected ${state.summary.clientId}`);
+      }
+    });
+  }
+  /** Pick a client: explicit id, else the most recently seen. */
+  pick(clientId) {
+    if (clientId) return this.clients.get(clientId) ?? null;
+    let best = null;
+    for (const c of this.clients.values()) if (!best || c.summary.lastSeenWall > best.summary.lastSeenWall) best = c;
+    return best;
+  }
+  listClients() {
+    return [...this.clients.values()].map((c) => c.summary);
+  }
+  status() {
+    return { tool: "@omniaura/solid-pulse", protocol: PROTOCOL_VERSION, path: this.path, uptimeMs: Date.now() - this.startedWall, allowRemote: this.opts.allowRemote, clients: this.listClients() };
+  }
+  events(clientId, opts = {}) {
+    const c = this.clients.get(clientId);
+    if (!c) return [];
+    const kinds = opts.kinds && opts.kinds.length ? expandKinds(opts.kinds) : null;
+    const out = c.buffer.toArray().filter((e) => e.seq > (opts.since ?? 0) && (!kinds || kinds.has(e.kind)));
+    const limit = opts.limit ?? 200;
+    return out.length > limit ? out.slice(out.length - limit) : out;
+  }
+  command(clientId, name, args = {}) {
+    const c = this.clients.get(clientId);
+    if (!c) return Promise.resolve({ ok: false, error: `client not connected: ${clientId}` });
+    const id = `c${this.nextCommand++}`;
+    const frame = { type: "command", id, name, args };
+    return new Promise((resolve) => {
+      const timer = setTimeout(() => {
+        c.pending.delete(id);
+        resolve({ ok: false, error: `command timed out after ${this.opts.commandTimeoutMs}ms` });
+      }, this.opts.commandTimeoutMs);
+      c.pending.set(id, {
+        resolve: (result) => {
+          if (name === "events.clear" && result.ok) c.buffer.clear();
+          resolve(result);
+        },
+        timer
+      });
+      c.ws.send(JSON.stringify(frame));
+    });
+  }
+  onEvents(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  close() {
+    for (const c of this.clients.values()) c.ws.terminate();
+    this.clients.clear();
+    this.wss.close();
+  }
+};
+function startBridgeServer(options = {}) {
+  const bridge = new BridgeServer(options);
+  const server = createServer((req, res) => {
+    if (bridge.handleHttp(req, res)) return;
+    json(res, 404, { error: "not found", hint: `${bridge.path}/api/status` });
+  });
+  bridge.attach(server);
+  const host = options.host ?? "127.0.0.1";
+  const port = options.port ?? 4567;
+  const ready = new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(port, host, () => {
+      const addr = server.address();
+      const actual = typeof addr === "object" && addr ? addr.port : port;
+      resolve({ url: `http://${host}:${actual}${bridge.path}`, port: actual });
+    });
+  });
+  return {
+    bridge,
+    server,
+    ready,
+    url: `http://${host}:${port}${bridge.path}`,
+    close: () => new Promise((resolve) => {
+      bridge.close();
+      let done = false;
+      const finish = () => {
+        if (done) return;
+        done = true;
+        resolve();
+      };
+      server.close(finish);
+      server.closeAllConnections?.();
+      setTimeout(finish, 500).unref?.();
+    })
+  };
+}
+
+export {
+  BridgeServer,
+  startBridgeServer
+};
+//# sourceMappingURL=chunk-TVSI7G5S.js.map

package/dist/chunk-TVSI7G5S.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge/server.ts","../src/core/ring-buffer.ts","../src/core/events.ts"],"sourcesContent":["/**\n * Bridge server (Node/Bun). Accepts page runtimes over WebSocket at\n * `<path>/ws`, mirrors their events into a per-client ring buffer, and exposes\n * a small HTTP API for CLIs and agents at `<path>/api/*`:\n *\n *   GET  /api/status                    server + connected clients\n *   GET  /api/clients\n *   GET  /api/commands?client=          the page's command contract\n *   POST /api/command {client?,name,args}   run a command in the page\n *   GET  /api/command?name=&args=<json>&client=   (curl-friendly)\n *   GET  /api/events?client=&since=&kinds=&limit=\n *   GET  /api/events/stream?client=&kinds=        SSE, one `pulse` event per PulseEvent\n *\n * Access: loopback only unless `allowRemote` is set — remote address and Host\n * header are both checked, so a LAN dev server does not leak instrumentation.\n */\n\nimport type { IncomingMessage, Server as HttpServer, ServerResponse } from \"node:http\";\nimport { createServer } from \"node:http\";\nimport type { Duplex } from \"node:stream\";\nimport { WebSocketServer, type WebSocket } from \"ws\";\nimport { RingBuffer } from \"../core/ring-buffer.js\";\nimport { expandKinds, type PulseEvent } from \"../core/events.js\";\nimport type { CommandResult, CommandSpec } from \"../core/controller.js\";\nimport { DEFAULT_PATH, PROTOCOL_VERSION, isPageFrame, type ClientSummary, type CommandFrame } from \"../core/protocol.js\";\n\nexport interface BridgeServerOptions {\n  /** URL prefix (default `/__pulse`). */\n  path?: string;\n  /** Accept non-loopback peers and hosts (default false). */\n  allowRemote?: boolean;\n  /** Per-client mirror buffer (default 5000 events). */\n  bufferSize?: number;\n  /** Command timeout in ms (default 10000). */\n  commandTimeoutMs?: number;\n  log?: (message: string) => void;\n}\n\ninterface ClientState {\n  ws: WebSocket;\n  summary: ClientSummary;\n  commands: CommandSpec[];\n  buffer: RingBuffer<PulseEvent>;\n  pending: Map<string, { resolve: (r: CommandResult) => void; timer: ReturnType<typeof setTimeout> }>;\n}\n\ntype EventListener = (clientId: string, events: PulseEvent[]) => void;\n\nconst LOOPBACK = new Set([\"127.0.0.1\", \"::1\", \"::ffff:127.0.0.1\", \"localhost\"]);\n\nfunction hostIsLocal(host: string | undefined): boolean {\n  if (!host) return false;\n  const h = host.replace(/^\\[/, \"\").replace(/\\]?(:\\d+)?$/, \"\");\n  return LOOPBACK.has(h) || h.endsWith(\".localhost\");\n}\n\nfunction readBody(req: IncomingMessage): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let data = \"\";\n    req.on(\"data\", (c: Buffer) => {\n      data += c.toString();\n      if (data.length > 1_000_000) reject(new Error(\"body too large\"));\n    });\n    req.on(\"end\", () => resolve(data));\n    req.on(\"error\", reject);\n  });\n}\n\nfunction json(res: ServerResponse, status: number, body: unknown) {\n  res.writeHead(status, { \"content-type\": \"application/json\", \"cache-control\": \"no-store\" });\n  res.end(JSON.stringify(body));\n}\n\nexport class BridgeServer {\n  readonly path: string;\n  private clients = new Map<string, ClientState>();\n  private wss: WebSocketServer;\n  private listeners = new Set<EventListener>();\n  private nextCommand = 1;\n  private startedWall = Date.now();\n  private opts: Required<Omit<BridgeServerOptions, \"log\">> & { log: (m: string) => void };\n\n  constructor(options: BridgeServerOptions = {}) {\n    this.path = (options.path ?? DEFAULT_PATH).replace(/\\/$/, \"\");\n    this.opts = {\n      path: this.path,\n      allowRemote: options.allowRemote ?? false,\n      bufferSize: options.bufferSize ?? 5000,\n      commandTimeoutMs: options.commandTimeoutMs ?? 10_000,\n      log: options.log ?? (() => {}),\n    };\n    this.wss = new WebSocketServer({ noServer: true });\n    this.wss.on(\"connection\", (ws) => this.onConnection(ws));\n  }\n\n  /** Attach the WebSocket upgrade handler to an existing http server (e.g. Vite's). */\n  attach(server: HttpServer) {\n    server.on(\"upgrade\", (req: IncomingMessage, socket: Duplex, head: Buffer) => {\n      const url = req.url ?? \"\";\n      if (url.split(\"?\")[0] !== `${this.path}/ws`) return; // not ours (Vite HMR etc.)\n      if (!this.isAllowed(req)) {\n        socket.write(\"HTTP/1.1 403 Forbidden\\r\\n\\r\\n\");\n        socket.destroy();\n        return;\n      }\n      this.wss.handleUpgrade(req, socket, head, (ws) => this.wss.emit(\"connection\", ws, req));\n    });\n  }\n\n  isAllowed(req: IncomingMessage): boolean {\n    if (this.opts.allowRemote) return true;\n    const remote = req.socket.remoteAddress ?? \"\";\n    return LOOPBACK.has(remote) && hostIsLocal(req.headers.host);\n  }\n\n  /** Connect middleware: handles `<path>/api/*`; returns false when the URL is not ours. */\n  handleHttp(req: IncomingMessage, res: ServerResponse): boolean {\n    const raw = req.url ?? \"\";\n    if (!raw.startsWith(`${this.path}/api`)) return false;\n    void this.route(req, res).catch((err) => json(res, 500, { error: String(err instanceof Error ? err.message : err) }));\n    return true;\n  }\n\n  private async route(req: IncomingMessage, res: ServerResponse) {\n    if (!this.isAllowed(req)) return json(res, 403, { error: \"solid-pulse bridge is loopback-only (set allowRemote to override)\" });\n    const url = new URL(req.url ?? \"/\", \"http://localhost\");\n    const route = url.pathname.slice(`${this.path}/api`.length).replace(/\\/$/, \"\") || \"/\";\n    const method = req.method ?? \"GET\";\n    const clientParam = url.searchParams.get(\"client\") ?? undefined;\n\n    if (route === \"/status\" && method === \"GET\") return json(res, 200, this.status());\n    if (route === \"/clients\" && method === \"GET\") return json(res, 200, this.listClients());\n    if (route === \"/commands\" && method === \"GET\") {\n      const c = this.pick(clientParam);\n      return c ? json(res, 200, { client: c.summary.clientId, commands: c.commands }) : json(res, 404, { error: this.noClientMessage(clientParam) });\n    }\n    if (route === \"/command\" && (method === \"POST\" || method === \"GET\")) {\n      let name: string | undefined;\n      let args: Record<string, unknown> = {};\n      let client = clientParam;\n      if (method === \"POST\") {\n        const body = JSON.parse((await readBody(req)) || \"{}\") as { client?: string; name?: string; args?: Record<string, unknown> };\n        name = body.name;\n        args = body.args ?? {};\n        client = body.client ?? client;\n      } else {\n        name = url.searchParams.get(\"name\") ?? undefined;\n        const a = url.searchParams.get(\"args\");\n        args = a ? (JSON.parse(a) as Record<string, unknown>) : {};\n      }\n      if (!name) return json(res, 400, { error: \"name is required\" });\n      const c = this.pick(client);\n      if (!c) return json(res, 404, { error: this.noClientMessage(client) });\n      const result = await this.command(c.summary.clientId, name, args);\n      return json(res, result.ok ? 200 : 400, { client: c.summary.clientId, name, ...result });\n    }\n    if (route === \"/events\" && method === \"GET\") {\n      const c = this.pick(clientParam);\n      if (!c) return json(res, 404, { error: this.noClientMessage(clientParam) });\n      const events = this.events(c.summary.clientId, {\n        since: Number(url.searchParams.get(\"since\") ?? 0),\n        kinds: url.searchParams.get(\"kinds\")?.split(\",\").filter(Boolean),\n        limit: Number(url.searchParams.get(\"limit\") ?? 200),\n      });\n      return json(res, 200, { client: c.summary.clientId, count: events.length, last: events.at(-1)?.seq ?? 0, events });\n    }\n    if (route === \"/events/stream\" && method === \"GET\") {\n      const c = this.pick(clientParam);\n      const kinds = url.searchParams.get(\"kinds\")?.split(\",\").filter(Boolean);\n      const kindSet = kinds && kinds.length ? expandKinds(kinds) : null;\n      const target = c?.summary.clientId ?? clientParam;\n      res.writeHead(200, { \"content-type\": \"text/event-stream\", \"cache-control\": \"no-store\", connection: \"keep-alive\" });\n      res.write(`: solid-pulse stream client=${target ?? \"*\"}\\n\\n`);\n      const listener: EventListener = (clientId, events) => {\n        if (target && clientId !== target) return;\n        for (const e of events) {\n          if (kindSet && !kindSet.has(e.kind)) continue;\n          res.write(`event: pulse\\ndata: ${JSON.stringify({ client: clientId, ...e })}\\n\\n`);\n        }\n      };\n      this.listeners.add(listener);\n      const ka = setInterval(() => res.write(\":keepalive\\n\\n\"), 15_000);\n      req.on(\"close\", () => {\n        clearInterval(ka);\n        this.listeners.delete(listener);\n      });\n      return;\n    }\n    json(res, 404, { error: `unknown route ${method} ${route}` });\n  }\n\n  private noClientMessage(requested?: string) {\n    return requested\n      ? `no connected page with client id \"${requested}\" (see /api/clients)`\n      : \"no page connected to the bridge — open the app in a browser with solid-pulse enabled\";\n  }\n\n  private onConnection(ws: WebSocket) {\n    let state: ClientState | null = null;\n    ws.on(\"message\", (raw) => {\n      let frame: unknown;\n      try {\n        frame = JSON.parse(raw.toString());\n      } catch {\n        return;\n      }\n      if (!isPageFrame(frame)) return;\n      if (frame.type === \"hello\") {\n        const existing = this.clients.get(frame.clientId);\n        if (existing && existing.ws !== ws) existing.ws.close(4000, \"replaced by a newer connection\");\n        state = {\n          ws,\n          summary: { clientId: frame.clientId, url: frame.url, title: frame.title, userAgent: frame.userAgent, connectedWall: Date.now(), lastSeenWall: Date.now(), events: 0, commands: frame.commands.length },\n          commands: frame.commands,\n          buffer: existing?.buffer ?? new RingBuffer<PulseEvent>(this.opts.bufferSize),\n          pending: new Map(),\n        };\n        this.clients.set(frame.clientId, state);\n        ws.send(JSON.stringify({ type: \"welcome\", clientId: frame.clientId, protocol: PROTOCOL_VERSION }));\n        this.opts.log(`client connected ${frame.clientId} ${frame.url}`);\n        return;\n      }\n      if (!state) return;\n      state.summary.lastSeenWall = Date.now();\n      if (frame.type === \"events\") {\n        const fresh: PulseEvent[] = [];\n        for (const e of frame.events) {\n          // Replayed history after a reconnect may repeat; keep the buffer monotonic.\n          const last = state.buffer.size ? state.buffer.toArray().at(-1)!.seq : 0;\n          if (e.seq <= last) continue;\n          state.buffer.push(e);\n          fresh.push(e);\n        }\n        state.summary.events += fresh.length;\n        if (fresh.length) for (const l of this.listeners) l(state.summary.clientId, fresh);\n      } else if (frame.type === \"result\") {\n        const p = state.pending.get(frame.id);\n        if (p) {\n          clearTimeout(p.timer);\n          state.pending.delete(frame.id);\n          p.resolve(frame.result);\n        }\n      }\n    });\n    ws.on(\"close\", () => {\n      if (state && this.clients.get(state.summary.clientId)?.ws === ws) {\n        this.clients.delete(state.summary.clientId);\n        for (const p of state.pending.values()) {\n          clearTimeout(p.timer);\n          p.resolve({ ok: false, error: \"page disconnected\" });\n        }\n        this.opts.log(`client disconnected ${state.summary.clientId}`);\n      }\n    });\n  }\n\n  /** Pick a client: explicit id, else the most recently seen. */\n  pick(clientId?: string): ClientState | null {\n    if (clientId) return this.clients.get(clientId) ?? null;\n    let best: ClientState | null = null;\n    for (const c of this.clients.values()) if (!best || c.summary.lastSeenWall > best.summary.lastSeenWall) best = c;\n    return best;\n  }\n\n  listClients(): ClientSummary[] {\n    return [...this.clients.values()].map((c) => c.summary);\n  }\n\n  status() {\n    return { tool: \"@omniaura/solid-pulse\", protocol: PROTOCOL_VERSION, path: this.path, uptimeMs: Date.now() - this.startedWall, allowRemote: this.opts.allowRemote, clients: this.listClients() };\n  }\n\n  events(clientId: string, opts: { since?: number; kinds?: string[]; limit?: number } = {}): PulseEvent[] {\n    const c = this.clients.get(clientId);\n    if (!c) return [];\n    const kinds = opts.kinds && opts.kinds.length ? expandKinds(opts.kinds) : null;\n    const out = c.buffer.toArray().filter((e) => e.seq > (opts.since ?? 0) && (!kinds || kinds.has(e.kind)));\n    const limit = opts.limit ?? 200;\n    return out.length > limit ? out.slice(out.length - limit) : out;\n  }\n\n  command(clientId: string, name: string, args: Record<string, unknown> = {}): Promise<CommandResult> {\n    const c = this.clients.get(clientId);\n    if (!c) return Promise.resolve({ ok: false, error: `client not connected: ${clientId}` });\n    const id = `c${this.nextCommand++}`;\n    const frame: CommandFrame = { type: \"command\", id, name, args };\n    return new Promise((resolve) => {\n      const timer = setTimeout(() => {\n        c.pending.delete(id);\n        resolve({ ok: false, error: `command timed out after ${this.opts.commandTimeoutMs}ms` });\n      }, this.opts.commandTimeoutMs);\n      c.pending.set(id, {\n        resolve: (result) => {\n          // Keep the mirror in step with the page: a cleared page buffer must\n          // not keep serving stale history to `events`.\n          if (name === \"events.clear\" && result.ok) c.buffer.clear();\n          resolve(result);\n        },\n        timer,\n      });\n      c.ws.send(JSON.stringify(frame));\n    });\n  }\n\n  onEvents(listener: EventListener) {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  close() {\n    for (const c of this.clients.values()) c.ws.terminate();\n    this.clients.clear();\n    this.wss.close();\n  }\n}\n\nexport interface StandaloneOptions extends BridgeServerOptions {\n  port?: number;\n  host?: string;\n}\n\n/** Run the bridge as its own process (for non-Vite setups): `solid-pulse bridge --port 4567`. */\nexport function startBridgeServer(options: StandaloneOptions = {}) {\n  const bridge = new BridgeServer(options);\n  const server = createServer((req, res) => {\n    if (bridge.handleHttp(req, res)) return;\n    json(res, 404, { error: \"not found\", hint: `${bridge.path}/api/status` });\n  });\n  bridge.attach(server);\n  const host = options.host ?? \"127.0.0.1\";\n  const port = options.port ?? 4567;\n  const ready = new Promise<{ url: string; port: number }>((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(port, host, () => {\n      const addr = server.address();\n      const actual = typeof addr === \"object\" && addr ? addr.port : port;\n      resolve({ url: `http://${host}:${actual}${bridge.path}`, port: actual });\n    });\n  });\n  return {\n    bridge,\n    server,\n    ready,\n    url: `http://${host}:${port}${bridge.path}`,\n    close: () =>\n      new Promise<void>((resolve) => {\n        bridge.close();\n        let done = false;\n        const finish = () => {\n          if (done) return;\n          done = true;\n          resolve();\n        };\n        server.close(finish);\n        // Keep-alive HTTP and open SSE connections would otherwise hold `close` open.\n        (server as unknown as { closeAllConnections?: () => void }).closeAllConnections?.();\n        setTimeout(finish, 500).unref?.();\n      }),\n  };\n}\n","/** Fixed-capacity FIFO. Overwrites the oldest entry; never grows. */\nexport class RingBuffer<T> {\n  private items: (T | undefined)[];\n  private head = 0;\n  private count = 0;\n  /** Total number of pushes since creation (dropped + retained). */\n  pushed = 0;\n\n  constructor(public readonly capacity: number) {\n    if (!Number.isInteger(capacity) || capacity <= 0) {\n      throw new RangeError(`RingBuffer capacity must be a positive integer, got ${capacity}`);\n    }\n    this.items = new Array(capacity);\n  }\n\n  get size() {\n    return this.count;\n  }\n\n  get dropped() {\n    return this.pushed - this.count;\n  }\n\n  push(item: T) {\n    const idx = (this.head + this.count) % this.capacity;\n    if (this.count === this.capacity) {\n      this.items[this.head] = item;\n      this.head = (this.head + 1) % this.capacity;\n    } else {\n      this.items[idx] = item;\n      this.count++;\n    }\n    this.pushed++;\n  }\n\n  /** Oldest → newest. */\n  toArray(): T[] {\n    const out: T[] = new Array(this.count);\n    for (let i = 0; i < this.count; i++) {\n      out[i] = this.items[(this.head + i) % this.capacity] as T;\n    }\n    return out;\n  }\n\n  clear() {\n    this.items = new Array(this.capacity);\n    this.head = 0;\n    this.count = 0;\n  }\n}\n","/**\n * Event model. Every observation the runtime makes is one PulseEvent with a\n * precise `kind`. Kinds are deliberately specific: Solid has no \"rerender\", so\n * we never report one. What actually happens is one of:\n *\n *   solid.flush            a reactive flush completed (n computations re-ran)\n *   solid.computation      one memo/effect/render-effect re-ran (verbose mode)\n *   solid.component.mount  a component function ran (fresh mount, or hydrate)\n *   solid.component.dispose\n *   solid.component.remount same-named component disposed + mounted in one flush\n *   solid.root             a reactive root was created (multiple roots are fine)\n *   dom.mutation           the DOM actually changed (childList/attr/text)\n *   dom.detach             a subtree left the document (with scroll/focus state)\n *   dom.reattach           the same node instance came back (Suspense flip etc.)\n *   focus.lost             the focused element vanished from the document\n *   net.fetch.*            fetch lifecycle (start/end/error), SSE-aware\n *   net.ws.*               WebSocket lifecycle (open/message/close/error)\n *   net.sse.*              EventSource lifecycle\n *   query.*                Solid Query cache/observer events (adapter)\n *   mutation.*             Solid Query mutation cache events (adapter)\n *   pulse.*                runtime lifecycle / control-plane notes\n */\n\nexport type PulseEventKind =\n  | \"solid.flush\"\n  | \"solid.computation\"\n  | \"solid.component.mount\"\n  | \"solid.component.dispose\"\n  | \"solid.component.remount\"\n  | \"solid.root\"\n  | \"dom.mutation\"\n  | \"dom.detach\"\n  | \"dom.reattach\"\n  | \"focus.lost\"\n  | \"net.fetch.start\"\n  | \"net.fetch.end\"\n  | \"net.fetch.error\"\n  | \"net.ws.open\"\n  | \"net.ws.message\"\n  | \"net.ws.close\"\n  | \"net.ws.error\"\n  | \"net.sse.open\"\n  | \"net.sse.message\"\n  | \"net.sse.error\"\n  | \"net.sse.close\"\n  | \"query.added\"\n  | \"query.removed\"\n  | \"query.observe\"\n  | \"query.unobserve\"\n  | \"query.fetch.start\"\n  | \"query.fetch.success\"\n  | \"query.fetch.error\"\n  | \"query.invalidate\"\n  | \"query.update\"\n  | \"mutation.start\"\n  | \"mutation.success\"\n  | \"mutation.error\"\n  | \"pulse.note\";\n\nexport interface Rect {\n  x: number;\n  y: number;\n  w: number;\n  h: number;\n}\n\nexport interface ComponentRef {\n  id: number;\n  name: string;\n  /** Component ancestry, innermost first (names only). */\n  chain?: string[];\n  /** Source location if solid-grab's data-solid-source attribute was found. */\n  source?: string | null;\n}\n\nexport interface ElementRef {\n  tag: string;\n  id?: string;\n  testId?: string;\n  classes?: string;\n  /** Nearest `data-solid-component` ancestor name, if any. */\n  component?: string | null;\n  /** Nearest `data-solid-source` value, if any. */\n  source?: string | null;\n  rect?: Rect;\n}\n\nexport interface PulseEventBase {\n  /** Monotonic per-runtime sequence. */\n  seq: number;\n  /** performance.now() at capture. */\n  t: number;\n  /** Date.now() at capture (for cross-process correlation). */\n  wall: number;\n  kind: PulseEventKind;\n  /** Flush group the event belongs to, when attributable. */\n  flush?: number;\n  /** Component attribution, when known. */\n  component?: ComponentRef | null;\n  /** Free-form structured payload; shape depends on `kind`. */\n  data: Record<string, unknown>;\n}\n\nexport type PulseEvent = PulseEventBase;\n\nexport const KIND_GROUPS: Record<string, PulseEventKind[]> = {\n  solid: [\n    \"solid.flush\",\n    \"solid.computation\",\n    \"solid.component.mount\",\n    \"solid.component.dispose\",\n    \"solid.component.remount\",\n    \"solid.root\",\n  ],\n  dom: [\"dom.mutation\", \"dom.detach\", \"dom.reattach\", \"focus.lost\"],\n  net: [\n    \"net.fetch.start\",\n    \"net.fetch.end\",\n    \"net.fetch.error\",\n    \"net.ws.open\",\n    \"net.ws.message\",\n    \"net.ws.close\",\n    \"net.ws.error\",\n    \"net.sse.open\",\n    \"net.sse.message\",\n    \"net.sse.error\",\n    \"net.sse.close\",\n  ],\n  query: [\n    \"query.added\",\n    \"query.removed\",\n    \"query.observe\",\n    \"query.unobserve\",\n    \"query.fetch.start\",\n    \"query.fetch.success\",\n    \"query.fetch.error\",\n    \"query.invalidate\",\n    \"query.update\",\n    \"mutation.start\",\n    \"mutation.success\",\n    \"mutation.error\",\n  ],\n  pulse: [\"pulse.note\"],\n};\n\nexport const ALL_KINDS: PulseEventKind[] = Object.values(KIND_GROUPS).flat();\n\n/** Expand a kind filter: exact kinds, `group` names, or `prefix.*` globs. */\nexport function expandKinds(filters: readonly string[]): Set<PulseEventKind> {\n  const out = new Set<PulseEventKind>();\n  for (const raw of filters) {\n    const f = raw.trim();\n    if (!f) continue;\n    if (f === \"*\" || f === \"all\") {\n      for (const k of ALL_KINDS) out.add(k);\n      continue;\n    }\n    const group = KIND_GROUPS[f];\n    if (group) {\n      for (const k of group) out.add(k);\n      continue;\n    }\n    if (f.endsWith(\"*\")) {\n      const prefix = f.slice(0, -1);\n      for (const k of ALL_KINDS) if (k.startsWith(prefix)) out.add(k);\n      continue;\n    }\n    if ((ALL_KINDS as string[]).includes(f)) out.add(f as PulseEventKind);\n  }\n  return out;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-WIMCBTHZ.js

@@ -0,0 +1,21 @@
+// src/core/protocol.ts
+var PROTOCOL_VERSION = 1;
+var DEFAULT_PATH = "/__pulse";
+function isPageFrame(value) {
+  if (!value || typeof value !== "object") return false;
+  const t = value.type;
+  return t === "hello" || t === "events" || t === "result";
+}
+function isServerFrame(value) {
+  if (!value || typeof value !== "object") return false;
+  const t = value.type;
+  return t === "command" || t === "welcome";
+}
+
+export {
+  PROTOCOL_VERSION,
+  DEFAULT_PATH,
+  isPageFrame,
+  isServerFrame
+};
+//# sourceMappingURL=chunk-WIMCBTHZ.js.map

package/dist/chunk-WIMCBTHZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/protocol.ts"],"sourcesContent":["/**\n * Bridge protocol (JSON over WebSocket) between a page runtime and the bridge\n * server, and the HTTP shape the server exposes to CLIs and agents.\n *\n * Page → server\n *   hello      first frame; identifies the tab\n *   events     batched PulseEvents (≤ 50 ms coalescing)\n *   result     reply to a `command`\n * Server → page\n *   command    run a controller command; page answers with `result`\n *   welcome    ack of hello with the server-assigned client id\n */\n\nimport type { PulseEvent } from \"./events.js\";\nimport type { CommandResult, CommandSpec } from \"./controller.js\";\n\nexport const PROTOCOL_VERSION = 1;\nexport const DEFAULT_PATH = \"/__pulse\";\n\nexport interface HelloFrame {\n  type: \"hello\";\n  protocol: number;\n  clientId: string;\n  url: string;\n  title: string;\n  userAgent: string;\n  commands: CommandSpec[];\n  startedWall: number;\n}\n\nexport interface EventsFrame {\n  type: \"events\";\n  events: PulseEvent[];\n}\n\nexport interface ResultFrame {\n  type: \"result\";\n  id: string;\n  result: CommandResult;\n}\n\nexport interface CommandFrame {\n  type: \"command\";\n  id: string;\n  name: string;\n  args: Record<string, unknown>;\n}\n\nexport interface WelcomeFrame {\n  type: \"welcome\";\n  clientId: string;\n  protocol: number;\n}\n\nexport type PageFrame = HelloFrame | EventsFrame | ResultFrame;\nexport type ServerFrame = CommandFrame | WelcomeFrame;\n\nexport interface ClientSummary {\n  clientId: string;\n  url: string;\n  title: string;\n  userAgent: string;\n  connectedWall: number;\n  lastSeenWall: number;\n  events: number;\n  commands: number;\n}\n\nexport function isPageFrame(value: unknown): value is PageFrame {\n  if (!value || typeof value !== \"object\") return false;\n  const t = (value as { type?: unknown }).type;\n  return t === \"hello\" || t === \"events\" || t === \"result\";\n}\n\nexport function isServerFrame(value: unknown): value is ServerFrame {\n  if (!value || typeof value !== \"object\") return false;\n  const t = (value as { type?: unknown }).type;\n  return t === \"command\" || t === \"welcome\";\n}\n"],"mappings":";AAgBO,IAAM,mBAAmB;AACzB,IAAM,eAAe;AAmDrB,SAAS,YAAY,OAAoC;AAC9D,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,IAAK,MAA6B;AACxC,SAAO,MAAM,WAAW,MAAM,YAAY,MAAM;AAClD;AAEO,SAAS,cAAc,OAAsC;AAClE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,IAAK,MAA6B;AACxC,SAAO,MAAM,aAAa,MAAM;AAClC;","names":[]}