statewire 0.9.2 → 0.10.0

package/dist/client/sessionStore.d.ts

@@ -1,17 +1,8 @@
+import { StatewireClient } from "../statewire.js";
 //#region src/client/sessionStore.d.ts
-type StatewireSessionRecord = {
-  clientId: string;
-  nextSeq: number;
-  ctxNextSeq: number;
-};
-type StatewireSessionStore = {
-  load: () => StatewireSessionRecord | null;
-  save: (record: StatewireSessionRecord) => void;
-};
-type StatewireSessionStoreOptions = {
-  sessionStore?: StatewireSessionStore | undefined;
-};
-declare const createMemorySessionStore: () => StatewireSessionStore;
+/** The session storage `useStatewire` mounts, read by the transport's session. */
+declare const SessionStorageContext: import("react").Context<StatewireClient.SessionStorage | undefined>;
+declare const createMemorySessionStore: () => StatewireClient.SessionStorage;
 //#endregion
-export { StatewireSessionRecord, StatewireSessionStore, StatewireSessionStoreOptions, createMemorySessionStore };
+export { SessionStorageContext, createMemorySessionStore };
 //# sourceMappingURL=sessionStore.d.ts.map

package/dist/client/sessionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionStore.d.ts","names":[],"sources":["../../src/client/sessionStore.ts"],"mappings":";KAAY;EACV;EACA;EACA;;KAGU;EACV,YAAY;EACZ,OAAO,QAAQ;;KAGL;EACV,eAAe;;cAGJ,gCAA+B"}
+{"version":3,"file":"sessionStore.d.ts","names":[],"sources":["../../src/client/sessionStore.ts"],"mappings":";;;cAIa,uCAAqB,QAAA,gBAAA;cAIrB,gCAA+B,gBAAgB"}

package/dist/client/sessionStore.js

@@ -1,4 +1,7 @@
+import { createContext } from "@assistant-ui/tap/react-shim";
 //#region src/client/sessionStore.ts
+/** The session storage `useStatewire` mounts, read by the transport's session. */
+const SessionStorageContext = createContext(void 0);
 const createMemorySessionStore = () => {
 	let record = null;
 	return {
@@ -9,6 +12,6 @@ const createMemorySessionStore = () => {
 	};
 };
 //#endregion
-export { createMemorySessionStore };
+export { SessionStorageContext, createMemorySessionStore };
 
 //# sourceMappingURL=sessionStore.js.map

package/dist/client/sessionStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"sessionStore.js","names":["StatewireSessionRecord","clientId","nextSeq","ctxNextSeq","StatewireSessionStore","load","save","record","StatewireSessionStoreOptions","sessionStore","createMemorySessionStore","next"],"sources":["../../src/client/sessionStore.ts"],"sourcesContent":["export type StatewireSessionRecord = {\n  clientId: string;\n  nextSeq: number;\n  ctxNextSeq: number;\n};\n\nexport type StatewireSessionStore = {\n  load: () => StatewireSessionRecord | null;\n  save: (record: StatewireSessionRecord) => void;\n};\n\nexport type StatewireSessionStoreOptions = {\n  sessionStore?: StatewireSessionStore | undefined;\n};\n\nexport const createMemorySessionStore = (): StatewireSessionStore => {\n  let record: StatewireSessionRecord | null = null;\n  return {\n    load: () => record,\n    save: (next) => {\n      record = next;\n    },\n  };\n};\n"],"mappings":";AAeA,MAAaU,iCAAwD;CACnE,IAAIH,SAAwC;CAC5C,OAAO;EACLF,YAAYE;EACZD,OAAOK,SAAS;GACdJ,SAASI;EACX;CACF;AACF"}
+{"version":3,"file":"sessionStore.js","names":["createContext","StatewireClient","SessionStorageContext","SessionStorage","undefined","createMemorySessionStore","record","SessionRecord","load","save","next"],"sources":["../../src/client/sessionStore.ts"],"sourcesContent":["import { createContext } from \"react\";\nimport type { StatewireClient } from \"../statewire\";\n\n/** The session storage `useStatewire` mounts, read by the transport's session. */\nexport const SessionStorageContext = createContext<\n  StatewireClient.SessionStorage | undefined\n>(undefined);\n\nexport const createMemorySessionStore = (): StatewireClient.SessionStorage => {\n  let record: StatewireClient.SessionRecord | null = null;\n  return {\n    load: () => record,\n    save: (next) => {\n      record = next;\n    },\n  };\n};\n"],"mappings":";;;AAIA,MAAaE,wBAAwBF,cAEnCI,KAAAA,CAAS;AAEX,MAAaC,iCAAiE;CAC5E,IAAIC,SAA+C;CACnD,OAAO;EACLE,YAAYF;EACZG,OAAOC,SAAS;GACdJ,SAASI;EACX;CACF;AACF"}

