@shadow-js/realtime 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +26 -0
- package/README.md +35 -0
- package/dist/dev/adapter.d.ts +0 -2
- package/dist/dev/client/core.d.ts +0 -2
- package/dist/dev/client/core.js +105 -108
- package/dist/dev/client/core.js.map +1 -1
- package/dist/dev/client/presence.js +1 -2
- package/dist/dev/client/sse.js +34 -26
- package/dist/dev/client/sse.js.map +1 -1
- package/dist/dev/client/types.d.ts +6 -2
- package/dist/dev/client/util.js +3 -4
- package/dist/dev/client/util.js.map +1 -1
- package/dist/dev/client/ws.js +1 -2
- package/dist/dev/cloudflare/adapter.d.ts +0 -2
- package/dist/dev/cloudflare/adapter.js +1 -2
- package/dist/dev/cloudflare/core.js +1 -2
- package/dist/dev/cloudflare/link.js +70 -10
- package/dist/dev/cloudflare/link.js.map +1 -1
- package/dist/dev/cloudflare/object.d.ts +0 -2
- package/dist/dev/cloudflare/object.js +1 -2
- package/dist/dev/cloudflare/types.d.ts +0 -2
- package/dist/dev/cloudflare/wire.js +1 -2
- package/dist/dev/errors.d.ts +0 -2
- package/dist/dev/errors.js +1 -2
- package/dist/dev/hooks.d.ts +0 -2
- package/dist/dev/hooks.js +1 -2
- package/dist/dev/memory.d.ts +11 -2
- package/dist/dev/memory.js +39 -12
- package/dist/dev/memory.js.map +1 -1
- package/dist/dev/protocol.d.ts +0 -2
- package/dist/dev/protocol.js +14 -14
- package/dist/dev/protocol.js.map +1 -1
- package/dist/dev/redis/client.d.ts +0 -2
- package/dist/dev/redis/client.js +1 -2
- package/dist/dev/redis/scripts.js +1 -2
- package/dist/dev/redis/topics.d.ts +6 -3
- package/dist/dev/redis/topics.js +5 -3
- package/dist/dev/redis/topics.js.map +1 -1
- package/dist/dev/redis.d.ts +0 -2
- package/dist/dev/redis.js +1 -2
- package/dist/dev/server/http.d.ts +0 -2
- package/dist/dev/server/http.js +38 -26
- package/dist/dev/server/http.js.map +1 -1
- package/dist/dev/server/hub.d.ts +0 -2
- package/dist/dev/server/hub.js +67 -41
- package/dist/dev/server/hub.js.map +1 -1
- package/dist/dev/server/index.d.ts +2 -4
- package/dist/dev/server/index.js +1 -2
- package/dist/dev/server/index.js.map +1 -1
- package/dist/dev/server/limits.d.ts +4 -3
- package/dist/dev/server/limits.js +1 -2
- package/dist/dev/server/limits.js.map +1 -1
- package/dist/dev/server/rules.d.ts +0 -2
- package/dist/dev/server/rules.js +1 -2
- package/dist/dev/server/rules.js.map +1 -1
- package/dist/dev/testing.d.ts +0 -2
- package/dist/dev/testing.js +1 -2
- package/dist/prod/client/core.js +1 -1
- package/dist/prod/client/core.js.map +1 -1
- package/dist/prod/client/sse.js +1 -4
- package/dist/prod/client/sse.js.map +1 -1
- package/dist/prod/client/util.js +1 -1
- package/dist/prod/client/util.js.map +1 -1
- package/dist/prod/cloudflare/link.js +1 -1
- package/dist/prod/cloudflare/link.js.map +1 -1
- package/dist/prod/memory.js +1 -1
- package/dist/prod/memory.js.map +1 -1
- package/dist/prod/protocol.js +1 -1
- package/dist/prod/protocol.js.map +1 -1
- package/dist/prod/redis/topics.js +1 -1
- package/dist/prod/redis/topics.js.map +1 -1
- package/dist/prod/server/http.js +1 -1
- package/dist/prod/server/http.js.map +1 -1
- package/dist/prod/server/hub.js +1 -1
- package/dist/prod/server/hub.js.map +1 -1
- package/dist/prod/server/index.js.map +1 -1
- package/dist/prod/server/limits.js +1 -1
- package/dist/prod/server/limits.js.map +1 -1
- package/dist/prod/server/rules.js +1 -1
- package/dist/prod/server/rules.js.map +1 -1
- package/package.json +6 -5
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"link.js","names":["deferred","resolve","reject","promise","onResolve","onReject","Pump","#max","max","#stopped","#queue","item","wake","#wake","cancel","every","deliver","error","report","ChannelLink","channel","#host","host","#state","#messages","#presence","sub","#last","listener","#nudger","#start","RealtimeError","ms","#ready","#check","#connect","#cancelRetry","#cancelConnect","attempt","#attempt","#connectedAt","#down","#known","#opened","socket","#closeSocket","owner","#closeOwner","#socket","#tryClose","event","#received","#cancelKeep","#failures","ceiling","delay","#retryAt","now","grace","keep","#lastReceived","text","frame","decodeLinkFrame","next","member","before","#members","id","#fanPresence","old","message","members","known","#resume","reason"],"sources":["../../../src/cloudflare/link.ts"],"sourcesContent":["/**\n * The Worker side of a channel's subscribe socket: one socket per channel and adapter, shared by every local listener, kept\n * open with backoff, resumed with `after`, and feeding each listener through its own queue.\n *\n * A Worker may use an I/O object (a socket, a stream, a timer) only inside the request that created it. A listener runs in the\n * request that subscribed, so it is called by a loop that was started there and woken by a plain promise: the socket's\n * handler only moves data into queues and never calls a listener itself.\n * @packageDocumentation\n */\nimport { RealtimeError } from \"../errors\";\nimport type { Member, PresenceEvent, StoredMessage } from \"../protocol\";\nimport type { ClientSocket } from \"./types\";\nimport { decodeLinkFrame } from \"./wire\";\n\n/** What a link needs from the adapter that owns it. @internal */\nexport interface LinkHost {\n readonly reconnectMinMs: number;\n readonly reconnectMaxMs: number;\n /** Ping period; 0 turns pings off. */\n readonly keepAliveMs: number;\n readonly connectTimeoutMs: number;\n /** The most events queued for one listener. */\n readonly maxQueued: number;\n now(): number;\n random(): number;\n /** Opens the subscribe socket (not yet accepted). */\n open(channel: string, after: number | undefined): Promise<ClientSocket>;\n /** Runs `task` once after `ms`; returns the way to cancel. Everything scheduled is canceled when the adapter closes. */\n after(ms: number, task: () => void): () => void;\n /** Runs `task` every `ms`; returns the way to cancel. */\n every(ms: number, task: () => void): () => void;\n report(error: unknown, where: string, channel: string): void;\n /** Called once when the link has nothing left to do. */\n forget(link: ChannelLink): void;\n}\n\ninterface Deferred {\n readonly promise: Promise<void>;\n resolve(): void;\n reject(error: unknown): void;\n}\n\nfunction deferred(): Deferred {\n let resolve: () => void = () => undefined;\n let reject: (error: unknown) => void = () => undefined;\n const promise = new Promise<void>((onResolve, onReject) => {\n resolve = onResolve;\n reject = onReject;\n });\n // A waiter may give up first; the rejection must not become an unhandled one.\n promise.catch(() => undefined);\n return { promise, resolve, reject };\n}\n\n/** A queue and the loop that empties it, in the request that created it. */\nclass Pump<T> {\n readonly #queue: T[] = [];\n readonly #max: number;\n #wake: (() => void) | undefined;\n #stopped = false;\n\n constructor(max: number) {\n this.#max = max;\n }\n\n push(item: T): void {\n if (this.#stopped || this.#queue.length >= this.#max) return;\n this.#queue.push(item);\n const wake = this.#wake;\n this.#wake = undefined;\n wake?.();\n }\n\n stop(): void {\n this.#stopped = true;\n this.#queue.length = 0;\n const wake = this.#wake;\n this.#wake = undefined;\n wake?.();\n }\n\n async run(\n deliver: (item: T) => void,\n report: (error: unknown) => void,\n every: (() => () => void) | undefined,\n ): Promise<void> {\n const cancel = every?.();\n try {\n while (!this.#stopped) {\n const item = this.#queue.shift();\n if (item === undefined) {\n await new Promise<void>((resolve) => {\n this.#wake = resolve;\n });\n continue;\n }\n try {\n deliver(item);\n } catch (error) {\n report(error);\n }\n }\n } finally {\n cancel?.();\n }\n }\n}\n\ninterface MessageSub {\n readonly listener: (message: StoredMessage) => void;\n readonly pump: Pump<StoredMessage>;\n /** The highest seq queued for this listener; -1 until the link tells the head. */\n last: number;\n}\n\ninterface PresenceSub {\n readonly listener: (event: PresenceEvent) => void;\n readonly pump: Pump<PresenceEvent>;\n}\n\n/** A way to stop one listener. @internal */\nexport type LinkSubscription = MessageSub | PresenceSub;\n\ntype LinkState = \"idle\" | \"connecting\" | \"open\" | \"backoff\" | \"disposed\";\n\n/** @internal */\nexport class ChannelLink {\n readonly channel: string;\n readonly #host: LinkHost;\n readonly #messages = new Set<MessageSub>();\n readonly #presence = new Set<PresenceSub>();\n #state: LinkState = \"idle\";\n #socket: ClientSocket | undefined;\n #closeOwner: Deferred | undefined;\n #attempt = 0;\n /** The highest seq received on this link: where a reconnect resumes. */\n #last = 0;\n #known = false;\n #members: Map<string, Member> | undefined;\n #lastReceived = 0;\n #failures = 0;\n #retryAt = 0;\n #connectedAt = 0;\n #ready: Deferred = deferred();\n #cancelRetry: (() => void) | undefined;\n #cancelConnect: (() => void) | undefined;\n #cancelKeep: (() => void) | undefined;\n\n constructor(channel: string, host: LinkHost) {\n this.channel = channel;\n this.#host = host;\n }\n\n get state(): LinkState {\n return this.#state;\n }\n\n get size(): number {\n return this.#messages.size + this.#presence.size;\n }\n\n // --- listeners -----------------------------------------------------------------------------------------------------\n\n /** Adds a message listener (call it in the request that will receive messages). */\n addMessages(listener: (message: StoredMessage) => void): LinkSubscription {\n const sub: MessageSub = {\n listener,\n pump: new Pump(this.#host.maxQueued),\n last: this.#state === \"open\" ? this.#last : -1,\n };\n this.#messages.add(sub);\n void sub.pump.run(\n listener,\n (error) => this.#host.report(error, \"listener\", this.channel),\n this.#nudger(),\n );\n this.#start();\n return sub;\n }\n\n /** Adds a presence listener (call it in the request that will receive events). */\n addPresence(listener: (event: PresenceEvent) => void): LinkSubscription {\n const sub: PresenceSub = { listener, pump: new Pump(this.#host.maxQueued) };\n this.#presence.add(sub);\n void sub.pump.run(\n listener,\n (error) => this.#host.report(error, \"listener\", this.channel),\n this.#nudger(),\n );\n this.#start();\n return sub;\n }\n\n /** Removes a listener; the last one closes the link. */\n remove(sub: LinkSubscription): void {\n sub.pump.stop();\n this.#messages.delete(sub as MessageSub);\n this.#presence.delete(sub as PresenceSub);\n if (this.size === 0) this.dispose(new RealtimeError(\"closed\", \"the subscription ended\"));\n }\n\n /** Resolves when the socket is open and has told the channel's head; rejects after `ms`. */\n whenReady(ms: number): Promise<void> {\n if (this.#state === \"open\") return Promise.resolve();\n return new Promise<void>((resolve, reject) => {\n const cancel = this.#host.after(ms, () =>\n reject(new RealtimeError(\"unavailable\", \"timed out connecting to the channel object\")),\n );\n this.#ready.promise.then(\n () => {\n cancel();\n resolve();\n },\n (error: unknown) => {\n cancel();\n reject(error);\n },\n );\n });\n }\n\n // --- connecting ----------------------------------------------------------------------------------------------------\n\n /** The pump's periodic check, if pings are on. */\n #nudger(): (() => () => void) | undefined {\n const every = this.#host.keepAliveMs;\n if (every <= 0) return undefined;\n return () => this.#host.every(every, () => this.#check());\n }\n\n #start(): void {\n if (this.#state === \"idle\") this.#connect();\n }\n\n #connect(): void {\n if (this.#state === \"disposed\") return;\n this.#cancelRetry?.();\n this.#cancelRetry = undefined;\n this.#cancelConnect?.();\n this.#state = \"connecting\";\n const attempt = ++this.#attempt;\n this.#connectedAt = this.#host.now();\n this.#cancelConnect = this.#host.after(this.#host.connectTimeoutMs, () => {\n if (attempt === this.#attempt && this.#state === \"connecting\")\n this.#down(attempt, new RealtimeError(\"unavailable\", \"the channel object did not answer\"));\n });\n this.#host.open(this.channel, this.#known ? this.#last : undefined).then(\n (socket) => this.#opened(attempt, socket),\n (error: unknown) => {\n if (attempt === this.#attempt) this.#down(attempt, error);\n },\n );\n }\n\n #opened(attempt: number, socket: ClientSocket): void {\n if (attempt !== this.#attempt || this.#state !== \"connecting\") {\n this.#closeSocket(socket, undefined);\n return;\n }\n const owner = deferred();\n this.#closeOwner = owner;\n this.#socket = socket;\n // Waits in the request that opened the socket, which is the one place guaranteed to be allowed to close it.\n void owner.promise.then(\n () => this.#tryClose(socket),\n () => undefined,\n );\n socket.addEventListener(\"message\", (event) => {\n if (attempt !== this.#attempt || typeof event.data !== \"string\") return;\n this.#received(attempt, event.data);\n });\n socket.addEventListener(\"close\", () => {\n if (attempt === this.#attempt)\n this.#down(attempt, new RealtimeError(\"unavailable\", \"closed\"));\n });\n socket.addEventListener(\"error\", () => {\n if (attempt === this.#attempt) this.#down(attempt, new RealtimeError(\"unavailable\", \"error\"));\n });\n try {\n socket.accept();\n } catch (error) {\n this.#down(attempt, error);\n }\n }\n\n #tryClose(socket: ClientSocket): boolean {\n try {\n socket.close(1000, \"done\");\n return true;\n } catch {\n return false;\n }\n }\n\n /** Closes a socket from wherever this runs; when the runtime refuses, the request that opened it does it. */\n #closeSocket(socket: ClientSocket | undefined, owner: Deferred | undefined): void {\n if (socket === undefined) return;\n if (!this.#tryClose(socket)) owner?.resolve();\n }\n\n /** The socket failed or closed: schedule a new attempt, or end the link when nobody listens. */\n #down(attempt: number, error: unknown): void {\n if (attempt !== this.#attempt || this.#state === \"disposed\") return;\n this.#attempt += 1;\n this.#cancelConnect?.();\n this.#cancelConnect = undefined;\n this.#cancelKeep?.();\n this.#cancelKeep = undefined;\n const socket = this.#socket;\n const owner = this.#closeOwner;\n this.#socket = undefined;\n this.#closeOwner = undefined;\n this.#closeSocket(socket, owner);\n // Waiters keep the promise they hold until the link is open; only an opened link needs a new one.\n if (this.#state === \"open\") this.#ready = deferred();\n if (this.size === 0) {\n this.dispose(error);\n return;\n }\n this.#state = \"backoff\";\n this.#failures += 1;\n const ceiling = Math.min(\n this.#host.reconnectMaxMs,\n this.#host.reconnectMinMs * 2 ** Math.min(this.#failures - 1, 20),\n );\n const delay = Math.floor(this.#host.random() * ceiling);\n this.#retryAt = this.#host.now() + delay;\n this.#cancelRetry?.();\n this.#cancelRetry = this.#host.after(delay, () => this.#connect());\n }\n\n /** Reconnects now, without waiting: the object asked for it (a long replay is continued with a new socket). */\n #resume(attempt: number): void {\n if (attempt !== this.#attempt) return;\n this.#attempt += 1;\n const socket = this.#socket;\n const owner = this.#closeOwner;\n this.#socket = undefined;\n this.#closeOwner = undefined;\n this.#cancelKeep?.();\n this.#cancelKeep = undefined;\n this.#closeSocket(socket, owner);\n this.#state = \"idle\";\n this.#connect();\n }\n\n /**\n * A health check run by every listener's loop (each in its own request) and by the ping timer: whichever request is alive\n * can repair a link whose own request is gone, because a timer or a socket handler of a finished request never runs again.\n */\n #check(): void {\n const now = this.#host.now();\n const grace = Math.max(1000, this.#host.keepAliveMs);\n switch (this.#state) {\n case \"backoff\":\n if (now > this.#retryAt + grace) this.#connect();\n return;\n case \"connecting\":\n if (now > this.#connectedAt + this.#host.connectTimeoutMs * 2) this.#connect();\n return;\n case \"open\": {\n const keep = this.#host.keepAliveMs;\n if (keep > 0 && now - this.#lastReceived > keep * 3) {\n this.#down(\n this.#attempt,\n new RealtimeError(\"unavailable\", \"the channel object went silent\"),\n );\n return;\n }\n try {\n this.#socket?.send(\"ping\");\n } catch {\n // Sending from another request is refused; the owner's own ping covers it.\n }\n return;\n }\n default:\n return;\n }\n }\n\n // --- frames --------------------------------------------------------------------------------------------------------\n\n #received(attempt: number, text: string): void {\n this.#lastReceived = this.#host.now();\n if (text === \"pong\") return;\n const frame = decodeLinkFrame(text);\n if (frame === undefined) return;\n switch (frame.t) {\n case \"ready\": {\n if (this.#known && frame.head < this.#last) {\n // The channel's numbering restarted (it was forgotten): follow it.\n this.#last = frame.head;\n for (const sub of this.#messages) sub.last = Math.min(sub.last, frame.head);\n }\n if (!this.#known) {\n this.#last = frame.head;\n this.#known = true;\n }\n for (const sub of this.#messages) if (sub.last < 0) sub.last = frame.head;\n this.#state = \"open\";\n this.#failures = 0;\n this.#cancelConnect?.();\n this.#cancelConnect = undefined;\n this.#lastReceived = this.#host.now();\n if (this.#host.keepAliveMs > 0) {\n this.#cancelKeep?.();\n this.#cancelKeep = this.#host.every(this.#host.keepAliveMs, () => this.#check());\n }\n this.#ready.resolve();\n return;\n }\n case \"snap\": {\n const next = new Map<string, Member>();\n for (const member of frame.members) next.set(member.id, member);\n const before = this.#members;\n this.#members = next;\n if (before === undefined) return;\n for (const [id, member] of before)\n if (!next.has(id)) this.#fanPresence({ channel: this.channel, op: \"leave\", member });\n for (const [id, member] of next) {\n const old = before.get(id);\n if (old === undefined) this.#fanPresence({ channel: this.channel, op: \"join\", member });\n else if (member.v > old.v)\n this.#fanPresence({ channel: this.channel, op: \"set\", member });\n }\n return;\n }\n case \"msg\": {\n const message = frame.m;\n if (message.seq > this.#last) this.#last = message.seq;\n for (const sub of this.#messages)\n if (message.seq > sub.last) {\n sub.last = message.seq;\n sub.pump.push(message);\n }\n return;\n }\n case \"pres\": {\n const members = this.#members ?? new Map<string, Member>();\n this.#members = members;\n const known = members.get(frame.member.id);\n if (frame.op === \"leave\") {\n if (known === undefined) return;\n members.delete(frame.member.id);\n } else {\n if (known !== undefined && known.v >= frame.member.v && frame.op === \"join\") return;\n if (known !== undefined && known.v > frame.member.v) return;\n members.set(frame.member.id, frame.member);\n }\n this.#fanPresence({ channel: this.channel, op: frame.op, member: frame.member });\n return;\n }\n case \"more\":\n this.#resume(attempt);\n return;\n case \"bye\":\n this.#down(attempt, new RealtimeError(\"unavailable\", frame.why));\n return;\n }\n }\n\n #fanPresence(event: PresenceEvent): void {\n for (const sub of this.#presence) sub.pump.push(event);\n }\n\n // --- ending --------------------------------------------------------------------------------------------------------\n\n /** Ends the link: stops every listener, cancels timers and closes the socket. */\n dispose(reason: unknown): void {\n if (this.#state === \"disposed\") return;\n this.#state = \"disposed\";\n this.#attempt += 1;\n this.#cancelRetry?.();\n this.#cancelConnect?.();\n this.#cancelKeep?.();\n this.#cancelRetry = undefined;\n this.#cancelConnect = undefined;\n this.#cancelKeep = undefined;\n const socket = this.#socket;\n const owner = this.#closeOwner;\n this.#socket = undefined;\n this.#closeOwner = undefined;\n this.#closeSocket(socket, owner);\n this.#ready.reject(reason);\n for (const sub of this.#messages) sub.pump.stop();\n for (const sub of this.#presence) sub.pump.stop();\n this.#messages.clear();\n this.#presence.clear();\n this.#host.forget(this);\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"link.js","names":["deferred","resolve","reject","promise","onResolve","onReject","Pump","#max","max","#onDrop","onDrop","#stopped","#queue","item","wake","#wake","cancel","every","idle","deliver","error","report","ChannelLink","channel","#host","host","#state","#messages","#presence","sub","#dropped","#last","listener","#nudger","#start","event","#resync","RealtimeError","current","#members","id","member","seen","ms","#ready","#check","#connect","#cancelRetry","#cancelConnect","attempt","#attempt","#connectedAt","#down","#known","#opened","socket","#closeSocket","owner","#closeOwner","#socket","#tryClose","#received","#cancelKeep","#failures","ceiling","delay","#retryAt","now","grace","keep","#lastReceived","text","frame","decodeLinkFrame","next","before","#fanPresence","old","message","members","known","#resume","reason"],"sources":["../../../src/cloudflare/link.ts"],"sourcesContent":["/**\n * The Worker side of a channel's subscribe socket: one socket per channel and adapter, shared by every local listener, kept\n * open with backoff, resumed with `after`, and feeding each listener through its own queue.\n *\n * A Worker may use an I/O object (a socket, a stream, a timer) only inside the request that created it. A listener runs in the\n * request that subscribed, so it is called by a loop that was started there and woken by a plain promise: the socket's\n * handler only moves data into queues and never calls a listener itself.\n * @packageDocumentation\n */\nimport { RealtimeError } from \"../errors\";\nimport type { Member, PresenceEvent, StoredMessage } from \"../protocol\";\nimport type { ClientSocket } from \"./types\";\nimport { decodeLinkFrame } from \"./wire\";\n\n/** What a link needs from the adapter that owns it. @internal */\nexport interface LinkHost {\n readonly reconnectMinMs: number;\n readonly reconnectMaxMs: number;\n /** Ping period; 0 turns pings off. */\n readonly keepAliveMs: number;\n readonly connectTimeoutMs: number;\n /** The most events queued for one listener. */\n readonly maxQueued: number;\n now(): number;\n random(): number;\n /** Opens the subscribe socket (not yet accepted). */\n open(channel: string, after: number | undefined): Promise<ClientSocket>;\n /** Runs `task` once after `ms`; returns the way to cancel. Everything scheduled is canceled when the adapter closes. */\n after(ms: number, task: () => void): () => void;\n /** Runs `task` every `ms`; returns the way to cancel. */\n every(ms: number, task: () => void): () => void;\n report(error: unknown, where: string, channel: string): void;\n /** Called once when the link has nothing left to do. */\n forget(link: ChannelLink): void;\n}\n\ninterface Deferred {\n readonly promise: Promise<void>;\n resolve(): void;\n reject(error: unknown): void;\n}\n\nfunction deferred(): Deferred {\n let resolve: () => void = () => undefined;\n let reject: (error: unknown) => void = () => undefined;\n const promise = new Promise<void>((onResolve, onReject) => {\n resolve = onResolve;\n reject = onReject;\n });\n // A waiter may give up first; the rejection must not become an unhandled one.\n promise.catch(() => undefined);\n return { promise, resolve, reject };\n}\n\n/** A queue and the loop that empties it, in the request that created it. */\nclass Pump<T> {\n readonly #queue: T[] = [];\n readonly #max: number;\n readonly #onDrop: () => void;\n #wake: (() => void) | undefined;\n #stopped = false;\n\n /**\n * @param max The most items waiting for the loop.\n * @param onDrop Called for every item refused because the queue is full, so the owner can report it and repair what the\n * listener missed. It runs inside `push`, so it must not call back into this pump.\n */\n constructor(max: number, onDrop: () => void) {\n this.#max = max;\n this.#onDrop = onDrop;\n }\n\n push(item: T): void {\n if (this.#stopped) return;\n if (this.#queue.length >= this.#max) {\n this.#onDrop();\n return;\n }\n this.#queue.push(item);\n const wake = this.#wake;\n this.#wake = undefined;\n wake?.();\n }\n\n stop(): void {\n this.#stopped = true;\n this.#queue.length = 0;\n const wake = this.#wake;\n this.#wake = undefined;\n wake?.();\n }\n\n async run(\n deliver: (item: T) => void,\n report: (error: unknown) => void,\n every: (() => () => void) | undefined,\n idle?: () => void,\n ): Promise<void> {\n const cancel = every?.();\n try {\n while (!this.#stopped) {\n const item = this.#queue.shift();\n if (item === undefined) {\n // The queue just emptied: the owner may refill it (to repair what a full queue refused) before the loop sleeps.\n idle?.();\n if (this.#queue.length > 0) continue;\n await new Promise<void>((resolve) => {\n this.#wake = resolve;\n });\n continue;\n }\n try {\n deliver(item);\n } catch (error) {\n report(error);\n }\n }\n } finally {\n cancel?.();\n }\n }\n}\n\ninterface MessageSub {\n readonly listener: (message: StoredMessage) => void;\n readonly pump: Pump<StoredMessage>;\n /** The highest seq queued for this listener; -1 until the link tells the head. */\n last: number;\n /** True from the first message refused by a full queue until the queue has emptied (one report per overflow). */\n overflowed: boolean;\n}\n\ninterface PresenceSub {\n readonly listener: (event: PresenceEvent) => void;\n readonly pump: Pump<PresenceEvent>;\n /** The members this listener has been given: what a resync is computed against. */\n readonly view: Map<string, Member>;\n /** True after an event was refused by a full queue and until the resync has been queued. */\n stale: boolean;\n}\n\n/** A way to stop one listener. @internal */\nexport type LinkSubscription = MessageSub | PresenceSub;\n\ntype LinkState = \"idle\" | \"connecting\" | \"open\" | \"backoff\" | \"disposed\";\n\n/** @internal */\nexport class ChannelLink {\n readonly channel: string;\n readonly #host: LinkHost;\n readonly #messages = new Set<MessageSub>();\n readonly #presence = new Set<PresenceSub>();\n #state: LinkState = \"idle\";\n #socket: ClientSocket | undefined;\n #closeOwner: Deferred | undefined;\n #attempt = 0;\n /** The highest seq received on this link: where a reconnect resumes. */\n #last = 0;\n #known = false;\n #members: Map<string, Member> | undefined;\n #lastReceived = 0;\n #failures = 0;\n #retryAt = 0;\n #connectedAt = 0;\n #ready: Deferred = deferred();\n #cancelRetry: (() => void) | undefined;\n #cancelConnect: (() => void) | undefined;\n #cancelKeep: (() => void) | undefined;\n\n constructor(channel: string, host: LinkHost) {\n this.channel = channel;\n this.#host = host;\n }\n\n get state(): LinkState {\n return this.#state;\n }\n\n get size(): number {\n return this.#messages.size + this.#presence.size;\n }\n\n // --- listeners -----------------------------------------------------------------------------------------------------\n\n /** Adds a message listener (call it in the request that will receive messages). */\n addMessages(listener: (message: StoredMessage) => void): LinkSubscription {\n const sub: MessageSub = {\n listener,\n pump: new Pump(this.#host.maxQueued, () => this.#dropped(sub)),\n last: this.#state === \"open\" ? this.#last : -1,\n overflowed: false,\n };\n this.#messages.add(sub);\n // A refused message is not retried here: the listener's next message has a gap before it, which the hub fills from history.\n void sub.pump.run(\n listener,\n (error) => this.#host.report(error, \"listener\", this.channel),\n this.#nudger(),\n () => {\n sub.overflowed = false;\n },\n );\n this.#start();\n return sub;\n }\n\n /** Adds a presence listener (call it in the request that will receive events). */\n addPresence(listener: (event: PresenceEvent) => void): LinkSubscription {\n const sub: PresenceSub = {\n listener,\n pump: new Pump(this.#host.maxQueued, () => this.#dropped(sub)),\n view: new Map(),\n stale: false,\n };\n this.#presence.add(sub);\n void sub.pump.run(\n (event) => {\n // The view follows what the listener was given, even when it throws on it.\n if (event.op === \"leave\") sub.view.delete(event.member.id);\n else sub.view.set(event.member.id, event.member);\n listener(event);\n },\n (error) => this.#host.report(error, \"listener\", this.channel),\n this.#nudger(),\n () => this.#resync(sub),\n );\n this.#start();\n return sub;\n }\n\n /** A listener's queue refused an item: reported once per overflow, and a presence listener is marked for a resync. */\n #dropped(sub: MessageSub | PresenceSub): void {\n if (\"view\" in sub) {\n if (sub.stale) return;\n sub.stale = true;\n } else {\n if (sub.overflowed) return;\n sub.overflowed = true;\n }\n this.#host.report(\n new RealtimeError(\n \"limit\",\n \"a listener fell behind: its queue is full and events were dropped\",\n ),\n \"queue\",\n this.channel,\n );\n }\n\n /**\n * Called when a presence listener has caught up: after a drop it is sent the difference between what it was given and the\n * member set the link holds (leaves, joins, changes), so one overflow cannot leave its picture of the room wrong for good.\n * When the difference is larger than the queue, the rest follows at the next catch-up.\n */\n #resync(sub: PresenceSub): void {\n if (!sub.stale) return;\n sub.stale = false;\n const current = this.#members ?? new Map<string, Member>();\n for (const [id, member] of sub.view)\n if (!current.has(id)) sub.pump.push({ channel: this.channel, op: \"leave\", member });\n for (const [id, member] of current) {\n const seen = sub.view.get(id);\n if (seen === undefined) sub.pump.push({ channel: this.channel, op: \"join\", member });\n else if (member.v > seen.v) sub.pump.push({ channel: this.channel, op: \"set\", member });\n }\n }\n\n /** Removes a listener; the last one closes the link. */\n remove(sub: LinkSubscription): void {\n sub.pump.stop();\n this.#messages.delete(sub as MessageSub);\n this.#presence.delete(sub as PresenceSub);\n if (this.size === 0) this.dispose(new RealtimeError(\"closed\", \"the subscription ended\"));\n }\n\n /** Resolves when the socket is open and has told the channel's head; rejects after `ms`. */\n whenReady(ms: number): Promise<void> {\n if (this.#state === \"open\") return Promise.resolve();\n return new Promise<void>((resolve, reject) => {\n const cancel = this.#host.after(ms, () =>\n reject(new RealtimeError(\"unavailable\", \"timed out connecting to the channel object\")),\n );\n this.#ready.promise.then(\n () => {\n cancel();\n resolve();\n },\n (error: unknown) => {\n cancel();\n reject(error);\n },\n );\n });\n }\n\n // --- connecting ----------------------------------------------------------------------------------------------------\n\n /** The pump's periodic check, if pings are on. */\n #nudger(): (() => () => void) | undefined {\n const every = this.#host.keepAliveMs;\n if (every <= 0) return undefined;\n return () => this.#host.every(every, () => this.#check());\n }\n\n #start(): void {\n if (this.#state === \"idle\") this.#connect();\n }\n\n #connect(): void {\n if (this.#state === \"disposed\") return;\n this.#cancelRetry?.();\n this.#cancelRetry = undefined;\n this.#cancelConnect?.();\n this.#state = \"connecting\";\n const attempt = ++this.#attempt;\n this.#connectedAt = this.#host.now();\n this.#cancelConnect = this.#host.after(this.#host.connectTimeoutMs, () => {\n if (attempt === this.#attempt && this.#state === \"connecting\")\n this.#down(attempt, new RealtimeError(\"unavailable\", \"the channel object did not answer\"));\n });\n this.#host.open(this.channel, this.#known ? this.#last : undefined).then(\n (socket) => this.#opened(attempt, socket),\n (error: unknown) => {\n if (attempt === this.#attempt) this.#down(attempt, error);\n },\n );\n }\n\n #opened(attempt: number, socket: ClientSocket): void {\n if (attempt !== this.#attempt || this.#state !== \"connecting\") {\n this.#closeSocket(socket, undefined);\n return;\n }\n const owner = deferred();\n this.#closeOwner = owner;\n this.#socket = socket;\n // Waits in the request that opened the socket, which is the one place guaranteed to be allowed to close it.\n void owner.promise.then(\n () => this.#tryClose(socket),\n () => undefined,\n );\n socket.addEventListener(\"message\", (event) => {\n if (attempt !== this.#attempt || typeof event.data !== \"string\") return;\n this.#received(attempt, event.data);\n });\n socket.addEventListener(\"close\", () => {\n if (attempt === this.#attempt)\n this.#down(attempt, new RealtimeError(\"unavailable\", \"closed\"));\n });\n socket.addEventListener(\"error\", () => {\n if (attempt === this.#attempt) this.#down(attempt, new RealtimeError(\"unavailable\", \"error\"));\n });\n try {\n socket.accept();\n } catch (error) {\n this.#down(attempt, error);\n }\n }\n\n #tryClose(socket: ClientSocket): boolean {\n try {\n socket.close(1000, \"done\");\n return true;\n } catch {\n return false;\n }\n }\n\n /** Closes a socket from wherever this runs; when the runtime refuses, the request that opened it does it. */\n #closeSocket(socket: ClientSocket | undefined, owner: Deferred | undefined): void {\n if (socket === undefined) return;\n if (!this.#tryClose(socket)) owner?.resolve();\n }\n\n /** The socket failed or closed: schedule a new attempt, or end the link when nobody listens. */\n #down(attempt: number, error: unknown): void {\n if (attempt !== this.#attempt || this.#state === \"disposed\") return;\n this.#attempt += 1;\n this.#cancelConnect?.();\n this.#cancelConnect = undefined;\n this.#cancelKeep?.();\n this.#cancelKeep = undefined;\n const socket = this.#socket;\n const owner = this.#closeOwner;\n this.#socket = undefined;\n this.#closeOwner = undefined;\n this.#closeSocket(socket, owner);\n // Waiters keep the promise they hold until the link is open; only an opened link needs a new one.\n if (this.#state === \"open\") this.#ready = deferred();\n if (this.size === 0) {\n this.dispose(error);\n return;\n }\n this.#state = \"backoff\";\n this.#failures += 1;\n const ceiling = Math.min(\n this.#host.reconnectMaxMs,\n this.#host.reconnectMinMs * 2 ** Math.min(this.#failures - 1, 20),\n );\n const delay = Math.floor(this.#host.random() * ceiling);\n this.#retryAt = this.#host.now() + delay;\n this.#cancelRetry?.();\n this.#cancelRetry = this.#host.after(delay, () => this.#connect());\n }\n\n /** Reconnects now, without waiting: the object asked for it (a long replay is continued with a new socket). */\n #resume(attempt: number): void {\n if (attempt !== this.#attempt) return;\n this.#attempt += 1;\n const socket = this.#socket;\n const owner = this.#closeOwner;\n this.#socket = undefined;\n this.#closeOwner = undefined;\n this.#cancelKeep?.();\n this.#cancelKeep = undefined;\n this.#closeSocket(socket, owner);\n this.#state = \"idle\";\n this.#connect();\n }\n\n /**\n * A health check run by every listener's loop (each in its own request) and by the ping timer: whichever request is alive\n * can repair a link whose own request is gone, because a timer or a socket handler of a finished request never runs again.\n */\n #check(): void {\n const now = this.#host.now();\n const grace = Math.max(1000, this.#host.keepAliveMs);\n switch (this.#state) {\n case \"backoff\":\n if (now > this.#retryAt + grace) this.#connect();\n return;\n case \"connecting\":\n if (now > this.#connectedAt + this.#host.connectTimeoutMs * 2) this.#connect();\n return;\n case \"open\": {\n const keep = this.#host.keepAliveMs;\n if (keep > 0 && now - this.#lastReceived > keep * 3) {\n this.#down(\n this.#attempt,\n new RealtimeError(\"unavailable\", \"the channel object went silent\"),\n );\n return;\n }\n try {\n this.#socket?.send(\"ping\");\n } catch {\n // Sending from another request is refused; the owner's own ping covers it.\n }\n return;\n }\n default:\n return;\n }\n }\n\n // --- frames --------------------------------------------------------------------------------------------------------\n\n #received(attempt: number, text: string): void {\n this.#lastReceived = this.#host.now();\n if (text === \"pong\") return;\n const frame = decodeLinkFrame(text);\n if (frame === undefined) return;\n switch (frame.t) {\n case \"ready\": {\n if (this.#known && frame.head < this.#last) {\n // The channel's numbering restarted (it was forgotten): follow it.\n this.#last = frame.head;\n for (const sub of this.#messages) sub.last = Math.min(sub.last, frame.head);\n }\n if (!this.#known) {\n this.#last = frame.head;\n this.#known = true;\n }\n for (const sub of this.#messages) if (sub.last < 0) sub.last = frame.head;\n this.#state = \"open\";\n this.#failures = 0;\n this.#cancelConnect?.();\n this.#cancelConnect = undefined;\n this.#lastReceived = this.#host.now();\n if (this.#host.keepAliveMs > 0) {\n this.#cancelKeep?.();\n this.#cancelKeep = this.#host.every(this.#host.keepAliveMs, () => this.#check());\n }\n this.#ready.resolve();\n return;\n }\n case \"snap\": {\n const next = new Map<string, Member>();\n for (const member of frame.members) next.set(member.id, member);\n const before = this.#members;\n this.#members = next;\n if (before === undefined) return;\n for (const [id, member] of before)\n if (!next.has(id)) this.#fanPresence({ channel: this.channel, op: \"leave\", member });\n for (const [id, member] of next) {\n const old = before.get(id);\n if (old === undefined) this.#fanPresence({ channel: this.channel, op: \"join\", member });\n else if (member.v > old.v)\n this.#fanPresence({ channel: this.channel, op: \"set\", member });\n }\n return;\n }\n case \"msg\": {\n const message = frame.m;\n if (message.seq > this.#last) this.#last = message.seq;\n for (const sub of this.#messages)\n if (message.seq > sub.last) {\n sub.last = message.seq;\n sub.pump.push(message);\n }\n return;\n }\n case \"pres\": {\n const members = this.#members ?? new Map<string, Member>();\n this.#members = members;\n const known = members.get(frame.member.id);\n if (frame.op === \"leave\") {\n if (known === undefined) return;\n members.delete(frame.member.id);\n } else {\n if (known !== undefined && known.v >= frame.member.v && frame.op === \"join\") return;\n if (known !== undefined && known.v > frame.member.v) return;\n members.set(frame.member.id, frame.member);\n }\n this.#fanPresence({ channel: this.channel, op: frame.op, member: frame.member });\n return;\n }\n case \"more\":\n this.#resume(attempt);\n return;\n case \"bye\":\n this.#down(attempt, new RealtimeError(\"unavailable\", frame.why));\n return;\n }\n }\n\n #fanPresence(event: PresenceEvent): void {\n for (const sub of this.#presence) sub.pump.push(event);\n }\n\n // --- ending --------------------------------------------------------------------------------------------------------\n\n /** Ends the link: stops every listener, cancels timers and closes the socket. */\n dispose(reason: unknown): void {\n if (this.#state === \"disposed\") return;\n this.#state = \"disposed\";\n this.#attempt += 1;\n this.#cancelRetry?.();\n this.#cancelConnect?.();\n this.#cancelKeep?.();\n this.#cancelRetry = undefined;\n this.#cancelConnect = undefined;\n this.#cancelKeep = undefined;\n const socket = this.#socket;\n const owner = this.#closeOwner;\n this.#socket = undefined;\n this.#closeOwner = undefined;\n this.#closeSocket(socket, owner);\n this.#ready.reject(reason);\n for (const sub of this.#messages) sub.pump.stop();\n for (const sub of this.#presence) sub.pump.stop();\n this.#messages.clear();\n this.#presence.clear();\n this.#host.forget(this);\n }\n}\n"],"mappings":"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"}
|
package/dist/prod/memory.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
function
|
|
1
|
+
const e=4096;function t(t={}){let n=t.now??Date.now,r=t.idleMs??36e5,i=(e,n)=>{try{t.onError===void 0?console.error(`[realtime] memory adapter`,n,e):t.onError(e,n)}catch(e){console.error(`[realtime] memory adapter onError`,e)}},a=1024,o=/* @__PURE__ */ new Map,s=/* @__PURE__ */ new Map,c=/* @__PURE__ */ new Map,l=[],u=!1,d=!1;function f(){let e=n()-r;for(let[t,n]of o)n.listeners.size===0&&n.lastActive<e&&(_(n,n.log.length,r),n.log.length===0&&o.delete(t));a=Math.max(1024,o.size*2)}function p(t){let r=o.get(t);return r===void 0&&(o.size>=a&&f(),r={lastActive:n(),seq:0,log:[],keys:/* @__PURE__ */ new Map,keysSweepAt:e,listeners:/* @__PURE__ */ new Set,pending:[],draining:!1},o.set(t,r)),r.lastActive=n(),r}function m(e,t,n){for(let r of[...e])try{r(t)}catch(e){i(e,n)}}function h(e,t){if(!e.draining){e.draining=!0;try{for(let n=e.pending.shift();n!==void 0;n=e.pending.shift())m(e.listeners,n,{where:`listener`,channel:t})}finally{e.draining=!1}}}function g(e){if(l.push(e),!u){u=!0;try{for(let e=l.shift();e!==void 0;e=l.shift())m(c.get(e.channel)??[],e,{where:`presenceListener`,channel:e.channel})}finally{u=!1}}}function _(e,t,r){let i=n()-r,a=Math.max(0,e.log.length-t);for(;a<e.log.length&&(e.log[a]?.at??1/0)<i;)a+=1;a>0&&(e.log=e.log.slice(a))}function v(e){let t=s.get(e);return t===void 0&&(t=/* @__PURE__ */ new Map,s.set(e,t)),t}function y(){if(d)throw Error(`REALTIME_CLOSED`)}return{async publish(t,r,i){y();let a=p(t),o=n();if(i.key!==void 0){let t=a.keys.get(i.key);if(t!==void 0&&t.expires>o)return{seq:t.seq,duplicate:!0};let{keys:n}=a;if(n.size>=a.keysSweepAt){for(let[e,t]of n)t.expires<=o&&n.delete(e);a.keysSweepAt=Math.max(e,n.size*2)}for(let e of n.keys()){if(n.size<65536)break;n.delete(e)}}a.seq+=1;let s={...r,seq:a.seq,at:o};return i.key!==void 0&&a.keys.set(i.key,{seq:a.seq,expires:o+i.idempotencyTtlMs}),i.history>0?(a.log.push(s),_(a,i.history,i.historyTtlMs)):a.log=[],a.pending.push(s),h(a,t),{seq:s.seq,duplicate:!1}},async subscribe(e,t){y();let n=p(e);return n.listeners.add(t),async()=>{n.listeners.delete(t)}},async history(e,t,n){y();let r=o.get(e);if(r===void 0)return{messages:[],head:0,oldest:0};let i=r.log,a=[];for(let e of i){if(a.length>=n)break;e.seq>t&&a.push(e)}return{messages:a,head:r.seq,oldest:i[0]?.seq??0}},async presenceSet(e,t,r){y();let i=v(e),a=i.get(t.id);a!==void 0&&a.member.v>t.v||(i.set(t.id,{member:t,expires:n()+r}),a===void 0?g({channel:e,op:`join`,member:t}):a.member.v<t.v&&g({channel:e,op:`set`,member:t}))},async presenceRemove(e,t){y();let n=s.get(e),r=n?.get(t);return n===void 0||r===void 0?!1:(n.delete(t),n.size===0&&s.delete(e),g({channel:e,op:`leave`,member:r.member}),!0)},async presenceList(e){y();let t=n(),r=[];for(let n of s.get(e)?.values()??[])n.expires>t&&r.push(n.member);return r},async presenceTouch(e,t){y();let r=n()+t,i=[];for(let t of e){let e=s.get(t.channel)?.get(t.id);e===void 0?i.push(t):e.expires=r}return i},async presenceReap(e){y();let t=s.get(e);if(t===void 0)return[];let r=n(),i=[];for(let[n,a]of[...t])a.expires>r||(t.delete(n),i.push(a.member),g({channel:e,op:`leave`,member:a.member}));return t.size===0&&s.delete(e),i},async presenceSubscribe(e,t){y();let n=c.get(e);n===void 0&&(n=/* @__PURE__ */ new Set,c.set(e,n)),n.add(t);let r=n;return async()=>{r.delete(t),r.size===0&&c.get(e)===r&&c.delete(e)}},async close(){d=!0,o.clear(),s.clear(),c.clear()}}}export{t as memoryAdapter};
|
|
2
2
|
//# sourceMappingURL=memory.js.map
|
package/dist/prod/memory.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"memory.js","names":["memoryAdapter","now","options","idleMs","sweepAt","channels","presence","presenceListeners","presenceQueue","presenceDraining","closed","sweep","cutoff","name","state","trim","channelOf","drain","next","listener","emitPresence","event","ttl","drop","history","live","set","check","channel","at","publish","known","key","value","message","entry","retained","messages","limit","after","member","ttlMs","id","out","expires","missing","ref","entries","removed","owner"],"sources":["../../src/memory.ts"],"sourcesContent":["import type {\n Adapter,\n HistoryResult,\n PresenceRef,\n PublishOptions,\n PublishResult,\n Unsubscribe,\n} from \"./adapter\";\nimport type { Member, PresenceEvent, StoredEntry, StoredMessage } from \"./protocol\";\n\ninterface ChannelState {\n seq: number;\n log: StoredMessage[];\n readonly keys: Map<string, { readonly seq: number; readonly expires: number }>;\n readonly listeners: Set<(message: StoredMessage) => void>;\n readonly pending: StoredMessage[];\n draining: boolean;\n lastActive: number;\n}\n\ninterface PresenceEntry {\n member: Member;\n expires: number;\n}\n\n/**\n * Options of {@link memoryAdapter}.\n * @since 1.0.0\n */\nexport interface MemoryAdapterOptions {\n /** The clock, in epoch milliseconds. Default: `Date.now`. */\n readonly now?: () => number;\n /**\n * Milliseconds a channel with no listener and no retained message is remembered. After that its head is forgotten and its\n * numbering restarts, which a resuming client sees as `reset`. Default: one hour.\n */\n readonly idleMs?: number;\n}\n\n/**\n * The single-process adapter, and the default of `createHub`. Messages, history, idempotency keys and presence live in memory\n * of this process; several hubs created over one adapter object share them, which is how tests exercise two servers. Use the Redis\n * or Cloudflare adapter when more than one process serves clients.\n *\n * @param options The clock.\n * @returns The adapter.\n * @example\n * import { createHub, memoryAdapter } from \"@shadow-js/realtime/server\";\n *\n * const adapter = memoryAdapter();\n * const hub = createHub({ adapter });\n * void hub.close();\n * @since 1.0.0\n */\nexport function memoryAdapter(options: MemoryAdapterOptions = {}): Adapter {\n const now = options.now ?? Date.now;\n const idleMs = options.idleMs ?? 3_600_000;\n let sweepAt = 1024;\n const channels = new Map<string, ChannelState>();\n const presence = new Map<string, Map<string, PresenceEntry>>();\n const presenceListeners = new Map<string, Set<(event: PresenceEvent) => void>>();\n const presenceQueue: PresenceEvent[] = [];\n let presenceDraining = false;\n let closed = false;\n\n /** Forgets channels nobody listens to and nothing retains; runs when the table has doubled since the last sweep. */\n function sweep(): void {\n const cutoff = now() - idleMs;\n for (const [name, state] of channels)\n if (state.listeners.size === 0 && state.lastActive < cutoff) {\n trim(state, state.log.length, idleMs);\n if (state.log.length === 0) channels.delete(name);\n }\n sweepAt = Math.max(1024, channels.size * 2);\n }\n\n function channelOf(name: string): ChannelState {\n let state = channels.get(name);\n if (state === undefined) {\n if (channels.size >= sweepAt) sweep();\n state = {\n lastActive: now(),\n seq: 0,\n log: [],\n keys: new Map(),\n listeners: new Set(),\n pending: [],\n draining: false,\n };\n channels.set(name, state);\n }\n state.lastActive = now();\n return state;\n }\n\n /** Delivers queued messages in order; a listener that publishes in turn queues behind the message being delivered. */\n function drain(state: ChannelState): void {\n if (state.draining) return;\n state.draining = true;\n try {\n for (let next = state.pending.shift(); next !== undefined; next = state.pending.shift()) {\n for (const listener of [...state.listeners]) {\n try {\n listener(next);\n } catch {\n // A listener's failure is its own: delivery to the others goes on (guarantee G13).\n }\n }\n }\n } finally {\n state.draining = false;\n }\n }\n\n function emitPresence(event: PresenceEvent): void {\n presenceQueue.push(event);\n if (presenceDraining) return;\n presenceDraining = true;\n try {\n for (let next = presenceQueue.shift(); next !== undefined; next = presenceQueue.shift()) {\n for (const listener of [...(presenceListeners.get(next.channel) ?? [])]) {\n try {\n listener(next);\n } catch {\n // See `drain`.\n }\n }\n }\n } finally {\n presenceDraining = false;\n }\n }\n\n function trim(state: ChannelState, history: number, ttl: number): void {\n const cutoff = now() - ttl;\n let drop = Math.max(0, state.log.length - history);\n while (drop < state.log.length && (state.log[drop]?.at ?? Infinity) < cutoff) drop += 1;\n if (drop > 0) state.log = state.log.slice(drop);\n }\n\n function live(name: string): Map<string, PresenceEntry> {\n let set = presence.get(name);\n if (set === undefined) {\n set = new Map();\n presence.set(name, set);\n }\n return set;\n }\n\n function check(): void {\n if (closed) throw new Error(\"the adapter is closed.\");\n }\n\n return {\n async publish(\n channel: string,\n entry: StoredEntry,\n publish: PublishOptions,\n ): Promise<PublishResult> {\n check();\n const state = channelOf(channel);\n const at = now();\n if (publish.key !== undefined) {\n const known = state.keys.get(publish.key);\n if (known !== undefined && known.expires > at) return { seq: known.seq, duplicate: true };\n // Expired keys are swept when a new one is added, so the map stays bounded by the rate of publishes.\n if (state.keys.size >= 4096)\n for (const [key, value] of state.keys) if (value.expires <= at) state.keys.delete(key);\n }\n state.seq += 1;\n const message: StoredMessage = { ...entry, seq: state.seq, at };\n if (publish.key !== undefined)\n state.keys.set(publish.key, {\n seq: state.seq,\n expires: at + publish.idempotencyTtlMs,\n });\n if (publish.history > 0) {\n state.log.push(message);\n trim(state, publish.history, publish.historyTtlMs);\n } else {\n state.log = [];\n }\n state.pending.push(message);\n drain(state);\n return { seq: message.seq, duplicate: false };\n },\n\n async subscribe(\n channel: string,\n listener: (message: StoredMessage) => void,\n ): Promise<Unsubscribe> {\n check();\n const state = channelOf(channel);\n state.listeners.add(listener);\n return async () => {\n state.listeners.delete(listener);\n };\n },\n\n async history(channel: string, after: number, limit: number): Promise<HistoryResult> {\n check();\n const state = channels.get(channel);\n if (state === undefined) return { messages: [], head: 0, oldest: 0 };\n const retained = state.log;\n const messages: StoredMessage[] = [];\n for (const message of retained) {\n if (messages.length >= limit) break;\n if (message.seq > after) messages.push(message);\n }\n return { messages, head: state.seq, oldest: retained[0]?.seq ?? 0 };\n },\n\n async presenceSet(channel: string, member: Member, ttlMs: number): Promise<void> {\n check();\n const set = live(channel);\n const known = set.get(member.id);\n if (known !== undefined && known.member.v > member.v) return;\n set.set(member.id, { member, expires: now() + ttlMs });\n if (known === undefined) emitPresence({ channel, op: \"join\", member });\n else if (known.member.v < member.v) emitPresence({ channel, op: \"set\", member });\n },\n\n async presenceRemove(channel: string, id: string): Promise<boolean> {\n check();\n const set = presence.get(channel);\n const known = set?.get(id);\n if (set === undefined || known === undefined) return false;\n set.delete(id);\n if (set.size === 0) presence.delete(channel);\n emitPresence({ channel, op: \"leave\", member: known.member });\n return true;\n },\n\n async presenceList(channel: string): Promise<readonly Member[]> {\n check();\n const at = now();\n const out: Member[] = [];\n for (const entry of presence.get(channel)?.values() ?? [])\n if (entry.expires > at) out.push(entry.member);\n return out;\n },\n\n async presenceTouch(entries, ttlMs): Promise<readonly PresenceRef[]> {\n check();\n const expires = now() + ttlMs;\n const missing: PresenceRef[] = [];\n for (const ref of entries) {\n const entry = presence.get(ref.channel)?.get(ref.id);\n if (entry === undefined) missing.push(ref);\n else entry.expires = expires;\n }\n return missing;\n },\n\n async presenceReap(channel: string): Promise<readonly Member[]> {\n check();\n const set = presence.get(channel);\n if (set === undefined) return [];\n const at = now();\n const removed: Member[] = [];\n for (const [id, entry] of [...set]) {\n if (entry.expires > at) continue;\n set.delete(id);\n removed.push(entry.member);\n emitPresence({ channel, op: \"leave\", member: entry.member });\n }\n if (set.size === 0) presence.delete(channel);\n return removed;\n },\n\n async presenceSubscribe(\n channel: string,\n listener: (event: PresenceEvent) => void,\n ): Promise<Unsubscribe> {\n check();\n let set = presenceListeners.get(channel);\n if (set === undefined) {\n set = new Set();\n presenceListeners.set(channel, set);\n }\n set.add(listener);\n const owner = set;\n return async () => {\n owner.delete(listener);\n if (owner.size === 0 && presenceListeners.get(channel) === owner)\n presenceListeners.delete(channel);\n };\n },\n\n async close(): Promise<void> {\n closed = true;\n channels.clear();\n presence.clear();\n presenceListeners.clear();\n },\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"memory.js","names":["KEYS_SWEEP_FROM","memoryAdapter","now","options","idleMs","report","context","error","reporter","sweepAt","channels","presence","presenceListeners","presenceQueue","presenceDraining","closed","sweep","cutoff","name","state","trim","channelOf","deliver","listener","listeners","value","drain","next","emitPresence","event","ttl","drop","history","live","set","check","channel","at","publish","known","keys","key","message","entry","retained","messages","limit","after","member","ttlMs","id","out","expires","missing","ref","entries","removed","owner"],"sources":["../../src/memory.ts"],"sourcesContent":["import type {\n Adapter,\n HistoryResult,\n PresenceRef,\n PublishOptions,\n PublishResult,\n Unsubscribe,\n} from \"./adapter\";\nimport type { Member, PresenceEvent, StoredEntry, StoredMessage } from \"./protocol\";\n\ninterface ChannelState {\n seq: number;\n log: StoredMessage[];\n readonly keys: Map<string, { readonly seq: number; readonly expires: number }>;\n /** The size of `keys` at which expired entries are swept next. */\n keysSweepAt: number;\n readonly listeners: Set<(message: StoredMessage) => void>;\n readonly pending: StoredMessage[];\n draining: boolean;\n lastActive: number;\n}\n\n/** The most idempotency keys one channel remembers; past it the oldest are forgotten, which only lets a very old resend through. */\nconst MAX_KEYS = 65_536;\nconst KEYS_SWEEP_FROM = 4096;\n\ninterface PresenceEntry {\n member: Member;\n expires: number;\n}\n\n/**\n * Options of {@link memoryAdapter}.\n * @since 1.0.0\n */\nexport interface MemoryAdapterOptions {\n /** The clock, in epoch milliseconds. Default: `Date.now`. */\n readonly now?: () => number;\n /**\n * Milliseconds a channel with no listener and no retained message is remembered. After that its head is forgotten and its\n * numbering restarts, which a resuming client sees as `reset`. Default: one hour.\n */\n readonly idleMs?: number;\n /**\n * Receives a listener's failure (a message or presence listener that threw). Delivery to the other listeners goes on either\n * way. `createHub` passes its own `onError` here. Default: `console.error`, so a bug in a listener is never silent.\n */\n readonly onError?: (error: unknown, context: MemoryErrorContext) => void;\n}\n\n/** Where an error reported by the memory adapter came from. @since 1.0.0 */\nexport interface MemoryErrorContext {\n /** `\"listener\"` (a message listener) or `\"presenceListener\"`. */\n readonly where: \"listener\" | \"presenceListener\";\n readonly channel: string;\n}\n\n/**\n * The single-process adapter, and the default of `createHub`. Messages, history, idempotency keys and presence live in memory\n * of this process; several hubs created over one adapter object share them, which is how tests exercise two servers. Use the Redis\n * or Cloudflare adapter when more than one process serves clients.\n *\n * @param options The clock.\n * @returns The adapter.\n * @example\n * import { createHub, memoryAdapter } from \"@shadow-js/realtime/server\";\n *\n * const adapter = memoryAdapter();\n * const hub = createHub({ adapter });\n * void hub.close();\n * @since 1.0.0\n */\nexport function memoryAdapter(options: MemoryAdapterOptions = {}): Adapter {\n const now = options.now ?? Date.now;\n const idleMs = options.idleMs ?? 3_600_000;\n const report = (error: unknown, context: MemoryErrorContext): void => {\n try {\n if (options.onError === undefined) console.error(\"[realtime] memory adapter\", context, error);\n else options.onError(error, context);\n } catch (reporter) {\n // A reporter that throws must not stop delivery; its failure is the last resort for the console.\n console.error(\"[realtime] memory adapter onError\", reporter);\n }\n };\n let sweepAt = 1024;\n const channels = new Map<string, ChannelState>();\n const presence = new Map<string, Map<string, PresenceEntry>>();\n const presenceListeners = new Map<string, Set<(event: PresenceEvent) => void>>();\n const presenceQueue: PresenceEvent[] = [];\n let presenceDraining = false;\n let closed = false;\n\n /** Forgets channels nobody listens to and nothing retains; runs when the table has doubled since the last sweep. */\n function sweep(): void {\n const cutoff = now() - idleMs;\n for (const [name, state] of channels)\n if (state.listeners.size === 0 && state.lastActive < cutoff) {\n trim(state, state.log.length, idleMs);\n if (state.log.length === 0) channels.delete(name);\n }\n sweepAt = Math.max(1024, channels.size * 2);\n }\n\n function channelOf(name: string): ChannelState {\n let state = channels.get(name);\n if (state === undefined) {\n if (channels.size >= sweepAt) sweep();\n state = {\n lastActive: now(),\n seq: 0,\n log: [],\n keys: new Map(),\n keysSweepAt: KEYS_SWEEP_FROM,\n listeners: new Set(),\n pending: [],\n draining: false,\n };\n channels.set(name, state);\n }\n state.lastActive = now();\n return state;\n }\n\n /** Calls each listener with `value`. A listener's failure is its own: delivery to the others goes on (guarantee G13). */\n function deliver<T>(\n listeners: Iterable<(value: T) => void>,\n value: T,\n context: MemoryErrorContext,\n ): void {\n for (const listener of [...listeners]) {\n try {\n listener(value);\n } catch (error) {\n report(error, context);\n }\n }\n }\n\n /** Delivers queued messages in order; a listener that publishes in turn queues behind the message being delivered. */\n function drain(state: ChannelState, channel: string): void {\n if (state.draining) return;\n state.draining = true;\n try {\n for (let next = state.pending.shift(); next !== undefined; next = state.pending.shift()) {\n deliver(state.listeners, next, { where: \"listener\", channel });\n }\n } finally {\n state.draining = false;\n }\n }\n\n function emitPresence(event: PresenceEvent): void {\n presenceQueue.push(event);\n if (presenceDraining) return;\n presenceDraining = true;\n try {\n for (let next = presenceQueue.shift(); next !== undefined; next = presenceQueue.shift()) {\n deliver(presenceListeners.get(next.channel) ?? [], next, {\n where: \"presenceListener\",\n channel: next.channel,\n });\n }\n } finally {\n presenceDraining = false;\n }\n }\n\n function trim(state: ChannelState, history: number, ttl: number): void {\n const cutoff = now() - ttl;\n let drop = Math.max(0, state.log.length - history);\n while (drop < state.log.length && (state.log[drop]?.at ?? Infinity) < cutoff) drop += 1;\n if (drop > 0) state.log = state.log.slice(drop);\n }\n\n function live(name: string): Map<string, PresenceEntry> {\n let set = presence.get(name);\n if (set === undefined) {\n set = new Map();\n presence.set(name, set);\n }\n return set;\n }\n\n function check(): void {\n if (closed) throw new Error(__DEV__ ? \"the adapter is closed.\" : \"REALTIME_CLOSED\");\n }\n\n return {\n async publish(\n channel: string,\n entry: StoredEntry,\n publish: PublishOptions,\n ): Promise<PublishResult> {\n check();\n const state = channelOf(channel);\n const at = now();\n if (publish.key !== undefined) {\n const known = state.keys.get(publish.key);\n if (known !== undefined && known.expires > at) return { seq: known.seq, duplicate: true };\n // Expired keys are swept each time the map has doubled, so a sweep costs a publish little; the cap holds when none expired.\n const { keys } = state;\n if (keys.size >= state.keysSweepAt) {\n for (const [key, value] of keys) if (value.expires <= at) keys.delete(key);\n state.keysSweepAt = Math.max(KEYS_SWEEP_FROM, keys.size * 2);\n }\n for (const key of keys.keys()) {\n if (keys.size < MAX_KEYS) break;\n keys.delete(key);\n }\n }\n state.seq += 1;\n const message: StoredMessage = { ...entry, seq: state.seq, at };\n if (publish.key !== undefined)\n state.keys.set(publish.key, {\n seq: state.seq,\n expires: at + publish.idempotencyTtlMs,\n });\n if (publish.history > 0) {\n state.log.push(message);\n trim(state, publish.history, publish.historyTtlMs);\n } else {\n state.log = [];\n }\n state.pending.push(message);\n drain(state, channel);\n return { seq: message.seq, duplicate: false };\n },\n\n async subscribe(\n channel: string,\n listener: (message: StoredMessage) => void,\n ): Promise<Unsubscribe> {\n check();\n const state = channelOf(channel);\n state.listeners.add(listener);\n return async () => {\n state.listeners.delete(listener);\n };\n },\n\n async history(channel: string, after: number, limit: number): Promise<HistoryResult> {\n check();\n const state = channels.get(channel);\n if (state === undefined) return { messages: [], head: 0, oldest: 0 };\n const retained = state.log;\n const messages: StoredMessage[] = [];\n for (const message of retained) {\n if (messages.length >= limit) break;\n if (message.seq > after) messages.push(message);\n }\n return { messages, head: state.seq, oldest: retained[0]?.seq ?? 0 };\n },\n\n async presenceSet(channel: string, member: Member, ttlMs: number): Promise<void> {\n check();\n const set = live(channel);\n const known = set.get(member.id);\n if (known !== undefined && known.member.v > member.v) return;\n set.set(member.id, { member, expires: now() + ttlMs });\n if (known === undefined) emitPresence({ channel, op: \"join\", member });\n else if (known.member.v < member.v) emitPresence({ channel, op: \"set\", member });\n },\n\n async presenceRemove(channel: string, id: string): Promise<boolean> {\n check();\n const set = presence.get(channel);\n const known = set?.get(id);\n if (set === undefined || known === undefined) return false;\n set.delete(id);\n if (set.size === 0) presence.delete(channel);\n emitPresence({ channel, op: \"leave\", member: known.member });\n return true;\n },\n\n async presenceList(channel: string): Promise<readonly Member[]> {\n check();\n const at = now();\n const out: Member[] = [];\n for (const entry of presence.get(channel)?.values() ?? [])\n if (entry.expires > at) out.push(entry.member);\n return out;\n },\n\n async presenceTouch(entries, ttlMs): Promise<readonly PresenceRef[]> {\n check();\n const expires = now() + ttlMs;\n const missing: PresenceRef[] = [];\n for (const ref of entries) {\n const entry = presence.get(ref.channel)?.get(ref.id);\n if (entry === undefined) missing.push(ref);\n else entry.expires = expires;\n }\n return missing;\n },\n\n async presenceReap(channel: string): Promise<readonly Member[]> {\n check();\n const set = presence.get(channel);\n if (set === undefined) return [];\n const at = now();\n const removed: Member[] = [];\n for (const [id, entry] of [...set]) {\n if (entry.expires > at) continue;\n set.delete(id);\n removed.push(entry.member);\n emitPresence({ channel, op: \"leave\", member: entry.member });\n }\n if (set.size === 0) presence.delete(channel);\n return removed;\n },\n\n async presenceSubscribe(\n channel: string,\n listener: (event: PresenceEvent) => void,\n ): Promise<Unsubscribe> {\n check();\n let set = presenceListeners.get(channel);\n if (set === undefined) {\n set = new Set();\n presenceListeners.set(channel, set);\n }\n set.add(listener);\n const owner = set;\n return async () => {\n owner.delete(listener);\n if (owner.size === 0 && presenceListeners.get(channel) === owner)\n presenceListeners.delete(channel);\n };\n },\n\n async close(): Promise<void> {\n closed = true;\n channels.clear();\n presence.clear();\n presenceListeners.clear();\n },\n };\n}\n"],"mappings":"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"}
|
package/dist/prod/protocol.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=1,t=/^[A-Za-z0-9_.:/@-]{1,128}$/,n=/^[A-Za-z0-9_.:@-]{1,64}$/,r
|
|
1
|
+
const e=1,t=/^[A-Za-z0-9_.:/@-]{1,128}$/,n=/^[A-Za-z0-9_.:@-]{1,64}$/,r=new TextEncoder;function i(e){return typeof e==`string`&&t.test(e)}function a(e){return typeof e==`string`&&n.test(e)}function o(e){return typeof e==`string`&&n.test(e)}function s(e){if(e.length*3<=2147483647){let t=!0;for(let n=0;n<e.length;n+=1)if(e.charCodeAt(n)>127){t=!1;break}if(t)return e.length}return r.encode(e).length}function c(e){return typeof e==`number`&&Number.isSafeInteger(e)&&e>=0}function l(e,t){return{ok:!1,code:`bad_frame`,why:e,...c(t)?{n:t}:{}}}function u(e,t){if(s(e)>t)return{ok:!1,code:`too_large`,why:`REALTIME_FRAME_11`};let n;try{n=JSON.parse(e)}catch{return l(`REALTIME_FRAME_5`)}if(typeof n!=`object`||!n||Array.isArray(n))return l(`REALTIME_FRAME_10`);let r=n,u=r.t,d=r.n;if(d!==void 0&&!c(d))return l(`REALTIME_FRAME_8`);let f=r.c,p=()=>i(f)?void 0:{...l(`REALTIME_FRAME_2`,d),code:`bad_channel`};switch(u){case`hello`:{let e=r.v;return typeof e!=`number`||!Number.isInteger(e)||e<1?l(`REALTIME_FRAME_13`):{ok:!0,frame:{t:`hello`,v:e}}}case`ping`:return{ok:!0,frame:d===void 0?{t:`ping`}:{t:`ping`,n:d}};case`sub`:{let e=p();if(e!==void 0)return e;if(d===void 0)return l(`REALTIME_FRAME_9`);let t=r.after;if(t!==void 0&&!c(t))return l(`REALTIME_FRAME_1`,d);let n=r.echo;if(n!==void 0&&typeof n!=`boolean`)return l(`REALTIME_FRAME_3`,d);let i=r.watch;if(i!==void 0&&typeof i!=`boolean`)return l(`REALTIME_FRAME_14`,d);let a=`presence`in r;return{ok:!0,frame:{t:`sub`,n:d,c:f,hasPresence:a,...t===void 0?{}:{after:t},...n===void 0?{}:{echo:n},...i===void 0?{}:{watch:i},...a?{presence:r.presence}:{}}}}case`unsub`:{let e=p();return e===void 0?{ok:!0,frame:d===void 0?{t:`unsub`,c:f}:{t:`unsub`,n:d,c:f}}:e}case`pub`:{let e=p();if(e!==void 0)return e;let t=r.e;if(!a(t))return l(`REALTIME_FRAME_4`,d);let n=r.k;return n!==void 0&&!o(n)?l(`REALTIME_FRAME_6`,d):{ok:!0,frame:{t:`pub`,c:f,e:t,d:JSON.stringify(r.d??null),...d===void 0?{}:{n:d},...n===void 0?{}:{k:n}}}}case`req`:{let e=p();if(e!==void 0)return e;if(d===void 0)return l(`REALTIME_FRAME_9`);let t=r.e;if(!a(t))return l(`REALTIME_FRAME_4`,d);let n=r.ms;return n!==void 0&&!(typeof n==`number`&&Number.isFinite(n)&&n>0)?l(`REALTIME_FRAME_7`,d):{ok:!0,frame:{t:`req`,n:d,c:f,e:t,d:r.d??null,...n===void 0?{}:{ms:n}}}}case`pres`:{let e=p();return e===void 0?{ok:!0,frame:{t:`pres`,c:f,s:r.s??null}}:e}default:return l(`REALTIME_FRAME_12`,d)}}function d(e){try{return f(JSON.parse(e))}catch{return}}function f(e){if(typeof e!=`object`||!e||Array.isArray(e))return;let t=e,n=e=>{let n=t[e];return typeof n==`string`?n:void 0},r=e=>{let n=t[e];return c(n)?n:void 0};switch(t.t){case`ready`:{let e=r(`v`),t=n(`id`);return e===void 0||t===void 0?void 0:{t:`ready`,v:e,id:t,hb:r(`hb`)??3e4,max:r(`max`)??65536}}case`subbed`:{let e=r(`n`),i=n(`c`),a=r(`head`);return e===void 0||i===void 0||a===void 0?void 0:{t:`subbed`,n:e,c:i,head:a,...t.gap===!0?{gap:!0}:{},...t.reset===!0?{reset:!0}:{}}}case`unsubbed`:{let e=n(`c`);if(e===void 0)return;let t=n(`why`);return t===void 0?{t:`unsubbed`,c:e}:{t:`unsubbed`,c:e,why:t}}case`msg`:{let e=n(`c`),i=r(`s`),a=n(`e`);if(e===void 0||i===void 0||a===void 0||i<1)return;let o=n(`p`),s=n(`u`);return{t:`msg`,c:e,s:i,e:a,d:t.d,...o===void 0?{}:{p:o},...s===void 0?{}:{u:s},...t.r===1?{r:1}:{}}}case`ack`:{let e=r(`n`),n=r(`s`);return e===void 0||n===void 0?void 0:{t:`ack`,n:e,s:n,...t.dup===!0?{dup:!0}:{}}}case`rep`:{let e=r(`n`);return e===void 0?void 0:{t:`rep`,n:e,d:t.d}}case`err`:{let e=n(`code`);if(e===void 0)return;let t=r(`n`),i=n(`c`),a=n(`msg`);return{t:`err`,code:e,...t===void 0?{}:{n:t},...i===void 0?{}:{c:i},...a===void 0?{}:{msg:a}}}case`pres`:{let e=n(`c`),r=t.op,i=t.m;if(e===void 0||r!==`sync`&&r!==`join`&&r!==`set`&&r!==`leave`)return;let a=e=>{if(typeof e!=`object`||!e)return;let t=e;if(typeof t.id==`string`&&c(t.v))return{id:t.id,v:t.v,s:t.s??null,...typeof t.u==`string`?{u:t.u}:{}}};if(r===`sync`){if(!Array.isArray(i))return;let t=i.map(a);return t.some(e=>e===void 0)?void 0:{t:`pres`,c:e,op:r,m:t}}let o=a(i);return o===void 0?void 0:{t:`pres`,c:e,op:r,m:o}}case`pong`:{let e=r(`n`);return e===void 0?{t:`pong`}:{t:`pong`,n:e}}case`bye`:{let e=r(`code`);return e===void 0?void 0:{t:`bye`,code:e,why:n(`why`)??``}}default:return}}export{e as PROTOCOL_VERSION,s as byteLength,u as decodeClientFrame,d as decodeServerFrame,i as isChannelName,a as isEventName,o as isIdempotencyKey,f as serverFrameOf};
|
|
2
2
|
//# sourceMappingURL=protocol.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"protocol.js","names":["PROTOCOL_VERSION","CHANNEL","EVENT","KEY","encoder","isChannelName","value","isEventName","isIdempotencyKey","byteLength","text","ascii","at","isCount","bad","n","decodeClientFrame","maxBytes","raw","type","\"t\"","\"n\"","c","\"c\"","needChannel","v","\"v\"","refusal","after","\"after\"","echo","\"echo\"","watch","\"watch\"","hasPresence","\"presence\"","e","\"e\"","k","\"k\"","\"d\"","ms","\"ms\"","\"s\"","decodeServerFrame","str","item","key","num","id","head","\"gap\"","\"reset\"","why","s","p","u","\"r\"","\"dup\"","code","msg","op","\"op\"","m","\"m\"","member","entry","\"id\"","\"u\"","list","one"],"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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"}
|
|
1
|
+
{"version":3,"file":"protocol.js","names":["PROTOCOL_VERSION","CHANNEL","EVENT","encoder","isChannelName","value","isEventName","isIdempotencyKey","byteLength","text","ascii","at","isCount","bad","n","decodeClientFrame","maxBytes","raw","type","\"t\"","\"n\"","c","\"c\"","needChannel","v","\"v\"","refusal","after","\"after\"","echo","\"echo\"","watch","\"watch\"","hasPresence","\"presence\"","e","\"e\"","k","\"k\"","\"d\"","ms","\"ms\"","\"s\"","decodeServerFrame","serverFrameOf","str","item","key","num","id","head","\"gap\"","\"reset\"","why","s","p","u","\"r\"","\"dup\"","code","msg","op","\"op\"","m","\"m\"","member","entry","\"id\"","\"u\"","list","one"],"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}$/;\n// Event names and idempotency keys share one shape.\nconst EVENT = /^[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\" && EVENT.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 { ok: false, code: \"bad_frame\", why, ...(isCount(n) ? { n } : {}) };\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 {\n ok: false,\n code: \"too_large\",\n why: __DEV__ ? \"the frame is larger than the limit\" : \"REALTIME_FRAME_11\",\n };\n let value: unknown;\n try {\n value = JSON.parse(text);\n } catch {\n return bad(__DEV__ ? \"the frame is not JSON\" : \"REALTIME_FRAME_5\");\n }\n if (value === null || typeof value !== \"object\" || Array.isArray(value))\n return bad(__DEV__ ? \"the frame is not an object\" : \"REALTIME_FRAME_10\");\n const raw = value as Record<string, unknown>;\n const type = raw[\"t\"];\n const n = raw[\"n\"];\n if (n !== undefined && !isCount(n))\n return bad(__DEV__ ? \"n must be a non-negative integer\" : \"REALTIME_FRAME_8\");\n const c = raw[\"c\"];\n const needChannel = (): Refusal | undefined =>\n isChannelName(c)\n ? undefined\n : {\n ...bad(__DEV__ ? \"c is not a valid channel name\" : \"REALTIME_FRAME_2\", n),\n code: \"bad_channel\",\n };\n switch (type) {\n case \"hello\": {\n const v = raw[\"v\"];\n if (typeof v !== \"number\" || !Number.isInteger(v) || v < 1)\n return bad(__DEV__ ? \"v must be a version\" : \"REALTIME_FRAME_13\");\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(__DEV__ ? \"sub needs n\" : \"REALTIME_FRAME_9\");\n const after = raw[\"after\"];\n if (after !== undefined && !isCount(after))\n return bad(__DEV__ ? \"after must be a non-negative integer\" : \"REALTIME_FRAME_1\", n);\n const echo = raw[\"echo\"];\n if (echo !== undefined && typeof echo !== \"boolean\")\n return bad(__DEV__ ? \"echo must be a boolean\" : \"REALTIME_FRAME_3\", n);\n const watch = raw[\"watch\"];\n if (watch !== undefined && typeof watch !== \"boolean\")\n return bad(__DEV__ ? \"watch must be a boolean\" : \"REALTIME_FRAME_14\", 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))\n return bad(__DEV__ ? \"e is not a valid event name\" : \"REALTIME_FRAME_4\", n);\n const k = raw[\"k\"];\n if (k !== undefined && !isIdempotencyKey(k))\n return bad(__DEV__ ? \"k is not a valid key\" : \"REALTIME_FRAME_6\", 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(__DEV__ ? \"req needs n\" : \"REALTIME_FRAME_9\");\n const e = raw[\"e\"];\n if (!isEventName(e))\n return bad(__DEV__ ? \"e is not a valid event name\" : \"REALTIME_FRAME_4\", n);\n const ms = raw[\"ms\"];\n if (ms !== undefined && !(typeof ms === \"number\" && Number.isFinite(ms) && ms > 0))\n return bad(__DEV__ ? \"ms must be a positive number\" : \"REALTIME_FRAME_7\", 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(__DEV__ ? \"unknown frame type\" : \"REALTIME_FRAME_12\", 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 try {\n return serverFrameOf(JSON.parse(text));\n } catch {\n return undefined;\n }\n}\n\n/**\n * Decodes a server frame that is already parsed (the frames of an HTTP answer arrive inside one JSON document), with the\n * rules of {@link decodeServerFrame}.\n * @internal\n */\nexport function serverFrameOf(value: unknown): ServerFrame | undefined {\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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"}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=[50,250,1e3],t=5e3;function n(e){return new Promise(t=>setTimeout(t,e))}function r(e,t){let n=e.get(t.member.id);return t.op===`leave`?n!==void 0&&e.delete(t.member.id):n!==void 0&&n.v>=t.member.v?!1:(e.set(t.member.id,t.member),!0)}function i(i){let a=/* @__PURE__ */ new Map,o=!1,s,c=!1,l=!1,u,d=[];function f(e,t,n){i.report(e,{where:n,channel:t.channel})}function p(e,t){if(!
|
|
1
|
+
const e=[50,250,1e3],t=5e3;function n(e){return new Promise(t=>setTimeout(t,e))}function r(e,t){let n=e.get(t.member.id);return t.op===`leave`?n!==void 0&&e.delete(t.member.id):n!==void 0&&n.v>=t.member.v?!1:(e.set(t.member.id,t.member),!0)}function i(i){let a=/* @__PURE__ */ new Map,o=!1,s,c=!1,l=!1,u,d=[];function f(e,t,n){i.report(e,{where:n,channel:t.channel})}function p(e,t){if(!e.dead&&!(t.seq<=e.last&&t.at<=e.lastAt)){e.last=t.seq,e.lastAt=Math.max(e.lastAt,t.at);for(let n of[...e.listeners])try{n(t)}catch(t){f(t,e,`listener`)}}}function m(e,t){let n=i.parseMessage(t,e.channel);n===void 0||e.dead||(e.catching||e.last>0&&n.seq>e.last+1?(e.buffer.length>=1e3?e.overflow=!0:e.buffer.push(n),e.catching||v(e)):p(e,n))}function h(e,t){for(let n of[...e.listeners])try{n(t)}catch(t){f(t,e,`listener`)}}function g(e,n){let a=i.parsePresence(n,e.channel);a===void 0||e.dead||(e.pending===void 0?(!e.tracked||r(e.members,a))&&h(e,a):(e.pending.length<t?e.pending.push(a):e.tracked=!1,h(e,a)))}async function _(e){for(;;){let t=!0;for(;t;){let n=await i.history(e.channel,e.last,500);if(e.dead)return;for(let t of n)p(e,t);t=n.length>=500}if(!e.overflow)return;e.overflow=!1,e.buffer.length=0}}async function v(t){if(t.catching)t.rerun=!0;else{t.catching=!0;try{let r=0;for(;!t.dead&&!o;){t.rerun=!1;try{if(await _(t),!t.rerun)return}catch(i){f(i,t,`recover`);let a=e[r];if(r+=1,a===void 0)return;await n(a)}}}finally{t.catching=!1,t.rerun=!1;let e=t.buffer.splice(0);for(let n of e)p(t,n)}}}async function y(e){if(!e.tracked)return;let n=e.members;e.pending=[];let a;try{a=await i.members(e.channel)}catch(t){let i=e.pending;e.pending=void 0;for(let t of i)r(n,t)&&h(e,t);throw t}let o=e.pending;if(e.pending=void 0,e.dead)return;let s=new Map(a.map(e=>[e.id,e]));for(let e of o)r(s,e);let c=[];for(let[t,r]of n)s.has(t)||c.push({channel:e.channel,op:`leave`,member:r});for(let[t,r]of s){let i=n.get(t);i===void 0?c.push({channel:e.channel,op:`join`,member:r}):r.v>i.v&&c.push({channel:e.channel,op:`set`,member:r})}e.members=s,s.size>t&&(e.tracked=!1);for(let t of c)h(e,t)}async function b(t){for(let r=0;;r+=1)try{await(await i.subscriber()).subscribe(t.topic,t.handler),t.kind===`message`?t.last>0&&await v(t):await y(t);return}catch(i){f(i,t,`reconnect`);let a=e[r];if(a===void 0||t.dead||o||(await n(a),t.dead||o))return}}async function x(){if(c)l=!0;else{c=!0;try{do{l=!1;let e=[...a.values()].filter(e=>!e.dead);for(let t=0;t<e.length&&!o;t+=64)await Promise.all(e.slice(t,t+64).map(b))}while(l&&!o)}finally{c=!1}}}async function S(){let e=await i.subscriber();if(u!==e){u=e,d.push(e.onReconnect(()=>{x()}));let t=e.onError?.(e=>i.report(e,{where:`subscriber`}));t!==void 0&&d.push(t)}return e}async function C(){let e=[...a.values()].filter(e=>e.kind===`message`&&!e.dead);for(let t=0;t<e.length;t+=64)await Promise.all(e.slice(t,t+64).map(async e=>{try{await i.keepAlive(e.channel)}catch(t){f(t,e,`keepAlive`)}}))}function w(){let e=[...a.values()].some(e=>e.kind===`message`);e&&s===void 0&&!o?(s=setInterval(()=>void C(),i.keepAliveMs),s.unref?.()):!e&&s!==void 0&&(clearInterval(s),s=void 0)}async function T(e){a.set(e.topic,e),w(),e.ready=(async()=>{await(await S()).subscribe(e.topic,e.handler),e.kind===`presence`&&await E(e)})(),e.ready.catch(()=>{e.dead=!0,a.get(e.topic)===e&&a.delete(e.topic),w(),u?.unsubscribe(e.topic).catch(()=>void 0)}),await e.ready}async function E(e){e.pending=[];let n;try{n=await i.members(e.channel)}catch(t){throw e.pending=void 0,t}let a=e.pending;e.pending=void 0;let o=new Map(n.map(e=>[e.id,e]));for(let e of a)r(o,e);e.members=o,o.size>t&&(e.tracked=!1)}function D(e,t){let n=!1;return async()=>{if(!n&&(n=!0,t(),!(e.listeners.size>0||e.dead)&&(e.dead=!0,a.get(e.topic)===e&&a.delete(e.topic),w(),!(o||u===void 0))))try{await u.unsubscribe(e.topic)}catch(t){f(t,e,`unsubscribe`)}}}async function O(e,t,n){if(o)throw i.fail(/* @__PURE__ */ Error(`the adapter is closed.`));let r=e??t(),a=n(r);try{e===void 0?await T(r):await r.ready}catch(e){throw a(),i.fail(e)}if(o||r.dead)throw a(),i.fail(/* @__PURE__ */ Error(`the adapter is closed.`));return a}return{messages(e,t){let n=i.messageTopic(e),r=a.get(n);return O(r?.kind===`message`?r:void 0,()=>{let t={kind:`message`,channel:e,topic:n,listeners:/* @__PURE__ */ new Set,last:0,lastAt:0,catching:!1,rerun:!1,buffer:[],overflow:!1,dead:!1,ready:Promise.resolve(),handler:e=>m(t,e)};return t},e=>(e.listeners.add(t),D(e,()=>e.listeners.delete(t))))},presence(e,t){let n=i.presenceTopic(e),r=a.get(n);return O(r?.kind===`presence`?r:void 0,()=>{let t={kind:`presence`,channel:e,topic:n,listeners:/* @__PURE__ */ new Set,members:/* @__PURE__ */ new Map,tracked:!0,pending:void 0,dead:!1,ready:Promise.resolve(),handler:e=>g(t,e)};return t},e=>(e.listeners.add(t),D(e,()=>e.listeners.delete(t))))},async close(){o=!0;for(let e of d.splice(0))e();s!==void 0&&clearInterval(s),s=void 0;let e=[...a.values()];a.clear();for(let t of e)t.dead=!0;if(e.length===0)return;let t=u;t!==void 0&&await Promise.all(e.map(e=>t.unsubscribe(e.topic).catch(t=>{f(t,e,`unsubscribe`)})))},get size(){return a.size}}}export{i as createTopics};
|
|
2
2
|
//# sourceMappingURL=topics.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"topics.js","names":["RETRY_DELAYS_MS","MAX_TRACKED_MEMBERS","sleep","resolve","ms","apply","known","members","event","createTopics","topics","closed","timer","reconnecting","again","connected","unhook","reportTo","deps","error","topic","emit","message","listener","onMessage","text","heal","dispatchPresence","onPresence","readToPresent","more","page","attempt","delay","held","resync","before","list","next","member","events","id","recover","reconnect","live","from","hook","subscriber","stopErrors","keepAliveRound","channels","syncTimer","needed","open","seed","release","done","remove","attach","found","create","stop","add","key","channel","existing"],"sources":["../../../src/redis/topics.ts"],"sourcesContent":["import type { Unsubscribe } from \"../adapter\";\nimport type { Member, PresenceEvent, StoredMessage } from \"../protocol\";\nimport type { RedisSubscriber } from \"./client\";\n\n/** Where a failure the adapter handled came from. */\nexport interface RedisErrorContext {\n readonly where: string;\n readonly channel?: string;\n}\n\n/** What the subscription manager needs from the adapter that owns it. */\nexport interface TopicsDeps {\n /** The shared subscriber connection (opened on first use). */\n subscriber(): Promise<RedisSubscriber>;\n /** The retained messages after `after`, at most `limit`, oldest first. */\n history(channel: string, after: number, limit: number): Promise<readonly StoredMessage[]>;\n /** The live presence members of a channel. */\n members(channel: string): Promise<readonly Member[]>;\n /** Extends the lifetime of a channel's numbering. */\n keepAlive(channel: string): Promise<void>;\n /** Parses a pub/sub payload; undefined (after reporting) when it is malformed. */\n parseMessage(text: string, channel: string): StoredMessage | undefined;\n parsePresence(text: string, channel: string): PresenceEvent | undefined;\n messageTopic(channel: string): string;\n presenceTopic(channel: string): string;\n report(error: unknown, context: RedisErrorContext): void;\n /** Turns a failure into the error the adapter's callers see. */\n fail(error: unknown): Error;\n /** Milliseconds between keep-alive rounds. */\n keepAliveMs: number;\n}\n\n/** What the manager returns. */\nexport interface Topics {\n messages(channel: string, listener: (message: StoredMessage) => void): Promise<Unsubscribe>;\n presence(channel: string, listener: (event: PresenceEvent) => void): Promise<Unsubscribe>;\n /** Unsubscribes everything and stops the timers. */\n close(): Promise<void>;\n /** The number of topics currently subscribed (for tests and diagnostics). */\n readonly size: number;\n}\n\n/** Live messages held while a recovery reads history; a larger burst falls back to reading history again. */\nconst CATCH_UP_BUFFER = 1000;\n/** Messages read per history page during recovery. */\nconst CATCH_UP_PAGE = 500;\n/** Delays between attempts to recover after a reconnect. */\nconst RETRY_DELAYS_MS: readonly number[] = [50, 250, 1000];\n/** Topics subscribed again at once after a reconnect. */\nconst RESUBSCRIBE_BATCH = 64;\n/** Members tracked per presence channel; a larger channel is delivered unfiltered and not reconciled after a reconnect. */\nconst MAX_TRACKED_MEMBERS = 5000;\n\ntype MessageListener = (message: StoredMessage) => void;\ntype PresenceListener = (event: PresenceEvent) => void;\n\ninterface TopicBase {\n readonly channel: string;\n readonly topic: string;\n readonly handler: (text: string) => void;\n ready: Promise<void>;\n dead: boolean;\n}\n\ninterface MessageTopic extends TopicBase {\n readonly kind: \"message\";\n readonly listeners: Set<MessageListener>;\n /** The highest seq handed to the listeners: nothing at or below it is delivered again. */\n last: number;\n /** True while history is being read to fill a gap: live messages wait in `buffer`. */\n catching: boolean;\n /** Set when a reconnect happened while a recovery was running: it reads once more. */\n rerun: boolean;\n buffer: StoredMessage[];\n overflow: boolean;\n}\n\ninterface PresenceTopic extends TopicBase {\n readonly kind: \"presence\";\n readonly listeners: Set<PresenceListener>;\n /** The members as the listeners know them, by id. */\n members: Map<string, Member>;\n /** False when the channel is too large to track: events are then delivered unfiltered and not reconciled. */\n tracked: boolean;\n /** Events received while the state is being read; applied on top of it when it arrives. */\n pending: PresenceEvent[] | undefined;\n}\n\ntype Topic = MessageTopic | PresenceTopic;\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Applies an event to a member map; true when it changed the map (a stale or repeated event does not). */\nfunction apply(members: Map<string, Member>, event: PresenceEvent): boolean {\n const known = members.get(event.member.id);\n if (event.op === \"leave\") return known !== undefined && members.delete(event.member.id);\n if (known !== undefined && known.v >= event.member.v) return false;\n members.set(event.member.id, event.member);\n return true;\n}\n\n/**\n * The shared subscriber connection of one adapter: topics are refcounted (one SUBSCRIBE per topic however many listeners), a\n * listener sees strictly increasing seqs and never a repeat, and after a reconnect the topics are subscribed again and what the\n * connection missed is read back from history (messages) or from the member list (presence).\n */\nexport function createTopics(deps: TopicsDeps): Topics {\n const topics = new Map<string, Topic>();\n let closed = false;\n let timer: ReturnType<typeof setInterval> | undefined;\n let reconnecting = false;\n let again = false;\n let connected: RedisSubscriber | undefined;\n /** Removes the hooks this manager put on the subscriber (a subscriber the caller passed outlives the adapter). */\n const unhook: (() => void)[] = [];\n\n function reportTo(error: unknown, topic: Topic, where: string): void {\n deps.report(error, { where, channel: topic.channel });\n }\n\n // --- delivery ------------------------------------------------------------------------------------------------------\n\n function emit(topic: MessageTopic, message: StoredMessage): void {\n if (topic.dead || message.seq <= topic.last) return;\n topic.last = message.seq;\n for (const listener of [...topic.listeners]) {\n try {\n listener(message);\n } catch (error) {\n reportTo(error, topic, \"listener\");\n }\n }\n }\n\n function onMessage(topic: MessageTopic, text: string): void {\n const message = deps.parseMessage(text, topic.channel);\n if (message === undefined || topic.dead) return;\n if (topic.catching || (topic.last > 0 && message.seq > topic.last + 1)) {\n // Either history is being read, or this message jumped ahead of the cursor (a publish this connection missed): hold it\n // back and fill the gap from history first, so the listeners see every retained message in order.\n if (topic.buffer.length >= CATCH_UP_BUFFER) topic.overflow = true;\n else topic.buffer.push(message);\n if (!topic.catching) void heal(topic);\n return;\n }\n emit(topic, message);\n }\n\n function dispatchPresence(topic: PresenceTopic, event: PresenceEvent): void {\n for (const listener of [...topic.listeners]) {\n try {\n listener(event);\n } catch (error) {\n reportTo(error, topic, \"listener\");\n }\n }\n }\n\n function onPresence(topic: PresenceTopic, text: string): void {\n const event = deps.parsePresence(text, topic.channel);\n if (event === undefined || topic.dead) return;\n if (topic.pending !== undefined) {\n // The state is being read: deliver raw now, and fold the event into the state when it arrives.\n if (topic.pending.length < MAX_TRACKED_MEMBERS) topic.pending.push(event);\n else topic.tracked = false;\n dispatchPresence(topic, event);\n return;\n }\n if (topic.tracked && !apply(topic.members, event)) return;\n dispatchPresence(topic, event);\n }\n\n // --- recovery after a reconnect ------------------------------------------------------------------------------------\n\n /** Reads history from the cursor until it reaches the present, then lets the held live messages through. */\n async function readToPresent(topic: MessageTopic): Promise<void> {\n for (;;) {\n let more = true;\n while (more) {\n const page = await deps.history(topic.channel, topic.last, CATCH_UP_PAGE);\n if (topic.dead) return;\n for (const message of page) emit(topic, message);\n more = page.length >= CATCH_UP_PAGE;\n }\n if (!topic.overflow) return;\n // More live messages arrived than the buffer holds: read history again from the cursor.\n topic.overflow = false;\n topic.buffer.length = 0;\n }\n }\n\n /**\n * Fills a gap of the cursor from history. One at a time per topic; a request that arrives while one runs makes it read once\n * more. Gives up after a few failed attempts (the hub's own recovery is the next net) and lets the held messages through.\n */\n async function heal(topic: MessageTopic): Promise<void> {\n if (topic.catching) {\n topic.rerun = true;\n return;\n }\n topic.catching = true;\n try {\n let attempt = 0;\n while (!topic.dead && !closed) {\n topic.rerun = false;\n try {\n await readToPresent(topic);\n if (!topic.rerun) return;\n } catch (error) {\n reportTo(error, topic, \"recover\");\n const delay = RETRY_DELAYS_MS[attempt];\n attempt += 1;\n if (delay === undefined) return;\n await sleep(delay);\n }\n }\n } finally {\n topic.catching = false;\n topic.rerun = false;\n const held = topic.buffer.splice(0);\n for (const message of held) emit(topic, message);\n }\n }\n\n async function resync(topic: PresenceTopic): Promise<void> {\n if (!topic.tracked) return;\n const before = topic.members;\n topic.pending = [];\n let list: readonly Member[];\n try {\n list = await deps.members(topic.channel);\n } catch (error) {\n const held = topic.pending;\n topic.pending = undefined;\n for (const event of held) if (apply(before, event)) dispatchPresence(topic, event);\n throw error;\n }\n const held = topic.pending;\n topic.pending = undefined;\n if (topic.dead) return;\n const next = new Map<string, Member>(list.map((member) => [member.id, member]));\n for (const event of held) apply(next, event);\n const events: PresenceEvent[] = [];\n for (const [id, member] of before)\n if (!next.has(id)) events.push({ channel: topic.channel, op: \"leave\", member });\n for (const [id, member] of next) {\n const known = before.get(id);\n if (known === undefined) events.push({ channel: topic.channel, op: \"join\", member });\n else if (member.v > known.v) events.push({ channel: topic.channel, op: \"set\", member });\n }\n topic.members = next;\n if (next.size > MAX_TRACKED_MEMBERS) topic.tracked = false;\n for (const event of events) dispatchPresence(topic, event);\n }\n\n async function recover(topic: Topic): Promise<void> {\n for (let attempt = 0; ; attempt += 1) {\n try {\n const subscriber = await deps.subscriber();\n await subscriber.subscribe(topic.topic, topic.handler);\n if (topic.kind === \"message\") {\n if (topic.last > 0) await heal(topic);\n } else {\n await resync(topic);\n }\n return;\n } catch (error) {\n reportTo(error, topic, \"reconnect\");\n const delay = RETRY_DELAYS_MS[attempt];\n if (delay === undefined || topic.dead || closed) return;\n await sleep(delay);\n if (topic.dead || closed) return;\n }\n }\n }\n\n async function reconnect(): Promise<void> {\n if (reconnecting) {\n again = true;\n return;\n }\n reconnecting = true;\n try {\n do {\n again = false;\n const live = [...topics.values()].filter((topic) => !topic.dead);\n for (let from = 0; from < live.length && !closed; from += RESUBSCRIBE_BATCH)\n await Promise.all(live.slice(from, from + RESUBSCRIBE_BATCH).map(recover));\n } while (again && !closed);\n } finally {\n reconnecting = false;\n }\n }\n\n async function hook(): Promise<RedisSubscriber> {\n const subscriber = await deps.subscriber();\n if (connected !== subscriber) {\n connected = subscriber;\n unhook.push(\n subscriber.onReconnect(() => {\n void reconnect();\n }),\n );\n const stopErrors = subscriber.onError?.((error) =>\n deps.report(error, { where: \"subscriber\" }),\n );\n if (stopErrors !== undefined) unhook.push(stopErrors);\n }\n return subscriber;\n }\n\n // --- keeping numbering alive ---------------------------------------------------------------------------------------\n\n async function keepAliveRound(): Promise<void> {\n const channels = [...topics.values()].filter(\n (topic): topic is MessageTopic => topic.kind === \"message\" && !topic.dead,\n );\n for (let from = 0; from < channels.length; from += RESUBSCRIBE_BATCH)\n await Promise.all(\n channels.slice(from, from + RESUBSCRIBE_BATCH).map(async (topic) => {\n try {\n await deps.keepAlive(topic.channel);\n } catch (error) {\n reportTo(error, topic, \"keepAlive\");\n }\n }),\n );\n }\n\n function syncTimer(): void {\n const needed = [...topics.values()].some((topic) => topic.kind === \"message\");\n if (needed && timer === undefined && !closed) {\n timer = setInterval(() => void keepAliveRound(), deps.keepAliveMs);\n (timer as { unref?: () => void }).unref?.();\n } else if (!needed && timer !== undefined) {\n clearInterval(timer);\n timer = undefined;\n }\n }\n\n // --- subscribing and releasing -------------------------------------------------------------------------------------\n\n async function open<T extends Topic>(topic: T): Promise<void> {\n topics.set(topic.topic, topic);\n syncTimer();\n topic.ready = (async () => {\n const subscriber = await hook();\n await subscriber.subscribe(topic.topic, topic.handler);\n if (topic.kind === \"presence\") await seed(topic);\n })();\n topic.ready.catch(() => {\n // The first caller's await reports it; here the half-open topic is dropped.\n topic.dead = true;\n if (topics.get(topic.topic) === topic) topics.delete(topic.topic);\n syncTimer();\n connected?.unsubscribe(topic.topic).catch(() => undefined);\n });\n await topic.ready;\n }\n\n async function seed(topic: PresenceTopic): Promise<void> {\n topic.pending = [];\n let list: readonly Member[];\n try {\n list = await deps.members(topic.channel);\n } catch (error) {\n topic.pending = undefined;\n throw error;\n }\n const held = topic.pending;\n topic.pending = undefined;\n const members = new Map<string, Member>(list.map((member) => [member.id, member]));\n for (const event of held) apply(members, event);\n topic.members = members;\n if (members.size > MAX_TRACKED_MEMBERS) topic.tracked = false;\n }\n\n /**\n * Returns the function that removes one listener. The last listener out drops the topic and sends UNSUBSCRIBE at once (not\n * after an await), so a subscribe of the same topic issued next is sent after it and wins.\n */\n function release(topic: Topic, remove: () => void): Unsubscribe {\n let done = false;\n return async () => {\n if (done) return;\n done = true;\n remove();\n if (topic.listeners.size > 0 || topic.dead) return;\n topic.dead = true;\n if (topics.get(topic.topic) === topic) topics.delete(topic.topic);\n syncTimer();\n if (closed || connected === undefined) return;\n try {\n await connected.unsubscribe(topic.topic);\n } catch (error) {\n reportTo(error, topic, \"unsubscribe\");\n }\n };\n }\n\n async function attach<T extends Topic>(\n topic: T | undefined,\n create: () => T,\n add: (topic: T) => Unsubscribe,\n ): Promise<Unsubscribe> {\n if (closed) throw deps.fail(new Error(\"the adapter is closed.\"));\n const found = topic ?? create();\n const stop = add(found);\n try {\n if (topic === undefined) await open(found);\n else await found.ready;\n } catch (error) {\n void stop();\n throw deps.fail(error);\n }\n if (closed || found.dead) {\n void stop();\n throw deps.fail(new Error(\"the adapter is closed.\"));\n }\n return stop;\n }\n\n return {\n messages(channel, listener) {\n const key = deps.messageTopic(channel);\n const existing = topics.get(key);\n return attach<MessageTopic>(\n existing?.kind === \"message\" ? existing : undefined,\n () => {\n const topic: MessageTopic = {\n kind: \"message\",\n channel,\n topic: key,\n listeners: new Set(),\n last: 0,\n catching: false,\n rerun: false,\n buffer: [],\n overflow: false,\n dead: false,\n ready: Promise.resolve(),\n handler: (text) => onMessage(topic, text),\n };\n return topic;\n },\n (topic) => {\n topic.listeners.add(listener);\n return release(topic, () => topic.listeners.delete(listener));\n },\n );\n },\n presence(channel, listener) {\n const key = deps.presenceTopic(channel);\n const existing = topics.get(key);\n return attach<PresenceTopic>(\n existing?.kind === \"presence\" ? existing : undefined,\n () => {\n const topic: PresenceTopic = {\n kind: \"presence\",\n channel,\n topic: key,\n listeners: new Set(),\n members: new Map(),\n tracked: true,\n pending: undefined,\n dead: false,\n ready: Promise.resolve(),\n handler: (text) => onPresence(topic, text),\n };\n return topic;\n },\n (topic) => {\n topic.listeners.add(listener);\n return release(topic, () => topic.listeners.delete(listener));\n },\n );\n },\n async close() {\n closed = true;\n for (const stop of unhook.splice(0)) stop();\n if (timer !== undefined) clearInterval(timer);\n timer = undefined;\n const open = [...topics.values()];\n topics.clear();\n for (const topic of open) topic.dead = true;\n if (open.length === 0) return;\n const subscriber = connected;\n if (subscriber === undefined) return;\n await Promise.all(\n open.map((topic) =>\n subscriber.unsubscribe(topic.topic).catch((error: unknown) => {\n reportTo(error, topic, \"unsubscribe\");\n }),\n ),\n );\n },\n get size() {\n return topics.size;\n },\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"topics.js","names":["RETRY_DELAYS_MS","MAX_TRACKED_MEMBERS","sleep","resolve","ms","apply","known","members","event","createTopics","topics","closed","timer","reconnecting","again","connected","unhook","reportTo","deps","error","topic","emit","message","listener","onMessage","text","heal","dispatchPresence","onPresence","readToPresent","more","page","attempt","delay","held","resync","before","list","next","member","events","id","recover","reconnect","live","from","hook","subscriber","stopErrors","keepAliveRound","channels","syncTimer","needed","open","seed","release","done","remove","attach","found","create","stop","add","key","channel","existing"],"sources":["../../../src/redis/topics.ts"],"sourcesContent":["import type { Unsubscribe } from \"../adapter\";\nimport type { Member, PresenceEvent, StoredMessage } from \"../protocol\";\nimport type { RedisSubscriber } from \"./client\";\n\n/**\n * Where a failure the adapter handled came from.\n * @since 1.0.0\n */\nexport interface RedisErrorContext {\n /** The step that failed, for example `\"parse\"`, `\"listener\"`, `\"reconnect\"` or `\"subscriber\"`. */\n readonly where: string;\n /** The channel it concerned, when it concerned one. */\n readonly channel?: string;\n}\n\n/** What the subscription manager needs from the adapter that owns it. */\nexport interface TopicsDeps {\n /** The shared subscriber connection (opened on first use). */\n subscriber(): Promise<RedisSubscriber>;\n /** The retained messages after `after`, at most `limit`, oldest first. */\n history(channel: string, after: number, limit: number): Promise<readonly StoredMessage[]>;\n /** The live presence members of a channel. */\n members(channel: string): Promise<readonly Member[]>;\n /** Extends the lifetime of a channel's numbering. */\n keepAlive(channel: string): Promise<void>;\n /** Parses a pub/sub payload; undefined (after reporting) when it is malformed. */\n parseMessage(text: string, channel: string): StoredMessage | undefined;\n parsePresence(text: string, channel: string): PresenceEvent | undefined;\n messageTopic(channel: string): string;\n presenceTopic(channel: string): string;\n report(error: unknown, context: RedisErrorContext): void;\n /** Turns a failure into the error the adapter's callers see. */\n fail(error: unknown): Error;\n /** Milliseconds between keep-alive rounds. */\n keepAliveMs: number;\n}\n\n/** What the manager returns. */\nexport interface Topics {\n messages(channel: string, listener: (message: StoredMessage) => void): Promise<Unsubscribe>;\n presence(channel: string, listener: (event: PresenceEvent) => void): Promise<Unsubscribe>;\n /** Unsubscribes everything and stops the timers. */\n close(): Promise<void>;\n /** The number of topics currently subscribed (for tests and diagnostics). */\n readonly size: number;\n}\n\n/** Live messages held while a recovery reads history; a larger burst falls back to reading history again. */\nconst CATCH_UP_BUFFER = 1000;\n/** Messages read per history page during recovery. */\nconst CATCH_UP_PAGE = 500;\n/** Delays between attempts to recover after a reconnect. */\nconst RETRY_DELAYS_MS: readonly number[] = [50, 250, 1000];\n/** Topics subscribed again at once after a reconnect. */\nconst RESUBSCRIBE_BATCH = 64;\n/** Members tracked per presence channel; a larger channel is delivered unfiltered and not reconciled after a reconnect. */\nconst MAX_TRACKED_MEMBERS = 5000;\n\ntype MessageListener = (message: StoredMessage) => void;\ntype PresenceListener = (event: PresenceEvent) => void;\n\ninterface TopicBase {\n readonly channel: string;\n readonly topic: string;\n readonly handler: (text: string) => void;\n ready: Promise<void>;\n dead: boolean;\n}\n\ninterface MessageTopic extends TopicBase {\n readonly kind: \"message\";\n readonly listeners: Set<MessageListener>;\n /** The highest seq handed to the listeners: nothing at or below it is delivered again. */\n last: number;\n /** When the message at `last` was accepted: a lower seq accepted later is a restarted numbering, not a repeat. */\n lastAt: number;\n /** True while history is being read to fill a gap: live messages wait in `buffer`. */\n catching: boolean;\n /** Set when a reconnect happened while a recovery was running: it reads once more. */\n rerun: boolean;\n buffer: StoredMessage[];\n overflow: boolean;\n}\n\ninterface PresenceTopic extends TopicBase {\n readonly kind: \"presence\";\n readonly listeners: Set<PresenceListener>;\n /** The members as the listeners know them, by id. */\n members: Map<string, Member>;\n /** False when the channel is too large to track: events are then delivered unfiltered and not reconciled. */\n tracked: boolean;\n /** Events received while the state is being read; applied on top of it when it arrives. */\n pending: PresenceEvent[] | undefined;\n}\n\ntype Topic = MessageTopic | PresenceTopic;\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** Applies an event to a member map; true when it changed the map (a stale or repeated event does not). */\nfunction apply(members: Map<string, Member>, event: PresenceEvent): boolean {\n const known = members.get(event.member.id);\n if (event.op === \"leave\") return known !== undefined && members.delete(event.member.id);\n if (known !== undefined && known.v >= event.member.v) return false;\n members.set(event.member.id, event.member);\n return true;\n}\n\n/**\n * The shared subscriber connection of one adapter: topics are refcounted (one SUBSCRIBE per topic however many listeners), a\n * listener sees strictly increasing seqs and never a repeat, and after a reconnect the topics are subscribed again and what the\n * connection missed is read back from history (messages) or from the member list (presence).\n */\nexport function createTopics(deps: TopicsDeps): Topics {\n const topics = new Map<string, Topic>();\n let closed = false;\n let timer: ReturnType<typeof setInterval> | undefined;\n let reconnecting = false;\n let again = false;\n let connected: RedisSubscriber | undefined;\n /** Removes the hooks this manager put on the subscriber (a subscriber the caller passed outlives the adapter). */\n const unhook: (() => void)[] = [];\n\n function reportTo(error: unknown, topic: Topic, where: string): void {\n deps.report(error, { where, channel: topic.channel });\n }\n\n // --- delivery ------------------------------------------------------------------------------------------------------\n\n function emit(topic: MessageTopic, message: StoredMessage): void {\n if (topic.dead) return;\n // Redis stamps `at` itself, so a repeat carries the time it first had. A lower seq with a later time means the keys were\n // lost (a flush, a failover to a replica that lacked them) and numbering began again: dropping it would silence the\n // channel until the new numbers pass the old ones. The hub tells its subscribers `reset` when it sees one.\n if (message.seq <= topic.last && message.at <= topic.lastAt) return;\n topic.last = message.seq;\n topic.lastAt = Math.max(topic.lastAt, message.at);\n for (const listener of [...topic.listeners]) {\n try {\n listener(message);\n } catch (error) {\n reportTo(error, topic, \"listener\");\n }\n }\n }\n\n function onMessage(topic: MessageTopic, text: string): void {\n const message = deps.parseMessage(text, topic.channel);\n if (message === undefined || topic.dead) return;\n if (topic.catching || (topic.last > 0 && message.seq > topic.last + 1)) {\n // Either history is being read, or this message jumped ahead of the cursor (a publish this connection missed): hold it\n // back and fill the gap from history first, so the listeners see every retained message in order.\n if (topic.buffer.length >= CATCH_UP_BUFFER) topic.overflow = true;\n else topic.buffer.push(message);\n if (!topic.catching) void heal(topic);\n return;\n }\n emit(topic, message);\n }\n\n function dispatchPresence(topic: PresenceTopic, event: PresenceEvent): void {\n for (const listener of [...topic.listeners]) {\n try {\n listener(event);\n } catch (error) {\n reportTo(error, topic, \"listener\");\n }\n }\n }\n\n function onPresence(topic: PresenceTopic, text: string): void {\n const event = deps.parsePresence(text, topic.channel);\n if (event === undefined || topic.dead) return;\n if (topic.pending !== undefined) {\n // The state is being read: deliver raw now, and fold the event into the state when it arrives.\n if (topic.pending.length < MAX_TRACKED_MEMBERS) topic.pending.push(event);\n else topic.tracked = false;\n dispatchPresence(topic, event);\n return;\n }\n if (topic.tracked && !apply(topic.members, event)) return;\n dispatchPresence(topic, event);\n }\n\n // --- recovery after a reconnect ------------------------------------------------------------------------------------\n\n /** Reads history from the cursor until it reaches the present, then lets the held live messages through. */\n async function readToPresent(topic: MessageTopic): Promise<void> {\n for (;;) {\n let more = true;\n while (more) {\n const page = await deps.history(topic.channel, topic.last, CATCH_UP_PAGE);\n if (topic.dead) return;\n for (const message of page) emit(topic, message);\n more = page.length >= CATCH_UP_PAGE;\n }\n if (!topic.overflow) return;\n // More live messages arrived than the buffer holds: read history again from the cursor.\n topic.overflow = false;\n topic.buffer.length = 0;\n }\n }\n\n /**\n * Fills a gap of the cursor from history. One at a time per topic; a request that arrives while one runs makes it read once\n * more. Gives up after a few failed attempts (the hub's own recovery is the next net) and lets the held messages through.\n */\n async function heal(topic: MessageTopic): Promise<void> {\n if (topic.catching) {\n topic.rerun = true;\n return;\n }\n topic.catching = true;\n try {\n let attempt = 0;\n while (!topic.dead && !closed) {\n topic.rerun = false;\n try {\n await readToPresent(topic);\n if (!topic.rerun) return;\n } catch (error) {\n reportTo(error, topic, \"recover\");\n const delay = RETRY_DELAYS_MS[attempt];\n attempt += 1;\n if (delay === undefined) return;\n await sleep(delay);\n }\n }\n } finally {\n topic.catching = false;\n topic.rerun = false;\n const held = topic.buffer.splice(0);\n for (const message of held) emit(topic, message);\n }\n }\n\n async function resync(topic: PresenceTopic): Promise<void> {\n if (!topic.tracked) return;\n const before = topic.members;\n topic.pending = [];\n let list: readonly Member[];\n try {\n list = await deps.members(topic.channel);\n } catch (error) {\n const held = topic.pending;\n topic.pending = undefined;\n for (const event of held) if (apply(before, event)) dispatchPresence(topic, event);\n throw error;\n }\n const held = topic.pending;\n topic.pending = undefined;\n if (topic.dead) return;\n const next = new Map<string, Member>(list.map((member) => [member.id, member]));\n for (const event of held) apply(next, event);\n const events: PresenceEvent[] = [];\n for (const [id, member] of before)\n if (!next.has(id)) events.push({ channel: topic.channel, op: \"leave\", member });\n for (const [id, member] of next) {\n const known = before.get(id);\n if (known === undefined) events.push({ channel: topic.channel, op: \"join\", member });\n else if (member.v > known.v) events.push({ channel: topic.channel, op: \"set\", member });\n }\n topic.members = next;\n if (next.size > MAX_TRACKED_MEMBERS) topic.tracked = false;\n for (const event of events) dispatchPresence(topic, event);\n }\n\n async function recover(topic: Topic): Promise<void> {\n for (let attempt = 0; ; attempt += 1) {\n try {\n const subscriber = await deps.subscriber();\n await subscriber.subscribe(topic.topic, topic.handler);\n if (topic.kind === \"message\") {\n if (topic.last > 0) await heal(topic);\n } else {\n await resync(topic);\n }\n return;\n } catch (error) {\n reportTo(error, topic, \"reconnect\");\n const delay = RETRY_DELAYS_MS[attempt];\n if (delay === undefined || topic.dead || closed) return;\n await sleep(delay);\n if (topic.dead || closed) return;\n }\n }\n }\n\n async function reconnect(): Promise<void> {\n if (reconnecting) {\n again = true;\n return;\n }\n reconnecting = true;\n try {\n do {\n again = false;\n const live = [...topics.values()].filter((topic) => !topic.dead);\n for (let from = 0; from < live.length && !closed; from += RESUBSCRIBE_BATCH)\n await Promise.all(live.slice(from, from + RESUBSCRIBE_BATCH).map(recover));\n } while (again && !closed);\n } finally {\n reconnecting = false;\n }\n }\n\n async function hook(): Promise<RedisSubscriber> {\n const subscriber = await deps.subscriber();\n if (connected !== subscriber) {\n connected = subscriber;\n unhook.push(\n subscriber.onReconnect(() => {\n void reconnect();\n }),\n );\n const stopErrors = subscriber.onError?.((error) =>\n deps.report(error, { where: \"subscriber\" }),\n );\n if (stopErrors !== undefined) unhook.push(stopErrors);\n }\n return subscriber;\n }\n\n // --- keeping numbering alive ---------------------------------------------------------------------------------------\n\n async function keepAliveRound(): Promise<void> {\n const channels = [...topics.values()].filter(\n (topic): topic is MessageTopic => topic.kind === \"message\" && !topic.dead,\n );\n for (let from = 0; from < channels.length; from += RESUBSCRIBE_BATCH)\n await Promise.all(\n channels.slice(from, from + RESUBSCRIBE_BATCH).map(async (topic) => {\n try {\n await deps.keepAlive(topic.channel);\n } catch (error) {\n reportTo(error, topic, \"keepAlive\");\n }\n }),\n );\n }\n\n function syncTimer(): void {\n const needed = [...topics.values()].some((topic) => topic.kind === \"message\");\n if (needed && timer === undefined && !closed) {\n timer = setInterval(() => void keepAliveRound(), deps.keepAliveMs);\n (timer as { unref?: () => void }).unref?.();\n } else if (!needed && timer !== undefined) {\n clearInterval(timer);\n timer = undefined;\n }\n }\n\n // --- subscribing and releasing -------------------------------------------------------------------------------------\n\n async function open<T extends Topic>(topic: T): Promise<void> {\n topics.set(topic.topic, topic);\n syncTimer();\n topic.ready = (async () => {\n const subscriber = await hook();\n await subscriber.subscribe(topic.topic, topic.handler);\n if (topic.kind === \"presence\") await seed(topic);\n })();\n topic.ready.catch(() => {\n // The first caller's await reports it; here the half-open topic is dropped.\n topic.dead = true;\n if (topics.get(topic.topic) === topic) topics.delete(topic.topic);\n syncTimer();\n connected?.unsubscribe(topic.topic).catch(() => undefined);\n });\n await topic.ready;\n }\n\n async function seed(topic: PresenceTopic): Promise<void> {\n topic.pending = [];\n let list: readonly Member[];\n try {\n list = await deps.members(topic.channel);\n } catch (error) {\n topic.pending = undefined;\n throw error;\n }\n const held = topic.pending;\n topic.pending = undefined;\n const members = new Map<string, Member>(list.map((member) => [member.id, member]));\n for (const event of held) apply(members, event);\n topic.members = members;\n if (members.size > MAX_TRACKED_MEMBERS) topic.tracked = false;\n }\n\n /**\n * Returns the function that removes one listener. The last listener out drops the topic and sends UNSUBSCRIBE at once (not\n * after an await), so a subscribe of the same topic issued next is sent after it and wins.\n */\n function release(topic: Topic, remove: () => void): Unsubscribe {\n let done = false;\n return async () => {\n if (done) return;\n done = true;\n remove();\n if (topic.listeners.size > 0 || topic.dead) return;\n topic.dead = true;\n if (topics.get(topic.topic) === topic) topics.delete(topic.topic);\n syncTimer();\n if (closed || connected === undefined) return;\n try {\n await connected.unsubscribe(topic.topic);\n } catch (error) {\n reportTo(error, topic, \"unsubscribe\");\n }\n };\n }\n\n async function attach<T extends Topic>(\n topic: T | undefined,\n create: () => T,\n add: (topic: T) => Unsubscribe,\n ): Promise<Unsubscribe> {\n if (closed) throw deps.fail(new Error(\"the adapter is closed.\"));\n const found = topic ?? create();\n const stop = add(found);\n try {\n if (topic === undefined) await open(found);\n else await found.ready;\n } catch (error) {\n void stop();\n throw deps.fail(error);\n }\n if (closed || found.dead) {\n void stop();\n throw deps.fail(new Error(\"the adapter is closed.\"));\n }\n return stop;\n }\n\n return {\n messages(channel, listener) {\n const key = deps.messageTopic(channel);\n const existing = topics.get(key);\n return attach<MessageTopic>(\n existing?.kind === \"message\" ? existing : undefined,\n () => {\n const topic: MessageTopic = {\n kind: \"message\",\n channel,\n topic: key,\n listeners: new Set(),\n last: 0,\n lastAt: 0,\n catching: false,\n rerun: false,\n buffer: [],\n overflow: false,\n dead: false,\n ready: Promise.resolve(),\n handler: (text) => onMessage(topic, text),\n };\n return topic;\n },\n (topic) => {\n topic.listeners.add(listener);\n return release(topic, () => topic.listeners.delete(listener));\n },\n );\n },\n presence(channel, listener) {\n const key = deps.presenceTopic(channel);\n const existing = topics.get(key);\n return attach<PresenceTopic>(\n existing?.kind === \"presence\" ? existing : undefined,\n () => {\n const topic: PresenceTopic = {\n kind: \"presence\",\n channel,\n topic: key,\n listeners: new Set(),\n members: new Map(),\n tracked: true,\n pending: undefined,\n dead: false,\n ready: Promise.resolve(),\n handler: (text) => onPresence(topic, text),\n };\n return topic;\n },\n (topic) => {\n topic.listeners.add(listener);\n return release(topic, () => topic.listeners.delete(listener));\n },\n );\n },\n async close() {\n closed = true;\n for (const stop of unhook.splice(0)) stop();\n if (timer !== undefined) clearInterval(timer);\n timer = undefined;\n const open = [...topics.values()];\n topics.clear();\n for (const topic of open) topic.dead = true;\n if (open.length === 0) return;\n const subscriber = connected;\n if (subscriber === undefined) return;\n await Promise.all(\n open.map((topic) =>\n subscriber.unsubscribe(topic.topic).catch((error: unknown) => {\n reportTo(error, topic, \"unsubscribe\");\n }),\n ),\n );\n },\n get size() {\n return topics.size;\n },\n };\n}\n"],"mappings":"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"}
|