@shadow-js/realtime 0.0.0-stage → 1.0.0

package/dist/dev/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","names":[],"sources":["../../src/protocol.ts"],"sourcesContent":["import type { ErrorCode } from \"./errors\";\n\n/**\n * The wire protocol version this package speaks (https://realtime.shadowjs.net/guides/realtime-protocol/).\n * @example\n * import { PROTOCOL_VERSION } from \"@shadow-js/realtime\";\n *\n * const hello = JSON.stringify({ t: \"hello\", v: PROTOCOL_VERSION });\n * @since 1.0.0\n */\nexport const PROTOCOL_VERSION: 1 = 1;\n\n/**\n * Any JSON value.\n * @since 1.0.0\n */\nexport type Json =\n  | null\n  | boolean\n  | number\n  | string\n  | readonly Json[]\n  | { readonly [key: string]: Json };\n\n/**\n * One member of a channel's presence set: the connection that joined, its user, its state, and the version of that state.\n * @since 1.0.0\n */\nexport interface Member<State = Json> {\n  /** The connection id. */\n  readonly id: string;\n  /** The user of the connection's identity, when it has one. */\n  readonly u?: string;\n  /** The member's state. */\n  readonly s: State;\n  /** A counter that rises with every state change of this member, from 1. */\n  readonly v: number;\n}\n\n/** A message as stored by an adapter: the data is its JSON text. @since 1.0.0 */\nexport interface StoredMessage {\n  readonly seq: number;\n  readonly event: string;\n  /** The JSON text of the data. */\n  readonly data: string;\n  /** The publishing connection id, when a connection published it. */\n  readonly publisher?: string;\n  /** The publishing user, when it has one. */\n  readonly user?: string;\n  /** When the adapter accepted it, in epoch milliseconds. */\n  readonly at: number;\n}\n\n/** What a publisher supplies; the adapter adds `seq` and `at`. @since 1.0.0 */\nexport type StoredEntry = Omit<StoredMessage, \"seq\" | \"at\">;\n\n/** A change of a presence set, as adapters deliver it. @since 1.0.0 */\nexport interface PresenceEvent {\n  readonly channel: string;\n  readonly op: \"join\" | \"set\" | \"leave\";\n  readonly member: Member;\n}\n\n/** Frames a client sends. @since 1.0.0 */\nexport type ClientFrame =\n  | { readonly t: \"hello\"; readonly v: number }\n  | {\n      readonly t: \"sub\";\n      readonly n: number;\n      readonly c: string;\n      readonly after?: number;\n      readonly echo?: boolean;\n      readonly presence?: Json;\n      readonly hasPresence: boolean;\n      readonly watch?: boolean;\n    }\n  | { readonly t: \"unsub\"; readonly n?: number; readonly c: string }\n  | {\n      readonly t: \"pub\";\n      readonly c: string;\n      readonly e: string;\n      readonly d: string;\n      readonly n?: number;\n      readonly k?: string;\n    }\n  | {\n      readonly t: \"req\";\n      readonly n: number;\n      readonly c: string;\n      readonly e: string;\n      readonly d: Json;\n      readonly ms?: number;\n    }\n  | { readonly t: \"pres\"; readonly c: string; readonly s: Json }\n  | { readonly t: \"ping\"; readonly n?: number };\n\n/** What decoding a client frame yields. @since 1.0.0 */\nexport type DecodedClientFrame =\n  | { readonly ok: true; readonly frame: ClientFrame }\n  | { readonly ok: false; readonly code: ErrorCode; readonly n?: number; readonly why: string };\n\nconst CHANNEL = /^[A-Za-z0-9_.:/@-]{1,128}$/;\nconst EVENT = /^[A-Za-z0-9_.:@-]{1,64}$/;\nconst KEY = /^[A-Za-z0-9_.:@-]{1,64}$/;\nconst encoder = new TextEncoder();\n\n/**\n * Whether `value` is a valid channel name: 1..128 characters of `A-Za-z0-9_.:/@-`, not starting with the reserved `$`.\n * @param value The candidate.\n * @returns True for a valid name.\n * @example\n * import { isChannelName } from \"@shadow-js/realtime\";\n *\n * isChannelName(\"chat:lobby\"); // true\n * isChannelName(\"chat lobby\"); // false\n * @since 1.0.0\n */\nexport function isChannelName(value: unknown): value is string {\n  return typeof value === \"string\" && CHANNEL.test(value);\n}\n\n/**\n * Whether `value` is a valid event name: 1..64 characters of `A-Za-z0-9_.:@-`.\n * @param value The candidate.\n * @returns True for a valid name.\n * @example\n * import { isEventName } from \"@shadow-js/realtime\";\n *\n * isEventName(\"message\"); // true\n * isEventName(\"a/b\"); // false\n * @since 1.0.0\n */\nexport function isEventName(value: unknown): value is string {\n  return typeof value === \"string\" && EVENT.test(value);\n}\n\n/** Whether `value` is a valid idempotency key. @internal */\nexport function isIdempotencyKey(value: unknown): value is string {\n  return typeof value === \"string\" && KEY.test(value);\n}\n\n/** The number of bytes of `text` in UTF-8, without encoding the common cases. @internal */\nexport function byteLength(text: string): number {\n  // Every UTF-16 unit is at most 3 bytes in UTF-8, and at least 1.\n  if (text.length * 3 <= 0x7fffffff) {\n    let ascii = true;\n    for (let at = 0; at < text.length; at += 1) {\n      if (text.charCodeAt(at) > 0x7f) {\n        ascii = false;\n        break;\n      }\n    }\n    if (ascii) return text.length;\n  }\n  return encoder.encode(text).length;\n}\n\nfunction isCount(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\ntype Refusal = Extract<DecodedClientFrame, { ok: false }>;\n\nfunction bad(why: string, n?: unknown): Refusal {\n  return isCount(n)\n    ? { ok: false, code: \"bad_frame\", n, why }\n    : { ok: false, code: \"bad_frame\", why };\n}\n\n/**\n * Decodes and validates one client frame (server side). Never throws: any text yields a frame or a refusal.\n *\n * @param text The frame text.\n * @param maxBytes The largest accepted frame, in UTF-8 bytes.\n * @returns The frame, or the code and reason to refuse it with.\n * @example\n * import { decodeClientFrame } from \"@shadow-js/realtime\";\n *\n * const result = decodeClientFrame('{\"t\":\"ping\"}', 65_536);\n * result.ok; // true\n * @since 1.0.0\n */\nexport function decodeClientFrame(text: string, maxBytes: number): DecodedClientFrame {\n  if (byteLength(text) > maxBytes)\n    return { ok: false, code: \"too_large\", why: \"the frame is larger than the limit\" };\n  let value: unknown;\n  try {\n    value = JSON.parse(text);\n  } catch {\n    return bad(\"the frame is not JSON\");\n  }\n  if (value === null || typeof value !== \"object\" || Array.isArray(value))\n    return bad(\"the frame is not an object\");\n  const raw = value as Record<string, unknown>;\n  const type = raw[\"t\"];\n  const n = raw[\"n\"];\n  if (n !== undefined && !isCount(n)) return bad(\"n must be a non-negative integer\");\n  const c = raw[\"c\"];\n  const needChannel = (): Refusal | undefined =>\n    isChannelName(c)\n      ? undefined\n      : { ...bad(\"c is not a valid channel name\", n), code: \"bad_channel\" };\n  switch (type) {\n    case \"hello\": {\n      const v = raw[\"v\"];\n      if (typeof v !== \"number\" || !Number.isInteger(v) || v < 1) return bad(\"v must be a version\");\n      return { ok: true, frame: { t: \"hello\", v } };\n    }\n    case \"ping\":\n      return { ok: true, frame: n === undefined ? { t: \"ping\" } : { t: \"ping\", n } };\n    case \"sub\": {\n      const refusal = needChannel();\n      if (refusal !== undefined) return refusal;\n      if (n === undefined) return bad(\"sub needs n\");\n      const after = raw[\"after\"];\n      if (after !== undefined && !isCount(after))\n        return bad(\"after must be a non-negative integer\", n);\n      const echo = raw[\"echo\"];\n      if (echo !== undefined && typeof echo !== \"boolean\") return bad(\"echo must be a boolean\", n);\n      const watch = raw[\"watch\"];\n      if (watch !== undefined && typeof watch !== \"boolean\")\n        return bad(\"watch must be a boolean\", n);\n      const hasPresence = \"presence\" in raw;\n      return {\n        ok: true,\n        frame: {\n          t: \"sub\",\n          n,\n          c: c as string,\n          hasPresence,\n          ...(after === undefined ? {} : { after }),\n          ...(echo === undefined ? {} : { echo }),\n          ...(watch === undefined ? {} : { watch }),\n          ...(hasPresence ? { presence: raw[\"presence\"] as Json } : {}),\n        },\n      };\n    }\n    case \"unsub\": {\n      const refusal = needChannel();\n      if (refusal !== undefined) return refusal;\n      return {\n        ok: true,\n        frame: n === undefined ? { t: \"unsub\", c: c as string } : { t: \"unsub\", n, c: c as string },\n      };\n    }\n    case \"pub\": {\n      const refusal = needChannel();\n      if (refusal !== undefined) return refusal;\n      const e = raw[\"e\"];\n      if (!isEventName(e)) return bad(\"e is not a valid event name\", n);\n      const k = raw[\"k\"];\n      if (k !== undefined && !isIdempotencyKey(k)) return bad(\"k is not a valid key\", n);\n      const data = JSON.stringify(raw[\"d\"] ?? null);\n      return {\n        ok: true,\n        frame: {\n          t: \"pub\",\n          c: c as string,\n          e,\n          d: data,\n          ...(n === undefined ? {} : { n }),\n          ...(k === undefined ? {} : { k }),\n        },\n      };\n    }\n    case \"req\": {\n      const refusal = needChannel();\n      if (refusal !== undefined) return refusal;\n      if (n === undefined) return bad(\"req needs n\");\n      const e = raw[\"e\"];\n      if (!isEventName(e)) return bad(\"e is not a valid event name\", n);\n      const ms = raw[\"ms\"];\n      if (ms !== undefined && !(typeof ms === \"number\" && Number.isFinite(ms) && ms > 0))\n        return bad(\"ms must be a positive number\", n);\n      return {\n        ok: true,\n        frame: {\n          t: \"req\",\n          n,\n          c: c as string,\n          e,\n          d: (raw[\"d\"] ?? null) as Json,\n          ...(ms === undefined ? {} : { ms }),\n        },\n      };\n    }\n    case \"pres\": {\n      const refusal = needChannel();\n      if (refusal !== undefined) return refusal;\n      return { ok: true, frame: { t: \"pres\", c: c as string, s: (raw[\"s\"] ?? null) as Json } };\n    }\n    default:\n      return bad(\"unknown frame type\", n);\n  }\n}\n\n/** Frames a server sends, as a client reads them. @since 1.0.0 */\nexport type ServerFrame =\n  | {\n      readonly t: \"ready\";\n      readonly v: number;\n      readonly id: string;\n      readonly hb: number;\n      readonly max: number;\n    }\n  | {\n      readonly t: \"subbed\";\n      readonly n: number;\n      readonly c: string;\n      readonly head: number;\n      readonly gap?: boolean;\n      readonly reset?: boolean;\n    }\n  | { readonly t: \"unsubbed\"; readonly c: string; readonly why?: string }\n  | {\n      readonly t: \"msg\";\n      readonly c: string;\n      readonly s: number;\n      readonly e: string;\n      readonly d: Json;\n      readonly p?: string;\n      readonly u?: string;\n      readonly r?: 1;\n    }\n  | { readonly t: \"ack\"; readonly n: number; readonly s: number; readonly dup?: boolean }\n  | { readonly t: \"rep\"; readonly n: number; readonly d: Json }\n  | {\n      readonly t: \"err\";\n      readonly n?: number;\n      readonly c?: string;\n      readonly code: ErrorCode;\n      readonly msg?: string;\n    }\n  | {\n      readonly t: \"pres\";\n      readonly c: string;\n      readonly op: \"sync\" | \"join\" | \"set\" | \"leave\";\n      readonly m: Member | readonly Member[];\n    }\n  | { readonly t: \"pong\"; readonly n?: number }\n  | { readonly t: \"bye\"; readonly code: number; readonly why: string };\n\n/**\n * Decodes one server frame (client side). Returns `undefined` for anything that is not a known, well-formed frame, so a\n * client ignores what a newer server may send and never acts on a malformed frame.\n *\n * @param text The frame text.\n * @returns The frame, or undefined.\n * @example\n * import { decodeServerFrame } from \"@shadow-js/realtime\";\n *\n * decodeServerFrame('{\"t\":\"pong\"}'); // { t: \"pong\" }\n * decodeServerFrame(\"not json\"); // undefined\n * @since 1.0.0\n */\nexport function decodeServerFrame(text: string): ServerFrame | undefined {\n  let value: unknown;\n  try {\n    value = JSON.parse(text);\n  } catch {\n    return undefined;\n  }\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n  const raw = value as Record<string, unknown>;\n  const str = (key: string): string | undefined => {\n    const item = raw[key];\n    return typeof item === \"string\" ? item : undefined;\n  };\n  const num = (key: string): number | undefined => {\n    const item = raw[key];\n    return isCount(item) ? item : undefined;\n  };\n  switch (raw[\"t\"]) {\n    case \"ready\": {\n      const v = num(\"v\");\n      const id = str(\"id\");\n      if (v === undefined || id === undefined) return undefined;\n      return { t: \"ready\", v, id, hb: num(\"hb\") ?? 30_000, max: num(\"max\") ?? 65_536 };\n    }\n    case \"subbed\": {\n      const n = num(\"n\");\n      const c = str(\"c\");\n      const head = num(\"head\");\n      if (n === undefined || c === undefined || head === undefined) return undefined;\n      return {\n        t: \"subbed\",\n        n,\n        c,\n        head,\n        ...(raw[\"gap\"] === true ? { gap: true } : {}),\n        ...(raw[\"reset\"] === true ? { reset: true } : {}),\n      };\n    }\n    case \"unsubbed\": {\n      const c = str(\"c\");\n      if (c === undefined) return undefined;\n      const why = str(\"why\");\n      return why === undefined ? { t: \"unsubbed\", c } : { t: \"unsubbed\", c, why };\n    }\n    case \"msg\": {\n      const c = str(\"c\");\n      const s = num(\"s\");\n      const e = str(\"e\");\n      if (c === undefined || s === undefined || e === undefined || s < 1) return undefined;\n      const p = str(\"p\");\n      const u = str(\"u\");\n      return {\n        t: \"msg\",\n        c,\n        s,\n        e,\n        d: raw[\"d\"] as Json,\n        ...(p === undefined ? {} : { p }),\n        ...(u === undefined ? {} : { u }),\n        ...(raw[\"r\"] === 1 ? { r: 1 as const } : {}),\n      };\n    }\n    case \"ack\": {\n      const n = num(\"n\");\n      const s = num(\"s\");\n      if (n === undefined || s === undefined) return undefined;\n      return { t: \"ack\", n, s, ...(raw[\"dup\"] === true ? { dup: true } : {}) };\n    }\n    case \"rep\": {\n      const n = num(\"n\");\n      if (n === undefined) return undefined;\n      return { t: \"rep\", n, d: raw[\"d\"] as Json };\n    }\n    case \"err\": {\n      const code = str(\"code\");\n      if (code === undefined) return undefined;\n      const n = num(\"n\");\n      const c = str(\"c\");\n      const msg = str(\"msg\");\n      return {\n        t: \"err\",\n        code: code as ErrorCode,\n        ...(n === undefined ? {} : { n }),\n        ...(c === undefined ? {} : { c }),\n        ...(msg === undefined ? {} : { msg }),\n      };\n    }\n    case \"pres\": {\n      const c = str(\"c\");\n      const op = raw[\"op\"];\n      const m = raw[\"m\"];\n      if (c === undefined || (op !== \"sync\" && op !== \"join\" && op !== \"set\" && op !== \"leave\"))\n        return undefined;\n      const member = (item: unknown): Member | undefined => {\n        if (item === null || typeof item !== \"object\") return undefined;\n        const entry = item as Record<string, unknown>;\n        if (typeof entry[\"id\"] !== \"string\" || !isCount(entry[\"v\"])) return undefined;\n        return {\n          id: entry[\"id\"],\n          v: entry[\"v\"],\n          s: (entry[\"s\"] ?? null) as Json,\n          ...(typeof entry[\"u\"] === \"string\" ? { u: entry[\"u\"] } : {}),\n        };\n      };\n      if (op === \"sync\") {\n        if (!Array.isArray(m)) return undefined;\n        const list = m.map(member);\n        if (list.some((item) => item === undefined)) return undefined;\n        return { t: \"pres\", c, op, m: list as Member[] };\n      }\n      const one = member(m);\n      return one === undefined ? undefined : { t: \"pres\", c, op, m: one };\n    }\n    case \"pong\": {\n      const n = num(\"n\");\n      return n === undefined ? { t: \"pong\" } : { t: \"pong\", n };\n    }\n    case \"bye\": {\n      const code = num(\"code\");\n      return code === undefined ? undefined : { t: \"bye\", code, why: str(\"why\") ?? \"\" };\n    }\n    default:\n      return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/dev/redis/client.d.ts

