@shadow-js/realtime 0.0.0-stage → 1.0.1

package/dist/dev/cloudflare/object.js

@@ -0,0 +1,213 @@
+import { RealtimeError } from "../errors.js";
+import { isChannelName } from "../protocol.js";
+import { isOperation, parseRequest } from "./wire.js";
+import { ChannelCore } from "./core.js";
+// src/cloudflare/object.ts
+function workersPlatform() {
+	return {
+		createPair() {
+			const Pair = Reflect.get(globalThis, "WebSocketPair");
+			if (typeof Pair !== "function") throw new RealtimeError("unavailable", "WebSocketPair is missing: this is not a Worker");
+			const pair = Reflect.construct(Pair, []);
+			const client = Reflect.get(Object(pair), "0");
+			const server = Reflect.get(Object(pair), "1");
+			if (typeof server !== "object" || server === null || typeof Reflect.get(server, "send") !== "function" || typeof Reflect.get(server, "close") !== "function") throw new TypeError("WebSocketPair returned an unexpected socket");
+			return {
+				client,
+				server
+			};
+		},
+		upgrade(client) {
+			return new Response(null, {
+				status: 101,
+				webSocket: client
+			});
+		},
+		autoResponse() {
+			const Pair = Reflect.get(globalThis, "WebSocketRequestResponsePair");
+			return typeof Pair === "function" ? Reflect.construct(Pair, ["ping", "pong"]) : void 0;
+		}
+	};
+}
+const JSON_HEADERS = { "content-type": "application/json" };
+function reply(body, status = 200) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: JSON_HEADERS
+	});
+}
+function refusal(code, message, status) {
+	return reply({ error: {
+		code,
+		message
+	} }, status);
+}
+const STATUS = {
+	bad_frame: 400,
+	bad_channel: 400,
+	too_large: 413,
+	limit: 429,
+	conflict: 409
+};
+/** A close code `close()` may send: the reserved 1005, 1006 and 1015 never go on the wire. */
+function replyCode(code) {
+	return code >= 1e3 && code < 5e3 && code !== 1005 && code !== 1006 && code !== 1015 ? code : 1e3;
+}
+function readAfter(url) {
+	const value = url.searchParams.get("after");
+	if (value === null) return void 0;
+	if (!/^\d{1,16}$/.test(value)) return "bad";
+	return Number(value);
+}
+/**
+* The Durable Object that owns one channel: the single writer of its sequence numbers, its retained history, its idempotency
+* keys and its presence set, and the fan-out to the Workers that subscribed. Re-export it from your Worker and bind it as a
+* SQLite-backed Durable Object; `cloudflareAdapter` talks to it.
+*
+* It keeps everything in Durable Object storage, so it can be evicted and restart at any time, and it uses the WebSocket
+* Hibernation API, so a channel nobody publishes to costs nothing while its subscribers stay connected. An alarm reaps expired
+* presence members and expired retention.
+*
+* @example
+* // worker.ts
+* export { RealtimeChannelObject } from "@shadow-js/realtime/cloudflare";
+*
+* // wrangler.toml
+* // [[durable_objects.bindings]]
+* // name = "CHANNELS"
+* // class_name = "RealtimeChannelObject"
+* // [[migrations]]
+* // tag = "v1"
+* // new_sqlite_classes = ["RealtimeChannelObject"]
+* @since 1.0.0
+*/
+var RealtimeChannelObject = class {
+	#state;
+	#core;
+	#platform;
+	/**
+	* @param state The Durable Object state the runtime passes.
+	* @param env The Worker's bindings (unused).
+	* @param platform The platform seams (the runtime passes none).
+	*/
+	constructor(state, env, platform) {
+		this.#state = state;
+		this.#platform = platform ?? workersPlatform();
+		this.#core = new ChannelCore({ storage: state.storage });
+		this.#core.adopt(state.getWebSockets());
+		const pair = this.#platform.autoResponse();
+		if (pair !== void 0) state.setWebSocketAutoResponse?.(pair);
+	}
+	/**
+	* Handles a request from `cloudflareAdapter`: `POST /v1/<operation>` with a JSON body, or `GET /v1/ws` to subscribe.
+	*
+	* @param request The request.
+	* @returns The response.
+	*/
+	async fetch(request) {
+		const url = new URL(request.url);
+		if (url.pathname === `/v1/ws`) return this.#subscribe(request, url);
+		const operation = /^\/v(\d+)\/([a-z-]+)$/.exec(url.pathname);
+		if (operation?.[1] !== String(1) || !isOperation(operation[2] ?? "")) return refusal("bad_frame", "unknown operation", 404);
+		const op = operation[2] ?? "";
+		if (!isOperation(op)) return refusal("bad_frame", "unknown operation", 404);
+		if (request.method !== "POST") return refusal("bad_frame", "use POST", 405);
+		if (Number(request.headers.get("content-length") ?? 0) > 262144) return refusal("too_large", "the body is too large", 413);
+		const text = await request.text();
+		if (text.length > 262144) return refusal("too_large", "the body is too large", 413);
+		let body;
+		try {
+			body = JSON.parse(text);
+		} catch {
+			return refusal("bad_frame", "the body is not JSON", 400);
+		}
+		const parsed = parseRequest(op, body);
+		if (!parsed.ok) return refusal(parsed.code, parsed.message, STATUS[parsed.code] ?? 400);
+		const call = parsed.request;
+		try {
+			switch (call.op) {
+				case "publish": return reply(await this.#core.publish(call.channel, call.entry, call.options, call.idleMs));
+				case "history": return reply(await this.#core.history(call.channel, call.after, call.limit));
+				case "presence-set":
+					await this.#core.presenceSet(call.channel, call.member, call.ttlMs, call.graceMs);
+					return reply({});
+				case "presence-remove": return reply({ removed: await this.#core.presenceRemove(call.channel, call.id) });
+				case "presence-list": return reply({ members: await this.#core.presenceList(call.channel) });
+				case "presence-touch": return reply({ missing: await this.#core.presenceTouch(call.channel, call.ids, call.ttlMs) });
+				case "presence-reap": return reply({ members: await this.#core.presenceReap(call.channel) });
+			}
+		} catch (error) {
+			if (error instanceof RealtimeError) return refusal(error.code, error.message, STATUS[error.code] ?? 500);
+			console.error("[realtime] channel object", error);
+			return refusal("unavailable", "the channel object failed", 500);
+		}
+	}
+	async #subscribe(request, url) {
+		if (request.headers.get("upgrade")?.toLowerCase() !== "websocket") return refusal("bad_frame", "expected a WebSocket upgrade", 426);
+		const channel = url.searchParams.get("c");
+		if (!isChannelName(channel)) return refusal("bad_channel", "bad channel name", 400);
+		const after = readAfter(url);
+		if (after === "bad") return refusal("bad_frame", "bad after", 400);
+		const { client, server } = this.#platform.createPair();
+		this.#state.acceptWebSocket(server);
+		try {
+			await this.#core.attach(server, channel, after);
+		} catch (error) {
+			try {
+				server.close(1011, "attach failed");
+			} catch {}
+			if (error instanceof RealtimeError) return refusal(error.code, error.message, STATUS[error.code] ?? 500);
+			console.error("[realtime] channel object", error);
+			return refusal("unavailable", "the channel object failed", 500);
+		}
+		return this.#platform.upgrade(client);
+	}
+	/**
+	* Runtime hook: a message on a subscribe socket. The only message is the keep-alive `ping`, which the runtime normally answers
+	* itself without waking the object.
+	*
+	* @param socket The socket.
+	* @param message The message.
+	*/
+	webSocketMessage(socket, message) {
+		if (message === "ping") try {
+			socket.send("pong");
+		} catch {
+			this.#core.detach(socket);
+		}
+	}
+	/**
+	* Runtime hook: a subscribe socket closed.
+	*
+	* @param socket The socket.
+	* @param code The close code the peer sent.
+	* @param reason The reason the peer sent.
+	*/
+	webSocketClose(socket, code, reason) {
+		this.#core.detach(socket);
+		try {
+			socket.close(replyCode(code), reason.slice(0, 100));
+		} catch {}
+	}
+	/**
+	* Runtime hook: a subscribe socket failed.
+	*
+	* @param socket The socket.
+	*/
+	webSocketError(socket) {
+		this.#core.detach(socket);
+		try {
+			socket.close(1011, "error");
+		} catch {}
+	}
+	/**
+	* Runtime hook: the alarm. Reaps expired presence members (one `leave` each), expired idempotency keys and expired retained
+	* messages, and sets the next alarm.
+	*/
+	async alarm() {
+		await this.#core.alarm();
+	}
+};
+export { RealtimeChannelObject };
+
+//# sourceMappingURL=object.js.map

package/dist/dev/cloudflare/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","names":[],"sources":["../../../src/cloudflare/object.ts"],"sourcesContent":["import { RealtimeError } from \"../errors\";\nimport { isChannelName } from \"../protocol\";\nimport { ChannelCore } from \"./core\";\nimport type { ChannelObjectState, ChannelSocket } from \"./types\";\nimport { isOperation, MAX_BODY_BYTES, parseRequest, WIRE_VERSION } from \"./wire\";\n\n/**\n * The pieces of the platform the object creates: a WebSocket pair, the upgrade response and the auto-response pair. The default\n * reads the Workers globals; the unit tests pass their own.\n * @internal\n */\nexport interface ObjectPlatform {\n  createPair(): { readonly client: unknown; readonly server: ChannelSocket };\n  upgrade(client: unknown): Response;\n  autoResponse(): object | undefined;\n}\n\nfunction workersPlatform(): ObjectPlatform {\n  return {\n    createPair() {\n      const Pair: unknown = Reflect.get(globalThis, \"WebSocketPair\");\n      if (typeof Pair !== \"function\")\n        throw new RealtimeError(\"unavailable\", \"WebSocketPair is missing: this is not a Worker\");\n      const pair: unknown = Reflect.construct(Pair, []);\n      const client: unknown = Reflect.get(Object(pair), \"0\");\n      const server: unknown = Reflect.get(Object(pair), \"1\");\n      if (\n        typeof server !== \"object\" ||\n        server === null ||\n        typeof Reflect.get(server, \"send\") !== \"function\" ||\n        typeof Reflect.get(server, \"close\") !== \"function\"\n      )\n        throw new TypeError(\"WebSocketPair returned an unexpected socket\");\n      return { client, server: server as ChannelSocket };\n    },\n    upgrade(client) {\n      // `webSocket` is a Workers extension of `ResponseInit`; the standard type does not have it.\n      return new Response(null, { status: 101, webSocket: client } as unknown as ResponseInit);\n    },\n    autoResponse() {\n      const Pair: unknown = Reflect.get(globalThis, \"WebSocketRequestResponsePair\");\n      return typeof Pair === \"function\"\n        ? (Reflect.construct(Pair, [\"ping\", \"pong\"]) as object)\n        : undefined;\n    },\n  };\n}\n\nconst JSON_HEADERS = { \"content-type\": \"application/json\" } as const;\n\nfunction reply(body: unknown, status = 200): Response {\n  return new Response(JSON.stringify(body), { status, headers: JSON_HEADERS });\n}\n\nfunction refusal(code: string, message: string, status: number): Response {\n  return reply({ error: { code, message } }, status);\n}\n\nconst STATUS: Readonly<Record<string, number>> = {\n  bad_frame: 400,\n  bad_channel: 400,\n  too_large: 413,\n  limit: 429,\n  conflict: 409,\n};\n\n/** A close code `close()` may send: the reserved 1005, 1006 and 1015 never go on the wire. */\nfunction replyCode(code: number): number {\n  return code >= 1000 && code < 5000 && code !== 1005 && code !== 1006 && code !== 1015\n    ? code\n    : 1000;\n}\n\nfunction readAfter(url: URL): number | undefined | \"bad\" {\n  const value = url.searchParams.get(\"after\");\n  if (value === null) return undefined;\n  if (!/^\\d{1,16}$/.test(value)) return \"bad\";\n  return Number(value);\n}\n\n/**\n * The Durable Object that owns one channel: the single writer of its sequence numbers, its retained history, its idempotency\n * keys and its presence set, and the fan-out to the Workers that subscribed. Re-export it from your Worker and bind it as a\n * SQLite-backed Durable Object; `cloudflareAdapter` talks to it.\n *\n * It keeps everything in Durable Object storage, so it can be evicted and restart at any time, and it uses the WebSocket\n * Hibernation API, so a channel nobody publishes to costs nothing while its subscribers stay connected. An alarm reaps expired\n * presence members and expired retention.\n *\n * @example\n * // worker.ts\n * export { RealtimeChannelObject } from \"@shadow-js/realtime/cloudflare\";\n *\n * // wrangler.toml\n * // [[durable_objects.bindings]]\n * // name = \"CHANNELS\"\n * // class_name = \"RealtimeChannelObject\"\n * // [[migrations]]\n * // tag = \"v1\"\n * // new_sqlite_classes = [\"RealtimeChannelObject\"]\n * @since 1.0.0\n */\nexport class RealtimeChannelObject {\n  readonly #state: ChannelObjectState;\n  readonly #core: ChannelCore;\n  readonly #platform: ObjectPlatform;\n\n  /**\n   * @param state The Durable Object state the runtime passes.\n   * @param env The Worker's bindings (unused).\n   * @param platform The platform seams (the runtime passes none).\n   */\n  constructor(state: ChannelObjectState, env?: unknown, platform?: ObjectPlatform) {\n    void env;\n    this.#state = state;\n    this.#platform = platform ?? workersPlatform();\n    this.#core = new ChannelCore({ storage: state.storage });\n    this.#core.adopt(state.getWebSockets());\n    const pair = this.#platform.autoResponse();\n    if (pair !== undefined) state.setWebSocketAutoResponse?.(pair);\n  }\n\n  /**\n   * Handles a request from `cloudflareAdapter`: `POST /v1/<operation>` with a JSON body, or `GET /v1/ws` to subscribe.\n   *\n   * @param request The request.\n   * @returns The response.\n   */\n  async fetch(request: Request): Promise<Response> {\n    const url = new URL(request.url);\n    if (url.pathname === `/v${WIRE_VERSION}/ws`) return this.#subscribe(request, url);\n    const operation = /^\\/v(\\d+)\\/([a-z-]+)$/.exec(url.pathname);\n    if (operation?.[1] !== String(WIRE_VERSION) || !isOperation(operation[2] ?? \"\"))\n      return refusal(\"bad_frame\", \"unknown operation\", 404);\n    const op = operation[2] ?? \"\";\n    if (!isOperation(op)) return refusal(\"bad_frame\", \"unknown operation\", 404);\n    if (request.method !== \"POST\") return refusal(\"bad_frame\", \"use POST\", 405);\n    const declared = Number(request.headers.get(\"content-length\") ?? 0);\n    if (declared > MAX_BODY_BYTES) return refusal(\"too_large\", \"the body is too large\", 413);\n    const text = await request.text();\n    if (text.length > MAX_BODY_BYTES) return refusal(\"too_large\", \"the body is too large\", 413);\n    let body: unknown;\n    try {\n      body = JSON.parse(text);\n    } catch {\n      return refusal(\"bad_frame\", \"the body is not JSON\", 400);\n    }\n    const parsed = parseRequest(op, body);\n    if (!parsed.ok) return refusal(parsed.code, parsed.message, STATUS[parsed.code] ?? 400);\n    const call = parsed.request;\n    try {\n      switch (call.op) {\n        case \"publish\":\n          return reply(\n            await this.#core.publish(call.channel, call.entry, call.options, call.idleMs),\n          );\n        case \"history\":\n          return reply(await this.#core.history(call.channel, call.after, call.limit));\n        case \"presence-set\":\n          await this.#core.presenceSet(call.channel, call.member, call.ttlMs, call.graceMs);\n          return reply({});\n        case \"presence-remove\":\n          return reply({ removed: await this.#core.presenceRemove(call.channel, call.id) });\n        case \"presence-list\":\n          return reply({ members: await this.#core.presenceList(call.channel) });\n        case \"presence-touch\":\n          return reply({\n            missing: await this.#core.presenceTouch(call.channel, call.ids, call.ttlMs),\n          });\n        case \"presence-reap\":\n          return reply({ members: await this.#core.presenceReap(call.channel) });\n      }\n    } catch (error) {\n      if (error instanceof RealtimeError)\n        return refusal(error.code, error.message, STATUS[error.code] ?? 500);\n      console.error(\"[realtime] channel object\", error);\n      return refusal(\"unavailable\", \"the channel object failed\", 500);\n    }\n  }\n\n  async #subscribe(request: Request, url: URL): Promise<Response> {\n    if (request.headers.get(\"upgrade\")?.toLowerCase() !== \"websocket\")\n      return refusal(\"bad_frame\", \"expected a WebSocket upgrade\", 426);\n    const channel = url.searchParams.get(\"c\");\n    if (!isChannelName(channel)) return refusal(\"bad_channel\", \"bad channel name\", 400);\n    const after = readAfter(url);\n    if (after === \"bad\") return refusal(\"bad_frame\", \"bad after\", 400);\n    const { client, server } = this.#platform.createPair();\n    this.#state.acceptWebSocket(server);\n    try {\n      await this.#core.attach(server, channel, after);\n    } catch (error) {\n      try {\n        server.close(1011, \"attach failed\");\n      } catch {\n        // Already closed.\n      }\n      if (error instanceof RealtimeError)\n        return refusal(error.code, error.message, STATUS[error.code] ?? 500);\n      console.error(\"[realtime] channel object\", error);\n      return refusal(\"unavailable\", \"the channel object failed\", 500);\n    }\n    return this.#platform.upgrade(client);\n  }\n\n  /**\n   * Runtime hook: a message on a subscribe socket. The only message is the keep-alive `ping`, which the runtime normally answers\n   * itself without waking the object.\n   *\n   * @param socket The socket.\n   * @param message The message.\n   */\n  webSocketMessage(socket: ChannelSocket, message: string | ArrayBuffer): void {\n    if (message === \"ping\") {\n      try {\n        socket.send(\"pong\");\n      } catch {\n        this.#core.detach(socket);\n      }\n    }\n  }\n\n  /**\n   * Runtime hook: a subscribe socket closed.\n   *\n   * @param socket The socket.\n   * @param code The close code the peer sent.\n   * @param reason The reason the peer sent.\n   */\n  webSocketClose(socket: ChannelSocket, code: number, reason: string): void {\n    this.#core.detach(socket);\n    try {\n      socket.close(replyCode(code), reason.slice(0, 100));\n    } catch {\n      // Already closed.\n    }\n  }\n\n  /**\n   * Runtime hook: a subscribe socket failed.\n   *\n   * @param socket The socket.\n   */\n  webSocketError(socket: ChannelSocket): void {\n    this.#core.detach(socket);\n    try {\n      socket.close(1011, \"error\");\n    } catch {\n      // Already closed.\n    }\n  }\n\n  /**\n   * Runtime hook: the alarm. Reaps expired presence members (one `leave` each), expired idempotency keys and expired retained\n   * messages, and sets the next alarm.\n   */\n  async alarm(): Promise<void> {\n    await this.#core.alarm();\n  }\n}\n"],"mappings":"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"}

package/dist/dev/cloudflare/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * The few shapes of the Cloudflare Workers runtime the Durable Object adapter touches. They are declared here, structurally, so
+ * the package has no dependency on `@cloudflare/workers-types`: the real `DurableObjectNamespace`, `DurableObjectState` and
+ * `DurableObjectStorage` satisfy them, and so do the in-memory doubles the unit tests use.
+ * @packageDocumentation
+ */
+/** Options of {@link ChannelStorage.list}. @since 1.0.0 */
+export interface StorageListOptions {
+  /** Only keys with this prefix. */
+  readonly prefix?: string;
+  /** The first key to return (inclusive). */
+  readonly start?: string;
+  /** The key to stop at (exclusive). */
+  readonly end?: string;
+  /** The most entries to return. */
+  readonly limit?: number;
+  /** Return in descending key order. */
+  readonly reverse?: boolean;
+}
+/** The writes available inside {@link ChannelStorage.transaction}. @since 1.0.0 */
+export interface StorageTransaction {
+  put(entries: Readonly<Record<string, unknown>>): Promise<void>;
+  delete(keys: readonly string[]): Promise<number>;
+}
+/**
+ * The part of a Durable Object's storage the channel object uses. Keys sort as strings, so numbers inside keys are zero padded.
+ * @since 1.0.0
+ */
+export interface ChannelStorage {
+  get<T>(key: string): Promise<T | undefined>;
+  get<T>(keys: readonly string[]): Promise<Map<string, T>>;
+  put(entries: Readonly<Record<string, unknown>>): Promise<void>;
+  delete(keys: readonly string[]): Promise<number>;
+  list<T>(options?: StorageListOptions): Promise<Map<string, T>>;
+  transaction<T>(closure: (transaction: StorageTransaction) => Promise<T>): Promise<T>;
+  getAlarm(): Promise<number | null>;
+  setAlarm(scheduledTime: number): Promise<void>;
+  deleteAlarm(): Promise<void>;
+  deleteAll(): Promise<void>;
+}
+/** A WebSocket as the channel object and the adapter use it. @since 1.0.0 */
+export interface ChannelSocket {
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+}
+/** What the object needs from `DurableObjectState`. @since 1.0.0 */
+export interface ChannelObjectState {
+  readonly storage: ChannelStorage;
+  /** Accepts a server-side socket with the Hibernation API: the runtime may evict the object while the socket stays open. */
+  acceptWebSocket(socket: ChannelSocket, tags?: string[]): void;
+  /** The sockets accepted with `acceptWebSocket` that are still open. */
+  getWebSockets(tag?: string): ChannelSocket[];
+  /** Answers a fixed request text without waking the object. */
+  setWebSocketAutoResponse?(pair?: object): void;
+}
+/** A response of a Durable Object stub, with the WebSocket of an accepted upgrade. @since 1.0.0 */
+export interface ChannelResponse {
+  readonly status: number;
+  readonly ok: boolean;
+  readonly webSocket?: ClientSocket | null;
+  text(): Promise<string>;
+}
+/** The client end of a WebSocket pair, before `accept()`. @since 1.0.0 */
+export interface ClientSocket {
+  accept(): void;
+  send(data: string): void;
+  close(code?: number, reason?: string): void;
+  addEventListener(type: "message", listener: (event: {
+    readonly data: unknown;
+  }) => void): void;
+  addEventListener(type: "close", listener: (event: {
+    readonly code?: number;
+  }) => void): void;
+  addEventListener(type: "error", listener: (event: unknown) => void): void;
+}
+/** What a request to a stub carries. @since 1.0.0 */
+export interface ChannelRequestInit {
+  readonly method?: string;
+  readonly headers?: Readonly<Record<string, string>>;
+  readonly body?: string;
+  readonly signal?: AbortSignal;
+}
+/** A Durable Object stub. @since 1.0.0 */
+export interface ChannelStub {
+  fetch(url: string, init?: ChannelRequestInit): Promise<ChannelResponse>;
+}
+/**
+ * The namespace binding of the channel object (`env.CHANNELS` for a binding named `CHANNELS`): the real
+ * `DurableObjectNamespace` fits.
+ * @since 1.0.0
+ */
+export interface ChannelNamespace<Id = unknown> {
+  idFromName(name: string): Id;
+  get(id: Id, options?: {
+    readonly locationHint?: string;
+  }): ChannelStub;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/dev/cloudflare/wire.js

@@ -0,0 +1,283 @@
+import { byteLength, isChannelName, isEventName, isIdempotencyKey } from "../protocol.js";
+// src/cloudflare/wire.ts
+/** The most bytes of one message (data, event and names) the object stores in one value; the platform's smallest value limit is 128 KiB. @internal */
+const MAX_ENTRY_BYTES = 122880;
+/** The most bytes of one member's state. @internal */
+const MAX_STATE_BYTES = 16384;
+/** The most members one channel object keeps. @internal */
+const MAX_MEMBERS = 1e4;
+/** The most messages one channel retains. @internal */
+const MAX_HISTORY = 1e4;
+/** The longest expiry of a presence member or an idempotency key. @internal */
+const MAX_TTL_MS = 864e5;
+/** The most bytes of a request body the object reads. @internal */
+const MAX_BODY_BYTES = 262144;
+const OPERATIONS = /* @__PURE__ */ new Set([
+	"publish",
+	"history",
+	"presence-set",
+	"presence-remove",
+	"presence-list",
+	"presence-touch",
+	"presence-reap"
+]);
+/** Whether `value` names an operation. @internal */
+function isOperation(value) {
+	return OPERATIONS.has(value);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isCount(value, max = Number.MAX_SAFE_INTEGER) {
+	return typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= max;
+}
+function fail(message, code = "bad_frame") {
+	return {
+		ok: false,
+		code,
+		message
+	};
+}
+/**
+* Whether `value` is a well formed member: an id, an optional user, a version of 1 or more and a JSON state of bounded size.
+* @internal
+*/
+function parseMember(value) {
+	if (!isRecord(value)) return void 0;
+	const { id, u, s, v } = value;
+	if (typeof id !== "string" || id.length === 0 || id.length > 256) return void 0;
+	if (u !== void 0 && (typeof u !== "string" || u.length > 256)) return void 0;
+	if (typeof v !== "number" || !Number.isInteger(v) || v < 1) return void 0;
+	const state = s === void 0 ? null : s;
+	const text = JSON.stringify(state);
+	if (text === void 0 || byteLength(text) > 16384) return void 0;
+	return u === void 0 ? {
+		id,
+		s: state,
+		v
+	} : {
+		id,
+		u,
+		s: state,
+		v
+	};
+}
+function parseEntry(value) {
+	if (!isRecord(value)) return void 0;
+	const { event, data, publisher, user } = value;
+	if (!isEventName(event) || typeof data !== "string") return void 0;
+	if (publisher !== void 0 && (typeof publisher !== "string" || publisher.length > 256)) return void 0;
+	if (user !== void 0 && (typeof user !== "string" || user.length > 256)) return void 0;
+	return {
+		event,
+		data,
+		...publisher === void 0 ? {} : { publisher },
+		...user === void 0 ? {} : { user }
+	};
+}
+function parseOptions(value) {
+	if (!isRecord(value)) return void 0;
+	const { history, historyTtlMs, key, idempotencyTtlMs } = value;
+	if (!isCount(history, 1e4)) return void 0;
+	if (!isCount(historyTtlMs, 316224e5)) return void 0;
+	if (!isCount(idempotencyTtlMs, 864e5)) return void 0;
+	if (key !== void 0 && !isIdempotencyKey(key)) return void 0;
+	return key === void 0 ? {
+		history,
+		historyTtlMs,
+		idempotencyTtlMs
+	} : {
+		history,
+		historyTtlMs,
+		key,
+		idempotencyTtlMs
+	};
+}
+/**
+* Parses the JSON body of a request to operation `op`.
+*
+* @param op The operation from the path.
+* @param body The parsed JSON body.
+* @returns The request, or the refusal to answer.
+* @internal
+*/
+function parseRequest(op, body) {
+	if (!isRecord(body)) return fail("the body must be an object");
+	const { channel } = body;
+	if (!isChannelName(channel)) return fail("bad channel name", "bad_channel");
+	switch (op) {
+		case "publish": {
+			const entry = parseEntry(body["entry"]);
+			const options = parseOptions(body["options"]);
+			const idleMs = body["idleMs"] ?? 0;
+			if (entry === void 0) return fail("bad entry");
+			if (options === void 0) return fail("bad options");
+			if (!isCount(idleMs, 31536e7)) return fail("bad idleMs");
+			if (byteLength(entry.data) + byteLength(entry.event) > 122880) return fail("the message is too large for one stored value", "too_large");
+			return {
+				ok: true,
+				request: {
+					op,
+					channel,
+					entry,
+					options,
+					idleMs
+				}
+			};
+		}
+		case "history": {
+			const { after, limit } = body;
+			if (!isCount(after) || !isCount(limit, 1e5)) return fail("bad after or limit");
+			return {
+				ok: true,
+				request: {
+					op,
+					channel,
+					after,
+					limit
+				}
+			};
+		}
+		case "presence-set": {
+			const member = parseMember(body["member"]);
+			const { ttlMs } = body;
+			const graceMs = body["graceMs"] ?? 0;
+			if (member === void 0) return fail("bad member");
+			if (!isCount(ttlMs, 864e5) || ttlMs === 0) return fail("bad ttlMs");
+			if (!isCount(graceMs, 36e5)) return fail("bad graceMs");
+			return {
+				ok: true,
+				request: {
+					op,
+					channel,
+					member,
+					ttlMs,
+					graceMs
+				}
+			};
+		}
+		case "presence-remove": {
+			const { id } = body;
+			if (typeof id !== "string" || id.length === 0 || id.length > 256) return fail("bad id");
+			return {
+				ok: true,
+				request: {
+					op,
+					channel,
+					id
+				}
+			};
+		}
+		case "presence-touch": {
+			const { ids, ttlMs } = body;
+			if (!isCount(ttlMs, 864e5) || ttlMs === 0) return fail("bad ttlMs");
+			if (!Array.isArray(ids) || ids.length > 1e4 || !ids.every((id) => typeof id === "string" && id.length > 0 && id.length <= 256)) return fail("bad ids");
+			return {
+				ok: true,
+				request: {
+					op,
+					channel,
+					ids,
+					ttlMs
+				}
+			};
+		}
+		case "presence-list":
+		case "presence-reap": return {
+			ok: true,
+			request: {
+				op,
+				channel
+			}
+		};
+	}
+}
+/** Decodes a frame from the object; `undefined` for anything that is not a known, well formed frame. @internal */
+function decodeLinkFrame(text) {
+	let value;
+	try {
+		value = JSON.parse(text);
+	} catch {
+		return;
+	}
+	if (!isRecord(value)) return void 0;
+	switch (value["t"]) {
+		case "ready": {
+			const { head, oldest } = value;
+			return isCount(head) && isCount(oldest) ? {
+				t: "ready",
+				head,
+				oldest
+			} : void 0;
+		}
+		case "snap": {
+			const list = value["members"];
+			if (!Array.isArray(list)) return void 0;
+			const members = [];
+			for (const item of list) {
+				const member = parseMember(item);
+				if (member === void 0) return void 0;
+				members.push(member);
+			}
+			return {
+				t: "snap",
+				members
+			};
+		}
+		case "msg": {
+			const message = parseStored(value["m"]);
+			return message === void 0 ? void 0 : {
+				t: "msg",
+				m: message
+			};
+		}
+		case "pres": {
+			const member = parseMember(value["member"]);
+			const op = value["op"];
+			if (member === void 0 || op !== "join" && op !== "set" && op !== "leave") return void 0;
+			return {
+				t: "pres",
+				op,
+				member
+			};
+		}
+		case "more": return { t: "more" };
+		case "bye": return {
+			t: "bye",
+			why: typeof value["why"] === "string" ? value["why"] : ""
+		};
+		default: return;
+	}
+}
+/** Reads a stored message; `undefined` when it is malformed. @internal */
+function parseStored(value) {
+	if (!isRecord(value)) return void 0;
+	const { seq, event, data, at, publisher, user } = value;
+	if (!isCount(seq) || seq < 1 || typeof event !== "string" || typeof data !== "string") return void 0;
+	if (!isCount(at)) return void 0;
+	if (publisher !== void 0 && typeof publisher !== "string") return void 0;
+	if (user !== void 0 && typeof user !== "string") return void 0;
+	return {
+		seq,
+		event,
+		data,
+		at,
+		...publisher === void 0 ? {} : { publisher },
+		...user === void 0 ? {} : { user }
+	};
+}
+/** Whether `value` is a count (a non-negative safe integer). @internal */
+function isWholeNumber(value) {
+	return isCount(value);
+}
+/** The key of retained message `seq`: zero padded so keys sort by seq. @internal */
+function historyKey(seq) {
+	return `h:${String(seq).padStart(16, "0")}`;
+}
+/** The seq a history key stands for. @internal */
+function seqOfKey(key) {
+	return Number(key.slice(2));
+}
+export { MAX_BODY_BYTES, MAX_ENTRY_BYTES, MAX_HISTORY, MAX_MEMBERS, MAX_STATE_BYTES, MAX_TTL_MS, decodeLinkFrame, historyKey, isOperation, isWholeNumber, parseMember, parseRequest, parseStored, seqOfKey };
+
+//# sourceMappingURL=wire.js.map

package/dist/dev/cloudflare/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","names":[],"sources":["../../../src/cloudflare/wire.ts"],"sourcesContent":["/**\n * The private protocol between the adapter (in a Worker) and the channel object (a Durable Object): JSON requests to\n * `/v1/<op>` and the frames of the subscribe WebSocket. Both sides validate what they read; neither trusts the other's shape.\n * @packageDocumentation\n */\nimport type { PublishOptions } from \"../adapter\";\nimport type { ErrorCode } from \"../errors\";\nimport {\n  byteLength,\n  isChannelName,\n  isEventName,\n  isIdempotencyKey,\n  type Json,\n  type Member,\n  type PresenceEvent,\n  type StoredEntry,\n  type StoredMessage,\n} from \"../protocol\";\n\n/** The version in the request path. @internal */\nexport const WIRE_VERSION: number = 1;\n\n/** The most bytes of one message (data, event and names) the object stores in one value; the platform's smallest value limit is 128 KiB. @internal */\nexport const MAX_ENTRY_BYTES: number = 120 * 1024;\n/** The most bytes of one member's state. @internal */\nexport const MAX_STATE_BYTES: number = 16 * 1024;\n/** The most members one channel object keeps. @internal */\nexport const MAX_MEMBERS: number = 10_000;\n/** The most messages one channel retains. @internal */\nexport const MAX_HISTORY: number = 10_000;\n/** The longest expiry of a presence member or an idempotency key. @internal */\nexport const MAX_TTL_MS: number = 86_400_000;\n/** The most bytes of a request body the object reads. @internal */\nexport const MAX_BODY_BYTES: number = 256 * 1024;\n\n/** The operations of the request protocol. @internal */\nexport type Operation =\n  | \"publish\"\n  | \"history\"\n  | \"presence-set\"\n  | \"presence-remove\"\n  | \"presence-list\"\n  | \"presence-touch\"\n  | \"presence-reap\";\n\n/** A parsed request. @internal */\nexport type ParsedRequest =\n  | {\n      readonly op: \"publish\";\n      readonly channel: string;\n      readonly entry: StoredEntry;\n      readonly options: PublishOptions;\n      readonly idleMs: number;\n    }\n  | {\n      readonly op: \"history\";\n      readonly channel: string;\n      readonly after: number;\n      readonly limit: number;\n    }\n  | {\n      readonly op: \"presence-set\";\n      readonly channel: string;\n      readonly member: Member;\n      readonly ttlMs: number;\n      readonly graceMs: number;\n    }\n  | { readonly op: \"presence-remove\"; readonly channel: string; readonly id: string }\n  | { readonly op: \"presence-list\"; readonly channel: string }\n  | {\n      readonly op: \"presence-touch\";\n      readonly channel: string;\n      readonly ids: readonly string[];\n      readonly ttlMs: number;\n    }\n  | { readonly op: \"presence-reap\"; readonly channel: string };\n\n/** What parsing a request yields. @internal */\nexport type Parsed =\n  | { readonly ok: true; readonly request: ParsedRequest }\n  | { readonly ok: false; readonly code: ErrorCode; readonly message: string };\n\n/** A page of history as the object returns it. @internal */\nexport interface HistoryPage {\n  readonly messages: readonly StoredMessage[];\n  readonly head: number;\n  readonly oldest: number;\n  /** True when retained messages after the last one returned remain. */\n  readonly more: boolean;\n}\n\n/** Frames the object sends on a subscribe socket. @internal */\nexport type LinkFrame =\n  | { readonly t: \"ready\"; readonly head: number; readonly oldest: number }\n  | { readonly t: \"snap\"; readonly members: readonly Member[] }\n  | { readonly t: \"msg\"; readonly m: StoredMessage }\n  | {\n      readonly t: \"pres\";\n      readonly op: PresenceEvent[\"op\"];\n      readonly member: Member;\n    }\n  | { readonly t: \"more\" }\n  | { readonly t: \"bye\"; readonly why: string };\n\nconst OPERATIONS: ReadonlySet<string> = new Set<Operation>([\n  \"publish\",\n  \"history\",\n  \"presence-set\",\n  \"presence-remove\",\n  \"presence-list\",\n  \"presence-touch\",\n  \"presence-reap\",\n]);\n\n/** Whether `value` names an operation. @internal */\nexport function isOperation(value: string): value is Operation {\n  return OPERATIONS.has(value);\n}\n\nfunction isRecord(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isCount(value: unknown, max = Number.MAX_SAFE_INTEGER): value is number {\n  return typeof value === \"number\" && Number.isInteger(value) && value >= 0 && value <= max;\n}\n\nfunction fail(message: string, code: ErrorCode = \"bad_frame\"): Parsed {\n  return { ok: false, code, message };\n}\n\n/**\n * Whether `value` is a well formed member: an id, an optional user, a version of 1 or more and a JSON state of bounded size.\n * @internal\n */\nexport function parseMember(value: unknown): Member | undefined {\n  if (!isRecord(value)) return undefined;\n  const { id, u, s, v } = value;\n  if (typeof id !== \"string\" || id.length === 0 || id.length > 256) return undefined;\n  if (u !== undefined && (typeof u !== \"string\" || u.length > 256)) return undefined;\n  if (typeof v !== \"number\" || !Number.isInteger(v) || v < 1) return undefined;\n  const state: Json = s === undefined ? null : (s as Json);\n  const text = JSON.stringify(state);\n  if (text === undefined || byteLength(text) > MAX_STATE_BYTES) return undefined;\n  return u === undefined ? { id, s: state, v } : { id, u, s: state, v };\n}\n\nfunction parseEntry(value: unknown): StoredEntry | undefined {\n  if (!isRecord(value)) return undefined;\n  const { event, data, publisher, user } = value;\n  if (!isEventName(event) || typeof data !== \"string\") return undefined;\n  if (publisher !== undefined && (typeof publisher !== \"string\" || publisher.length > 256))\n    return undefined;\n  if (user !== undefined && (typeof user !== \"string\" || user.length > 256)) return undefined;\n  return {\n    event,\n    data,\n    ...(publisher === undefined ? {} : { publisher }),\n    ...(user === undefined ? {} : { user }),\n  };\n}\n\nfunction parseOptions(value: unknown): PublishOptions | undefined {\n  if (!isRecord(value)) return undefined;\n  const { history, historyTtlMs, key, idempotencyTtlMs } = value;\n  if (!isCount(history, MAX_HISTORY)) return undefined;\n  if (!isCount(historyTtlMs, MAX_TTL_MS * 366)) return undefined;\n  if (!isCount(idempotencyTtlMs, MAX_TTL_MS)) return undefined;\n  if (key !== undefined && !isIdempotencyKey(key)) return undefined;\n  return key === undefined\n    ? { history, historyTtlMs, idempotencyTtlMs }\n    : { history, historyTtlMs, key, idempotencyTtlMs };\n}\n\n/**\n * Parses the JSON body of a request to operation `op`.\n *\n * @param op The operation from the path.\n * @param body The parsed JSON body.\n * @returns The request, or the refusal to answer.\n * @internal\n */\nexport function parseRequest(op: Operation, body: unknown): Parsed {\n  if (!isRecord(body)) return fail(\"the body must be an object\");\n  const { channel } = body;\n  if (!isChannelName(channel)) return fail(\"bad channel name\", \"bad_channel\");\n  switch (op) {\n    case \"publish\": {\n      const entry = parseEntry(body[\"entry\"]);\n      const options = parseOptions(body[\"options\"]);\n      const idleMs = body[\"idleMs\"] ?? 0;\n      if (entry === undefined) return fail(\"bad entry\");\n      if (options === undefined) return fail(\"bad options\");\n      if (!isCount(idleMs, MAX_TTL_MS * 3650)) return fail(\"bad idleMs\");\n      if (byteLength(entry.data) + byteLength(entry.event) > MAX_ENTRY_BYTES)\n        return fail(\"the message is too large for one stored value\", \"too_large\");\n      return { ok: true, request: { op, channel, entry, options, idleMs } };\n    }\n    case \"history\": {\n      const { after, limit } = body;\n      if (!isCount(after) || !isCount(limit, 100_000)) return fail(\"bad after or limit\");\n      return { ok: true, request: { op, channel, after, limit } };\n    }\n    case \"presence-set\": {\n      const member = parseMember(body[\"member\"]);\n      const { ttlMs } = body;\n      const graceMs = body[\"graceMs\"] ?? 0;\n      if (member === undefined) return fail(\"bad member\");\n      if (!isCount(ttlMs, MAX_TTL_MS) || ttlMs === 0) return fail(\"bad ttlMs\");\n      if (!isCount(graceMs, 3_600_000)) return fail(\"bad graceMs\");\n      return { ok: true, request: { op, channel, member, ttlMs, graceMs } };\n    }\n    case \"presence-remove\": {\n      const { id } = body;\n      if (typeof id !== \"string\" || id.length === 0 || id.length > 256) return fail(\"bad id\");\n      return { ok: true, request: { op, channel, id } };\n    }\n    case \"presence-touch\": {\n      const { ids, ttlMs } = body;\n      if (!isCount(ttlMs, MAX_TTL_MS) || ttlMs === 0) return fail(\"bad ttlMs\");\n      if (\n        !Array.isArray(ids) ||\n        ids.length > MAX_MEMBERS ||\n        !ids.every((id) => typeof id === \"string\" && id.length > 0 && id.length <= 256)\n      )\n        return fail(\"bad ids\");\n      return { ok: true, request: { op, channel, ids: ids as string[], ttlMs } };\n    }\n    case \"presence-list\":\n    case \"presence-reap\":\n      return { ok: true, request: { op, channel } };\n  }\n}\n\n/** Decodes a frame from the object; `undefined` for anything that is not a known, well formed frame. @internal */\nexport function decodeLinkFrame(text: string): LinkFrame | undefined {\n  let value: unknown;\n  try {\n    value = JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n  if (!isRecord(value)) return undefined;\n  switch (value[\"t\"]) {\n    case \"ready\": {\n      const { head, oldest } = value;\n      return isCount(head) && isCount(oldest) ? { t: \"ready\", head, oldest } : undefined;\n    }\n    case \"snap\": {\n      const list = value[\"members\"];\n      if (!Array.isArray(list)) return undefined;\n      const members: Member[] = [];\n      for (const item of list) {\n        const member = parseMember(item);\n        if (member === undefined) return undefined;\n        members.push(member);\n      }\n      return { t: \"snap\", members };\n    }\n    case \"msg\": {\n      const message = parseStored(value[\"m\"]);\n      return message === undefined ? undefined : { t: \"msg\", m: message };\n    }\n    case \"pres\": {\n      const member = parseMember(value[\"member\"]);\n      const op = value[\"op\"];\n      if (member === undefined || (op !== \"join\" && op !== \"set\" && op !== \"leave\"))\n        return undefined;\n      return { t: \"pres\", op, member };\n    }\n    case \"more\":\n      return { t: \"more\" };\n    case \"bye\":\n      return { t: \"bye\", why: typeof value[\"why\"] === \"string\" ? value[\"why\"] : \"\" };\n    default:\n      return undefined;\n  }\n}\n\n/** Reads a stored message; `undefined` when it is malformed. @internal */\nexport function parseStored(value: unknown): StoredMessage | undefined {\n  if (!isRecord(value)) return undefined;\n  const { seq, event, data, at, publisher, user } = value;\n  if (!isCount(seq) || seq < 1 || typeof event !== \"string\" || typeof data !== \"string\")\n    return undefined;\n  if (!isCount(at)) return undefined;\n  if (publisher !== undefined && typeof publisher !== \"string\") return undefined;\n  if (user !== undefined && typeof user !== \"string\") return undefined;\n  return {\n    seq,\n    event,\n    data,\n    at,\n    ...(publisher === undefined ? {} : { publisher }),\n    ...(user === undefined ? {} : { user }),\n  };\n}\n\n/** Whether `value` is a count (a non-negative safe integer). @internal */\nexport function isWholeNumber(value: unknown): value is number {\n  return isCount(value);\n}\n\n/** The key of retained message `seq`: zero padded so keys sort by seq. @internal */\nexport function historyKey(seq: number): string {\n  return `h:${String(seq).padStart(16, \"0\")}`;\n}\n\n/** The seq a history key stands for. @internal */\nexport function seqOfKey(key: string): number {\n  return Number(key.slice(2));\n}\n"],"mappings":"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"}

package/dist/dev/cloudflare.d.ts

@@ -0,0 +1,4 @@
+import { ChannelNamespace, ChannelObjectState, ChannelRequestInit, ChannelResponse, ChannelSocket, ChannelStorage, ChannelStub, ClientSocket, StorageListOptions, StorageTransaction } from "./cloudflare/types.js";
+import { CloudflareRealtimeOptions, cloudflareAdapter } from "./cloudflare/adapter.js";
+import { RealtimeChannelObject } from "./cloudflare/object.js";
+export { type ChannelNamespace, type ChannelObjectState, type ChannelRequestInit, type ChannelResponse, type ChannelSocket, type ChannelStorage, type ChannelStub, type ClientSocket, type CloudflareRealtimeOptions, RealtimeChannelObject, type StorageListOptions, type StorageTransaction, cloudflareAdapter };