package/dist/host/http.d.ts

@@ -0,0 +1,7 @@
+import { SocketHostState } from "./socket.js";
+//#region src/host/http.d.ts
+declare const stream: (h: SocketHostState, request: Request) => Promise<Response>;
+declare const frames: (h: SocketHostState, request: Request) => Promise<Response>;
+//#endregion
+export { frames, stream };
+//# sourceMappingURL=http.d.ts.map

package/dist/host/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","names":[],"sources":["../../src/host/http.ts"],"mappings":";;cAiNa,SACX,GAAG,iBACH,SAAS,YACR,QAAQ;cAkCE,SACX,GAAG,iBACH,SAAS,YACR,QAAQ"}

package/dist/host/http.js

@@ -0,0 +1,175 @@
+import { CLIENT_ID_RE, admitFrame, closeConn, flush, parseFrame, parseFrameValue, register, sendTo } from "./socket.js";
+//#region src/host/http.ts
+const CLIENT_ID_HEADER = "Statewire-Client-Id";
+const LEASE_HEADER = "Statewire-Lease";
+const VERSION_HEADER = "Statewire-Version";
+const VERSION = "1";
+const encoder = new TextEncoder();
+const invalidClientIdReason = (clientId) => {
+	if (clientId === "") return "id must be non-empty";
+	if (clientId.length > 256) return "id must be at most 256 characters";
+	if (!CLIENT_ID_RE.test(clientId)) return "id must contain only [A-Za-z0-9._~-]";
+	return null;
+};
+const clientIdResponse = (request) => {
+	const clientId = request.headers.get(CLIENT_ID_HEADER);
+	if (clientId === null) return { response: Response.json({ detail: `missing ${CLIENT_ID_HEADER} header` }, { status: 400 }) };
+	const reason = invalidClientIdReason(clientId);
+	if (reason !== null) return { response: Response.json({ detail: `invalid ${CLIENT_ID_HEADER}: ${reason}` }, { status: 400 }) };
+	return { clientId };
+};
+const headersOf = (request) => Object.fromEntries(request.headers);
+const mergedHeaders = (request, extra) => {
+	const headers = headersOf(request);
+	for (const [name, value] of Object.entries(extra)) headers[name.toLowerCase()] = value;
+	return headers;
+};
+const authorize = async (h, headers) => {
+	try {
+		await h.authorize?.({ headers });
+		return null;
+	} catch (error) {
+		if (error instanceof Response) return error;
+		throw error;
+	}
+};
+const mintLease = () => {
+	const bytes = crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(16));
+	return btoa(String.fromCharCode(...bytes)).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+};
+const attachSse = (h, clientId) => {
+	let controller;
+	let connection = null;
+	let open = true;
+	const body = new ReadableStream({
+		start: (next) => {
+			controller = next;
+		},
+		cancel: () => {
+			open = false;
+			connection?.close();
+		}
+	});
+	const registration = register(h, clientId, {
+		send: (data) => {
+			if (!open) return;
+			const frame = data === "{}" ? ": ping\n\n" : `data: ${data}\n\n`;
+			try {
+				controller.enqueue(encoder.encode(frame));
+			} catch {
+				open = false;
+				connection?.close();
+			}
+		},
+		close: () => {
+			if (!open) return;
+			open = false;
+			try {
+				controller.close();
+			} catch {
+				return;
+			}
+		}
+	});
+	connection = registration?.connection ?? null;
+	if (!open) connection?.close();
+	return {
+		body,
+		registration
+	};
+};
+const streamResponse = (attachment, lease) => new Response(attachment.body, {
+	status: 200,
+	headers: {
+		"Content-Type": "text/event-stream",
+		[VERSION_HEADER]: VERSION,
+		...lease !== null && { [LEASE_HEADER]: lease }
+	}
+});
+const admitAttachFrame = (h, registration, frame) => {
+	if (frame.ctx.length === 0 && frame.cmd.length === 0) return;
+	const admission = admitFrame(h, registration.rec, frame);
+	if (admission.type === "refused") sendTo(h, registration.conn, JSON.stringify(admission.syn));
+};
+const getStream = async (h, request) => {
+	const refused = await authorize(h, headersOf(request));
+	if (refused !== null) return refused;
+	const client = clientIdResponse(request);
+	if ("response" in client) return client.response;
+	const attachment = attachSse(h, client.clientId);
+	const lease = attachment.registration === null ? null : mintLease();
+	if (attachment.registration !== null) attachment.registration.rec.lease = lease;
+	return streamResponse(attachment, lease);
+};
+const postStream = async (h, request) => {
+	const client = clientIdResponse(request);
+	if ("response" in client) return client.response;
+	let body;
+	try {
+		body = JSON.parse(await request.text());
+	} catch {
+		return Response.json({ detail: "body must be JSON" }, { status: 400 });
+	}
+	let frame;
+	try {
+		frame = parseFrameValue(body, true);
+	} catch (error) {
+		if (!(error instanceof Error) || error.name !== "StatewireViolation") throw error;
+		return Response.json({ detail: error.message }, { status: 400 });
+	}
+	if (frame.headers === null) return Response.json({ detail: "first frame must carry headers" }, { status: 400 });
+	const refused = await authorize(h, mergedHeaders(request, frame.headers));
+	if (refused !== null) return refused;
+	const attachment = attachSse(h, client.clientId);
+	if (attachment.registration === null) return streamResponse(attachment, null);
+	const lease = mintLease();
+	attachment.registration.rec.lease = lease;
+	admitAttachFrame(h, attachment.registration, frame);
+	return streamResponse(attachment, lease);
+};
+const stream = async (h, request) => {
+	if (request.method === "GET") return getStream(h, request);
+	if (request.method === "POST") return postStream(h, request);
+	return new Response(null, {
+		status: 405,
+		headers: { Allow: "GET, POST" }
+	});
+};
+const finClient = (h, clientId, fin) => {
+	flush(h);
+	for (const conn of [...h.conns]) {
+		if (conn.clientId !== clientId) continue;
+		sendTo(h, conn, JSON.stringify({ fin }));
+		closeConn(h, conn);
+	}
+};
+const violationResponse = (h, clientId, reason) => {
+	finClient(h, clientId, {
+		reason: "error",
+		message: `protocol violation: ${reason}`
+	});
+	return Response.json({ error: reason }, { status: 400 });
+};
+const frames = async (h, request) => {
+	const refused = await authorize(h, headersOf(request));
+	if (refused !== null) return refused;
+	const client = clientIdResponse(request);
+	if ("response" in client) return client.response;
+	const rec = h.clients.get(client.clientId);
+	const lease = request.headers.get(LEASE_HEADER);
+	if (h.disposed || h.finished !== null || rec === void 0 || lease === null || lease !== rec.lease) return Response.json({ error: "stale-lease" }, { status: 423 });
+	let frame;
+	try {
+		frame = parseFrame(await request.text(), false);
+	} catch (error) {
+		if (!(error instanceof Error) || error.name !== "StatewireViolation") throw error;
+		return violationResponse(h, client.clientId, error.message);
+	}
+	const admission = admitFrame(h, rec, frame);
+	if (admission.type === "refused") return Response.json(admission.syn, { status: 409 });
+	return Response.json({});
+};
+//#endregion
+export { frames, stream };
+
+//# sourceMappingURL=http.js.map

