@firtoz/socka 2.0.0

package/dist/chunk-MZCQHJXY.js

@@ -0,0 +1,158 @@
+import { pack, unpack } from 'msgpackr';
+import { exhaustiveGuard } from '@firtoz/maybe-error';
+
+// src/core/validate.ts
+async function parseStandardSchema(schema, value) {
+  const result = await schema["~standard"].validate(value);
+  if (result.issues) {
+    const messages = result.issues.map((issue) => issue.message).join("; ");
+    throw new Error(messages || "Validation failed");
+  }
+  return result.value;
+}
+
+// src/core/socka-error.ts
+var SockaError = class _SockaError extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "SockaError";
+    this.requestId = options?.requestId;
+    this.code = options?.code;
+    if (options?.cause !== void 0) {
+      Object.defineProperty(this, "cause", {
+        value: options.cause,
+        configurable: true,
+        enumerable: false,
+        writable: true
+      });
+    }
+    Object.setPrototypeOf(this, _SockaError.prototype);
+  }
+  /** Builds a {@link SockaError} from a standard RPC error envelope. */
+  static fromWire(msg) {
+    return new _SockaError(msg.error, { requestId: msg.id });
+  }
+};
+
+// src/core/envelope.ts
+var SOCKA_WIRE_VERSION = 1;
+var SockaWireError = class extends Error {
+  constructor() {
+    super(...arguments);
+    this.name = "SockaWireError";
+  }
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function decodeSockaWire(parsed) {
+  if (!isRecord(parsed)) {
+    throw new SockaWireError("socka: expected a JSON object");
+  }
+  if (parsed.socka === void 0) {
+    throw new SockaWireError('socka: missing "socka" discriminator');
+  }
+  if (parsed.v !== SOCKA_WIRE_VERSION) {
+    throw new SockaWireError("socka: unsupported wire version");
+  }
+  const socka = parsed.socka;
+  if (socka === "clientRequest" && typeof parsed.id === "string" && typeof parsed.rpc === "string" && isRecord(parsed.body)) {
+    return {
+      kind: "clientRequest",
+      frame: parsed
+    };
+  }
+  if (socka === "serverResponse" && typeof parsed.id === "string" && typeof parsed.rpc === "string") {
+    return {
+      kind: "serverResponse",
+      frame: parsed
+    };
+  }
+  if (socka === "serverError" && typeof parsed.id === "string" && typeof parsed.error === "string") {
+    return {
+      kind: "serverError",
+      frame: parsed
+    };
+  }
+  if (socka === "serverEvent" && typeof parsed.event === "string") {
+    return {
+      kind: "serverEvent",
+      frame: parsed
+    };
+  }
+  throw new SockaWireError(
+    `socka: unknown or invalid frame kind ${String(socka)}`
+  );
+}
+function encodeClientRequest(id, rpc, body) {
+  return { socka: "clientRequest", v: SOCKA_WIRE_VERSION, id, rpc, body };
+}
+function encodeServerResponse(id, rpc, body) {
+  return { socka: "serverResponse", v: SOCKA_WIRE_VERSION, id, rpc, body };
+}
+function encodeServerError(id, error) {
+  return { socka: "serverError", v: SOCKA_WIRE_VERSION, id, error };
+}
+function encodeServerEvent(event, body) {
+  return { socka: "serverEvent", v: SOCKA_WIRE_VERSION, event, body };
+}
+function encodeSockaWire(frame, format, serializeJson = JSON.stringify) {
+  if (format === "json") {
+    return serializeJson(frame);
+  }
+  return pack(frame);
+}
+function parseWirePayload(data, format, deserializeJson = JSON.parse) {
+  if (format === "json") {
+    if (typeof data !== "string") {
+      throw new Error("socka: expected a JSON text frame");
+    }
+    return deserializeJson(data);
+  }
+  if (data instanceof Uint8Array) {
+    return unpack(data);
+  }
+  if (data instanceof ArrayBuffer) {
+    return unpack(new Uint8Array(data));
+  }
+  throw new Error("socka: expected an ArrayBuffer or Uint8Array msgpack frame");
+}
+function defaultReportError(event) {
+  switch (event.kind) {
+    case "clientEventListener":
+      console.error("socka: event listener error", event.error);
+      return;
+    case "clientEventValidation":
+      console.error("socka: event validation error", event.error);
+      return;
+    case "serverOnAttached":
+      console.error("socka: onAttached error:", event.error);
+      return;
+    case "serverInboundMessage":
+      if (event.adapter === "hono") {
+        console.error("socka: onMessage error:", event.error);
+      } else {
+        console.error("socka: message handler error:", event.error);
+      }
+      return;
+    case "serverHandleClose":
+      console.error("socka: handleClose error:", event.error);
+      return;
+    case "serverShutdown":
+      if (event.adapter === "hono") {
+        console.error("socka: onClose error:", event.error);
+      } else {
+        console.error("socka: shutdown error:", event.error);
+      }
+      return;
+    default:
+      exhaustiveGuard(event);
+  }
+}
+function reportSockaError(reportError, event) {
+  (reportError ?? defaultReportError)(event);
+}
+
+export { SOCKA_WIRE_VERSION, SockaError, SockaWireError, decodeSockaWire, defaultReportError, encodeClientRequest, encodeServerError, encodeServerEvent, encodeServerResponse, encodeSockaWire, parseStandardSchema, parseWirePayload, reportSockaError };
+//# sourceMappingURL=chunk-MZCQHJXY.js.map
+//# sourceMappingURL=chunk-MZCQHJXY.js.map

package/dist/chunk-MZCQHJXY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/validate.ts","../src/core/socka-error.ts","../src/core/envelope.ts","../src/core/wire-codec.ts","../src/core/socka-report-error.ts"],"names":[],"mappings":"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","file":"chunk-MZCQHJXY.js","sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Validates {@link value} with a Standard Schema v1 schema and returns the output,\n * or throws an {@link Error} whose message aggregates issue messages.\n */\nexport async function parseStandardSchema<T>(\n\tschema: StandardSchemaV1<unknown, T>,\n\tvalue: unknown,\n): Promise<T> {\n\tconst result = await schema[\"~standard\"].validate(value);\n\tif (result.issues) {\n\t\tconst messages = result.issues.map((issue) => issue.message).join(\"; \");\n\t\tthrow new Error(messages || \"Validation failed\");\n\t}\n\treturn result.value;\n}\n","/**\n * Thrown on the server and surfaced on the client when the wire uses a shared\n * `{ type: \"error\", id, error }` envelope for correlated RPC failures.\n */\nexport class SockaError extends Error {\n\treadonly requestId?: string;\n\treadonly code?: string;\n\n\tconstructor(\n\t\tmessage: string,\n\t\toptions?: { requestId?: string; code?: string; cause?: unknown },\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"SockaError\";\n\t\tthis.requestId = options?.requestId;\n\t\tthis.code = options?.code;\n\t\tif (options?.cause !== undefined) {\n\t\t\tObject.defineProperty(this, \"cause\", {\n\t\t\t\tvalue: options.cause,\n\t\t\t\tconfigurable: true,\n\t\t\t\tenumerable: false,\n\t\t\t\twritable: true,\n\t\t\t});\n\t\t}\n\t\tObject.setPrototypeOf(this, SockaError.prototype);\n\t}\n\n\t/** Builds a {@link SockaError} from a standard RPC error envelope. */\n\tstatic fromWire(msg: { id: string; error: string }): SockaError {\n\t\treturn new SockaError(msg.error, { requestId: msg.id });\n\t}\n}\n","/**\n * Versioned socka wire framing. After JSON parse or msgpack unpack, every frame\n * must satisfy {@link decodeSockaWire}; procedure bodies are validated with Standard Schema on each side.\n */\n\nexport const SOCKA_WIRE_VERSION = 1 as const;\n\nexport class SockaWireError extends Error {\n\toverride readonly name = \"SockaWireError\";\n}\n\nexport type SockaClientRequestFrame = {\n\treadonly socka: \"clientRequest\";\n\treadonly v: typeof SOCKA_WIRE_VERSION;\n\treadonly id: string;\n\treadonly rpc: string;\n\treadonly body: Record<string, unknown>;\n};\n\nexport type SockaServerResponseFrame = {\n\treadonly socka: \"serverResponse\";\n\treadonly v: typeof SOCKA_WIRE_VERSION;\n\treadonly id: string;\n\treadonly rpc: string;\n\treadonly body: unknown;\n};\n\nexport type SockaServerErrorFrame = {\n\treadonly socka: \"serverError\";\n\treadonly v: typeof SOCKA_WIRE_VERSION;\n\treadonly id: string;\n\treadonly error: string;\n};\n\nexport type SockaServerEventFrame = {\n\treadonly socka: \"serverEvent\";\n\treadonly v: typeof SOCKA_WIRE_VERSION;\n\treadonly event: string;\n\treadonly body: unknown;\n};\n\nexport type SockaWireFrame =\n\t| SockaClientRequestFrame\n\t| SockaServerResponseFrame\n\t| SockaServerErrorFrame\n\t| SockaServerEventFrame;\n\nexport type DecodedSockaWire =\n\t| { readonly kind: \"clientRequest\"; readonly frame: SockaClientRequestFrame }\n\t| {\n\t\t\treadonly kind: \"serverResponse\";\n\t\t\treadonly frame: SockaServerResponseFrame;\n\t  }\n\t| { readonly kind: \"serverError\"; readonly frame: SockaServerErrorFrame }\n\t| { readonly kind: \"serverEvent\"; readonly frame: SockaServerEventFrame };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Decodes a parsed wire object (from JSON or msgpack). Throws {@link SockaWireError}\n * if the payload is not a valid socka v1 frame.\n */\nexport function decodeSockaWire(parsed: unknown): DecodedSockaWire {\n\tif (!isRecord(parsed)) {\n\t\tthrow new SockaWireError(\"socka: expected a JSON object\");\n\t}\n\tif (parsed.socka === undefined) {\n\t\tthrow new SockaWireError('socka: missing \"socka\" discriminator');\n\t}\n\tif (parsed.v !== SOCKA_WIRE_VERSION) {\n\t\tthrow new SockaWireError(\"socka: unsupported wire version\");\n\t}\n\tconst socka = parsed.socka;\n\tif (\n\t\tsocka === \"clientRequest\" &&\n\t\ttypeof parsed.id === \"string\" &&\n\t\ttypeof parsed.rpc === \"string\" &&\n\t\tisRecord(parsed.body)\n\t) {\n\t\treturn {\n\t\t\tkind: \"clientRequest\",\n\t\t\tframe: parsed as SockaClientRequestFrame,\n\t\t};\n\t}\n\tif (\n\t\tsocka === \"serverResponse\" &&\n\t\ttypeof parsed.id === \"string\" &&\n\t\ttypeof parsed.rpc === \"string\"\n\t) {\n\t\treturn {\n\t\t\tkind: \"serverResponse\",\n\t\t\tframe: parsed as SockaServerResponseFrame,\n\t\t};\n\t}\n\tif (\n\t\tsocka === \"serverError\" &&\n\t\ttypeof parsed.id === \"string\" &&\n\t\ttypeof parsed.error === \"string\"\n\t) {\n\t\treturn {\n\t\t\tkind: \"serverError\",\n\t\t\tframe: parsed as SockaServerErrorFrame,\n\t\t};\n\t}\n\tif (socka === \"serverEvent\" && typeof parsed.event === \"string\") {\n\t\treturn {\n\t\t\tkind: \"serverEvent\",\n\t\t\tframe: parsed as SockaServerEventFrame,\n\t\t};\n\t}\n\tthrow new SockaWireError(\n\t\t`socka: unknown or invalid frame kind ${String(socka)}`,\n\t);\n}\n\n/** Builds a socka v1 client request frame. */\nexport function encodeClientRequest(\n\tid: string,\n\trpc: string,\n\tbody: Record<string, unknown>,\n): SockaClientRequestFrame {\n\treturn { socka: \"clientRequest\", v: SOCKA_WIRE_VERSION, id, rpc, body };\n}\n\n/** Builds a socka v1 server response frame. */\nexport function encodeServerResponse(\n\tid: string,\n\trpc: string,\n\tbody: unknown,\n): SockaServerResponseFrame {\n\treturn { socka: \"serverResponse\", v: SOCKA_WIRE_VERSION, id, rpc, body };\n}\n\n/** Builds a socka v1 server error frame. */\nexport function encodeServerError(\n\tid: string,\n\terror: string,\n): SockaServerErrorFrame {\n\treturn { socka: \"serverError\", v: SOCKA_WIRE_VERSION, id, error };\n}\n\n/** Builds a socka v1 server event frame. */\nexport function encodeServerEvent(\n\tevent: string,\n\tbody: unknown,\n): SockaServerEventFrame {\n\treturn { socka: \"serverEvent\", v: SOCKA_WIRE_VERSION, event, body };\n}\n","/**\n * JSON text frames vs msgpack binary frames for the same socka v1 object graph.\n * Matches {@link decodeSockaWire} after parse/unpack.\n */\n\nimport { pack, unpack } from \"msgpackr\";\nimport type { SockaWireFrame } from \"./envelope\";\n\n/** Wire encoding: UTF-8 JSON strings (default) or msgpack `ArrayBuffer` frames. */\nexport type SockaWireFormat = \"json\" | \"msgpack\";\n\n/**\n * Encodes a socka frame for the wire. JSON returns a string; msgpack returns bytes\n * suitable for `WebSocket.send`.\n */\nexport function encodeSockaWire(\n\tframe: SockaWireFrame,\n\tformat: SockaWireFormat,\n\tserializeJson: (value: unknown) => string = JSON.stringify,\n): string | Uint8Array {\n\tif (format === \"json\") {\n\t\treturn serializeJson(frame);\n\t}\n\treturn pack(frame) as Uint8Array;\n}\n\n/**\n * Decodes a wire payload to a plain object before {@link decodeSockaWire}.\n * Msgpack mode accepts `ArrayBuffer` or `Uint8Array` (e.g. from `msgpackr` / `WebSocket`).\n */\nexport function parseWirePayload(\n\tdata: string | ArrayBuffer | Uint8Array,\n\tformat: SockaWireFormat,\n\tdeserializeJson: (raw: string) => unknown = JSON.parse,\n): unknown {\n\tif (format === \"json\") {\n\t\tif (typeof data !== \"string\") {\n\t\t\tthrow new Error(\"socka: expected a JSON text frame\");\n\t\t}\n\t\treturn deserializeJson(data);\n\t}\n\tif (data instanceof Uint8Array) {\n\t\treturn unpack(data);\n\t}\n\tif (data instanceof ArrayBuffer) {\n\t\treturn unpack(new Uint8Array(data));\n\t}\n\tthrow new Error(\"socka: expected an ArrayBuffer or Uint8Array msgpack frame\");\n}\n","import { exhaustiveGuard } from \"@firtoz/maybe-error\";\n\n/**\n * Single discriminated union for optional `reportError` on session config and\n * `SockaSession` options: `kind` narrows context; `error` is what was thrown or rejected.\n */\nexport type SockaReportError =\n\t| { kind: \"clientEventListener\"; eventName: string; error: unknown }\n\t| { kind: \"clientEventValidation\"; eventName: string; error: unknown }\n\t| { kind: \"serverOnAttached\"; error: unknown }\n\t| {\n\t\t\tkind: \"serverInboundMessage\";\n\t\t\t/** `hono` uses the same log line as the Hono adapters; others use attach-style. */\n\t\t\tadapter: \"attach\" | \"hono\" | \"bun\";\n\t\t\terror: unknown;\n\t  }\n\t| { kind: \"serverHandleClose\"; error: unknown }\n\t| {\n\t\t\tkind: \"serverShutdown\";\n\t\t\tadapter: \"attach\" | \"hono\";\n\t\t\terror: unknown;\n\t  };\n\n/** Default `console.error` behavior; same messages as pre–`reportError` socka. */\nexport function defaultReportError(event: SockaReportError): void {\n\tswitch (event.kind) {\n\t\tcase \"clientEventListener\":\n\t\t\tconsole.error(\"socka: event listener error\", event.error);\n\t\t\treturn;\n\t\tcase \"clientEventValidation\":\n\t\t\tconsole.error(\"socka: event validation error\", event.error);\n\t\t\treturn;\n\t\tcase \"serverOnAttached\":\n\t\t\tconsole.error(\"socka: onAttached error:\", event.error);\n\t\t\treturn;\n\t\tcase \"serverInboundMessage\":\n\t\t\tif (event.adapter === \"hono\") {\n\t\t\t\tconsole.error(\"socka: onMessage error:\", event.error);\n\t\t\t} else {\n\t\t\t\tconsole.error(\"socka: message handler error:\", event.error);\n\t\t\t}\n\t\t\treturn;\n\t\tcase \"serverHandleClose\":\n\t\t\tconsole.error(\"socka: handleClose error:\", event.error);\n\t\t\treturn;\n\t\tcase \"serverShutdown\":\n\t\t\tif (event.adapter === \"hono\") {\n\t\t\t\tconsole.error(\"socka: onClose error:\", event.error);\n\t\t\t} else {\n\t\t\t\tconsole.error(\"socka: shutdown error:\", event.error);\n\t\t\t}\n\t\t\treturn;\n\t\tdefault:\n\t\t\texhaustiveGuard(event);\n\t}\n}\n\n/** Invokes the optional `reportError` callback when provided, otherwise `defaultReportError`. */\nexport function reportSockaError(\n\treportError: ((event: SockaReportError) => void) | undefined,\n\tevent: SockaReportError,\n): void {\n\t(reportError ?? defaultReportError)(event);\n}\n"]}

package/dist/chunk-YMT4HAH7.js

@@ -0,0 +1,20 @@
+// src/core/reserved-procedure-names.ts
+var RESERVED_SOCKA_PROCEDURE_NAMES = [
+  // Promise-like (thenables)
+  "then",
+  "catch",
+  "finally",
+  // Instance shape
+  "constructor",
+  // Typical Object.prototype / debugging
+  "toString",
+  "valueOf",
+  "toLocaleString",
+  "hasOwnProperty",
+  "isPrototypeOf",
+  "propertyIsEnumerable"
+];
+
+export { RESERVED_SOCKA_PROCEDURE_NAMES };
+//# sourceMappingURL=chunk-YMT4HAH7.js.map
+//# sourceMappingURL=chunk-YMT4HAH7.js.map

package/dist/chunk-YMT4HAH7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/reserved-procedure-names.ts"],"names":[],"mappings":";AAMO,IAAM,8BAAA,GAAiC;AAAA;AAAA,EAE7C,MAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA;AAAA,EAEA,aAAA;AAAA;AAAA,EAEA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,gBAAA;AAAA,EACA,gBAAA;AAAA,EACA,eAAA;AAAA,EACA;AACD","file":"chunk-YMT4HAH7.js","sourcesContent":["/**\n * Call names that cannot be used in {@link defineSocka} `calls` because they would\n * make {@link SockaSession} `send` look Promise-like or clash with ordinary object\n * shape (`constructor`, `Object.prototype`). Call names live only under `send`, so\n * session fields like `client` / `close` need not be reserved.\n */\nexport const RESERVED_SOCKA_PROCEDURE_NAMES = [\n\t// Promise-like (thenables)\n\t\"then\",\n\t\"catch\",\n\t\"finally\",\n\t// Instance shape\n\t\"constructor\",\n\t// Typical Object.prototype / debugging\n\t\"toString\",\n\t\"valueOf\",\n\t\"toLocaleString\",\n\t\"hasOwnProperty\",\n\t\"isPrototypeOf\",\n\t\"propertyIsEnumerable\",\n] as const;\n\n/** Union of {@link RESERVED_SOCKA_PROCEDURE_NAMES}. */\nexport type ReservedSockaProcedureName =\n\t(typeof RESERVED_SOCKA_PROCEDURE_NAMES)[number];\n"]}

package/dist/client/index.d.ts

@@ -0,0 +1,119 @@
+import { S as SockaContract, a as SockaContractConfig, b as SockaWireFormat, n as SockaServerResponseFrame, l as SockaServerErrorFrame, m as SockaServerEventFrame, I as InferSockaSend, g as InferSockaPushPayload, f as InferSockaPushHandlers, y as SockaReportError } from '../socka-report-error-DzFI2Tr7.js';
+export { x as reportSockaError } from '../socka-report-error-DzFI2Tr7.js';
+import '@standard-schema/spec';
+
+interface SockaWebSocketClientOptions<TContract extends SockaContract<SockaContractConfig>> {
+    contract: TContract;
+    /** Default `"json"` (text frames). Use `"msgpack"` for binary `ArrayBuffer` frames. */
+    wireFormat?: SockaWireFormat;
+    url?: string;
+    webSocket?: WebSocket;
+    /**
+     * When `false`, the socket is not created until {@link SockaWebSocketClient.connect}
+     * (or the first operation that implicitly opens, e.g. {@link SockaSession} `send`).
+     * Default `true`.
+     */
+    autoConnect?: boolean;
+    serializeJson?: (value: unknown) => string;
+    deserializeJson?: (raw: string) => unknown;
+    onOpen?: (event: Event) => void;
+    onClose?: (event: CloseEvent) => void;
+    onError?: (event: Event) => void;
+    onResponse?: (frame: SockaServerResponseFrame) => void;
+    onServerError?: (frame: SockaServerErrorFrame) => void;
+    onEvent?: (frame: SockaServerEventFrame) => void;
+    onValidationError?: (error: Error, rawMessage: unknown) => void;
+}
+/**
+ * Browser WebSocket client driven by a socka contract. Sends client request
+ * frames and dispatches decoded server frames to callbacks.
+ */
+declare class SockaWebSocketClient<TContract extends SockaContract<SockaContractConfig>> {
+    private ws;
+    private readonly opts;
+    private readonly wireFormat;
+    private readonly serializeJson;
+    private readonly deserializeJson;
+    private readonly onResponseCb?;
+    private readonly onServerErrorCb?;
+    private readonly onEventCb?;
+    private readonly onValidationError?;
+    readonly contract: TContract;
+    constructor(options: SockaWebSocketClientOptions<TContract>);
+    private createSocket;
+    private attachSocket;
+    private handleMessageEvent;
+    /**
+     * Creates the WebSocket (when {@link SockaWebSocketClientOptions.autoConnect}
+     * was `false`) and waits until the connection is open.
+     */
+    connect(): Promise<void>;
+    sendRequest(id: string, rpc: string, body: Record<string, unknown>): void;
+    close(code?: number, reason?: string): void;
+    get readyState(): number;
+    get socket(): WebSocket;
+    waitForOpen(): Promise<void>;
+}
+
+type SockaSessionPushWaitOptions<TContract extends SockaContract<SockaContractConfig>, K extends keyof TContract["pushes"] & string> = {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    predicate?: (payload: InferSockaPushPayload<TContract, K>) => boolean;
+};
+type SockaSessionSubscribeApi<TContract extends SockaContract<SockaContractConfig>> = {
+    on<K extends keyof TContract["pushes"] & string>(name: K, handler: (payload: InferSockaPushPayload<TContract, K>) => void | Promise<void>): void;
+    off<K extends keyof TContract["pushes"] & string>(name: K, handler: (payload: InferSockaPushPayload<TContract, K>) => void | Promise<void>): void;
+    once<K extends keyof TContract["pushes"] & string>(name: K, handler: (payload: InferSockaPushPayload<TContract, K>) => void | Promise<void>): void;
+    waitForPush<K extends keyof TContract["pushes"] & string>(name: K, options?: SockaSessionPushWaitOptions<TContract, K>): Promise<InferSockaPushPayload<TContract, K>>;
+};
+type SockaSessionOptions<TContract extends SockaContract<SockaContractConfig>> = Omit<SockaWebSocketClientOptions<TContract>, "onResponse" | "onServerError" | "onEvent"> & {
+    onOpen?: (event: Event) => void;
+    onClose?: (event: CloseEvent) => void;
+    onError?: (event: Event) => void;
+    pushHandlers?: Partial<InferSockaPushHandlers<TContract>>;
+    /**
+     * Optional sink for client-side push pipeline failures (listener throws,
+     * push payload validation). Defaults to `console.error`; see
+     * `SockaReportError` in `@firtoz/socka/core`.
+     */
+    reportError?: (event: SockaReportError) => void;
+};
+/**
+ * Browser WebSocket session: **`session.send`** for contract calls, **`session.subscribe`**
+ * for server pushes, **`session.client`** for low-level wire access.
+ */
+declare class SockaSessionBase<TContract extends SockaContract<SockaContractConfig>> {
+    readonly client: SockaWebSocketClient<TContract>;
+    readonly send: InferSockaSend<TContract>;
+    readonly subscribe: SockaSessionSubscribeApi<TContract>;
+    private readonly pending;
+    private idSeq;
+    private readonly pushListeners;
+    private readonly reportError?;
+    constructor(options: SockaSessionOptions<TContract>);
+    private createSubscribeApi;
+    private addPushListener;
+    private removePushListener;
+    private waitForPushImpl;
+    private buildSendMethods;
+    private call;
+    private handleResponse;
+    private handleServerError;
+    private handleEvent;
+    private dispatchValidatedPush;
+    private nextId;
+    rejectAllPending(reason: Error): void;
+    close(code?: number, reason?: string): void;
+    /** Opens the WebSocket when using {@link SockaWebSocketClientOptions.autoConnect} `false`. */
+    connect(): Promise<void>;
+}
+interface SockaSessionConstructor {
+    new <TContract extends SockaContract<SockaContractConfig>>(options: SockaSessionOptions<TContract>): SockaSession<TContract>;
+}
+type SockaSession<TContract extends SockaContract<SockaContractConfig>> = SockaSessionBase<TContract>;
+/**
+ * WebSocket session: **`session.send`** for contract calls, **`session.subscribe`** for server pushes.
+ */
+declare const SockaSession: SockaSessionConstructor;
+
+export { SockaReportError, SockaSession, type SockaSessionConstructor, type SockaSessionOptions, type SockaSessionPushWaitOptions, type SockaSessionSubscribeApi, SockaWebSocketClient, type SockaWebSocketClientOptions };

package/dist/client/index.js

@@ -0,0 +1,5 @@
+export { SockaSession, SockaWebSocketClient } from '../chunk-AM7PB26G.js';
+import '../chunk-YMT4HAH7.js';
+export { reportSockaError } from '../chunk-MZCQHJXY.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,29 @@
+export { D as DecodedSockaWire, e as InferSockaHandlers, f as InferSockaPushHandlers, g as InferSockaPushPayload, I as InferSockaSend, R as RESERVED_SOCKA_PROCEDURE_NAMES, h as ReservedSockaProcedureName, i as SOCKA_WIRE_VERSION, k as SockaClientRequestFrame, S as SockaContract, a as SockaContractConfig, c as SockaProcedureDef, y as SockaReportError, l as SockaServerErrorFrame, m as SockaServerEventFrame, n as SockaServerResponseFrame, j as SockaWireError, b as SockaWireFormat, o as SockaWireFrame, V as ValidateSockaCallKeys, p as decodeSockaWire, w as defaultReportError, d as defineSocka, q as encodeClientRequest, s as encodeServerError, t as encodeServerEvent, r as encodeServerResponse, u as encodeSockaWire, v as parseWirePayload, x as reportSockaError } from '../socka-report-error-DzFI2Tr7.js';
+import { StandardSchemaV1 } from '@standard-schema/spec';
+
+/**
+ * Validates {@link value} with a Standard Schema v1 schema and returns the output,
+ * or throws an {@link Error} whose message aggregates issue messages.
+ */
+declare function parseStandardSchema<T>(schema: StandardSchemaV1<unknown, T>, value: unknown): Promise<T>;
+
+/**
+ * Thrown on the server and surfaced on the client when the wire uses a shared
+ * `{ type: "error", id, error }` envelope for correlated RPC failures.
+ */
+declare class SockaError extends Error {
+    readonly requestId?: string;
+    readonly code?: string;
+    constructor(message: string, options?: {
+        requestId?: string;
+        code?: string;
+        cause?: unknown;
+    });
+    /** Builds a {@link SockaError} from a standard RPC error envelope. */
+    static fromWire(msg: {
+        id: string;
+        error: string;
+    }): SockaError;
+}
+
+export { SockaError, parseStandardSchema };

package/dist/core/index.js

@@ -0,0 +1,14 @@
+export { RESERVED_SOCKA_PROCEDURE_NAMES } from '../chunk-YMT4HAH7.js';
+export { SOCKA_WIRE_VERSION, SockaError, SockaWireError, decodeSockaWire, defaultReportError, encodeClientRequest, encodeServerError, encodeServerEvent, encodeServerResponse, encodeSockaWire, parseStandardSchema, parseWirePayload, reportSockaError } from '../chunk-MZCQHJXY.js';
+
+// src/core/contract.ts
+function defineSocka(config) {
+  return {
+    calls: config.calls,
+    pushes: config.pushes ?? {}
+  };
+}
+
+export { defineSocka };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/contract.ts"],"names":[],"mappings":";;;;AAiHO,SAAS,YACf,MAAA,EACmB;AACnB,EAAA,OAAO;AAAA,IACN,OAAO,MAAA,CAAO,KAAA;AAAA,IACd,MAAA,EAAS,MAAA,CAAO,MAAA,IAAU;AAAC,GAC5B;AACD","file":"index.js","sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { ReservedSockaProcedureName } from \"./reserved-procedure-names\";\n\n/**\n * Defines one client-initiated call: an optional input schema and a required output schema.\n * Both must be Standard Schema v1 compliant (Zod v4, Valibot, ArkType, etc.).\n */\nexport type SockaProcedureDef = {\n\treadonly input?: StandardSchemaV1;\n\treadonly output: StandardSchemaV1;\n};\n\n/** Configuration object accepted by {@link defineSocka}. */\nexport type SockaContractConfig = {\n\treadonly calls: Record<string, SockaProcedureDef>;\n\treadonly pushes?: Record<string, StandardSchemaV1>;\n};\n\n/**\n * When call keys are a **narrow** object type, rejects keys in\n * {@link ReservedSockaProcedureName} (thenable / `Object.prototype` hazards on\n * `session.send`). Wide `Record<string, SockaProcedureDef>` is unchanged so\n * dynamic maps still typecheck; use runtime validation (see {@link SockaSession}\n * `send`).\n */\nexport type ValidateSockaCallKeys<P extends Record<string, SockaProcedureDef>> =\n\tstring extends keyof P\n\t\t? P\n\t\t: keyof P & ReservedSockaProcedureName extends never\n\t\t\t? P\n\t\t\t: never;\n\n/** Runtime contract returned by {@link defineSocka}, preserving full generic types. */\nexport type SockaContract<T extends SockaContractConfig = SockaContractConfig> =\n\t{\n\t\treadonly calls: T[\"calls\"];\n\t\treadonly pushes: T extends { pushes: Record<string, StandardSchemaV1> }\n\t\t\t? T[\"pushes\"]\n\t\t\t: Record<string, never>;\n\t};\n\ntype CallFn<P extends SockaProcedureDef> = P extends {\n\tinput: infer I extends StandardSchemaV1;\n}\n\t? (\n\t\t\tinput: StandardSchemaV1.InferInput<I>,\n\t\t) => Promise<StandardSchemaV1.InferOutput<P[\"output\"]>>\n\t: () => Promise<StandardSchemaV1.InferOutput<P[\"output\"]>>;\n\n/**\n * Infers the typed `session.send.*` method map for a contract.\n */\nexport type InferSockaSend<C extends SockaContract> = {\n\t[K in keyof C[\"calls\"]]: CallFn<C[\"calls\"][K]>;\n};\n\ntype HandlerOut<P extends SockaProcedureDef> =\n\t| StandardSchemaV1.InferOutput<P[\"output\"]>\n\t| Promise<StandardSchemaV1.InferOutput<P[\"output\"]>>;\n\ntype HandlerFn<P extends SockaProcedureDef, TSession> = P extends {\n\tinput: infer I extends StandardSchemaV1;\n}\n\t? (input: StandardSchemaV1.InferInput<I>, session: TSession) => HandlerOut<P>\n\t: (session: TSession) => HandlerOut<P>;\n\n/**\n * Infers the typed server handler map for a contract. Handlers with an input\n * schema take `(input, session)`; calls without input take `(session)` only.\n * Each handler returns the output that will be validated before sending.\n */\nexport type InferSockaHandlers<C extends SockaContract, TSession> = {\n\t[K in keyof C[\"calls\"]]: HandlerFn<C[\"calls\"][K], TSession>;\n};\n\ntype InferPushPayload<S extends StandardSchemaV1> =\n\tStandardSchemaV1.InferOutput<S>;\n\n/**\n * Payload type for a contract push (output of the push's Standard Schema).\n */\nexport type InferSockaPushPayload<\n\tC extends SockaContract<SockaContractConfig>,\n\tK extends keyof C[\"pushes\"],\n> = C[\"pushes\"][K] extends StandardSchemaV1\n\t? InferPushPayload<C[\"pushes\"][K]>\n\t: never;\n\n/**\n * Infers the typed push subscription handler map for a contract's `pushes`.\n */\nexport type InferSockaPushHandlers<C extends SockaContract> = {\n\t[K in keyof C[\"pushes\"]]: C[\"pushes\"][K] extends StandardSchemaV1\n\t\t? (payload: InferPushPayload<C[\"pushes\"][K]>) => void | Promise<void>\n\t\t: never;\n};\n\n/**\n * Creates a socka contract from call and push definitions. Pass Zod, Valibot,\n * ArkType, or any Standard Schema v1 schemas directly — no adapters needed.\n *\n * ```ts\n * export const myContract = defineSocka({\n *   calls: {\n *     list: { output: z.array(itemSchema) },\n *     insert: { input: z.object({ item: itemSchema }), output: z.void() },\n *   },\n * });\n * ```\n *\n * Call names must not be {@link ReservedSockaProcedureName} — they would make\n * `session.send` thenable or unsafe as a plain method bag.\n */\nexport function defineSocka<const T extends SockaContractConfig>(\n\tconfig: T & { calls: ValidateSockaCallKeys<T[\"calls\"]> },\n): SockaContract<T> {\n\treturn {\n\t\tcalls: config.calls,\n\t\tpushes: (config.pushes ?? {}) as SockaContract<T>[\"pushes\"],\n\t};\n}\n"]}

