@shadow-js/realtime 0.0.0-stage → 1.0.0

package/dist/dev/redis.js

@@ -0,0 +1,422 @@
+import { RealtimeError } from "./errors.js";
+import { HISTORY, KEEPALIVE, PRESENCE_LIST, PRESENCE_REAP, PRESENCE_REMOVE, PRESENCE_SET, PRESENCE_TOUCH, PUBLISH } from "./redis/scripts.js";
+import { createTopics } from "./redis/topics.js";
+import { fromIoredis, fromNodeRedis } from "./redis/client.js";
+//#region src/redis.ts
+const DAY_MS = 864e5;
+const MAX_LIMIT = 1e4;
+const MAX_KEY_BYTES = 1024;
+const REAP_PAGE = 500;
+const TOUCH_PAGE = 500;
+const PIPELINE = 64;
+function positive(name, value) {
+	if (!Number.isFinite(value) || value < 1) throw new RangeError(`${name} must be a positive number of milliseconds.`);
+	return Math.ceil(value);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function text(reply) {
+	if (typeof reply === "string") return reply;
+	if (reply instanceof Uint8Array) return new TextDecoder().decode(reply);
+	if (typeof reply === "number") return String(reply);
+	throw new TypeError("Redis answered with an unexpected reply.");
+}
+function integer(reply) {
+	const value = typeof reply === "number" ? reply : Number(text(reply));
+	if (!Number.isSafeInteger(value)) throw new TypeError("Redis answered with an unexpected number.");
+	return value;
+}
+function list(reply) {
+	if (!Array.isArray(reply)) throw new TypeError("Redis answered with an unexpected reply.");
+	return reply;
+}
+function isNoScript(error) {
+	return (error instanceof Error ? error.message : String(error)).includes("NOSCRIPT");
+}
+/** Walks pages of `size` items and runs `work` on up to `PIPELINE` of them at once. */
+async function inBatches(items, work) {
+	for (let from = 0; from < items.length; from += PIPELINE) await Promise.all(items.slice(from, from + PIPELINE).map(work));
+}
+/**
+* The adapter that makes several servers one: messages, history, idempotency and presence live in Redis (6.2 or later, or
+* Valkey), and fan-out between servers goes through pub/sub. A hub created with it behaves exactly like one over the in-memory
+* adapter, on as many servers as you run.
+*
+* What is stored, per channel `c` (`p` is the prefix; the braces make every key of one channel hash to one Redis Cluster slot):
+* `p:{c}:m` (hash: head seq, history lifetime), `p:{c}:l` and `p:{c}:t` (sorted sets: the retained messages by seq, and when
+* each was accepted), `p:{c}:k:<key>` (idempotency keys), `p:{c}:p` and `p:{c}:x` (presence members, and when each expires),
+* and the topics `p:{c}:c` (messages) and `p:{c}:e` (presence events). A publish is one Lua script: it checks the key,
+* numbers, stores, trims by count and age, and publishes, atomically, so seq order is delivery order. Every method rejects with
+* `RealtimeError("unavailable")` when Redis cannot be reached, and leaves no half-applied state.
+*
+* @param options The connections and the key prefix.
+* @returns The adapter. Close it with the hub (`createHub` closes an adapter it created; close one you passed yourself).
+* @throws RangeError for an option that is not valid; TypeError when no subscriber is given and the client cannot create one.
+* @example
+* import { Redis } from "ioredis";
+* import { createHub } from "@shadow-js/realtime/server";
+* import { fromIoredis, redisAdapter } from "@shadow-js/realtime/redis";
+*
+* const adapter = redisAdapter({ client: fromIoredis(new Redis(process.env.REDIS_URL ?? "")), prefix: "myapp" });
+* const hub = createHub({ adapter, channels: { "chat:{room}": { subscribe: true, publish: true } } });
+* await hub.close();
+* await adapter.close();
+* @since 1.0.0
+*/
+function redisAdapter(options) {
+	const { client } = options;
+	if (typeof client?.sendCommand !== "function") throw new TypeError("redisAdapter needs a client with sendCommand (see fromIoredis, fromNodeRedis).");
+	if (options.subscriber === void 0 && client.createSubscriber === void 0) throw new TypeError("redisAdapter needs a subscriber: pass one, or a client that can create one (fromIoredis, fromNodeRedis).");
+	const prefix = options.prefix ?? "rt";
+	if (!/^[^\s{}]{1,128}$/.test(prefix)) throw new RangeError("prefix must be 1 to 128 characters without braces or whitespace.");
+	const channelTtlMs = positive("channelTtlMs", options.channelTtlMs ?? DAY_MS);
+	const graceMs = positive("presenceGraceMs", options.presenceGraceMs ?? 6e4);
+	const onError = options.onError;
+	let closed = false;
+	let ownedSubscriber;
+	function report(error, context) {
+		try {
+			onError?.(error, context);
+		} catch {}
+	}
+	function fail(error) {
+		if (error instanceof RealtimeError) return error;
+		return new RealtimeError("unavailable", closed ? "the Redis adapter is closed." : "the Redis adapter could not complete the command.", { cause: error });
+	}
+	function open() {
+		if (closed) throw new RealtimeError("unavailable", "the Redis adapter is closed.");
+	}
+	function name(channel) {
+		if (channel.length === 0 || channel.includes("{") || channel.includes("}")) throw new RealtimeError("bad_channel", "a channel name is empty or contains a brace.");
+		return `${prefix}:{${channel}}`;
+	}
+	const keysOf = (channel) => {
+		const base = name(channel);
+		return {
+			meta: `${base}:m`,
+			log: `${base}:l`,
+			time: `${base}:t`,
+			idem: (key) => `${base}:k:${key}`,
+			members: `${base}:p`,
+			expiry: `${base}:x`,
+			messages: `${base}:c`,
+			events: `${base}:e`
+		};
+	};
+	/** Runs a script by hash and, when the server does not know it (first use, a flush, a failover), by source. */
+	async function run(script, keys, args) {
+		open();
+		const tail = [
+			String(keys.length),
+			...keys,
+			...args
+		];
+		try {
+			try {
+				return await client.sendCommand([
+					"EVALSHA",
+					script.sha,
+					...tail
+				]);
+			} catch (error) {
+				if (!isNoScript(error)) throw error;
+				return await client.sendCommand([
+					"EVAL",
+					script.source,
+					...tail
+				]);
+			}
+		} catch (error) {
+			throw fail(error);
+		}
+	}
+	function parseMessage(source, channel) {
+		try {
+			const value = JSON.parse(source);
+			if (isRecord(value)) {
+				const seq = value["s"];
+				const at = value["a"];
+				const event = value["e"];
+				const data = value["d"];
+				const publisher = value["p"];
+				const user = value["u"];
+				if (typeof seq === "number" && Number.isSafeInteger(seq) && seq >= 1 && typeof at === "number" && typeof event === "string" && typeof data === "string" && (publisher === void 0 || typeof publisher === "string") && (user === void 0 || typeof user === "string")) return {
+					seq,
+					at,
+					event,
+					data,
+					...publisher === void 0 ? {} : { publisher },
+					...user === void 0 ? {} : { user }
+				};
+			}
+		} catch (error) {
+			report(error, {
+				where: "parse",
+				channel
+			});
+			return;
+		}
+		report(/* @__PURE__ */ new TypeError("a stored message has an unexpected shape."), {
+			where: "parse",
+			channel
+		});
+	}
+	function memberOf(value) {
+		if (!isRecord(value)) return void 0;
+		const id = value["id"];
+		const user = value["u"];
+		const version = value["v"];
+		if (typeof id !== "string" || typeof version !== "number" || !Number.isSafeInteger(version) || !("s" in value) || user !== void 0 && typeof user !== "string") return void 0;
+		return {
+			id,
+			...user === void 0 ? {} : { u: user },
+			s: value["s"],
+			v: version
+		};
+	}
+	function parseStoredMember(source, channel) {
+		try {
+			const value = JSON.parse(text(source));
+			const member = isRecord(value) ? memberOf(value["m"]) : void 0;
+			if (member !== void 0) return member;
+		} catch (error) {
+			report(error, {
+				where: "parse",
+				channel
+			});
+			return;
+		}
+		report(/* @__PURE__ */ new TypeError("a stored presence member has an unexpected shape."), {
+			where: "parse",
+			channel
+		});
+	}
+	function parsePresence(source, channel) {
+		try {
+			const value = JSON.parse(source);
+			if (isRecord(value)) {
+				const op = value["o"];
+				const member = memberOf(value["m"]);
+				if ((op === "join" || op === "set" || op === "leave") && member !== void 0) return {
+					channel,
+					op,
+					member
+				};
+			}
+		} catch (error) {
+			report(error, {
+				where: "parse",
+				channel
+			});
+			return;
+		}
+		report(/* @__PURE__ */ new TypeError("a presence event has an unexpected shape."), {
+			where: "parse",
+			channel
+		});
+	}
+	async function history(channel, after, limit) {
+		const keys = keysOf(channel);
+		const from = Number.isFinite(after) ? Math.min(Math.max(0, Math.floor(after)), Number.MAX_SAFE_INTEGER) : 0;
+		const count = Number.isFinite(limit) ? Math.min(Math.max(0, Math.floor(limit)), MAX_LIMIT) : 0;
+		const reply = list(await run(HISTORY, [
+			keys.meta,
+			keys.log,
+			keys.time
+		], [String(from), String(count)]));
+		const messages = [];
+		try {
+			for (const row of reply.slice(2)) {
+				const message = parseMessage(text(row), channel);
+				if (message !== void 0) messages.push(message);
+			}
+			return {
+				messages,
+				head: integer(reply[0]),
+				oldest: integer(reply[1])
+			};
+		} catch (error) {
+			throw fail(error);
+		}
+	}
+	async function members(channel) {
+		const keys = keysOf(channel);
+		const reply = list(await run(PRESENCE_LIST, [keys.members, keys.expiry], []));
+		const out = [];
+		for (const row of reply) {
+			const member = parseStoredMember(row, channel);
+			if (member !== void 0) out.push(member);
+		}
+		return out;
+	}
+	function subscriber() {
+		open();
+		if (options.subscriber !== void 0) return Promise.resolve(options.subscriber);
+		if (ownedSubscriber === void 0) {
+			const create = client.createSubscriber;
+			if (create === void 0) return Promise.reject(fail(/* @__PURE__ */ new TypeError("no subscriber.")));
+			ownedSubscriber = (async () => create.call(client))();
+			ownedSubscriber.catch(() => {
+				ownedSubscriber = void 0;
+			});
+		}
+		return ownedSubscriber.catch((error) => {
+			throw fail(error);
+		});
+	}
+	const topics = createTopics({
+		subscriber,
+		history: async (channel, after, limit) => (await history(channel, after, limit)).messages,
+		members,
+		keepAlive: async (channel) => {
+			await run(KEEPALIVE, [keysOf(channel).meta], [String(channelTtlMs)]);
+		},
+		parseMessage,
+		parsePresence,
+		messageTopic: (channel) => keysOf(channel).messages,
+		presenceTopic: (channel) => keysOf(channel).events,
+		report,
+		fail,
+		keepAliveMs: Math.max(100, Math.floor(channelTtlMs / 3))
+	});
+	return {
+		async publish(channel, entry, publish) {
+			const keys = keysOf(channel);
+			if (typeof entry.data !== "string") throw new TypeError("a stored entry's data is the JSON text of the value.");
+			const history = Math.max(0, Math.floor(publish.history));
+			const historyTtl = positive("historyTtlMs", publish.historyTtlMs);
+			const idempotencyTtl = positive("idempotencyTtlMs", publish.idempotencyTtlMs);
+			const key = publish.key;
+			if (key !== void 0 && (key.length === 0 || key.length > MAX_KEY_BYTES)) throw new RealtimeError("bad_frame", "an idempotency key is empty or too long.");
+			const body = JSON.stringify({
+				e: entry.event,
+				d: entry.data,
+				...entry.publisher === void 0 ? {} : { p: entry.publisher },
+				...entry.user === void 0 ? {} : { u: entry.user }
+			}).slice(1);
+			const reply = list(await run(PUBLISH, [
+				keys.meta,
+				keys.log,
+				keys.time,
+				...key === void 0 ? [] : [keys.idem(key)]
+			], [
+				String(history),
+				String(historyTtl),
+				String(idempotencyTtl),
+				String(channelTtlMs),
+				keys.messages,
+				body
+			]));
+			try {
+				return {
+					seq: integer(reply[0]),
+					duplicate: integer(reply[1]) === 1
+				};
+			} catch (error) {
+				throw fail(error);
+			}
+		},
+		subscribe(channel, listener) {
+			try {
+				open();
+				name(channel);
+			} catch (error) {
+				return Promise.reject(fail(error));
+			}
+			return topics.messages(channel, listener);
+		},
+		history,
+		async presenceSet(channel, member, ttlMs) {
+			const keys = keysOf(channel);
+			if (!Number.isSafeInteger(member.v) || member.v < 0) throw new RangeError("a member version must be a non-negative integer.");
+			const json = JSON.stringify({
+				id: member.id,
+				...member.u === void 0 ? {} : { u: member.u },
+				s: member.s === void 0 ? null : member.s,
+				v: member.v
+			});
+			await run(PRESENCE_SET, [keys.members, keys.expiry], [
+				member.id,
+				String(member.v),
+				String(positive("ttlMs", ttlMs)),
+				keys.events,
+				`{"v":${member.v},"m":${json}}`,
+				json,
+				String(graceMs)
+			]);
+		},
+		async presenceRemove(channel, id) {
+			const keys = keysOf(channel);
+			return integer(await run(PRESENCE_REMOVE, [keys.members, keys.expiry], [id, keys.events])) === 1;
+		},
+		async presenceList(channel) {
+			return members(channel);
+		},
+		async presenceTouch(entries, ttlMs) {
+			const ttl = String(positive("ttlMs", ttlMs));
+			const byChannel = /* @__PURE__ */ new Map();
+			for (const ref of entries) {
+				const ids = byChannel.get(ref.channel);
+				if (ids === void 0) byChannel.set(ref.channel, [ref.id]);
+				else ids.push(ref.id);
+			}
+			const jobs = [];
+			for (const [channel, ids] of byChannel) for (let from = 0; from < ids.length; from += TOUCH_PAGE) jobs.push({
+				channel,
+				ids: ids.slice(from, from + TOUCH_PAGE)
+			});
+			const missing = [];
+			await inBatches(jobs, async ({ channel, ids }) => {
+				const keys = keysOf(channel);
+				const reply = list(await run(PRESENCE_TOUCH, [keys.members, keys.expiry], [
+					ttl,
+					String(graceMs),
+					...ids
+				]));
+				for (const id of reply) missing.push({
+					channel,
+					id: text(id)
+				});
+			});
+			return missing;
+		},
+		async presenceReap(channel) {
+			const keys = keysOf(channel);
+			const removed = [];
+			for (;;) {
+				const reply = list(await run(PRESENCE_REAP, [keys.members, keys.expiry], [keys.events, String(REAP_PAGE)]));
+				for (const row of reply) {
+					const member = parseStoredMember(row, channel);
+					if (member !== void 0) removed.push(member);
+				}
+				if (reply.length < REAP_PAGE) return removed;
+			}
+		},
+		presenceSubscribe(channel, listener) {
+			try {
+				open();
+				name(channel);
+			} catch (error) {
+				return Promise.reject(fail(error));
+			}
+			return topics.presence(channel, listener);
+		},
+		async close() {
+			if (closed) return;
+			closed = true;
+			await topics.close();
+			const owned = ownedSubscriber;
+			ownedSubscriber = void 0;
+			if (owned !== void 0) try {
+				await (await owned).close?.();
+			} catch (error) {
+				report(error, { where: "close" });
+			}
+		}
+	};
+}
+//#endregion
+export { fromIoredis, fromNodeRedis, redisAdapter };
+
+//# sourceMappingURL=redis.js.map

package/dist/dev/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","names":[],"sources":["../../src/redis.ts"],"sourcesContent":["import type {\n  Adapter,\n  HistoryResult,\n  PresenceRef,\n  PublishOptions,\n  PublishResult,\n  Unsubscribe,\n} from \"./adapter\";\nimport { RealtimeError } from \"./errors\";\nimport type { Member, PresenceEvent, StoredEntry, StoredMessage } from \"./protocol\";\nimport type { RedisClient, RedisSubscriber } from \"./redis/client\";\nimport {\n  HISTORY,\n  KEEPALIVE,\n  PRESENCE_LIST,\n  PRESENCE_REAP,\n  PRESENCE_REMOVE,\n  PRESENCE_SET,\n  PRESENCE_TOUCH,\n  PUBLISH,\n  type Script,\n} from \"./redis/scripts\";\nimport { createTopics, type RedisErrorContext } from \"./redis/topics\";\n\nexport {\n  fromIoredis,\n  fromNodeRedis,\n  type IoredisLike,\n  type IoredisSubscriberLike,\n  type NodeRedisLike,\n  type NodeRedisSubscriberLike,\n  type RedisClient,\n  type RedisSubscriber,\n} from \"./redis/client\";\nexport type { RedisErrorContext } from \"./redis/topics\";\n\n/**\n * Options of {@link redisAdapter}.\n * @since 1.0.0\n */\nexport interface RedisAdapterOptions {\n  /** The connection that runs commands (see {@link fromIoredis} and {@link fromNodeRedis}). The adapter never closes it. */\n  readonly client: RedisClient;\n  /**\n   * A connection in subscriber mode, shared by every subscription of this adapter. Without it the adapter asks the client for one\n   * (`client.createSubscriber`) when the first subscription is made, and closes that one with the adapter. A subscriber you pass\n   * is yours to close; give it to one adapter only (a topic has one listener on a subscriber).\n   */\n  readonly subscriber?: RedisSubscriber;\n  /**\n   * Prefix of every key and topic. Servers that share channels use the same one; apps (or environments) that must not share\n   * use different ones. No braces or whitespace. Default `\"rt\"`.\n   */\n  readonly prefix?: string;\n  /**\n   * Milliseconds a channel's numbering outlives its last publish (and its last listener, which keeps it alive). After an idle\n   * channel expired, its seq restarts at 1, which a client that resumes sees as `reset`. Default 24 hours.\n   */\n  readonly channelTtlMs?: number;\n  /**\n   * Milliseconds the presence keys of a channel outlive the last refresh of any member, so a channel nobody reaps anymore does\n   * not stay in Redis forever. Default 60 seconds.\n   */\n  readonly presenceGraceMs?: number;\n  /**\n   * Receives every failure the adapter handled without surfacing it: a malformed stored entry that was skipped, a listener that\n   * threw, a subscriber connection error, a recovery that gave up. Default: ignored.\n   */\n  readonly onError?: (error: unknown, context: RedisErrorContext) => void;\n}\n\nconst DAY_MS = 86_400_000;\nconst MAX_LIMIT = 10_000;\nconst MAX_KEY_BYTES = 1024;\nconst REAP_PAGE = 500;\nconst TOUCH_PAGE = 500;\nconst PIPELINE = 64;\n\nfunction positive(name: string, value: number): number {\n  if (!Number.isFinite(value) || value < 1)\n    throw new RangeError(`${name} must be a positive number of milliseconds.`);\n  return Math.ceil(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 text(reply: unknown): string {\n  if (typeof reply === \"string\") return reply;\n  if (reply instanceof Uint8Array) return new TextDecoder().decode(reply);\n  if (typeof reply === \"number\") return String(reply);\n  throw new TypeError(\"Redis answered with an unexpected reply.\");\n}\n\nfunction integer(reply: unknown): number {\n  const value = typeof reply === \"number\" ? reply : Number(text(reply));\n  if (!Number.isSafeInteger(value))\n    throw new TypeError(\"Redis answered with an unexpected number.\");\n  return value;\n}\n\nfunction list(reply: unknown): readonly unknown[] {\n  if (!Array.isArray(reply)) throw new TypeError(\"Redis answered with an unexpected reply.\");\n  return reply;\n}\n\nfunction isNoScript(error: unknown): boolean {\n  const message = error instanceof Error ? error.message : String(error);\n  return message.includes(\"NOSCRIPT\");\n}\n\n/** Walks pages of `size` items and runs `work` on up to `PIPELINE` of them at once. */\nasync function inBatches<T>(items: readonly T[], work: (item: T) => Promise<void>): Promise<void> {\n  for (let from = 0; from < items.length; from += PIPELINE)\n    await Promise.all(items.slice(from, from + PIPELINE).map(work));\n}\n\n/**\n * The adapter that makes several servers one: messages, history, idempotency and presence live in Redis (6.2 or later, or\n * Valkey), and fan-out between servers goes through pub/sub. A hub created with it behaves exactly like one over the in-memory\n * adapter, on as many servers as you run.\n *\n * What is stored, per channel `c` (`p` is the prefix; the braces make every key of one channel hash to one Redis Cluster slot):\n * `p:{c}:m` (hash: head seq, history lifetime), `p:{c}:l` and `p:{c}:t` (sorted sets: the retained messages by seq, and when\n * each was accepted), `p:{c}:k:<key>` (idempotency keys), `p:{c}:p` and `p:{c}:x` (presence members, and when each expires),\n * and the topics `p:{c}:c` (messages) and `p:{c}:e` (presence events). A publish is one Lua script: it checks the key,\n * numbers, stores, trims by count and age, and publishes, atomically, so seq order is delivery order. Every method rejects with\n * `RealtimeError(\"unavailable\")` when Redis cannot be reached, and leaves no half-applied state.\n *\n * @param options The connections and the key prefix.\n * @returns The adapter. Close it with the hub (`createHub` closes an adapter it created; close one you passed yourself).\n * @throws RangeError for an option that is not valid; TypeError when no subscriber is given and the client cannot create one.\n * @example\n * import { Redis } from \"ioredis\";\n * import { createHub } from \"@shadow-js/realtime/server\";\n * import { fromIoredis, redisAdapter } from \"@shadow-js/realtime/redis\";\n *\n * const adapter = redisAdapter({ client: fromIoredis(new Redis(process.env.REDIS_URL ?? \"\")), prefix: \"myapp\" });\n * const hub = createHub({ adapter, channels: { \"chat:{room}\": { subscribe: true, publish: true } } });\n * await hub.close();\n * await adapter.close();\n * @since 1.0.0\n */\nexport function redisAdapter(options: RedisAdapterOptions): Adapter {\n  const { client } = options;\n  if (typeof client?.sendCommand !== \"function\")\n    throw new TypeError(\n      \"redisAdapter needs a client with sendCommand (see fromIoredis, fromNodeRedis).\",\n    );\n  if (options.subscriber === undefined && client.createSubscriber === undefined)\n    throw new TypeError(\n      \"redisAdapter needs a subscriber: pass one, or a client that can create one (fromIoredis, fromNodeRedis).\",\n    );\n  const prefix = options.prefix ?? \"rt\";\n  if (!/^[^\\s{}]{1,128}$/.test(prefix))\n    throw new RangeError(\"prefix must be 1 to 128 characters without braces or whitespace.\");\n  const channelTtlMs = positive(\"channelTtlMs\", options.channelTtlMs ?? DAY_MS);\n  const graceMs = positive(\"presenceGraceMs\", options.presenceGraceMs ?? 60_000);\n  const onError = options.onError;\n  let closed = false;\n  let ownedSubscriber: Promise<RedisSubscriber> | undefined;\n\n  function report(error: unknown, context: RedisErrorContext): void {\n    try {\n      onError?.(error, context);\n    } catch {\n      // The reporter's failure must not become the adapter's.\n    }\n  }\n\n  function fail(error: unknown): RealtimeError {\n    if (error instanceof RealtimeError) return error;\n    return new RealtimeError(\n      \"unavailable\",\n      closed ? \"the Redis adapter is closed.\" : \"the Redis adapter could not complete the command.\",\n      { cause: error },\n    );\n  }\n\n  function open(): void {\n    if (closed) throw new RealtimeError(\"unavailable\", \"the Redis adapter is closed.\");\n  }\n\n  function name(channel: string): string {\n    if (channel.length === 0 || channel.includes(\"{\") || channel.includes(\"}\"))\n      throw new RealtimeError(\"bad_channel\", \"a channel name is empty or contains a brace.\");\n    return `${prefix}:{${channel}}`;\n  }\n\n  const keysOf = (channel: string) => {\n    const base = name(channel);\n    return {\n      meta: `${base}:m`,\n      log: `${base}:l`,\n      time: `${base}:t`,\n      idem: (key: string): string => `${base}:k:${key}`,\n      members: `${base}:p`,\n      expiry: `${base}:x`,\n      messages: `${base}:c`,\n      events: `${base}:e`,\n    };\n  };\n\n  /** Runs a script by hash and, when the server does not know it (first use, a flush, a failover), by source. */\n  async function run(\n    script: Script,\n    keys: readonly string[],\n    args: readonly string[],\n  ): Promise<unknown> {\n    open();\n    const tail = [String(keys.length), ...keys, ...args];\n    try {\n      try {\n        return await client.sendCommand([\"EVALSHA\", script.sha, ...tail]);\n      } catch (error) {\n        if (!isNoScript(error)) throw error;\n        return await client.sendCommand([\"EVAL\", script.source, ...tail]);\n      }\n    } catch (error) {\n      throw fail(error);\n    }\n  }\n\n  // --- parsing what Redis holds --------------------------------------------------------------------------------------\n\n  function parseMessage(source: string, channel: string): StoredMessage | undefined {\n    try {\n      const value: unknown = JSON.parse(source);\n      if (isRecord(value)) {\n        const seq = value[\"s\"];\n        const at = value[\"a\"];\n        const event = value[\"e\"];\n        const data = value[\"d\"];\n        const publisher = value[\"p\"];\n        const user = value[\"u\"];\n        if (\n          typeof seq === \"number\" &&\n          Number.isSafeInteger(seq) &&\n          seq >= 1 &&\n          typeof at === \"number\" &&\n          typeof event === \"string\" &&\n          typeof data === \"string\" &&\n          (publisher === undefined || typeof publisher === \"string\") &&\n          (user === undefined || typeof user === \"string\")\n        )\n          return {\n            seq,\n            at,\n            event,\n            data,\n            ...(publisher === undefined ? {} : { publisher }),\n            ...(user === undefined ? {} : { user }),\n          };\n      }\n    } catch (error) {\n      report(error, { where: \"parse\", channel });\n      return undefined;\n    }\n    report(new TypeError(\"a stored message has an unexpected shape.\"), { where: \"parse\", channel });\n    return undefined;\n  }\n\n  function memberOf(value: unknown): Member | undefined {\n    if (!isRecord(value)) return undefined;\n    const id = value[\"id\"];\n    const user = value[\"u\"];\n    const version = value[\"v\"];\n    if (\n      typeof id !== \"string\" ||\n      typeof version !== \"number\" ||\n      !Number.isSafeInteger(version) ||\n      !(\"s\" in value) ||\n      (user !== undefined && typeof user !== \"string\")\n    )\n      return undefined;\n    return {\n      id,\n      ...(user === undefined ? {} : { u: user }),\n      s: value[\"s\"] as Member[\"s\"],\n      v: version,\n    };\n  }\n\n  function parseStoredMember(source: unknown, channel: string): Member | undefined {\n    try {\n      const value: unknown = JSON.parse(text(source));\n      const member = isRecord(value) ? memberOf(value[\"m\"]) : undefined;\n      if (member !== undefined) return member;\n    } catch (error) {\n      report(error, { where: \"parse\", channel });\n      return undefined;\n    }\n    report(new TypeError(\"a stored presence member has an unexpected shape.\"), {\n      where: \"parse\",\n      channel,\n    });\n    return undefined;\n  }\n\n  function parsePresence(source: string, channel: string): PresenceEvent | undefined {\n    try {\n      const value: unknown = JSON.parse(source);\n      if (isRecord(value)) {\n        const op = value[\"o\"];\n        const member = memberOf(value[\"m\"]);\n        if ((op === \"join\" || op === \"set\" || op === \"leave\") && member !== undefined)\n          return { channel, op, member };\n      }\n    } catch (error) {\n      report(error, { where: \"parse\", channel });\n      return undefined;\n    }\n    report(new TypeError(\"a presence event has an unexpected shape.\"), { where: \"parse\", channel });\n    return undefined;\n  }\n\n  // --- reads shared with the subscription recovery -------------------------------------------------------------------\n\n  async function history(channel: string, after: number, limit: number): Promise<HistoryResult> {\n    const keys = keysOf(channel);\n    const from = Number.isFinite(after)\n      ? Math.min(Math.max(0, Math.floor(after)), Number.MAX_SAFE_INTEGER)\n      : 0;\n    const count = Number.isFinite(limit) ? Math.min(Math.max(0, Math.floor(limit)), MAX_LIMIT) : 0;\n    const reply = list(\n      await run(HISTORY, [keys.meta, keys.log, keys.time], [String(from), String(count)]),\n    );\n    const messages: StoredMessage[] = [];\n    try {\n      for (const row of reply.slice(2)) {\n        const message = parseMessage(text(row), channel);\n        if (message !== undefined) messages.push(message);\n      }\n      return { messages, head: integer(reply[0]), oldest: integer(reply[1]) };\n    } catch (error) {\n      throw fail(error);\n    }\n  }\n\n  async function members(channel: string): Promise<readonly Member[]> {\n    const keys = keysOf(channel);\n    const reply = list(await run(PRESENCE_LIST, [keys.members, keys.expiry], []));\n    const out: Member[] = [];\n    for (const row of reply) {\n      const member = parseStoredMember(row, channel);\n      if (member !== undefined) out.push(member);\n    }\n    return out;\n  }\n\n  // --- the shared subscriber -----------------------------------------------------------------------------------------\n\n  function subscriber(): Promise<RedisSubscriber> {\n    open();\n    if (options.subscriber !== undefined) return Promise.resolve(options.subscriber);\n    if (ownedSubscriber === undefined) {\n      const create = client.createSubscriber;\n      if (create === undefined) return Promise.reject(fail(new TypeError(\"no subscriber.\")));\n      ownedSubscriber = (async () => create.call(client))();\n      ownedSubscriber.catch(() => {\n        ownedSubscriber = undefined;\n      });\n    }\n    return ownedSubscriber.catch((error: unknown) => {\n      throw fail(error);\n    });\n  }\n\n  const topics = createTopics({\n    subscriber,\n    history: async (channel, after, limit) => (await history(channel, after, limit)).messages,\n    members,\n    keepAlive: async (channel) => {\n      await run(KEEPALIVE, [keysOf(channel).meta], [String(channelTtlMs)]);\n    },\n    parseMessage,\n    parsePresence,\n    messageTopic: (channel) => keysOf(channel).messages,\n    presenceTopic: (channel) => keysOf(channel).events,\n    report,\n    fail,\n    keepAliveMs: Math.max(100, Math.floor(channelTtlMs / 3)),\n  });\n\n  // --- the adapter ---------------------------------------------------------------------------------------------------\n\n  return {\n    async publish(\n      channel: string,\n      entry: StoredEntry,\n      publish: PublishOptions,\n    ): Promise<PublishResult> {\n      const keys = keysOf(channel);\n      if (typeof entry.data !== \"string\")\n        throw new TypeError(\"a stored entry's data is the JSON text of the value.\");\n      const history = Math.max(0, Math.floor(publish.history));\n      const historyTtl = positive(\"historyTtlMs\", publish.historyTtlMs);\n      const idempotencyTtl = positive(\"idempotencyTtlMs\", publish.idempotencyTtlMs);\n      const key = publish.key;\n      if (key !== undefined && (key.length === 0 || key.length > MAX_KEY_BYTES))\n        throw new RealtimeError(\"bad_frame\", \"an idempotency key is empty or too long.\");\n      const body = JSON.stringify({\n        e: entry.event,\n        d: entry.data,\n        ...(entry.publisher === undefined ? {} : { p: entry.publisher }),\n        ...(entry.user === undefined ? {} : { u: entry.user }),\n      }).slice(1);\n      const reply = list(\n        await run(\n          PUBLISH,\n          [keys.meta, keys.log, keys.time, ...(key === undefined ? [] : [keys.idem(key)])],\n          [\n            String(history),\n            String(historyTtl),\n            String(idempotencyTtl),\n            String(channelTtlMs),\n            keys.messages,\n            body,\n          ],\n        ),\n      );\n      try {\n        return { seq: integer(reply[0]), duplicate: integer(reply[1]) === 1 };\n      } catch (error) {\n        throw fail(error);\n      }\n    },\n\n    subscribe(channel: string, listener: (message: StoredMessage) => void): Promise<Unsubscribe> {\n      try {\n        open();\n        name(channel);\n      } catch (error) {\n        return Promise.reject(fail(error));\n      }\n      return topics.messages(channel, listener);\n    },\n\n    history,\n\n    async presenceSet(channel: string, member: Member, ttlMs: number): Promise<void> {\n      const keys = keysOf(channel);\n      if (!Number.isSafeInteger(member.v) || member.v < 0)\n        throw new RangeError(\"a member version must be a non-negative integer.\");\n      const json = JSON.stringify({\n        id: member.id,\n        ...(member.u === undefined ? {} : { u: member.u }),\n        s: member.s === undefined ? null : member.s,\n        v: member.v,\n      });\n      await run(\n        PRESENCE_SET,\n        [keys.members, keys.expiry],\n        [\n          member.id,\n          String(member.v),\n          String(positive(\"ttlMs\", ttlMs)),\n          keys.events,\n          `{\"v\":${member.v},\"m\":${json}}`,\n          json,\n          String(graceMs),\n        ],\n      );\n    },\n\n    async presenceRemove(channel: string, id: string): Promise<boolean> {\n      const keys = keysOf(channel);\n      return (\n        integer(await run(PRESENCE_REMOVE, [keys.members, keys.expiry], [id, keys.events])) === 1\n      );\n    },\n\n    async presenceList(channel: string): Promise<readonly Member[]> {\n      return members(channel);\n    },\n\n    async presenceTouch(\n      entries: readonly PresenceRef[],\n      ttlMs: number,\n    ): Promise<readonly PresenceRef[]> {\n      const ttl = String(positive(\"ttlMs\", ttlMs));\n      const byChannel = new Map<string, string[]>();\n      for (const ref of entries) {\n        const ids = byChannel.get(ref.channel);\n        if (ids === undefined) byChannel.set(ref.channel, [ref.id]);\n        else ids.push(ref.id);\n      }\n      const jobs: { readonly channel: string; readonly ids: readonly string[] }[] = [];\n      for (const [channel, ids] of byChannel)\n        for (let from = 0; from < ids.length; from += TOUCH_PAGE)\n          jobs.push({ channel, ids: ids.slice(from, from + TOUCH_PAGE) });\n      const missing: PresenceRef[] = [];\n      await inBatches(jobs, async ({ channel, ids }) => {\n        const keys = keysOf(channel);\n        const reply = list(\n          await run(PRESENCE_TOUCH, [keys.members, keys.expiry], [ttl, String(graceMs), ...ids]),\n        );\n        for (const id of reply) missing.push({ channel, id: text(id) });\n      });\n      return missing;\n    },\n\n    async presenceReap(channel: string): Promise<readonly Member[]> {\n      const keys = keysOf(channel);\n      const removed: Member[] = [];\n      for (;;) {\n        const reply = list(\n          await run(PRESENCE_REAP, [keys.members, keys.expiry], [keys.events, String(REAP_PAGE)]),\n        );\n        for (const row of reply) {\n          const member = parseStoredMember(row, channel);\n          if (member !== undefined) removed.push(member);\n        }\n        if (reply.length < REAP_PAGE) return removed;\n      }\n    },\n\n    presenceSubscribe(\n      channel: string,\n      listener: (event: PresenceEvent) => void,\n    ): Promise<Unsubscribe> {\n      try {\n        open();\n        name(channel);\n      } catch (error) {\n        return Promise.reject(fail(error));\n      }\n      return topics.presence(channel, listener);\n    },\n\n    async close(): Promise<void> {\n      if (closed) return;\n      closed = true;\n      await topics.close();\n      const owned = ownedSubscriber;\n      ownedSubscriber = undefined;\n      if (owned !== undefined) {\n        try {\n          await (await owned).close?.();\n        } catch (error) {\n          report(error, { where: \"close\" });\n        }\n      }\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/dev/server/http.d.ts

@@ -0,0 +1,48 @@
+import { Identity } from "./rules.js";
+//#region src/server/http.d.ts
+/** What a hub needs from the framework's request event. @since 1.0.0 */
+export interface RequestLike {
+  readonly request: Request;
+}
+/** How a connection is identified: an identity, or a response that refuses it. @since 1.0.0 */
+export type AuthenticateResult = Identity | undefined | Response;
+/** Options shared by the transport routes. @since 1.0.0 */
+export interface HubRouteOptions<E extends RequestLike> {
+  /**
+   * Reads the identity from the request (the session cookie, a bearer token). Return a `Response` to refuse (a 401). Return
+   * nothing for an anonymous connection. Default: everyone is anonymous, and channel rules decide.
+   */
+  readonly authenticate?: (event: E) => AuthenticateResult | Promise<AuthenticateResult>;
+  /**
+   * Origins allowed to open a stream or post (full origins such as `https://app.example.com`). Default: the request's own
+   * origin only. A request with no `Origin` header (same-origin GET, a non-browser client) is allowed.
+   */
+  readonly allowedOrigins?: readonly string[];
+}
+/** The WebSocket connection the framework hands to handlers (the part this package uses). @since 1.0.0 */
+export interface WebSocketLike {
+  readonly data: Record<string, unknown>;
+  readonly signal: AbortSignal;
+  send(message: string | Uint8Array): boolean;
+  close(code?: number, reason?: string): void;
+}
+/** The handlers of a WebSocket route, shaped like Dusk's `WS` export. @since 1.0.0 */
+export interface WebSocketRoute<E extends RequestLike> {
+  upgrade(event: E): Promise<Response | undefined>;
+  open(ws: WebSocketLike, event: E): Promise<void>;
+  message(ws: WebSocketLike, message: string | Uint8Array, event: E): void;
+  close(ws: WebSocketLike): void;
+  error(ws: WebSocketLike, error: unknown, event: E): void;
+}
+/** The stream a server-sent events route writes to (the part this package uses). @since 1.0.0 */
+export interface SseLike {
+  send(message: {
+    readonly event: string;
+    readonly data: string;
+  }): Promise<void>;
+  close(): void;
+  readonly signal: AbortSignal;
+  readonly closed: boolean;
+}
+//#endregion
+//# sourceMappingURL=http.d.ts.map