@@ -0,0 +1,139 @@
+//#region src/redis/client.d.ts
+/**
+ * What the Redis adapter needs from a Redis library, and the two wrappers that adapt the common ones. The adapter has no
+ * dependency on a Redis package: it is written against these small interfaces, which ioredis and node-redis satisfy through
+ * {@link fromIoredis} and {@link fromNodeRedis}, and which anything else (Upstash over TCP, a mock, your own pool) can implement.
+ */
+/**
+ * A connection that runs commands. Commands issued without waiting for the previous one are pipelined by the library, which the
+ * adapter relies on for throughput.
+ *
+ * @example
+ * import type { RedisClient } from "@shadow-js/realtime/redis";
+ *
+ * declare function send(args: string[]): Promise<unknown>;
+ * const client: RedisClient = { sendCommand: (args) => send([...args]) };
+ * @since 1.0.0
+ */
+export interface RedisClient {
+  /**
+   * Runs one command (`["EVALSHA", sha, "1", key, ...]`) and resolves with its reply: a string (or bytes) for bulk and status
+   * replies, a number for integers, `null` for nil, an array for multi-bulk. Rejects with the server's error (its message starts
+   * with the error code, for example `NOSCRIPT`) or with the transport's error.
+   */
+  sendCommand(args: readonly string[]): Promise<unknown>;
+  /**
+   * Opens a dedicated connection for pub/sub, used when {@link RedisAdapterOptions.subscriber} is not given. The adapter owns it
+   * and closes it with {@link RedisSubscriber.close}.
+   */
+  createSubscriber?(): Promise<RedisSubscriber> | RedisSubscriber;
+}
+/**
+ * A connection in subscriber mode.
+ *
+ * @example
+ * import type { RedisSubscriber } from "@shadow-js/realtime/redis";
+ *
+ * declare const subscriber: RedisSubscriber;
+ * await subscriber.subscribe("rt:{room}:c", (message) => message.length);
+ * await subscriber.unsubscribe("rt:{room}:c");
+ * @since 1.0.0
+ */
+export interface RedisSubscriber {
+  /**
+   * Subscribes to a topic. Resolves once the server confirmed. Calling it again for a topic already subscribed replaces the
+   * listener and does not deliver twice.
+   */
+  subscribe(topic: string, listener: (message: string) => void): Promise<void>;
+  /** Stops listening to a topic. The listener is removed before the returned promise settles. */
+  unsubscribe(topic: string): Promise<void>;
+  /**
+   * Registers a function to call whenever the connection was lost and came back (not for the first connection). The adapter
+   * subscribes its topics again and recovers what was published in between from history. Returns a function that removes the
+   * registration.
+   */
+  onReconnect(handler: () => void): () => void;
+  /** Registers a function that receives the connection's errors, so none goes unhandled. Returns a function that removes it. */
+  onError?(handler: (error: unknown) => void): () => void;
+  /** Closes the connection. Called only for a subscriber the adapter created itself. */
+  close?(): Promise<void>;
+}
+/**
+ * The part of an ioredis connection that {@link fromIoredis} uses. The real `Redis` and `Cluster` classes fit.
+ * @since 1.0.0
+ */
+export interface IoredisLike {
+  call(command: string, ...args: string[]): Promise<unknown>;
+  duplicate(): IoredisSubscriberLike;
+}
+/**
+ * The part of a duplicated ioredis connection that {@link fromIoredis} uses in subscriber mode.
+ * @since 1.0.0
+ */
+export interface IoredisSubscriberLike {
+  subscribe(...topics: string[]): Promise<unknown>;
+  unsubscribe(...topics: string[]): Promise<unknown>;
+  on(event: string, listener: (...args: never[]) => void): unknown;
+  off?(event: string, listener: (...args: never[]) => void): unknown;
+  removeListener?(event: string, listener: (...args: never[]) => void): unknown;
+  quit(): Promise<unknown>;
+  disconnect?(): void;
+}
+/**
+ * The part of a node-redis (v4 or v5) client that {@link fromNodeRedis} uses.
+ * @since 1.0.0
+ */
+export interface NodeRedisLike {
+  sendCommand(args: string[]): Promise<unknown>;
+  duplicate(): NodeRedisSubscriberLike;
+}
+/**
+ * The part of a duplicated node-redis client that {@link fromNodeRedis} uses in subscriber mode.
+ * @since 1.0.0
+ */
+export interface NodeRedisSubscriberLike {
+  connect(): Promise<unknown>;
+  subscribe(topic: string, listener: (message: string, topic: string) => void): Promise<unknown>;
+  unsubscribe(topic: string): Promise<unknown>;
+  on(event: string, listener: (...args: never[]) => void): unknown;
+  off?(event: string, listener: (...args: never[]) => void): unknown;
+  removeListener?(event: string, listener: (...args: never[]) => void): unknown;
+  close?(): Promise<unknown>;
+  quit?(): Promise<unknown>;
+  disconnect?(): Promise<unknown>;
+}
+/**
+ * Adapts an ioredis connection (`Redis` or `Cluster`). Commands go through `call`; the subscriber is a `duplicate()` of the
+ * connection, which ioredis re-subscribes by itself after a reconnect (the adapter then recovers what was missed).
+ *
+ * @param client The ioredis connection.
+ * @returns A {@link RedisClient} for `redisAdapter`.
+ * @example
+ * import { Redis } from "ioredis";
+ * import { fromIoredis, redisAdapter } from "@shadow-js/realtime/redis";
+ *
+ * const adapter = redisAdapter({ client: fromIoredis(new Redis(process.env.REDIS_URL ?? "")) });
+ * await adapter.close();
+ * @since 1.0.0
+ */
+export declare function fromIoredis(client: IoredisLike): RedisClient;
+/**
+ * Adapts a node-redis (v4 or v5) client. Commands go through `sendCommand`; the subscriber is a `duplicate()` that is connected
+ * here and that node-redis re-subscribes by itself after a reconnect (the adapter then recovers what was missed). Pass a
+ * standalone client; node-redis cluster clients route by key and need their own wrapper.
+ *
+ * @param client The node-redis client (already connected).
+ * @returns A {@link RedisClient} for `redisAdapter`.
+ * @example
+ * import { createClient } from "redis";
+ * import { fromNodeRedis, redisAdapter } from "@shadow-js/realtime/redis";
+ *
+ * const client = createClient({ url: process.env.REDIS_URL ?? "" });
+ * await client.connect();
+ * const adapter = redisAdapter({ client: fromNodeRedis(client) });
+ * await adapter.close();
+ * @since 1.0.0
+ */
+export declare function fromNodeRedis(client: NodeRedisLike): RedisClient;
+//#endregion
+//# sourceMappingURL=client.d.ts.map