package/dist/do/index.d.ts

@@ -0,0 +1,80 @@
+import { Context } from 'hono';
+import { BaseSession, SessionEnv, BaseWebSocketDO } from '@firtoz/websocket-do';
+import { S as SockaContract, a as SockaContractConfig, b as SockaWireFormat, e as InferSockaHandlers, y as SockaReportError, g as InferSockaPushPayload } from '../socka-report-error-DzFI2Tr7.js';
+import { e as SockaPushSession } from '../SockaWebSocketSession-Bru8yFcK.js';
+import '@standard-schema/spec';
+
+/** Session data with no fields — `createData` may be omitted (defaults to `{}`). */
+type EmptySockaSessionData = Record<string, never>;
+type SockaDoOuterSession<TContract extends SockaContract<SockaContractConfig>, TData, TEnv extends object> = SockaDoSession<TContract, TData, TEnv>;
+type SockaDoSessionCreateData<TData, TEnv extends object> = [TData] extends [
+    EmptySockaSessionData
+] ? {
+    createData?: (ctx: Context<{
+        Bindings: TEnv;
+    }>) => TData;
+} : {
+    createData: (ctx: Context<{
+        Bindings: TEnv;
+    }>) => TData;
+};
+type SockaDoSessionConfig<TContract extends SockaContract<SockaContractConfig>, TData, TEnv extends object> = {
+    contract: TContract;
+    /** Default `"json"`. Use `"msgpack"` for binary frames (must match client). */
+    wireFormat?: SockaWireFormat;
+    handlers: InferSockaHandlers<TContract, SockaDoOuterSession<TContract, TData, TEnv>>;
+    handleClose: (session: SockaDoOuterSession<TContract, TData, TEnv>) => Promise<void>;
+    onHandlerError?: (error: unknown, rpcName: string, input: unknown, session: SockaDoOuterSession<TContract, TData, TEnv>) => void;
+    onValidationError?: (error: unknown, originalMessage: unknown) => Promise<void>;
+    /**
+     * Optional sink for non-RPC failures (e.g. `onAttached`). Defaults to
+     * `console.error`; see `SockaReportError` in `@firtoz/socka/core`.
+     */
+    reportError?: (event: SockaReportError) => void;
+    /**
+     * Called after this session is registered in the DO `sessions` map (next
+     * microtask). Use for join broadcasts and other logic that must run only
+     * when peers can see this connection.
+     */
+    onAttached?: (session: SockaDoOuterSession<TContract, TData, TEnv>) => void | Promise<void>;
+    serializeJson?: (value: unknown) => string;
+    deserializeJson?: (raw: string) => unknown;
+} & SockaDoSessionCreateData<TData, TEnv>;
+/**
+ * Durable Object WebSocket session driven by a socka contract.
+ * Dispatches client requests to typed handler functions, validates
+ * input/output via Standard Schema, and auto-sends response/error frames.
+ */
+declare class SockaDoSession<TContract extends SockaContract<SockaContractConfig>, TData = EmptySockaSessionData, TEnv extends object = Cloudflare.Env> extends BaseSession<TData, unknown, unknown, TEnv> implements SockaPushSession<TContract> {
+    private socka;
+    constructor(websocket: WebSocket, sessions: Map<WebSocket, SockaDoSession<TContract, TData, TEnv>>, config: SockaDoSessionConfig<TContract, TData, TEnv>);
+    handleRawMessage(rawMessage: string): Promise<void>;
+    emitWireEvent(event: string, body: unknown): void;
+    emitPush<K extends keyof TContract["pushes"] & string>(name: K, body: InferSockaPushPayload<TContract, K>): Promise<void>;
+    broadcastPush<K extends keyof TContract["pushes"] & string>(name: K, body: InferSockaPushPayload<TContract, K>, excludeSelf?: boolean): Promise<void>;
+}
+
+type SockaWebSocketDOOptions<TEnv extends object, TSession extends SockaDoSession<any, any, TEnv>> = {
+    createSockaSession: (ctx: Context<{
+        Bindings: TEnv;
+    }> | undefined, websocket: WebSocket) => TSession | Promise<TSession>;
+};
+/**
+ * Durable Object base class for WebSocket apps using {@link SockaDoSession}
+ * (Standard Schema contract-driven).
+ */
+declare abstract class SockaWebSocketDO<TSession extends SockaDoSession<any, any, any> = SockaDoSession<SockaContract<SockaContractConfig>, any, any>, TEnv extends SessionEnv<TSession> = SessionEnv<TSession>> extends BaseWebSocketDO<TSession, TEnv> {
+    constructor(ctx: DurableObjectState, env: TEnv, options: SockaWebSocketDOOptions<TEnv, TSession>);
+}
+
+/**
+ * Shared error reply shape for correlate-by-id RPC when the handler throws.
+ * Narrow at the call site to your server message union if needed.
+ */
+declare function toErrorReply(id: string, error: string): {
+    type: "error";
+    id: string;
+    error: string;
+};
+
+export { SockaDoSession, type SockaDoSessionConfig, SockaWebSocketDO, type SockaWebSocketDOOptions, toErrorReply };