package/dist/host/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","names":["StatewireHost","CLIENT_ID_RE","admitFrame","closeConn","flush","parseFrame","parseFrameValue","register","sendTo","ParsedFrame","Registration","SocketHostState","CLIENT_ID_HEADER","LEASE_HEADER","VERSION_HEADER","VERSION","encoder","TextEncoder","invalidClientIdReason","clientId","length","test","clientIdResponse","request","Request","response","Response","headers","get","json","detail","status","reason","headersOf","Record","Object","fromEntries","mergedHeaders","extra","name","value","entries","toLowerCase","authorize","h","Promise","error","mintLease","bytes","crypto","getRandomValues","Uint8Array","btoa","String","fromCharCode","replaceAll","replace","SseAttachment","body","ReadableStream","registration","attachSse","controller","ReadableStreamDefaultController","connection","open","start","next","cancel","close","socket","send","data","frame","enqueue","encode","streamResponse","attachment","lease","admitAttachFrame","ctx","cmd","admission","rec","type","conn","JSON","stringify","syn","getStream","refused","client","postStream","parse","text","Error","message","stream","method","Allow","finClient","fin","Fin","conns","violationResponse","frames","clients","disposed","finished","undefined"],"sources":["../../src/host/http.ts"],"sourcesContent":["import type { StatewireHost } from \"../host\";\nimport {\n  CLIENT_ID_RE,\n  admitFrame,\n  closeConn,\n  flush,\n  parseFrame,\n  parseFrameValue,\n  register,\n  sendTo,\n} from \"./socket\";\nimport type { ParsedFrame, Registration, SocketHostState } from \"./socket\";\n\nconst CLIENT_ID_HEADER = \"Statewire-Client-Id\";\nconst LEASE_HEADER = \"Statewire-Lease\";\nconst VERSION_HEADER = \"Statewire-Version\";\nconst VERSION = \"1\";\nconst encoder = new TextEncoder();\n\nconst invalidClientIdReason = (clientId: string): string | null => {\n  if (clientId === \"\") return \"id must be non-empty\";\n  if (clientId.length > 256) return \"id must be at most 256 characters\";\n  if (!CLIENT_ID_RE.test(clientId)) {\n    return \"id must contain only [A-Za-z0-9._~-]\";\n  }\n  return null;\n};\n\nconst clientIdResponse = (\n  request: Request,\n): { clientId: string } | { response: Response } => {\n  const clientId = request.headers.get(CLIENT_ID_HEADER);\n  if (clientId === null) {\n    return {\n      response: Response.json(\n        { detail: `missing ${CLIENT_ID_HEADER} header` },\n        { status: 400 },\n      ),\n    };\n  }\n  const reason = invalidClientIdReason(clientId);\n  if (reason !== null) {\n    return {\n      response: Response.json(\n        { detail: `invalid ${CLIENT_ID_HEADER}: ${reason}` },\n        { status: 400 },\n      ),\n    };\n  }\n  return { clientId };\n};\n\nconst headersOf = (request: Request): Record<string, string> =>\n  Object.fromEntries(request.headers);\n\nconst mergedHeaders = (\n  request: Request,\n  extra: Record<string, string>,\n): Record<string, string> => {\n  const headers = headersOf(request);\n  for (const [name, value] of Object.entries(extra)) {\n    headers[name.toLowerCase()] = value;\n  }\n  return headers;\n};\n\nconst authorize = async (\n  h: SocketHostState,\n  headers: Record<string, string>,\n): Promise<Response | null> => {\n  try {\n    await h.authorize?.({ headers });\n    return null;\n  } catch (error) {\n    if (error instanceof Response) return error;\n    throw error;\n  }\n};\n\nconst mintLease = (): string => {\n  const bytes = crypto.getRandomValues(new Uint8Array(16));\n  return btoa(String.fromCharCode(...bytes))\n    .replaceAll(\"+\", \"-\")\n    .replaceAll(\"/\", \"_\")\n    .replace(/=+$/, \"\");\n};\n\ntype SseAttachment = {\n  body: ReadableStream<Uint8Array>;\n  registration: Registration | null;\n};\n\nconst attachSse = (h: SocketHostState, clientId: string): SseAttachment => {\n  let controller: ReadableStreamDefaultController<Uint8Array>;\n  let connection: Registration[\"connection\"] | null = null;\n  let open = true;\n  const body = new ReadableStream({\n    start: (next) => {\n      controller = next;\n    },\n    cancel: () => {\n      open = false;\n      connection?.close();\n    },\n  });\n  const socket = {\n    send: (data: string) => {\n      if (!open) return;\n      const frame = data === \"{}\" ? \": ping\\n\\n\" : `data: ${data}\\n\\n`;\n      try {\n        controller.enqueue(encoder.encode(frame));\n      } catch {\n        open = false;\n        connection?.close();\n      }\n    },\n    close: () => {\n      if (!open) return;\n      open = false;\n      try {\n        controller.close();\n      } catch {\n        return;\n      }\n    },\n  };\n  const registration = register(h, clientId, socket);\n  connection = registration?.connection ?? null;\n  if (!open) connection?.close();\n  return { body, registration };\n};\n\nconst streamResponse = (\n  attachment: SseAttachment,\n  lease: string | null,\n): Response =>\n  new Response(attachment.body, {\n    status: 200,\n    headers: {\n      \"Content-Type\": \"text/event-stream\",\n      [VERSION_HEADER]: VERSION,\n      ...(lease !== null && { [LEASE_HEADER]: lease }),\n    },\n  });\n\nconst admitAttachFrame = (\n  h: SocketHostState,\n  registration: Registration,\n  frame: ParsedFrame,\n) => {\n  if (frame.ctx.length === 0 && frame.cmd.length === 0) return;\n  const admission = admitFrame(h, registration.rec, frame);\n  if (admission.type === \"refused\") {\n    sendTo(h, registration.conn, JSON.stringify(admission.syn));\n  }\n};\n\nconst getStream = async (\n  h: SocketHostState,\n  request: Request,\n): Promise<Response> => {\n  const refused = await authorize(h, headersOf(request));\n  if (refused !== null) return refused;\n  const client = clientIdResponse(request);\n  if (\"response\" in client) return client.response;\n  const attachment = attachSse(h, client.clientId);\n  const lease = attachment.registration === null ? null : mintLease();\n  if (attachment.registration !== null)\n    attachment.registration.rec.lease = lease;\n  return streamResponse(attachment, lease);\n};\n\nconst postStream = async (\n  h: SocketHostState,\n  request: Request,\n): Promise<Response> => {\n  const client = clientIdResponse(request);\n  if (\"response\" in client) return client.response;\n  let body: unknown;\n  try {\n    body = JSON.parse(await request.text());\n  } catch {\n    return Response.json({ detail: \"body must be JSON\" }, { status: 400 });\n  }\n  let frame: ParsedFrame;\n  try {\n    frame = parseFrameValue(body, true);\n  } catch (error) {\n    if (!(error instanceof Error) || error.name !== \"StatewireViolation\") {\n      throw error;\n    }\n    return Response.json({ detail: error.message }, { status: 400 });\n  }\n  if (frame.headers === null) {\n    return Response.json(\n      { detail: \"first frame must carry headers\" },\n      { status: 400 },\n    );\n  }\n  const refused = await authorize(h, mergedHeaders(request, frame.headers));\n  if (refused !== null) return refused;\n  const attachment = attachSse(h, client.clientId);\n  if (attachment.registration === null) return streamResponse(attachment, null);\n  const lease = mintLease();\n  attachment.registration.rec.lease = lease;\n  admitAttachFrame(h, attachment.registration, frame);\n  return streamResponse(attachment, lease);\n};\n\nexport const stream = async (\n  h: SocketHostState,\n  request: Request,\n): Promise<Response> => {\n  if (request.method === \"GET\") return getStream(h, request);\n  if (request.method === \"POST\") return postStream(h, request);\n  return new Response(null, {\n    status: 405,\n    headers: { Allow: \"GET, POST\" },\n  });\n};\n\nconst finClient = (\n  h: SocketHostState,\n  clientId: string,\n  fin: StatewireHost.Fin,\n) => {\n  flush(h);\n  for (const conn of [...h.conns]) {\n    if (conn.clientId !== clientId) continue;\n    sendTo(h, conn, JSON.stringify({ fin }));\n    closeConn(h, conn);\n  }\n};\n\nconst violationResponse = (\n  h: SocketHostState,\n  clientId: string,\n  reason: string,\n) => {\n  finClient(h, clientId, {\n    reason: \"error\",\n    message: `protocol violation: ${reason}`,\n  });\n  return Response.json({ error: reason }, { status: 400 });\n};\n\nexport const frames = async (\n  h: SocketHostState,\n  request: Request,\n): Promise<Response> => {\n  const refused = await authorize(h, headersOf(request));\n  if (refused !== null) return refused;\n  const client = clientIdResponse(request);\n  if (\"response\" in client) return client.response;\n  const rec = h.clients.get(client.clientId);\n  const lease = request.headers.get(LEASE_HEADER);\n  if (\n    h.disposed ||\n    h.finished !== null ||\n    rec === undefined ||\n    lease === null ||\n    lease !== rec.lease\n  ) {\n    return Response.json({ error: \"stale-lease\" }, { status: 423 });\n  }\n  let frame: ParsedFrame;\n  try {\n    frame = parseFrame(await request.text(), false);\n  } catch (error) {\n    if (!(error instanceof Error) || error.name !== \"StatewireViolation\") {\n      throw error;\n    }\n    return violationResponse(h, client.clientId, error.message);\n  }\n  const admission = admitFrame(h, rec, frame);\n  if (admission.type === \"refused\") {\n    return Response.json(admission.syn, { status: 409 });\n  }\n  return Response.json({});\n};\n"],"mappings":"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"}

