@shadow-js/realtime 1.0.1 → 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 +20 -0
- package/README.md +35 -0
- package/dist/dev/client/core.js +104 -106
- package/dist/dev/client/core.js.map +1 -1
- package/dist/dev/client/sse.js +33 -24
- package/dist/dev/client/sse.js.map +1 -1
- package/dist/dev/client/types.d.ts +6 -0
- package/dist/dev/client/util.js +2 -2
- package/dist/dev/client/util.js.map +1 -1
- package/dist/dev/cloudflare/link.js +69 -8
- package/dist/dev/cloudflare/link.js.map +1 -1
- package/dist/dev/memory.d.ts +11 -0
- package/dist/dev/memory.js +38 -10
- package/dist/dev/memory.js.map +1 -1
- package/dist/dev/protocol.js +13 -12
- package/dist/dev/protocol.js.map +1 -1
- package/dist/dev/redis/topics.d.ts +6 -1
- package/dist/dev/redis/topics.js +4 -1
- package/dist/dev/redis/topics.js.map +1 -1
- package/dist/dev/server/http.js +37 -24
- package/dist/dev/server/http.js.map +1 -1
- package/dist/dev/server/hub.js +66 -39
- package/dist/dev/server/hub.js.map +1 -1
- package/dist/dev/server/index.d.ts +2 -2
- package/dist/dev/server/index.js.map +1 -1
- package/dist/dev/server/limits.d.ts +4 -1
- package/dist/dev/server/limits.js.map +1 -1
- package/dist/dev/server/rules.js.map +1 -1
- 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
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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"}
|
package/dist/prod/server/http.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{RealtimeError as e}from"../errors.js";import{
|
|
1
|
+
import{RealtimeError as e}from"../errors.js";import{TokenBucket as t}from"./limits.js";const n=`$realtime`,r=`$realtime:gone`;function i(e,t){return new Response(t,{status:e,headers:{"content-type":`application/json`,"cache-control":`no-store`}})}function a(e,t,n){return i(e,JSON.stringify({error:{code:t,message:n}}))}async function o(e,t){let n=new TextDecoder,r=``,i=0;for await(let a of e.body??[]){if(i+=a.byteLength,i>t)return;r+=n.decode(a,{stream:!0})}return r+n.decode()}function s(e,t){let n=e.headers.get(`origin`);if(n===null)return!0;if(t!==void 0)return t.includes(n);try{return n===new URL(e.url).origin}catch{return!1}}async function c(e,t){let n=await e.authenticate?.(t);return n instanceof Response?{refusal:n}:{identity:n??{}}}function l(e,t={}){return{async upgrade(e){let n=await c(t,e);return`refusal`in n?n.refusal:void 0},async open(i,a){let o=await c(t,a);if(i.signal.aborted||i.data[r]===!0)return;if(`refusal`in o){i.close(1008,``);return}let s={send:e=>i.send(e),close:(e,t)=>i.close(e,t)};i.data[n]=e.connect(s,o.identity)},message(e,t){let r=e.data[n];r!==void 0&&(typeof t==`string`?r.receive(t):e.close(1003,``))},close(e){e.data[r]=!0,e.data[n]?.closed()},error(t,r){e.report(r,{where:`websocket`}),t.data[n]?.closed()}}}async function u(e,t){try{await e.send({event:`rt`,data:JSON.stringify({t:`bye`,code:1008,why:t})})}catch{}e.close()}function d(e){let t=e.searchParams.get(`s`);if(t===null)return[];try{let e=JSON.parse(t);return!Array.isArray(e)||e.length>64?void 0:e.map(e=>typeof e==`object`&&e?e:{})}catch{return}}function f(t,n={}){return async(r,i)=>{if(!s(r.request,n.allowedOrigins)){t.report(new e(`forbidden`,void 0),{where:`sse.origin`}),await u(i,``);return}let a=await c(n,r),o=`refusal`in a?void 0:d(new URL(r.request.url));if(`refusal`in a||o===void 0){await u(i,``);return}let l=0,f=t.connect({send(e){return!i.closed&&(l+=e.length,i.send({event:`rt`,data:e}).then(()=>{l-=e.length},()=>{l=2**53-1,f.closed()}),!0)},close:()=>i.close(),buffered:()=>l},a.identity);o.forEach((e,t)=>{f.receive(JSON.stringify({...e,t:`sub`,n:t+1}))}),i.signal.aborted||await new Promise(e=>{i.signal.addEventListener(`abort`,()=>e(),{once:!0})}),f.closed(),await f.done}}function p(n,r={}){let l=/* @__PURE__ */ new Map,u=e=>{let r=l.get(e);if(r===void 0){if(l.size>=1e4){let e=l.keys().next().value;e!==void 0&&l.delete(e)}r=new t(n.limits.publishesPerSecond,n.limits.publishBurst,Date.now()),l.set(e,r)}return r};return async t=>{let{request:l}=t;if(!s(l,r.allowedOrigins))return a(403,`forbidden`,void 0);let d=await c(r,t);if(`refusal`in d)return d.refusal;let f=await o(l,n.limits.maxMessageBytes*8);if(f===void 0)return a(413,`too_large`,void 0);let p;try{p=JSON.parse(f)}catch{return a(400,`bad_frame`,void 0)}let m=p?.frames,h=p?.cid;if(!Array.isArray(m)||m.length===0||m.length>64)return a(400,`bad_frame`,void 0);let g=r.key?.(t,d.identity)??d.identity.user??`anonymous`,_=[],v=n.connect({send(e){return e.startsWith(`{"t":"ready"`)||_.push(e),!0},close:()=>void 0},d.identity,{stateless:!0,publishBucket:u(g),...typeof h==`string`?{actingFor:h}:{}});try{for(let t of m){let r=t?.t;if(r===`pres`){let r=t;try{if(typeof r.c!=`string`||typeof h!=`string`)throw new e(`bad_frame`,void 0);if(!u(g).take(Date.now()))throw new e(`rate_limited`);await n.setMemberState(d.identity,r.c,h,r.s??null)}catch(t){let n=t instanceof e?t.code:`unavailable`;_.push(JSON.stringify({t:`err`,code:n}))}}else r!==`pub`&&r!==`req`?_.push(JSON.stringify({t:`err`,code:`bad_frame`,msg:void 0})):v.receive(JSON.stringify(t))}await v.settled()}finally{v.closed()}return i(200,`{"frames":[${_.join(`,`)}]}`)}}export{p as postRoute,f as sseRoute,l as websocketRoute};
|
|
2
2
|
//# sourceMappingURL=http.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.js","names":["KEY","refuse","originAllowed","origin","request","allowed","identify","result","options","event","websocketRoute","ws","transport","frame","code","reason","hub","connection","message","error","refuseStream","stream","declared","text","url","value","item","sseRoute","RealtimeError","entries","pendingBytes","at","entry","resolve","postRoute","buckets","bucketFor","bucket","key","oldest","TokenBucket","byteLength","body","frames","cid","answers","type"],"sources":["../../../src/server/http.ts"],"sourcesContent":["import { RealtimeError } from \"../errors\";\nimport { byteLength, type Json } from \"../protocol\";\nimport type { HubConnection, HubCore, Transport } from \"./hub\";\nimport { TokenBucket } from \"./limits\";\nimport type { Identity } from \"./rules\";\n\n/** What a hub needs from the framework's request event. @since 1.0.0 */\nexport interface RequestLike {\n readonly request: Request;\n}\n\n/** How a connection is identified: an identity, or a response that refuses it. @since 1.0.0 */\nexport type AuthenticateResult = Identity | undefined | Response;\n\n/** Options shared by the transport routes. @since 1.0.0 */\nexport interface HubRouteOptions<E extends RequestLike> {\n /**\n * Reads the identity from the request (the session cookie, a bearer token). Return a `Response` to refuse (a 401). Return\n * nothing for an anonymous connection. Default: everyone is anonymous, and channel rules decide.\n */\n readonly authenticate?: (event: E) => AuthenticateResult | Promise<AuthenticateResult>;\n /**\n * Origins allowed to open a stream or post (full origins such as `https://app.example.com`). Default: the request's own\n * origin only. A request with no `Origin` header (same-origin GET, a non-browser client) is allowed.\n */\n readonly allowedOrigins?: readonly string[];\n}\n\n/** The WebSocket connection the framework hands to handlers (the part this package uses). @since 1.0.0 */\nexport interface WebSocketLike {\n readonly data: Record<string, unknown>;\n readonly signal: AbortSignal;\n send(message: string | Uint8Array): boolean;\n close(code?: number, reason?: string): void;\n}\n\n/** The handlers of a WebSocket route, shaped like Dusk's `WS` export. @since 1.0.0 */\nexport interface WebSocketRoute<E extends RequestLike> {\n upgrade(event: E): Promise<Response | undefined>;\n open(ws: WebSocketLike, event: E): Promise<void>;\n message(ws: WebSocketLike, message: string | Uint8Array, event: E): void;\n close(ws: WebSocketLike): void;\n error(ws: WebSocketLike, error: unknown, event: E): void;\n}\n\n/** The stream a server-sent events route writes to (the part this package uses). @since 1.0.0 */\nexport interface SseLike {\n send(message: { readonly event: string; readonly data: string }): Promise<void>;\n close(): void;\n readonly signal: AbortSignal;\n readonly closed: boolean;\n}\n\nconst KEY = \"$realtime\";\nconst MAX_FRAMES_PER_POST = 64;\nconst MAX_SUBSCRIPTIONS_IN_QUERY = 64;\nconst MAX_BUCKETS = 10_000;\n\nfunction refuse(status: number, code: RealtimeError[\"code\"], message: string): Response {\n return new Response(JSON.stringify({ error: { code, message } }), {\n status,\n headers: { \"content-type\": \"application/json\", \"cache-control\": \"no-store\" },\n });\n}\n\n/** Whether the request's `Origin` header is acceptable. A missing header is allowed (see `HubRouteOptions.allowedOrigins`). */\nfunction originAllowed(request: Request, allowed: readonly string[] | undefined): boolean {\n const origin = request.headers.get(\"origin\");\n if (origin === null) return true;\n if (allowed !== undefined) return allowed.includes(origin);\n try {\n return origin === new URL(request.url).origin;\n } catch {\n return false;\n }\n}\n\nasync function identify<E extends RequestLike>(\n options: HubRouteOptions<E>,\n event: E,\n): Promise<{ readonly identity: Identity } | { readonly refusal: Response }> {\n const result = await options.authenticate?.(event);\n if (result instanceof Response) return { refusal: result };\n return { identity: result ?? {} };\n}\n\n/**\n * The WebSocket route of a hub: `export const WS = hub.websocket({ authenticate })` in a Dusk stream file. The upgrade is decided\n * by `authenticate` (a `Response` refuses it) and Dusk's own checks (origin, caps, size); each text frame goes to the hub.\n * Binary frames close the connection with 1003.\n *\n * @param hub The hub.\n * @param options How to identify the connection.\n * @returns Handlers shaped like Dusk's `WS` export.\n * @example\n * import { createHub } from \"@shadow-js/realtime/server\";\n *\n * const hub = createHub({ channels: { \"chat:{room}\": { subscribe: true, publish: true } } });\n * export const WS = hub.websocket();\n * @since 1.0.0\n */\nexport function websocketRoute<E extends RequestLike>(\n hub: HubCore,\n options: Pick<HubRouteOptions<E>, \"authenticate\"> = {},\n): WebSocketRoute<E> {\n return {\n async upgrade(event) {\n const result = await identify(options, event);\n return \"refusal\" in result ? result.refusal : undefined;\n },\n async open(ws, event) {\n const result = await identify(options, event);\n if (\"refusal\" in result) {\n ws.close(1008, \"unauthorized\");\n return;\n }\n const transport: Transport = {\n send: (frame) => ws.send(frame),\n close: (code, reason) => ws.close(code, reason),\n };\n ws.data[KEY] = hub.connect(transport, result.identity);\n },\n message(ws, message) {\n const connection = ws.data[KEY] as HubConnection | undefined;\n if (connection === undefined) return;\n if (typeof message !== \"string\") {\n ws.close(1003, \"binary frames are not supported\");\n return;\n }\n connection.receive(message);\n },\n close(ws) {\n (ws.data[KEY] as HubConnection | undefined)?.closed();\n },\n error(ws, error) {\n hub.report(error, { where: \"websocket\" });\n (ws.data[KEY] as HubConnection | undefined)?.closed();\n },\n };\n}\n\n/**\n * Refuses a stream that has already started (the status 200 is sent before the handler runs): a `bye` with the policy code the\n * client treats as fatal, so it gives up instead of reconnecting for ever, then the end of the stream.\n */\nasync function refuseStream(stream: SseLike, why: string): Promise<void> {\n try {\n await stream.send({ event: \"rt\", data: JSON.stringify({ t: \"bye\", code: 1008, why }) });\n } catch {\n // A client that already left needs no answer.\n }\n stream.close();\n}\n\n/** Reads the subscriptions a stream request declares: `?s=[{\"c\":\"chat:lobby\",\"after\":12}]`. */\nfunction declared(url: URL): readonly Record<string, unknown>[] | undefined {\n const text = url.searchParams.get(\"s\");\n if (text === null) return [];\n try {\n const value: unknown = JSON.parse(text);\n if (!Array.isArray(value) || value.length > MAX_SUBSCRIPTIONS_IN_QUERY) return undefined;\n return value.map((item) =>\n item !== null && typeof item === \"object\" ? (item as Record<string, unknown>) : {},\n );\n } catch {\n return undefined;\n }\n}\n\n/**\n * The server-sent events route of a hub, for hosts that cannot hold a WebSocket: `export const SSE = hub.sse()`. The channels\n * are declared in the request (`?s=[{\"c\":\"chat:lobby\",\"after\":12,\"echo\":false,\"presence\":{\"typing\":false}}]`); to change them the\n * client opens a new stream. Frames go out as events named `rt`; everything the client sends goes to {@link postRoute}.\n *\n * @param hub The hub.\n * @param options How to identify the connection and which origins may connect.\n * @returns A handler shaped like Dusk's `SSE` export.\n * @example\n * import { createHub } from \"@shadow-js/realtime/server\";\n *\n * const hub = createHub({ channels: { \"chat:{room}\": { subscribe: true, publish: true } } });\n * export const SSE = hub.sse();\n * @since 1.0.0\n */\nexport function sseRoute<E extends RequestLike>(\n hub: HubCore,\n options: HubRouteOptions<E> = {},\n): (event: E, stream: SseLike) => Promise<void> {\n return async (event, stream) => {\n if (!originAllowed(event.request, options.allowedOrigins)) {\n hub.report(new RealtimeError(\"forbidden\", \"origin refused\"), { where: \"sse.origin\" });\n await refuseStream(stream, \"origin not allowed\");\n return;\n }\n const result = await identify(options, event);\n if (\"refusal\" in result) {\n await refuseStream(stream, \"unauthorized\");\n return;\n }\n const entries = declared(new URL(event.request.url));\n if (entries === undefined) {\n await refuseStream(stream, \"bad subscription list\");\n return;\n }\n let pendingBytes = 0;\n const transport: Transport = {\n send(frame) {\n if (stream.closed) return false;\n pendingBytes += frame.length;\n stream.send({ event: \"rt\", data: frame }).then(\n () => {\n pendingBytes -= frame.length;\n },\n () => {\n pendingBytes = Number.MAX_SAFE_INTEGER;\n connection.closed();\n },\n );\n return true;\n },\n close: () => stream.close(),\n buffered: () => pendingBytes,\n };\n const connection = hub.connect(transport, result.identity);\n entries.forEach((entry, at) => {\n connection.receive(JSON.stringify({ t: \"sub\", n: at + 1, ...entry }));\n });\n if (!stream.signal.aborted)\n await new Promise<void>((resolve) => {\n stream.signal.addEventListener(\"abort\", () => resolve(), { once: true });\n });\n connection.closed();\n await connection.done;\n };\n}\n\n/**\n * The HTTP route that carries what an SSE client sends: `export const POST = hub.post()`. The body is\n * `{\"cid\": \"<connection id>\", \"frames\": [ ... ]}` (at most 64 frames of the types `pub`, `req`, `pres`); the answer is\n * `{\"frames\": [ ... ]}` with the acks, replies and errors. It keeps nothing between requests, so any server can answer it.\n *\n * The request rate of one caller is limited by `key` (default: the user, else all anonymous callers together) with the hub's\n * publish limits; put Dusk's rate limiting in front of the route for per-address limits.\n *\n * @param hub The hub.\n * @param options Identity, origins and the rate-limit key.\n * @returns A handler for a Dusk API route.\n * @example\n * import { createHub } from \"@shadow-js/realtime/server\";\n *\n * const hub = createHub({ channels: { \"chat:{room}\": { subscribe: true, publish: true } } });\n * export const POST = hub.post();\n * @since 1.0.0\n */\nexport function postRoute<E extends RequestLike>(\n hub: HubCore,\n options: HubRouteOptions<E> & { readonly key?: (event: E, identity: Identity) => string } = {},\n): (event: E) => Promise<Response> {\n const buckets = new Map<string, TokenBucket>();\n const bucketFor = (key: string): TokenBucket => {\n let bucket = buckets.get(key);\n if (bucket === undefined) {\n if (buckets.size >= MAX_BUCKETS) {\n const oldest = buckets.keys().next().value;\n if (oldest !== undefined) buckets.delete(oldest);\n }\n bucket = new TokenBucket(hub.limits.publishesPerSecond, hub.limits.publishBurst, Date.now());\n buckets.set(key, bucket);\n }\n return bucket;\n };\n return async (event) => {\n const { request } = event;\n if (!originAllowed(request, options.allowedOrigins))\n return refuse(403, \"forbidden\", \"origin not allowed\");\n const result = await identify(options, event);\n if (\"refusal\" in result) return result.refusal;\n const text = await request.text();\n if (byteLength(text) > hub.limits.maxMessageBytes * 8)\n return refuse(413, \"too_large\", \"the request is too large\");\n let body: unknown;\n try {\n body = JSON.parse(text);\n } catch {\n return refuse(400, \"bad_frame\", \"the body is not JSON\");\n }\n const frames = (body as { frames?: unknown } | null)?.frames;\n const cid = (body as { cid?: unknown } | null)?.cid;\n if (!Array.isArray(frames) || frames.length === 0 || frames.length > MAX_FRAMES_PER_POST)\n return refuse(400, \"bad_frame\", `frames must hold 1..${MAX_FRAMES_PER_POST} frames`);\n const key = options.key?.(event, result.identity) ?? result.identity.user ?? \"anonymous\";\n const answers: string[] = [];\n const transport: Transport = {\n send(frame) {\n if (!frame.startsWith('{\"t\":\"ready\"')) answers.push(frame);\n return true;\n },\n close: () => undefined,\n };\n const connection = hub.connect(transport, result.identity, {\n stateless: true,\n publishBucket: bucketFor(key),\n ...(typeof cid === \"string\" ? { actingFor: cid } : {}),\n });\n try {\n for (const frame of frames) {\n const type = (frame as { t?: unknown } | null)?.t;\n if (type === \"pres\") {\n const item = frame as { c?: unknown; s?: unknown };\n try {\n if (typeof item.c !== \"string\" || typeof cid !== \"string\")\n throw new RealtimeError(\"bad_frame\", \"pres needs c and the connection id\");\n await hub.setMemberState(result.identity, item.c, cid, (item.s ?? null) as Json);\n } catch (error) {\n const code = error instanceof RealtimeError ? error.code : \"unavailable\";\n answers.push(JSON.stringify({ t: \"err\", code }));\n }\n continue;\n }\n if (type !== \"pub\" && type !== \"req\") {\n answers.push(\n JSON.stringify({ t: \"err\", code: \"bad_frame\", msg: \"only pub, req and pres\" }),\n );\n continue;\n }\n connection.receive(JSON.stringify(frame));\n }\n await connection.settled();\n } finally {\n connection.closed();\n }\n return new Response(`{\"frames\":[${answers.join(\",\")}]}`, {\n status: 200,\n headers: { \"content-type\": \"application/json\", \"cache-control\": \"no-store\" },\n });\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"http.js","names":["KEY","GONE","jsonResponse","body","refuse","status","readBounded","decoder","text","bytes","chunk","request","max","originAllowed","origin","allowed","identify","result","options","event","websocketRoute","ws","transport","frame","code","reason","hub","connection","message","error","refuseStream","stream","declared","url","value","item","sseRoute","RealtimeError","entries","pendingBytes","entry","at","resolve","postRoute","buckets","bucketFor","bucket","key","oldest","TokenBucket","frames","cid","answers","type"],"sources":["../../../src/server/http.ts"],"sourcesContent":["import { RealtimeError } from \"../errors\";\nimport type { Json } from \"../protocol\";\nimport type { HubConnection, HubCore, Transport } from \"./hub\";\nimport { TokenBucket } from \"./limits\";\nimport type { Identity } from \"./rules\";\n\n/** What a hub needs from the framework's request event. @since 1.0.0 */\nexport interface RequestLike {\n readonly request: Request;\n}\n\n/** How a connection is identified: an identity, or a response that refuses it. @since 1.0.0 */\nexport type AuthenticateResult = Identity | undefined | Response;\n\n/** Options shared by the transport routes. @since 1.0.0 */\nexport interface HubRouteOptions<E extends RequestLike> {\n /**\n * Reads the identity from the request (the session cookie, a bearer token). Return a `Response` to refuse (a 401). Return\n * nothing for an anonymous connection. Default: everyone is anonymous, and channel rules decide.\n */\n readonly authenticate?: (event: E) => AuthenticateResult | Promise<AuthenticateResult>;\n /**\n * Origins allowed to open a stream or post (full origins such as `https://app.example.com`). Default: the request's own\n * origin only. A request with no `Origin` header (same-origin GET, a non-browser client) is allowed.\n */\n readonly allowedOrigins?: readonly string[];\n}\n\n/** The WebSocket connection the framework hands to handlers (the part this package uses). @since 1.0.0 */\nexport interface WebSocketLike {\n readonly data: Record<string, unknown>;\n readonly signal: AbortSignal;\n send(message: string | Uint8Array): boolean;\n close(code?: number, reason?: string): void;\n}\n\n/** The handlers of a WebSocket route, shaped like Dusk's `WS` export. @since 1.0.0 */\nexport interface WebSocketRoute<E extends RequestLike> {\n upgrade(event: E): Promise<Response | undefined>;\n open(ws: WebSocketLike, event: E): Promise<void>;\n message(ws: WebSocketLike, message: string | Uint8Array, event: E): void;\n close(ws: WebSocketLike): void;\n error(ws: WebSocketLike, error: unknown, event: E): void;\n}\n\n/** The stream a server-sent events route writes to (the part this package uses). @since 1.0.0 */\nexport interface SseLike {\n send(message: { readonly event: string; readonly data: string }): Promise<void>;\n close(): void;\n readonly signal: AbortSignal;\n readonly closed: boolean;\n}\n\nconst KEY = \"$realtime\";\n/** Marks a socket that closed before its connection existed. */\nconst GONE = \"$realtime:gone\";\nconst MAX_FRAMES_PER_POST = 64;\nconst MAX_SUBSCRIPTIONS_IN_QUERY = 64;\nconst MAX_BUCKETS = 10_000;\n\n/** A JSON answer that no cache may keep. */\nfunction jsonResponse(status: number, body: string): Response {\n return new Response(body, {\n status,\n headers: { \"content-type\": \"application/json\", \"cache-control\": \"no-store\" },\n });\n}\n\nfunction refuse(\n status: number,\n code: RealtimeError[\"code\"],\n message: string | undefined,\n): Response {\n return jsonResponse(status, JSON.stringify({ error: { code, message } }));\n}\n\n/**\n * Reads a request body as text, stopping at `max` bytes: a body that never ends must not be held in memory before it is\n * refused. Undefined when the body is larger than `max`.\n */\nasync function readBounded(request: Request, max: number): Promise<string | undefined> {\n const decoder = new TextDecoder();\n let text = \"\";\n let bytes = 0;\n // Leaving the loop early cancels the stream, so the rest of an oversized body is never pulled.\n for await (const chunk of (request.body ?? []) as AsyncIterable<Uint8Array>) {\n bytes += chunk.byteLength;\n if (bytes > max) return undefined;\n text += decoder.decode(chunk, { stream: true });\n }\n return text + decoder.decode();\n}\n\n/** Whether the request's `Origin` header is acceptable. A missing header is allowed (see `HubRouteOptions.allowedOrigins`). */\nfunction originAllowed(request: Request, allowed: readonly string[] | undefined): boolean {\n const origin = request.headers.get(\"origin\");\n if (origin === null) return true;\n if (allowed !== undefined) return allowed.includes(origin);\n try {\n return origin === new URL(request.url).origin;\n } catch {\n return false;\n }\n}\n\nasync function identify<E extends RequestLike>(\n options: HubRouteOptions<E>,\n event: E,\n): Promise<{ readonly identity: Identity } | { readonly refusal: Response }> {\n const result = await options.authenticate?.(event);\n if (result instanceof Response) return { refusal: result };\n return { identity: result ?? {} };\n}\n\n/**\n * The WebSocket route of a hub: `export const WS = hub.websocket({ authenticate })` in a Dusk stream file. The upgrade is decided\n * by `authenticate` (a `Response` refuses it) and Dusk's own checks (origin, caps, size); each text frame goes to the hub.\n * Binary frames close the connection with 1003.\n *\n * @param hub The hub.\n * @param options How to identify the connection.\n * @returns Handlers shaped like Dusk's `WS` export.\n * @example\n * import { createHub } from \"@shadow-js/realtime/server\";\n *\n * const hub = createHub({ channels: { \"chat:{room}\": { subscribe: true, publish: true } } });\n * export const WS = hub.websocket();\n * @since 1.0.0\n */\nexport function websocketRoute<E extends RequestLike>(\n hub: HubCore,\n options: Pick<HubRouteOptions<E>, \"authenticate\"> = {},\n): WebSocketRoute<E> {\n return {\n async upgrade(event) {\n const result = await identify(options, event);\n return \"refusal\" in result ? result.refusal : undefined;\n },\n async open(ws, event) {\n const result = await identify(options, event);\n // `authenticate` can take a while: a peer that left in the meantime already had its `close`, which found no connection to\n // release, so connecting now would leave one in the hub for good.\n if (ws.signal.aborted || ws.data[GONE] === true) return;\n if (\"refusal\" in result) {\n ws.close(1008, __DEV__ ? \"unauthorized\" : \"\");\n return;\n }\n const transport: Transport = {\n send: (frame) => ws.send(frame),\n close: (code, reason) => ws.close(code, reason),\n };\n ws.data[KEY] = hub.connect(transport, result.identity);\n },\n message(ws, message) {\n const connection = ws.data[KEY] as HubConnection | undefined;\n if (connection === undefined) return;\n if (typeof message !== \"string\") {\n ws.close(1003, __DEV__ ? \"binary frames are not supported\" : \"\");\n return;\n }\n connection.receive(message);\n },\n close(ws) {\n ws.data[GONE] = true;\n (ws.data[KEY] as HubConnection | undefined)?.closed();\n },\n error(ws, error) {\n hub.report(error, { where: \"websocket\" });\n (ws.data[KEY] as HubConnection | undefined)?.closed();\n },\n };\n}\n\n/**\n * Refuses a stream that has already started (the status 200 is sent before the handler runs): a `bye` with the policy code the\n * client treats as fatal, so it gives up instead of reconnecting for ever, then the end of the stream.\n */\nasync function refuseStream(stream: SseLike, why: string): Promise<void> {\n try {\n await stream.send({ event: \"rt\", data: JSON.stringify({ t: \"bye\", code: 1008, why }) });\n } catch {\n // A client that already left needs no answer.\n }\n stream.close();\n}\n\n/** Reads the subscriptions a stream request declares: `?s=[{\"c\":\"chat:lobby\",\"after\":12}]`. */\nfunction declared(url: URL): readonly Record<string, unknown>[] | undefined {\n const text = url.searchParams.get(\"s\");\n if (text === null) return [];\n try {\n const value: unknown = JSON.parse(text);\n if (!Array.isArray(value) || value.length > MAX_SUBSCRIPTIONS_IN_QUERY) return undefined;\n return value.map((item) =>\n item !== null && typeof item === \"object\" ? (item as Record<string, unknown>) : {},\n );\n } catch {\n return undefined;\n }\n}\n\n/**\n * The server-sent events route of a hub, for hosts that cannot hold a WebSocket: `export const SSE = hub.sse()`. The channels\n * are declared in the request (`?s=[{\"c\":\"chat:lobby\",\"after\":12,\"echo\":false,\"presence\":{\"typing\":false}}]`); to change them the\n * client opens a new stream. Frames go out as events named `rt`; everything the client sends goes to {@link postRoute}.\n *\n * @param hub The hub.\n * @param options How to identify the connection and which origins may connect.\n * @returns A handler shaped like Dusk's `SSE` export.\n * @example\n * import { createHub } from \"@shadow-js/realtime/server\";\n *\n * const hub = createHub({ channels: { \"chat:{room}\": { subscribe: true, publish: true } } });\n * export const SSE = hub.sse();\n * @since 1.0.0\n */\nexport function sseRoute<E extends RequestLike>(\n hub: HubCore,\n options: HubRouteOptions<E> = {},\n): (event: E, stream: SseLike) => Promise<void> {\n return async (event, stream) => {\n if (!originAllowed(event.request, options.allowedOrigins)) {\n hub.report(new RealtimeError(\"forbidden\", __DEV__ ? \"origin refused\" : undefined), {\n where: \"sse.origin\",\n });\n await refuseStream(stream, __DEV__ ? \"origin not allowed\" : \"\");\n return;\n }\n const result = await identify(options, event);\n // The list is read only for an identified connection; either refusal ends the stream the same way.\n const entries = \"refusal\" in result ? undefined : declared(new URL(event.request.url));\n if (\"refusal\" in result || entries === undefined) {\n await refuseStream(\n stream,\n __DEV__ ? (\"refusal\" in result ? \"unauthorized\" : \"bad subscription list\") : \"\",\n );\n return;\n }\n let pendingBytes = 0;\n const transport: Transport = {\n send(frame) {\n if (stream.closed) return false;\n pendingBytes += frame.length;\n stream.send({ event: \"rt\", data: frame }).then(\n () => {\n pendingBytes -= frame.length;\n },\n () => {\n pendingBytes = Number.MAX_SAFE_INTEGER;\n connection.closed();\n },\n );\n return true;\n },\n close: () => stream.close(),\n buffered: () => pendingBytes,\n };\n const connection = hub.connect(transport, result.identity);\n entries.forEach((entry, at) => {\n // The type and the number come last: an entry that names its own `t` must not turn a declaration into a publish.\n connection.receive(JSON.stringify({ ...entry, t: \"sub\", n: at + 1 }));\n });\n if (!stream.signal.aborted)\n await new Promise<void>((resolve) => {\n stream.signal.addEventListener(\"abort\", () => resolve(), { once: true });\n });\n connection.closed();\n await connection.done;\n };\n}\n\n/**\n * The HTTP route that carries what an SSE client sends: `export const POST = hub.post()`. The body is\n * `{\"cid\": \"<connection id>\", \"frames\": [ ... ]}` (at most 64 frames of the types `pub`, `req`, `pres`); the answer is\n * `{\"frames\": [ ... ]}` with the acks, replies and errors. It keeps nothing between requests, so any server can answer it.\n *\n * The request rate of one caller is limited by `key` (default: the user, else all anonymous callers together) with the hub's\n * publish limits; put Dusk's rate limiting in front of the route for per-address limits.\n *\n * @param hub The hub.\n * @param options Identity, origins and the rate-limit key.\n * @returns A handler for a Dusk API route.\n * @example\n * import { createHub } from \"@shadow-js/realtime/server\";\n *\n * const hub = createHub({ channels: { \"chat:{room}\": { subscribe: true, publish: true } } });\n * export const POST = hub.post();\n * @since 1.0.0\n */\nexport function postRoute<E extends RequestLike>(\n hub: HubCore,\n options: HubRouteOptions<E> & { readonly key?: (event: E, identity: Identity) => string } = {},\n): (event: E) => Promise<Response> {\n const buckets = new Map<string, TokenBucket>();\n const bucketFor = (key: string): TokenBucket => {\n let bucket = buckets.get(key);\n if (bucket === undefined) {\n if (buckets.size >= MAX_BUCKETS) {\n const oldest = buckets.keys().next().value;\n if (oldest !== undefined) buckets.delete(oldest);\n }\n bucket = new TokenBucket(hub.limits.publishesPerSecond, hub.limits.publishBurst, Date.now());\n buckets.set(key, bucket);\n }\n return bucket;\n };\n return async (event) => {\n const { request } = event;\n if (!originAllowed(request, options.allowedOrigins))\n return refuse(403, \"forbidden\", __DEV__ ? \"origin not allowed\" : undefined);\n const result = await identify(options, event);\n if (\"refusal\" in result) return result.refusal;\n const text = await readBounded(request, hub.limits.maxMessageBytes * 8);\n if (text === undefined)\n return refuse(413, \"too_large\", __DEV__ ? \"the request is too large\" : undefined);\n let body: unknown;\n try {\n body = JSON.parse(text);\n } catch {\n return refuse(400, \"bad_frame\", __DEV__ ? \"the body is not JSON\" : undefined);\n }\n const frames = (body as { frames?: unknown } | null)?.frames;\n const cid = (body as { cid?: unknown } | null)?.cid;\n if (!Array.isArray(frames) || frames.length === 0 || frames.length > MAX_FRAMES_PER_POST)\n return refuse(\n 400,\n \"bad_frame\",\n __DEV__ ? `frames must hold 1..${MAX_FRAMES_PER_POST} frames` : undefined,\n );\n const key = options.key?.(event, result.identity) ?? result.identity.user ?? \"anonymous\";\n const answers: string[] = [];\n const transport: Transport = {\n send(frame) {\n if (!frame.startsWith('{\"t\":\"ready\"')) answers.push(frame);\n return true;\n },\n close: () => undefined,\n };\n const connection = hub.connect(transport, result.identity, {\n stateless: true,\n publishBucket: bucketFor(key),\n ...(typeof cid === \"string\" ? { actingFor: cid } : {}),\n });\n try {\n for (const frame of frames) {\n const type = (frame as { t?: unknown } | null)?.t;\n if (type === \"pres\") {\n const item = frame as { c?: unknown; s?: unknown };\n try {\n if (typeof item.c !== \"string\" || typeof cid !== \"string\")\n throw new RealtimeError(\n \"bad_frame\",\n __DEV__ ? \"pres needs c and the connection id\" : undefined,\n );\n // Each change costs the adapter two calls: it spends from the same bucket as a publish, as it does on a socket.\n if (!bucketFor(key).take(Date.now())) throw new RealtimeError(\"rate_limited\");\n await hub.setMemberState(result.identity, item.c, cid, (item.s ?? null) as Json);\n } catch (error) {\n const code = error instanceof RealtimeError ? error.code : \"unavailable\";\n answers.push(JSON.stringify({ t: \"err\", code }));\n }\n continue;\n }\n if (type !== \"pub\" && type !== \"req\") {\n answers.push(\n JSON.stringify({\n t: \"err\",\n code: \"bad_frame\",\n msg: __DEV__ ? \"only pub, req and pres\" : undefined,\n }),\n );\n continue;\n }\n connection.receive(JSON.stringify(frame));\n }\n await connection.settled();\n } finally {\n connection.closed();\n }\n return jsonResponse(200, `{\"frames\":[${answers.join(\",\")}]}`);\n };\n}\n"],"mappings":"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"}
|