package/dist/do/index.js

@@ -0,0 +1,110 @@
+import { SockaWebSocketSession } from '../chunk-45D4T232.js';
+import { reportSockaError } from '../chunk-MZCQHJXY.js';
+import { BaseSession, BaseWebSocketDO } from '@firtoz/websocket-do';
+
+function runSockaDoSessionOnAttached(config, session) {
+  const cb = config.onAttached;
+  if (!cb) return;
+  try {
+    const result = cb(session);
+    void Promise.resolve(result).catch((error) => {
+      reportSockaError(config.reportError, {
+        kind: "serverOnAttached",
+        error
+      });
+    });
+  } catch (error) {
+    reportSockaError(config.reportError, { kind: "serverOnAttached", error });
+  }
+}
+function wrapHandlersForInnerSockaEngine(contract, userHandlers, outer) {
+  const calls = contract.calls;
+  const out = {};
+  for (const key of Object.keys(calls)) {
+    const proc = calls[key];
+    const userFn = userHandlers[key];
+    if (proc.input) {
+      out[key] = (input, _inner) => userFn(input, outer);
+    } else {
+      out[key] = (_inner) => userFn(outer);
+    }
+  }
+  return out;
+}
+var SockaDoSession = class extends BaseSession {
+  constructor(websocket, sessions, config) {
+    const wireFormat = config.wireFormat ?? "json";
+    super(
+      websocket,
+      sessions,
+      {
+        createData: config.createData ?? ((_ctx) => ({})),
+        handleMessage: async () => {
+        },
+        handleBufferMessage: async (message) => {
+          await this.socka.handleBinaryMessage(message);
+        },
+        handleClose: async (baseSession) => {
+          await config.handleClose(
+            baseSession
+          );
+        }
+      }
+    );
+    const sockaConfig = {
+      contract: config.contract,
+      wireFormat,
+      handlers: wrapHandlersForInnerSockaEngine(
+        config.contract,
+        config.handlers,
+        this
+      ),
+      handleClose: async () => {
+      },
+      onHandlerError: config.onHandlerError ? (err, rpcName, input, _inner) => {
+        config.onHandlerError?.(err, rpcName, input, this);
+      } : void 0,
+      onValidationError: config.onValidationError,
+      serializeJson: config.serializeJson,
+      deserializeJson: config.deserializeJson
+    };
+    this.socka = new SockaWebSocketSession(
+      websocket,
+      sessions,
+      sockaConfig
+    );
+    queueMicrotask(() => {
+      queueMicrotask(() => {
+        runSockaDoSessionOnAttached(config, this);
+      });
+    });
+  }
+  async handleRawMessage(rawMessage) {
+    return this.socka.handleRawMessage(rawMessage);
+  }
+  emitWireEvent(event, body) {
+    this.socka.emitWireEvent(event, body);
+  }
+  emitPush(name, body) {
+    return this.socka.emitPush(name, body);
+  }
+  broadcastPush(name, body, excludeSelf = false) {
+    return this.socka.broadcastPush(name, body, excludeSelf);
+  }
+};
+var SockaWebSocketDO = class extends BaseWebSocketDO {
+  constructor(ctx, env, options) {
+    super(ctx, env, {
+      createSession: (sessionCtx, websocket) => options.createSockaSession(sessionCtx, websocket)
+    });
+  }
+};
+
+// src/do/dispatch.ts
+function toErrorReply(id, error) {
+  return { type: "error", id, error };
+}
+
+export { SockaDoSession, SockaWebSocketDO, toErrorReply };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/do/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/do/SockaDoSession.ts","../../src/do/SockaWebSocketDO.ts","../../src/do/dispatch.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Context } from \"hono\";\nimport { BaseSession } from \"@firtoz/websocket-do\";\nimport type {\n\tInferSockaPushPayload,\n\tSockaContract,\n\tSockaContractConfig,\n\tInferSockaHandlers,\n} from \"../core/contract\";\nimport {\n\tSockaWebSocketSession,\n\ttype SockaPushSession,\n\ttype SockaWebSocketSessionConfig,\n} from \"../server/SockaWebSocketSession\";\nimport { reportSockaError } from \"../core/socka-report-error\";\nimport type { SockaReportError } from \"../core/socka-report-error\";\nimport type { SockaWireFormat } from \"../core/wire-codec\";\n\n/** Session data with no fields — `createData` may be omitted (defaults to `{}`). */\ntype EmptySockaSessionData = Record<string, never>;\n\ntype SockaDoOuterSession<\n\tTContract extends SockaContract<SockaContractConfig>,\n\tTData,\n\tTEnv extends object,\n> = import(\"./SockaDoSession\").SockaDoSession<TContract, TData, TEnv>;\n\ntype SockaDoSessionCreateData<TData, TEnv extends object> = [TData] extends [\n\tEmptySockaSessionData,\n]\n\t? {\n\t\t\tcreateData?: (ctx: Context<{ Bindings: TEnv }>) => TData;\n\t\t}\n\t: {\n\t\t\tcreateData: (ctx: Context<{ Bindings: TEnv }>) => TData;\n\t\t};\n\nexport type SockaDoSessionConfig<\n\tTContract extends SockaContract<SockaContractConfig>,\n\tTData,\n\tTEnv extends object,\n> = {\n\tcontract: TContract;\n\t/** Default `\"json\"`. Use `\"msgpack\"` for binary frames (must match client). */\n\twireFormat?: SockaWireFormat;\n\thandlers: InferSockaHandlers<\n\t\tTContract,\n\t\tSockaDoOuterSession<TContract, TData, TEnv>\n\t>;\n\thandleClose: (\n\t\tsession: SockaDoOuterSession<TContract, TData, TEnv>,\n\t) => Promise<void>;\n\tonHandlerError?: (\n\t\terror: unknown,\n\t\trpcName: string,\n\t\tinput: unknown,\n\t\tsession: SockaDoOuterSession<TContract, TData, TEnv>,\n\t) => void;\n\tonValidationError?: (\n\t\terror: unknown,\n\t\toriginalMessage: unknown,\n\t) => Promise<void>;\n\t/**\n\t * Optional sink for non-RPC failures (e.g. `onAttached`). Defaults to\n\t * `console.error`; see `SockaReportError` in `@firtoz/socka/core`.\n\t */\n\treportError?: (event: SockaReportError) => void;\n\t/**\n\t * Called after this session is registered in the DO `sessions` map (next\n\t * microtask). Use for join broadcasts and other logic that must run only\n\t * when peers can see this connection.\n\t */\n\tonAttached?: (\n\t\tsession: SockaDoOuterSession<TContract, TData, TEnv>,\n\t) => void | Promise<void>;\n\tserializeJson?: (value: unknown) => string;\n\tdeserializeJson?: (raw: string) => unknown;\n} & SockaDoSessionCreateData<TData, TEnv>;\n\nfunction runSockaDoSessionOnAttached<\n\tTContract extends SockaContract<SockaContractConfig>,\n\tTData,\n\tTEnv extends object,\n>(\n\tconfig: SockaDoSessionConfig<TContract, TData, TEnv>,\n\tsession: SockaDoSession<TContract, TData, TEnv>,\n): void {\n\tconst cb = config.onAttached;\n\tif (!cb) return;\n\ttry {\n\t\tconst result = cb(session);\n\t\tvoid Promise.resolve(result).catch((error: unknown) => {\n\t\t\treportSockaError(config.reportError, {\n\t\t\t\tkind: \"serverOnAttached\",\n\t\t\t\terror,\n\t\t\t});\n\t\t});\n\t} catch (error) {\n\t\treportSockaError(config.reportError, { kind: \"serverOnAttached\", error });\n\t}\n}\n\nfunction wrapHandlersForInnerSockaEngine<\n\tTContract extends SockaContract<SockaContractConfig>,\n\tTData,\n\tTEnv extends object,\n>(\n\tcontract: TContract,\n\tuserHandlers: InferSockaHandlers<\n\t\tTContract,\n\t\tSockaDoSession<TContract, TData, TEnv>\n\t>,\n\touter: SockaDoSession<TContract, TData, TEnv>,\n): InferSockaHandlers<\n\tTContract,\n\tSockaWebSocketSession<TContract, EmptySockaSessionData>\n> {\n\tconst calls = contract.calls;\n\tconst out: Record<\n\t\tstring,\n\t\t| ((\n\t\t\t\tinput: unknown,\n\t\t\t\tinner: SockaWebSocketSession<TContract, EmptySockaSessionData>,\n\t\t  ) => unknown | Promise<unknown>)\n\t\t| ((\n\t\t\t\tinner: SockaWebSocketSession<TContract, EmptySockaSessionData>,\n\t\t  ) => unknown | Promise<unknown>)\n\t> = {};\n\n\tfor (const key of Object.keys(calls) as Array<keyof typeof calls & string>) {\n\t\tconst proc = calls[key];\n\t\tconst userFn = userHandlers[key as keyof typeof userHandlers];\n\t\tif (proc.input) {\n\t\t\tout[key] = (\n\t\t\t\tinput,\n\t\t\t\t_inner: SockaWebSocketSession<TContract, EmptySockaSessionData>,\n\t\t\t) =>\n\t\t\t\t(\n\t\t\t\t\tuserFn as (\n\t\t\t\t\t\ti: unknown,\n\t\t\t\t\t\ts: SockaDoSession<TContract, TData, TEnv>,\n\t\t\t\t\t) => unknown | Promise<unknown>\n\t\t\t\t)(input, outer);\n\t\t} else {\n\t\t\tout[key] = (\n\t\t\t\t_inner: SockaWebSocketSession<TContract, EmptySockaSessionData>,\n\t\t\t) =>\n\t\t\t\t(\n\t\t\t\t\tuserFn as (\n\t\t\t\t\t\ts: SockaDoSession<TContract, TData, TEnv>,\n\t\t\t\t\t) => unknown | Promise<unknown>\n\t\t\t\t)(outer);\n\t\t}\n\t}\n\n\treturn out as InferSockaHandlers<\n\t\tTContract,\n\t\tSockaWebSocketSession<TContract, EmptySockaSessionData>\n\t>;\n}\n\n/**\n * Durable Object WebSocket session driven by a socka contract.\n * Dispatches client requests to typed handler functions, validates\n * input/output via Standard Schema, and auto-sends response/error frames.\n */\nexport class SockaDoSession<\n\t\tTContract extends SockaContract<SockaContractConfig>,\n\t\tTData = EmptySockaSessionData,\n\t\tTEnv extends object = Cloudflare.Env,\n\t>\n\textends BaseSession<TData, unknown, unknown, TEnv>\n\timplements SockaPushSession<TContract>\n{\n\tprivate socka!: SockaWebSocketSession<TContract, EmptySockaSessionData>;\n\n\tconstructor(\n\t\twebsocket: WebSocket,\n\t\tsessions: Map<WebSocket, SockaDoSession<TContract, TData, TEnv>>,\n\t\tconfig: SockaDoSessionConfig<TContract, TData, TEnv>,\n\t) {\n\t\tconst wireFormat = config.wireFormat ?? \"json\";\n\t\tsuper(\n\t\t\twebsocket,\n\t\t\tsessions as Map<WebSocket, BaseSession<TData, unknown, unknown, TEnv>>,\n\t\t\t{\n\t\t\t\tcreateData:\n\t\t\t\t\tconfig.createData ??\n\t\t\t\t\t((_ctx: Context<{ Bindings: TEnv }>) => ({}) as TData),\n\t\t\t\thandleMessage: async () => {\n\t\t\t\t\t// Raw message handling goes through handleRawMessage / handleBufferMessage\n\t\t\t\t},\n\t\t\t\thandleBufferMessage: async (message) => {\n\t\t\t\t\tawait this.socka.handleBinaryMessage(message);\n\t\t\t\t},\n\t\t\t\thandleClose: async (baseSession) => {\n\t\t\t\t\tawait config.handleClose(\n\t\t\t\t\t\tbaseSession as SockaDoSession<TContract, TData, TEnv>,\n\t\t\t\t\t);\n\t\t\t\t},\n\t\t\t},\n\t\t);\n\t\tconst sockaConfig: SockaWebSocketSessionConfig<\n\t\t\tTContract,\n\t\t\tEmptySockaSessionData\n\t\t> = {\n\t\t\tcontract: config.contract,\n\t\t\twireFormat,\n\t\t\thandlers: wrapHandlersForInnerSockaEngine(\n\t\t\t\tconfig.contract,\n\t\t\t\tconfig.handlers,\n\t\t\t\tthis,\n\t\t\t),\n\t\t\thandleClose: async () => {\n\t\t\t\t// Outer DO lifecycle uses SockaDoSessionConfig.handleClose; inner engine no-op.\n\t\t\t},\n\t\t\tonHandlerError: config.onHandlerError\n\t\t\t\t? (err, rpcName, input, _inner) => {\n\t\t\t\t\t\tconfig.onHandlerError?.(err, rpcName, input, this);\n\t\t\t\t\t}\n\t\t\t\t: undefined,\n\t\t\tonValidationError: config.onValidationError,\n\t\t\tserializeJson: config.serializeJson,\n\t\t\tdeserializeJson: config.deserializeJson,\n\t\t};\n\t\tthis.socka = new SockaWebSocketSession(\n\t\t\twebsocket,\n\t\t\tsessions as unknown as Map<\n\t\t\t\tWebSocket,\n\t\t\t\tSockaWebSocketSession<TContract, EmptySockaSessionData>\n\t\t\t>,\n\t\t\tsockaConfig,\n\t\t);\n\t\t// Defer past the outer `await createSession()` continuation so\n\t\t// `BaseSession.startFresh` has run and `session.data` exists (single\n\t\t// `queueMicrotask` runs before that continuation).\n\t\tqueueMicrotask(() => {\n\t\t\tqueueMicrotask(() => {\n\t\t\t\trunSockaDoSessionOnAttached(config, this);\n\t\t\t});\n\t\t});\n\t}\n\n\tpublic async handleRawMessage(rawMessage: string): Promise<void> {\n\t\treturn this.socka.handleRawMessage(rawMessage);\n\t}\n\n\tpublic emitWireEvent(event: string, body: unknown): void {\n\t\tthis.socka.emitWireEvent(event, body);\n\t}\n\n\tpublic emitPush<K extends keyof TContract[\"pushes\"] & string>(\n\t\tname: K,\n\t\tbody: InferSockaPushPayload<TContract, K>,\n\t): Promise<void> {\n\t\treturn this.socka.emitPush(name, body);\n\t}\n\n\tpublic broadcastPush<K extends keyof TContract[\"pushes\"] & string>(\n\t\tname: K,\n\t\tbody: InferSockaPushPayload<TContract, K>,\n\t\texcludeSelf = false,\n\t): Promise<void> {\n\t\treturn this.socka.broadcastPush(name, body, excludeSelf);\n\t}\n}\n","import type { Context } from \"hono\";\nimport type { SessionEnv } from \"@firtoz/websocket-do\";\nimport { BaseWebSocketDO } from \"@firtoz/websocket-do\";\nimport type { SockaContract, SockaContractConfig } from \"../core/contract\";\nimport type { SockaDoSession } from \"./SockaDoSession\";\n\nexport type SockaWebSocketDOOptions<\n\tTEnv extends object,\n\t// `any` contract slot: concrete sessions use `defineSocka` contracts that do\n\t// not assign to `SockaContract<SockaContractConfig>` under strict generics.\n\tTSession extends SockaDoSession<\n\t\t// biome-ignore lint/suspicious/noExplicitAny: session family type erasure\n\t\tany,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: session family type erasure\n\t\tany,\n\t\tTEnv\n\t>,\n> = {\n\tcreateSockaSession: (\n\t\tctx: Context<{ Bindings: TEnv }> | undefined,\n\t\twebsocket: WebSocket,\n\t) => TSession | Promise<TSession>;\n};\n\n/**\n * Durable Object base class for WebSocket apps using {@link SockaDoSession}\n * (Standard Schema contract-driven).\n */\nexport abstract class SockaWebSocketDO<\n\tTSession extends SockaDoSession<\n\t\t// biome-ignore lint/suspicious/noExplicitAny: session family type erasure\n\t\tany,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: session family type erasure\n\t\tany,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: session family type erasure\n\t\tany\n\t> = SockaDoSession<\n\t\tSockaContract<SockaContractConfig>,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: session family type erasure\n\t\tany,\n\t\t// biome-ignore lint/suspicious/noExplicitAny: session family type erasure\n\t\tany\n\t>,\n\tTEnv extends SessionEnv<TSession> = SessionEnv<TSession>,\n> extends BaseWebSocketDO<TSession, TEnv> {\n\tconstructor(\n\t\tctx: DurableObjectState,\n\t\tenv: TEnv,\n\t\toptions: SockaWebSocketDOOptions<TEnv, TSession>,\n\t) {\n\t\tsuper(ctx, env, {\n\t\t\tcreateSession: (sessionCtx, websocket) =>\n\t\t\t\toptions.createSockaSession(sessionCtx, websocket),\n\t\t});\n\t}\n}\n","/**\n * Shared error reply shape for correlate-by-id RPC when the handler throws.\n * Narrow at the call site to your server message union if needed.\n */\nexport function toErrorReply(\n\tid: string,\n\terror: string,\n): {\n\ttype: \"error\";\n\tid: string;\n\terror: string;\n} {\n\treturn { type: \"error\", id, error };\n}\n"]}