package/dist/host/socket.d.ts

@@ -1,7 +1,108 @@
 import { Statewire } from "../types.js";
+import { StatewirePath } from "../wire/ops.js";
+import { CommandsHost } from "./host.js";
+import { StatewireHost } from "../host.js";
+import { StatewireCmd } from "../client/connection.js";
+import { StatewireMetaEntry } from "../wire/meta.js";
 import { StatewireHostInternal } from "../host-internal.js";
 import { ResourceElement } from "@assistant-ui/tap";
 //#region src/host/socket.d.ts
+declare const CLIENT_ID_RE: RegExp;
+type WireOp = {
+  op: string;
+  path?: StatewirePath;
+  value?: unknown;
+  meta?: StatewireMetaEntry[];
+};
+type Admission = {
+  seq: number;
+  method: string;
+  applied: boolean;
+  appliedSent: boolean;
+  settled: boolean;
+};
+type ClientRec = {
+  id: string;
+  lastSeq: number;
+  ctxSeq: number;
+  lease: string | null;
+  touched: number;
+  context: Record<string, unknown> | null;
+  results: Map<number, {
+    ts: number;
+    cmd: StatewireCmd;
+  }>;
+  inflight: Map<number, Admission>;
+};
+type Conn = {
+  clientId: string;
+  socket: StatewireHostInternal.Socket;
+  open: boolean;
+  sawFrame: boolean;
+  lastSentAt: number;
+};
+type CtxStatement = {
+  seq: number;
+  value: Record<string, unknown>;
+};
+type CmdStatement = {
+  seq: number;
+  method: string;
+  params: unknown;
+  meta?: unknown;
+};
+type ParsedFrame = {
+  headers: Record<string, string> | null;
+  ctx: CtxStatement[];
+  cmd: CmdStatement[];
+};
+declare const parseFrameValue: (frame: unknown, first: boolean) => ParsedFrame;
+declare const parseFrame: (raw: string, first: boolean) => ParsedFrame;
+type SocketHostState = {
+  heartbeatMs: number;
+  clientRecordLimit: number;
+  finOnIdle: boolean;
+  authorize: StatewireHostInternal.SocketHostOptions["authorize"];
+  clients: Map<string, ClientRec>;
+  conns: Set<Conn>;
+  pendingOps: WireOp[];
+  pendingApplied: Map<string, number[]>;
+  pendingCmds: Map<string, StatewireCmd[]>;
+  idleWire: boolean;
+  finished: StatewireHost.Fin | null;
+  disposed: boolean;
+  flushScheduled: boolean;
+  heartbeatTimer: ReturnType<typeof setInterval> | null;
+  stateHost: StatewireHost.StateHost | null;
+  commandsHost: CommandsHost | null;
+  current: Statewire<unknown> | null;
+  post: () => void;
+  connect: (clientId: string, socket: StatewireHostInternal.Socket) => StatewireHostInternal.SocketConnection;
+  finish: (fin: StatewireHost.Fin) => void;
+  stream: (request: Request) => Promise<Response>;
+  frames: (request: Request) => Promise<Response>;
+};
+declare const closeConn: (h: SocketHostState, conn: Conn, code?: number, reason?: string) => void;
+declare const sendTo: (h: SocketHostState, conn: Conn, data: string) => void;
+declare const flush: (h: SocketHostState, fin?: StatewireHost.Fin) => void;
+type FrameAdmission = {
+  type: "ok";
+} | {
+  type: "refused";
+  syn: {
+    syn: {
+      seq: number;
+      ctxSeq: number;
+    };
+  };
+};
+declare const admitFrame: (h: SocketHostState, rec: ClientRec, frame: ParsedFrame) => FrameAdmission;
+type Registration = {
+  rec: ClientRec;
+  conn: Conn;
+  connection: StatewireHostInternal.SocketConnection;
+};
+declare const register: (h: SocketHostState, clientId: string, socket: StatewireHostInternal.Socket) => Registration | null;
 /**
  * Transport-agnostic WS binding over a statewire/host transport:
  * feed it sockets (anything with `send`/`close`) and raw text frames, and it
@@ -11,5 +112,5 @@ import { ResourceElement } from "@assistant-ui/tap";
  */
 declare const StatewireSocketHost: (transport: ResourceElement<Statewire>, options?: StatewireHostInternal.SocketHostOptions) => StatewireHostInternal.SocketHost;
 //#endregion