package/dist/dev/redis/client.js

@@ -0,0 +1,146 @@
+//#region src/redis/client.ts
+/** A set of handlers with add-and-remove, shared by the two wrappers. */
+function handlers() {
+	const set = /* @__PURE__ */ new Set();
+	return {
+		add(handler) {
+			set.add(handler);
+			return () => {
+				set.delete(handler);
+			};
+		},
+		fire(...args) {
+			for (const handler of [...set]) try {
+				handler(...args);
+			} catch {}
+		}
+	};
+}
+/**
+* Adapts an ioredis connection (`Redis` or `Cluster`). Commands go through `call`; the subscriber is a `duplicate()` of the
+* connection, which ioredis re-subscribes by itself after a reconnect (the adapter then recovers what was missed).
+*
+* @param client The ioredis connection.
+* @returns A {@link RedisClient} for `redisAdapter`.
+* @example
+* import { Redis } from "ioredis";
+* import { fromIoredis, redisAdapter } from "@shadow-js/realtime/redis";
+*
+* const adapter = redisAdapter({ client: fromIoredis(new Redis(process.env.REDIS_URL ?? "")) });
+* await adapter.close();
+* @since 1.0.0
+*/
+function fromIoredis(client) {
+	return {
+		sendCommand: (args) => {
+			const [command, ...rest] = args;
+			return client.call(command ?? "", ...rest);
+		},
+		createSubscriber: () => {
+			const connection = client.duplicate();
+			const topics = /* @__PURE__ */ new Map();
+			const reconnects = handlers();
+			const errors = handlers();
+			let ready = 0;
+			connection.on("message", ((topic, message) => {
+				topics.get(topic)?.(message);
+			}));
+			connection.on("ready", (() => {
+				ready += 1;
+				if (ready > 1) reconnects.fire();
+			}));
+			connection.on("error", ((error) => errors.fire(error)));
+			return {
+				async subscribe(topic, listener) {
+					topics.set(topic, listener);
+					await connection.subscribe(topic);
+				},
+				async unsubscribe(topic) {
+					topics.delete(topic);
+					await connection.unsubscribe(topic);
+				},
+				onReconnect: (handler) => reconnects.add(handler),
+				onError: (handler) => errors.add(handler),
+				async close() {
+					topics.clear();
+					try {
+						await connection.quit();
+					} catch {
+						connection.disconnect?.();
+					}
+				}
+			};
+		}
+	};
+}
+/**
+* Adapts a node-redis (v4 or v5) client. Commands go through `sendCommand`; the subscriber is a `duplicate()` that is connected
+* here and that node-redis re-subscribes by itself after a reconnect (the adapter then recovers what was missed). Pass a
+* standalone client; node-redis cluster clients route by key and need their own wrapper.
+*
+* @param client The node-redis client (already connected).
+* @returns A {@link RedisClient} for `redisAdapter`.
+* @example
+* import { createClient } from "redis";
+* import { fromNodeRedis, redisAdapter } from "@shadow-js/realtime/redis";
+*
+* const client = createClient({ url: process.env.REDIS_URL ?? "" });
+* await client.connect();
+* const adapter = redisAdapter({ client: fromNodeRedis(client) });
+* await adapter.close();
+* @since 1.0.0
+*/
+function fromNodeRedis(client) {
+	return {
+		sendCommand: (args) => client.sendCommand([...args]),
+		createSubscriber: async () => {
+			const connection = client.duplicate();
+			const topics = /* @__PURE__ */ new Map();
+			const dispatch = (message, topic) => {
+				topics.get(topic)?.(message);
+			};
+			const reconnects = handlers();
+			const errors = handlers();
+			let ready = 0;
+			connection.on("ready", (() => {
+				ready += 1;
+				if (ready > 1) reconnects.fire();
+			}));
+			connection.on("error", ((error) => errors.fire(error)));
+			await connection.connect();
+			const registered = /* @__PURE__ */ new Set();
+			return {
+				async subscribe(topic, listener) {
+					topics.set(topic, listener);
+					if (registered.has(topic)) return;
+					registered.add(topic);
+					try {
+						await connection.subscribe(topic, dispatch);
+					} catch (error) {
+						registered.delete(topic);
+						topics.delete(topic);
+						throw error;
+					}
+				},
+				async unsubscribe(topic) {
+					topics.delete(topic);
+					if (!registered.delete(topic)) return;
+					await connection.unsubscribe(topic);
+				},
+				onReconnect: (handler) => reconnects.add(handler),
+				onError: (handler) => errors.add(handler),
+				async close() {
+					topics.clear();
+					registered.clear();
+					if (connection.close !== void 0) await connection.close();
+					else if (connection.quit !== void 0) await connection.quit();
+					else await connection.disconnect?.();
+				}
+			};
+		}
+	};
+}
+//#endregion
+export { fromIoredis, fromNodeRedis };
+
+//# sourceMappingURL=client.js.map