-export { StatewireSocketHost };
+export { CLIENT_ID_RE, ClientRec, Conn, FrameAdmission, ParsedFrame, Registration, SocketHostState, StatewireSocketHost, admitFrame, closeConn, flush, parseFrame, parseFrameValue, register, sendTo };
 //# sourceMappingURL=socket.d.ts.map

package/dist/host/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","names":[],"sources":["../../src/host/socket.ts"],"mappings":";;;;;;;;;;;cAqyBa,sBACX,WAAW,gBAAgB,YAC3B,UAAU,sBAAsB,sBAC/B,sBAAsB"}
+{"version":3,"file":"socket.d.ts","names":[],"sources":["../../src/host/socket.ts"],"mappings":";;;;;;;;;cAgBa,cAAY;KAKpB;EACH;EACA,OAAO;EACP;EACA,OAAO;;KAGJ;EACH;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,SAAS;IAAc;IAAY,KAAK;;EACxC,UAAU,YAAY;;KAGZ;EACV;EACA,QAAQ,sBAAsB;EAC9B;EACA;EACA;;KAcG;EAAiB;EAAa,OAAO;;KACrC;EACH;EACA;EACA;EACA;;KAGU;EACV,SAAS;EACT,KAAK;EACL,KAAK;;cAgDM,kBACX,gBACA,mBACC;cAoDU,aAAc,aAAa,mBAAiB;KAmE7C;EACV;EACA;EACA;EACA,WAAW,sBAAsB;EACjC,SAAS,YAAY;EACrB,OAAO,IAAI;EACX,YAAY;EACZ,gBAAgB;EAChB,aAAa,YAAY;EACzB;EACA,UAAU,cAAc;EACxB;EACA;EACA,gBAAgB,kBAAkB;EAClC,WAAW,cAAc;EACzB,cAAc;EACd,SAAS;EACT;EACA,UACE,kBACA,QAAQ,sBAAsB,WAC3B,sBAAsB;EAC3B,SAAS,KAAK,cAAc;EAC5B,SAAS,SAAS,YAAY,QAAQ;EACtC,SAAS,SAAS,YAAY,QAAQ;;cA+C3B,YACX,GAAG,iBACH,MAAM,MACN,eACA;cAgBW,SAAU,GAAG,iBAAiB,MAAM,MAAM;cAsC1C,QAAS,GAAG,iBAAiB,MAAM,cAAc;KAuOlD;EACN;;EACA;EAAiB;IAAO;MAAO;MAAa;;;;cAErC,aACX,GAAG,iBACH,KAAK,WACL,OAAO,gBACN;KAgES;EACV,KAAK;EACL,MAAM;EACN,YAAY,sBAAsB;;cAGvB,WACX,GAAG,iBACH,kBACA,QAAQ,sBAAsB,WAC7B;;;;;;;;cAgLU,sBACX,WAAW,gBAAgB,YAC3B,UAAU,sBAAsB,sBAC/B,sBAAsB"}

package/dist/host/socket.js

@@ -2,6 +2,7 @@ import { StatewireSendError } from "../types.js";
 import { getCommandsHost, getStateHost } from "./host.js";
 import { encodeValue, reviveValue } from "../wire/meta.js";
 import { createMacrotaskPoster } from "../util/macrotask.js";
+import { frames, stream } from "./http.js";
 import { useEffect, useState } from "@assistant-ui/tap/react-shim";
 import { createTapRoot, flushTapSync, useResource } from "@assistant-ui/tap";
 //#region src/host/socket.ts
@@ -38,13 +39,7 @@ const contextValue = (ops) => {
 	if (!isPlainObject(value)) throw new Error("context value must be an object");
 	return value;
 };
-const parseFrame = (raw, first) => {
-	let frame;
-	try {
-		frame = JSON.parse(raw);
-	} catch {
-		return violation("malformed frame");
-	}
+const parseFrameValue = (frame, first) => {
 	if (!isPlainObject(frame)) return violation("malformed frame");
 	if (frame["headers"] === void 0 && frame["ctx"] === void 0 && frame["cmd"] === void 0) return violation("malformed frame");
 	let headers = null;
@@ -80,6 +75,15 @@ const parseFrame = (raw, first) => {
 		cmd
 	};
 };
+const parseFrame = (raw, first) => {
+	let frame;
+	try {
+		frame = JSON.parse(raw);
+	} catch {
+		return violation("malformed frame");
+	}
+	return parseFrameValue(frame, first);
+};
 const encodePayload = (payload) => {
 	if (payload === void 0) return {};
 	const { value, meta } = encodeValue(payload);
@@ -357,20 +361,19 @@ const admitCmd = (h, rec, statement) => {
 		});
 	});
 };