package/dist/dev/redis/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/redis/client.ts"],"sourcesContent":["/**\n * What the Redis adapter needs from a Redis library, and the two wrappers that adapt the common ones. The adapter has no\n * dependency on a Redis package: it is written against these small interfaces, which ioredis and node-redis satisfy through\n * {@link fromIoredis} and {@link fromNodeRedis}, and which anything else (Upstash over TCP, a mock, your own pool) can implement.\n */\n\n/**\n * A connection that runs commands. Commands issued without waiting for the previous one are pipelined by the library, which the\n * adapter relies on for throughput.\n *\n * @example\n * import type { RedisClient } from \"@shadow-js/realtime/redis\";\n *\n * declare function send(args: string[]): Promise<unknown>;\n * const client: RedisClient = { sendCommand: (args) => send([...args]) };\n * @since 1.0.0\n */\nexport interface RedisClient {\n  /**\n   * Runs one command (`[\"EVALSHA\", sha, \"1\", key, ...]`) and resolves with its reply: a string (or bytes) for bulk and status\n   * replies, a number for integers, `null` for nil, an array for multi-bulk. Rejects with the server's error (its message starts\n   * with the error code, for example `NOSCRIPT`) or with the transport's error.\n   */\n  sendCommand(args: readonly string[]): Promise<unknown>;\n  /**\n   * Opens a dedicated connection for pub/sub, used when {@link RedisAdapterOptions.subscriber} is not given. The adapter owns it\n   * and closes it with {@link RedisSubscriber.close}.\n   */\n  createSubscriber?(): Promise<RedisSubscriber> | RedisSubscriber;\n}\n\n/**\n * A connection in subscriber mode.\n *\n * @example\n * import type { RedisSubscriber } from \"@shadow-js/realtime/redis\";\n *\n * declare const subscriber: RedisSubscriber;\n * await subscriber.subscribe(\"rt:{room}:c\", (message) => message.length);\n * await subscriber.unsubscribe(\"rt:{room}:c\");\n * @since 1.0.0\n */\nexport interface RedisSubscriber {\n  /**\n   * Subscribes to a topic. Resolves once the server confirmed. Calling it again for a topic already subscribed replaces the\n   * listener and does not deliver twice.\n   */\n  subscribe(topic: string, listener: (message: string) => void): Promise<void>;\n  /** Stops listening to a topic. The listener is removed before the returned promise settles. */\n  unsubscribe(topic: string): Promise<void>;\n  /**\n   * Registers a function to call whenever the connection was lost and came back (not for the first connection). The adapter\n   * subscribes its topics again and recovers what was published in between from history. Returns a function that removes the\n   * registration.\n   */\n  onReconnect(handler: () => void): () => void;\n  /** Registers a function that receives the connection's errors, so none goes unhandled. Returns a function that removes it. */\n  onError?(handler: (error: unknown) => void): () => void;\n  /** Closes the connection. Called only for a subscriber the adapter created itself. */\n  close?(): Promise<void>;\n}\n\n/**\n * The part of an ioredis connection that {@link fromIoredis} uses. The real `Redis` and `Cluster` classes fit.\n * @since 1.0.0\n */\nexport interface IoredisLike {\n  call(command: string, ...args: string[]): Promise<unknown>;\n  duplicate(): IoredisSubscriberLike;\n}\n\n/**\n * The part of a duplicated ioredis connection that {@link fromIoredis} uses in subscriber mode.\n * @since 1.0.0\n */\nexport interface IoredisSubscriberLike {\n  subscribe(...topics: string[]): Promise<unknown>;\n  unsubscribe(...topics: string[]): Promise<unknown>;\n  on(event: string, listener: (...args: never[]) => void): unknown;\n  off?(event: string, listener: (...args: never[]) => void): unknown;\n  removeListener?(event: string, listener: (...args: never[]) => void): unknown;\n  quit(): Promise<unknown>;\n  disconnect?(): void;\n}\n\n/**\n * The part of a node-redis (v4 or v5) client that {@link fromNodeRedis} uses.\n * @since 1.0.0\n */\nexport interface NodeRedisLike {\n  sendCommand(args: string[]): Promise<unknown>;\n  duplicate(): NodeRedisSubscriberLike;\n}\n\n/**\n * The part of a duplicated node-redis client that {@link fromNodeRedis} uses in subscriber mode.\n * @since 1.0.0\n */\nexport interface NodeRedisSubscriberLike {\n  connect(): Promise<unknown>;\n  subscribe(topic: string, listener: (message: string, topic: string) => void): Promise<unknown>;\n  unsubscribe(topic: string): Promise<unknown>;\n  on(event: string, listener: (...args: never[]) => void): unknown;\n  off?(event: string, listener: (...args: never[]) => void): unknown;\n  removeListener?(event: string, listener: (...args: never[]) => void): unknown;\n  close?(): Promise<unknown>;\n  quit?(): Promise<unknown>;\n  disconnect?(): Promise<unknown>;\n}\n\n/** A set of handlers with add-and-remove, shared by the two wrappers. */\nfunction handlers<A extends unknown[]>(): {\n  add(handler: (...args: A) => void): () => void;\n  fire(...args: A): void;\n} {\n  const set = new Set<(...args: A) => void>();\n  return {\n    add(handler) {\n      set.add(handler);\n      return () => {\n        set.delete(handler);\n      };\n    },\n    fire(...args) {\n      for (const handler of [...set]) {\n        try {\n          handler(...args);\n        } catch {\n          // A handler's failure is its own.\n        }\n      }\n    },\n  };\n}\n\n/**\n * Adapts an ioredis connection (`Redis` or `Cluster`). Commands go through `call`; the subscriber is a `duplicate()` of the\n * connection, which ioredis re-subscribes by itself after a reconnect (the adapter then recovers what was missed).\n *\n * @param client The ioredis connection.\n * @returns A {@link RedisClient} for `redisAdapter`.\n * @example\n * import { Redis } from \"ioredis\";\n * import { fromIoredis, redisAdapter } from \"@shadow-js/realtime/redis\";\n *\n * const adapter = redisAdapter({ client: fromIoredis(new Redis(process.env.REDIS_URL ?? \"\")) });\n * await adapter.close();\n * @since 1.0.0\n */\nexport function fromIoredis(client: IoredisLike): RedisClient {\n  return {\n    sendCommand: (args) => {\n      const [command, ...rest] = args;\n      return client.call(command ?? \"\", ...rest);\n    },\n    createSubscriber: (): RedisSubscriber => {\n      const connection = client.duplicate();\n      const topics = new Map<string, (message: string) => void>();\n      const reconnects = handlers<[]>();\n      const errors = handlers<[unknown]>();\n      let ready = 0;\n      connection.on(\"message\", ((topic: string, message: string) => {\n        topics.get(topic)?.(message);\n      }) as (...args: never[]) => void);\n      connection.on(\"ready\", (() => {\n        ready += 1;\n        if (ready > 1) reconnects.fire();\n      }) as (...args: never[]) => void);\n      connection.on(\"error\", ((error: unknown) => errors.fire(error)) as (\n        ...args: never[]\n      ) => void);\n      return {\n        async subscribe(topic, listener) {\n          topics.set(topic, listener);\n          await connection.subscribe(topic);\n        },\n        async unsubscribe(topic) {\n          topics.delete(topic);\n          await connection.unsubscribe(topic);\n        },\n        onReconnect: (handler) => reconnects.add(handler),\n        onError: (handler) => errors.add(handler),\n        async close() {\n          topics.clear();\n          try {\n            await connection.quit();\n          } catch {\n            connection.disconnect?.();\n          }\n        },\n      };\n    },\n  };\n}\n\n/**\n * Adapts a node-redis (v4 or v5) client. Commands go through `sendCommand`; the subscriber is a `duplicate()` that is connected\n * here and that node-redis re-subscribes by itself after a reconnect (the adapter then recovers what was missed). Pass a\n * standalone client; node-redis cluster clients route by key and need their own wrapper.\n *\n * @param client The node-redis client (already connected).\n * @returns A {@link RedisClient} for `redisAdapter`.\n * @example\n * import { createClient } from \"redis\";\n * import { fromNodeRedis, redisAdapter } from \"@shadow-js/realtime/redis\";\n *\n * const client = createClient({ url: process.env.REDIS_URL ?? \"\" });\n * await client.connect();\n * const adapter = redisAdapter({ client: fromNodeRedis(client) });\n * await adapter.close();\n * @since 1.0.0\n */\nexport function fromNodeRedis(client: NodeRedisLike): RedisClient {\n  return {\n    sendCommand: (args) => client.sendCommand([...args]),\n    createSubscriber: async (): Promise<RedisSubscriber> => {\n      const connection = client.duplicate();\n      const topics = new Map<string, (message: string) => void>();\n      const dispatch = (message: string, topic: string): void => {\n        topics.get(topic)?.(message);\n      };\n      const reconnects = handlers<[]>();\n      const errors = handlers<[unknown]>();\n      let ready = 0;\n      connection.on(\"ready\", (() => {\n        ready += 1;\n        if (ready > 1) reconnects.fire();\n      }) as (...args: never[]) => void);\n      // node-redis throws an unhandled \"error\" event as an exception: it is always handled here.\n      connection.on(\"error\", ((error: unknown) => errors.fire(error)) as (\n        ...args: never[]\n      ) => void);\n      await connection.connect();\n      const registered = new Set<string>();\n      return {\n        async subscribe(topic, listener) {\n          topics.set(topic, listener);\n          if (registered.has(topic)) return;\n          registered.add(topic);\n          try {\n            await connection.subscribe(topic, dispatch);\n          } catch (error) {\n            registered.delete(topic);\n            topics.delete(topic);\n            throw error;\n          }\n        },\n        async unsubscribe(topic) {\n          topics.delete(topic);\n          if (!registered.delete(topic)) return;\n          await connection.unsubscribe(topic);\n        },\n        onReconnect: (handler) => reconnects.add(handler),\n        onError: (handler) => errors.add(handler),\n        async close() {\n          topics.clear();\n          registered.clear();\n          if (connection.close !== undefined) await connection.close();\n          else if (connection.quit !== undefined) await connection.quit();\n          else await connection.disconnect?.();\n        },\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/dev/redis/scripts.js

@@ -0,0 +1,275 @@
+//#region src/redis/scripts.ts
+function rotateLeft(value, bits) {
+	return (value << bits | value >>> 32 - bits) >>> 0;
+}
+/**
+* SHA-1 of an ASCII or UTF-8 text, as lowercase hex. Pure TypeScript, so the adapter needs neither `node:crypto` nor a
+* round trip to `SCRIPT LOAD`.
+*/
+function sha1(text) {
+	const input = new TextEncoder().encode(text);
+	const total = input.length + 9 + 63 >> 6 << 6;
+	const padded = new Uint8Array(total);
+	padded.set(input);
+	padded[input.length] = 128;
+	const view = new DataView(padded.buffer);
+	const bits = input.length * 8;
+	view.setUint32(total - 8, Math.floor(bits / 2 ** 32));
+	view.setUint32(total - 4, bits >>> 0);
+	let h0 = 1732584193;
+	let h1 = 4023233417;
+	let h2 = 2562383102;
+	let h3 = 271733878;
+	let h4 = 3285377520;
+	const w = /* @__PURE__ */ new Uint32Array(80);
+	for (let offset = 0; offset < total; offset += 64) {
+		for (let i = 0; i < 16; i += 1) w[i] = view.getUint32(offset + i * 4);
+		for (let i = 16; i < 80; i += 1) w[i] = rotateLeft(w[i - 3] ^ w[i - 8] ^ w[i - 14] ^ w[i - 16], 1);
+		let a = h0;
+		let b = h1;
+		let c = h2;
+		let d = h3;
+		let e = h4;
+		for (let i = 0; i < 80; i += 1) {
+			let f;
+			let k;
+			if (i < 20) {
+				f = b & c | ~b & d;
+				k = 1518500249;
+			} else if (i < 40) {
+				f = b ^ c ^ d;
+				k = 1859775393;
+			} else if (i < 60) {
+				f = b & c | b & d | c & d;
+				k = 2400959708;
+			} else {
+				f = b ^ c ^ d;
+				k = 3395469782;
+			}
+			const next = rotateLeft(a, 5) + (f >>> 0) + e + k + w[i] >>> 0;
+			e = d;
+			d = c;
+			c = rotateLeft(b, 30);
+			b = a;
+			a = next;
+		}
+		h0 = h0 + a >>> 0;
+		h1 = h1 + b >>> 0;
+		h2 = h2 + c >>> 0;
+		h3 = h3 + d >>> 0;
+		h4 = h4 + e >>> 0;
+	}
+	return [
+		h0,
+		h1,
+		h2,
+		h3,
+		h4
+	].map((word) => word.toString(16).padStart(8, "0")).join("");
+}
+function script(source) {
+	return {
+		source,
+		sha: sha1(source)
+	};
+}
+/** Lua helpers shared by the scripts that read the clock. */
+const CLOCK = `
+local function now_ms()
+  local t = redis.call('TIME')
+  return tonumber(t[1]) * 1000 + math.floor(tonumber(t[2]) / 1000)
+end
+local function num(n) return string.format('%.0f', n) end
+`;
+/**
+* Publish. KEYS: meta hash, log zset (score = seq, member = the message), time zset (score = accepted-at, member = zero-padded
+* seq), optional idempotency key. ARGV: history, historyTtlMs, idempotencyTtlMs, channelTtlMs, topic, message tail.
+* Returns `{seq, duplicate}`.
+*/
+const PUBLISH = script(`${CLOCK}
+local meta, log, tix, idem = KEYS[1], KEYS[2], KEYS[3], KEYS[4]
+if idem then
+  local prev = redis.call('GET', idem)
+  if prev then return {tonumber(prev), 1} end
+end
+local history = tonumber(ARGV[1])
+local histTtl = tonumber(ARGV[2])
+local idemTtl = tonumber(ARGV[3])
+local chanTtl = tonumber(ARGV[4])
+local at = now_ms()
+local seq = redis.call('HINCRBY', meta, 's', 1)
+if history > 0 then
+  local newest = redis.call('ZREVRANGE', tix, 0, 0, 'WITHSCORES')
+  if newest[2] and tonumber(newest[2]) > at then at = tonumber(newest[2]) end
+end
+local msg = '{"s":' .. num(seq) .. ',"a":' .. num(at) .. ',' .. ARGV[6]
+if history > 0 then
+  local pad = string.format('%016.0f', seq)
+  redis.call('ZADD', log, seq, msg)
+  redis.call('ZADD', tix, at, pad)
+  local n = redis.call('ZCARD', log)
+  if n ~= redis.call('ZCARD', tix) then
+    redis.call('DEL', log, tix)
+    redis.call('ZADD', log, seq, msg)
+    redis.call('ZADD', tix, at, pad)
+  else
+    local drop = n - history
+    local old = redis.call('ZCOUNT', tix, '-inf', '(' .. num(at - histTtl))
+    if old > drop then drop = old end
+    if drop > 0 then
+      redis.call('ZREMRANGEBYRANK', log, 0, drop - 1)
+      redis.call('ZREMRANGEBYRANK', tix, 0, drop - 1)
+    end
+  end
+  redis.call('PEXPIRE', log, histTtl)
+  redis.call('PEXPIRE', tix, histTtl)
+else
+  redis.call('DEL', log, tix)
+end
+redis.call('HSET', meta, 't', ARGV[2])
+local keep = chanTtl
+if histTtl > keep then keep = histTtl end
+if idem and idemTtl > keep then keep = idemTtl end
+redis.call('PEXPIRE', meta, keep)
+if idem then redis.call('SET', idem, num(seq), 'PX', idemTtl) end
+redis.call('PUBLISH', ARGV[5], msg)
+return {seq, 0}
+`);
+/**
+* History. KEYS: meta, log, time. ARGV: after, limit. Returns `{head, oldest, message...}`; a message older than the channel's
+* history lifetime is not returned even when no publish has trimmed it yet.
+*/
+const HISTORY = script(`${CLOCK}
+local meta, log, tix = KEYS[1], KEYS[2], KEYS[3]
+local head = tonumber(redis.call('HGET', meta, 's') or '0')
+local ttl = redis.call('HGET', meta, 't')
+local low = tonumber(ARGV[1])
+local limit = tonumber(ARGV[2])
+local skip = 0
+if ttl then
+  skip = redis.call('ZCOUNT', tix, '-inf', '(' .. num(now_ms() - tonumber(ttl)))
+end
+local oldest = 0
+local first = redis.call('ZRANGE', tix, skip, skip)
+if first[1] then oldest = tonumber(first[1]) end
+if skip > 0 then
+  local expired = tonumber(redis.call('ZRANGE', tix, skip - 1, skip - 1)[1])
+  if expired and expired > low then low = expired end
+end
+local out = {head, oldest}
+if limit > 0 and oldest > 0 then
+  local rows = redis.call('ZRANGEBYSCORE', log, '(' .. num(low), '+inf', 'LIMIT', 0, limit)
+  for i = 1, #rows do out[#out + 1] = rows[i] end
+end
+return out
+`);
+/**
+* Keeps the numbering of a channel that has listeners alive. KEYS: meta. ARGV: channelTtlMs. Only ever extends the lifetime.
+*/
+const KEEPALIVE = script(`
+local ms = tonumber(ARGV[1])
+local left = redis.call('PTTL', KEYS[1])
+if left >= 0 and left < ms then redis.call('PEXPIRE', KEYS[1], ms) end
+return 1
+`);
+/** Lua: extends the lifetime of both presence keys to `keep` milliseconds, never shortens it. */
+const EXTEND = `
+local function extend(keep)
+  for i = 1, 2 do
+    local left = redis.call('PTTL', KEYS[i])
+    if left == -1 or (left >= 0 and left < keep) then redis.call('PEXPIRE', KEYS[i], keep) end
+  end
+end
+`;
+/**
+* Presence set. KEYS: members hash (id -> stored), expiry zset (id -> expires). ARGV: id, version, ttlMs, topic, stored, member
+* JSON, graceMs. Returns 0 for an ignored older version, else 1. Publishes join (new) or set (higher version).
+*/
+const PRESENCE_SET = script(`${CLOCK}${EXTEND}
+local id, version, ttl = ARGV[1], tonumber(ARGV[2]), tonumber(ARGV[3])
+local cur = redis.call('HGET', KEYS[1], id)
+local op = nil
+if cur then
+  local known = tonumber(string.match(cur, '^{"v":(%d+),'))
+  if known and known > version then return 0 end
+  if known == nil or known < version then op = 'set' end
+else
+  op = 'join'
+end
+redis.call('HSET', KEYS[1], id, ARGV[5])
+redis.call('ZADD', KEYS[2], num(now_ms() + ttl), id)
+extend(ttl + tonumber(ARGV[7]))
+if op then redis.call('PUBLISH', ARGV[4], '{"o":"' .. op .. '","m":' .. ARGV[6] .. '}') end
+return 1
+`);
+/**
+* Presence remove. KEYS: hash, zset. ARGV: id, topic. Returns 1 only for the call that removed the member (which alone
+* publishes the leave), else 0.
+*/
+const PRESENCE_REMOVE = script(`
+local cur = redis.call('HGET', KEYS[1], ARGV[1])
+redis.call('ZREM', KEYS[2], ARGV[1])
+if not cur then return 0 end
+redis.call('HDEL', KEYS[1], ARGV[1])
+local member = string.match(cur, '^{"v":%d+,"m":(.*)}$')
+if member then redis.call('PUBLISH', ARGV[2], '{"o":"leave","m":' .. member .. '}') end
+return 1
+`);
+/**
+* Presence touch. KEYS: hash, zset. ARGV: ttlMs, graceMs, id... Refreshes the expiry of the members that exist and returns the
+* ids that do not.
+*/
+const PRESENCE_TOUCH = script(`${CLOCK}${EXTEND}
+local ttl = tonumber(ARGV[1])
+local expires = num(now_ms() + ttl)
+local missing = {}
+local found = false
+for i = 3, #ARGV do
+  if redis.call('HEXISTS', KEYS[1], ARGV[i]) == 1 then
+    redis.call('ZADD', KEYS[2], expires, ARGV[i])
+    found = true
+  else
+    missing[#missing + 1] = ARGV[i]
+  end
+end
+if found then extend(ttl + tonumber(ARGV[2])) end
+return missing
+`);
+/**
+* Presence reap. KEYS: hash, zset. ARGV: topic, limit. Removes up to `limit` expired members, publishing one leave for each,
+* and returns their stored values.
+*/
+const PRESENCE_REAP = script(`${CLOCK}
+local ids = redis.call('ZRANGEBYSCORE', KEYS[2], '-inf', num(now_ms()), 'LIMIT', 0, tonumber(ARGV[2]))
+local out = {}
+for i = 1, #ids do
+  local cur = redis.call('HGET', KEYS[1], ids[i])
+  redis.call('ZREM', KEYS[2], ids[i])
+  if cur then
+    redis.call('HDEL', KEYS[1], ids[i])
+    out[#out + 1] = cur
+    local member = string.match(cur, '^{"v":%d+,"m":(.*)}$')
+    if member then redis.call('PUBLISH', ARGV[1], '{"o":"leave","m":' .. member .. '}') end
+  end
+end
+return out
+`);
+/** Presence list. KEYS: hash, zset. Returns the stored values of the members that have not expired. */
+const PRESENCE_LIST = script(`${CLOCK}
+local ids = redis.call('ZRANGEBYSCORE', KEYS[2], '(' .. num(now_ms()), '+inf')
+local out = {}
+local step = 400
+for from = 1, #ids, step do
+  local to = from + step - 1
+  if to > #ids then to = #ids end
+  local values = redis.call('HMGET', KEYS[1], unpack(ids, from, to))
+  for i = 1, #values do
+    if values[i] then out[#out + 1] = values[i] end
+  end
+end
+return out
+`);
+//#endregion
+export { HISTORY, KEEPALIVE, PRESENCE_LIST, PRESENCE_REAP, PRESENCE_REMOVE, PRESENCE_SET, PRESENCE_TOUCH, PUBLISH, sha1 };
+
+//# sourceMappingURL=scripts.js.map