-const admitFrame = (h, conn, frame) => {
-	const rec = h.clients.get(conn.clientId);
+const admitFrame = (h, rec, frame) => {
 	rec.touched = Date.now();
 	const through = admittedThrough(rec);
 	for (const statement of frame.cmd) if (statement.seq <= through) reemit(h, rec, statement.seq);
 	const ctxNew = frame.ctx.filter((s) => s.seq > rec.ctxSeq);
 	const cmdNew = frame.cmd.filter((s) => s.seq > through);
-	if (ctxNew.length > 0 && ctxNew[0].seq !== rec.ctxSeq + 1 || cmdNew.length > 0 && cmdNew[0].seq !== through + 1) {
-		sendTo(h, conn, JSON.stringify({ syn: {
+	if (ctxNew.length > 0 && ctxNew[0].seq !== rec.ctxSeq + 1 || cmdNew.length > 0 && cmdNew[0].seq !== through + 1) return {
+		type: "refused",
+		syn: { syn: {
 			seq: through,
 			ctxSeq: rec.ctxSeq
-		} }));
-		return;
-	}
+		} }
+	};
 	for (const statement of ctxNew) {
 		rec.context = statement.value;
 		rec.ctxSeq = statement.seq;
@@ -381,6 +384,7 @@ const admitFrame = (h, conn, frame) => {
 		dur: true
 	});
 	scheduleFlush(h);
+	return { type: "ok" };
 };
 const message = (h, conn, data) => {
 	if (!conn.open || h.disposed || h.finished !== null) return;
@@ -396,7 +400,9 @@ const message = (h, conn, data) => {
 		return;
 	}
 	if (frame.ctx.length === 0 && frame.cmd.length === 0) return;
-	admitFrame(h, conn, frame);
+	const rec = h.clients.get(conn.clientId);
+	const admission = admitFrame(h, rec, frame);
+	if (admission.type === "refused") sendTo(h, conn, JSON.stringify(admission.syn));
 };
 const gcClients = (h) => {
 	let excess = h.clients.size - h.clientRecordLimit;
@@ -410,17 +416,12 @@ const gcClients = (h) => {
 		excess -= 1;
 	}
 };
-const connect = (h, clientId, socket) => {
-	const dead = {
-		clientId,
-		message: () => {},
-		close: () => {}
-	};
+const register = (h, clientId, socket) => {
 	const refuse = (code, reason) => {
 		try {
 			socket.close(code, reason);
 		} catch {}
-		return dead;
+		return null;
 	};
 	if (h.disposed) return refuse(1001, "disposed");
 	if (!CLIENT_ID_RE.test(clientId)) return refuse(1008, "invalid client id");
@@ -429,7 +430,8 @@ const connect = (h, clientId, socket) => {
 		try {
 			socket.send(JSON.stringify({ fin: h.finished }));
 		} catch {}
-		return refuse(1e3, "finished");
+		refuse(1e3, "finished");
+		return null;
 	}
 	const known = h.clients.has(clientId);
 	const rec = known ? h.clients.get(clientId) : (() => {
@@ -437,6 +439,7 @@ const connect = (h, clientId, socket) => {
 			id: clientId,
 			lastSeq: 0,
 			ctxSeq: 0,
+			lease: null,
 			touched: Date.now(),
 			context: null,
 			results: /* @__PURE__ */ new Map(),
@@ -446,6 +449,7 @@ const connect = (h, clientId, socket) => {
 		return created;
 	})();
 	rec.touched = Date.now();
+	rec.lease = null;
 	for (const other of [...h.conns]) {
 		if (other.clientId !== clientId) continue;
 		sendTo(h, other, JSON.stringify({ fin: { reason: "superseded" } }));
@@ -478,9 +482,20 @@ const connect = (h, clientId, socket) => {
 	};
 	sendTo(h, conn, JSON.stringify(hello));
 	return {
+		rec,
+		conn,
+		connection: {
+			clientId,
+			message: (data) => message(h, conn, data),
+			close: () => closeConn(h, conn)
+		}
+	};
+};
+const connect = (h, clientId, socket) => {
+	return register(h, clientId, socket)?.connection ?? {
 		clientId,
-		message: (data) => message(h, conn, data),
-		close: () => closeConn(h, conn)
+		message: () => {},
+		close: () => {}
 	};
 };
 const finish = (h, fin) => {
@@ -506,6 +521,7 @@ const useSocketHost = (transport, options) => {
 			heartbeatMs: 15e3,
 			clientRecordLimit: CLIENT_RECORD_LIMIT,
 			finOnIdle: false,
+			authorize: void 0,
 			clients: /* @__PURE__ */ new Map(),
 			conns: /* @__PURE__ */ new Set(),
 			pendingOps: [],
@@ -524,13 +540,16 @@ const useSocketHost = (transport, options) => {
 				flush(host);
 			}),
 			connect: (clientId, socket) => connect(host, clientId, socket),
-			finish: (fin) => finish(host, fin)
+			finish: (fin) => finish(host, fin),
+			stream: (request) => stream(host, request),
+			frames: (request_0) => frames(host, request_0)
 		};
 		return host;
 	});
 	setHeartbeatMs(h, options?.heartbeatIntervalMs ?? 15e3);
 	h.clientRecordLimit = options?.clientRecordLimit ?? CLIENT_RECORD_LIMIT;
 	h.finOnIdle = options?.finOnIdle ?? false;
+	h.authorize = options?.authorize;
 	const value = useResource(transport);
 	attach(h, value);
 	useEffect(() => {
@@ -557,6 +576,8 @@ const StatewireSocketHost = (transport, options) => {
 	let disposed = false;
 	return {
 		connect: (clientId, socket) => flushTapSync(() => root.getValue().connect(clientId, socket)),
+		stream: (request) => flushTapSync(() => root.getValue().stream(request)),
+		frames: (request) => flushTapSync(() => root.getValue().frames(request)),
 		finish: (fin) => flushTapSync(() => root.getValue().finish(fin)),
 		dispose: () => {
 			if (disposed) return;
@@ -567,6 +588,6 @@ const StatewireSocketHost = (transport, options) => {
 	};
 };
 //#endregion
-export { StatewireSocketHost };
+export { CLIENT_ID_RE, StatewireSocketHost, admitFrame, closeConn, flush, parseFrame, parseFrameValue, register, sendTo };
 
 //# sourceMappingURL=socket.js.map