@vielzeug/pulse 1.0.3
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/README.md +68 -0
- package/dist/_dev.cjs +2 -0
- package/dist/_dev.cjs.map +1 -0
- package/dist/_dev.d.ts +2 -0
- package/dist/_dev.d.ts.map +1 -0
- package/dist/_dev.js +9 -0
- package/dist/_dev.js.map +1 -0
- package/dist/_utils.cjs +2 -0
- package/dist/_utils.cjs.map +1 -0
- package/dist/_utils.d.ts +2 -0
- package/dist/_utils.d.ts.map +1 -0
- package/dist/_utils.js +36 -0
- package/dist/_utils.js.map +1 -0
- package/dist/_wait.cjs +2 -0
- package/dist/_wait.cjs.map +1 -0
- package/dist/_wait.d.ts +2 -0
- package/dist/_wait.d.ts.map +1 -0
- package/dist/_wait.js +29 -0
- package/dist/_wait.js.map +1 -0
- package/dist/channel.cjs +2 -0
- package/dist/channel.cjs.map +1 -0
- package/dist/channel.d.ts +2 -0
- package/dist/channel.d.ts.map +1 -0
- package/dist/channel.js +58 -0
- package/dist/channel.js.map +1 -0
- package/dist/errors.cjs +2 -0
- package/dist/errors.cjs.map +1 -0
- package/dist/errors.d.ts +45 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +36 -0
- package/dist/errors.js.map +1 -0
- package/dist/heartbeat.cjs +2 -0
- package/dist/heartbeat.cjs.map +1 -0
- package/dist/heartbeat.d.ts +9 -0
- package/dist/heartbeat.d.ts.map +1 -0
- package/dist/heartbeat.js +37 -0
- package/dist/heartbeat.js.map +1 -0
- package/dist/index.cjs +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +3 -0
- package/dist/presence.cjs +2 -0
- package/dist/presence.cjs.map +1 -0
- package/dist/presence.d.ts +8 -0
- package/dist/presence.d.ts.map +1 -0
- package/dist/presence.js +71 -0
- package/dist/presence.js.map +1 -0
- package/dist/protocol.cjs +2 -0
- package/dist/protocol.cjs.map +1 -0
- package/dist/protocol.d.ts +81 -0
- package/dist/protocol.d.ts.map +1 -0
- package/dist/protocol.js +20 -0
- package/dist/protocol.js.map +1 -0
- package/dist/pulse.cjs +2 -0
- package/dist/pulse.cjs.map +1 -0
- package/dist/pulse.d.ts +16 -0
- package/dist/pulse.d.ts.map +1 -0
- package/dist/pulse.iife.js +2 -0
- package/dist/pulse.iife.js.map +1 -0
- package/dist/pulse.js +2 -0
- package/dist/pulse.js.map +1 -0
- package/dist/reconnect.cjs +2 -0
- package/dist/reconnect.cjs.map +1 -0
- package/dist/reconnect.d.ts +10 -0
- package/dist/reconnect.d.ts.map +1 -0
- package/dist/reconnect.js +29 -0
- package/dist/reconnect.js.map +1 -0
- package/dist/types.d.ts +243 -0
- package/dist/types.d.ts.map +1 -0
- package/package.json +43 -0
package/dist/presence.js
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { warn as e } from "./_dev.js";
|
|
2
|
+
import { deriveAbortController as t } from "./_utils.js";
|
|
3
|
+
import { encode as n } from "./protocol.js";
|
|
4
|
+
import { signal as r } from "@vielzeug/ripple";
|
|
5
|
+
//#region src/presence.ts
|
|
6
|
+
function i(i, a, o, s) {
|
|
7
|
+
let c = t(s), l = c.signal.aborted, u = r(/* @__PURE__ */ new Map()), d = /* @__PURE__ */ new Set(), f = /* @__PURE__ */ new Set(), p = [
|
|
8
|
+
o.onState((e) => {
|
|
9
|
+
if (e.room !== i) return;
|
|
10
|
+
let t = /* @__PURE__ */ new Map();
|
|
11
|
+
for (let [n, r] of Object.entries(e.members)) t.set(n, r);
|
|
12
|
+
u.value = t;
|
|
13
|
+
}),
|
|
14
|
+
o.onJoin((e) => {
|
|
15
|
+
if (e.room !== i) return;
|
|
16
|
+
let t = new Map(u.value);
|
|
17
|
+
t.set(e.id, e.state), u.value = t;
|
|
18
|
+
for (let t of d) t(e.id, e.state);
|
|
19
|
+
}),
|
|
20
|
+
o.onLeave((e) => {
|
|
21
|
+
if (e.room !== i) return;
|
|
22
|
+
let t = new Map(u.value);
|
|
23
|
+
t.delete(e.id), u.value = t;
|
|
24
|
+
for (let t of f) t(e.id);
|
|
25
|
+
})
|
|
26
|
+
];
|
|
27
|
+
return {
|
|
28
|
+
get disposalSignal() {
|
|
29
|
+
return c.signal;
|
|
30
|
+
},
|
|
31
|
+
dispose() {
|
|
32
|
+
if (!l) {
|
|
33
|
+
l = !0, a(n({
|
|
34
|
+
room: i,
|
|
35
|
+
type: "leave"
|
|
36
|
+
})), c.abort();
|
|
37
|
+
for (let e of p) e();
|
|
38
|
+
p.length = 0, d.clear(), f.clear(), u.dispose();
|
|
39
|
+
}
|
|
40
|
+
},
|
|
41
|
+
get disposed() {
|
|
42
|
+
return l;
|
|
43
|
+
},
|
|
44
|
+
onJoin(t) {
|
|
45
|
+
return l ? (e(`onJoin() called on a disposed presence channel '${i}' — listener ignored`), () => {}) : (d.add(t), () => d.delete(t));
|
|
46
|
+
},
|
|
47
|
+
onLeave(t) {
|
|
48
|
+
return l ? (e(`onLeave() called on a disposed presence channel '${i}' — listener ignored`), () => {}) : (f.add(t), () => f.delete(t));
|
|
49
|
+
},
|
|
50
|
+
get room() {
|
|
51
|
+
return i;
|
|
52
|
+
},
|
|
53
|
+
get state() {
|
|
54
|
+
return u;
|
|
55
|
+
},
|
|
56
|
+
[Symbol.dispose]() {
|
|
57
|
+
this.dispose();
|
|
58
|
+
},
|
|
59
|
+
update(e) {
|
|
60
|
+
l || a(n({
|
|
61
|
+
room: i,
|
|
62
|
+
state: e,
|
|
63
|
+
type: "presence"
|
|
64
|
+
}));
|
|
65
|
+
}
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
//#endregion
|
|
69
|
+
export { i as createPresence };
|
|
70
|
+
|
|
71
|
+
//# sourceMappingURL=presence.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"presence.js","names":[],"sources":["../src/presence.ts"],"sourcesContent":["import { type Signal, signal } from '@vielzeug/ripple';\n\nimport type { PresenceChannel, Unsubscribe } from './types';\n\nimport { warn } from './_dev';\nimport { deriveAbortController } from './_utils';\nimport { type InPresenceJoinFrame, type InPresenceLeaveFrame, type InPresenceStateFrame, encode } from './protocol';\n\ntype RawSendFn = (frame: string) => void;\n\nexport type PresenceEvents = {\n onJoin(handler: (frame: InPresenceJoinFrame) => void): Unsubscribe;\n onLeave(handler: (frame: InPresenceLeaveFrame) => void): Unsubscribe;\n onState(handler: (frame: InPresenceStateFrame) => void): Unsubscribe;\n};\n\n/**\n * Create a presence channel that reactively tracks room member states.\n * @internal\n */\nexport function createPresence<T>(\n room: string,\n rawSend: RawSendFn,\n events: PresenceEvents,\n disposalSignal: AbortSignal,\n): PresenceChannel<T> {\n const ctrl = deriveAbortController(disposalSignal);\n\n let disposed = ctrl.signal.aborted;\n\n const members: Signal<Map<string, T>> = signal(new Map<string, T>());\n const joinHandlers = new Set<(memberId: string, state: T) => void>();\n const leaveHandlers = new Set<(memberId: string) => void>();\n\n const unsubs: Array<() => void> = [\n events.onState((frame) => {\n if (frame.room !== room) return;\n\n const next = new Map<string, T>();\n\n for (const [id, state] of Object.entries(frame.members)) {\n next.set(id, state as T);\n }\n\n members.value = next;\n }),\n events.onJoin((frame) => {\n if (frame.room !== room) return;\n\n const next = new Map(members.value);\n\n next.set(frame.id, frame.state as T);\n members.value = next;\n\n for (const handler of joinHandlers) {\n handler(frame.id, frame.state as T);\n }\n }),\n events.onLeave((frame) => {\n if (frame.room !== room) return;\n\n const next = new Map(members.value);\n\n next.delete(frame.id);\n members.value = next;\n\n for (const handler of leaveHandlers) {\n handler(frame.id);\n }\n }),\n ];\n\n const presence: PresenceChannel<T> = {\n get disposalSignal() {\n return ctrl.signal;\n },\n\n dispose() {\n if (disposed) return;\n\n disposed = true;\n rawSend(encode({ room, type: 'leave' }));\n ctrl.abort();\n\n for (const unsub of unsubs) unsub();\n\n unsubs.length = 0;\n joinHandlers.clear();\n leaveHandlers.clear();\n members.dispose();\n },\n\n get disposed() {\n return disposed;\n },\n\n onJoin(handler: (memberId: string, state: T) => void): Unsubscribe {\n if (disposed) {\n warn(`onJoin() called on a disposed presence channel '${room}' — listener ignored`);\n\n return () => {};\n }\n\n joinHandlers.add(handler);\n\n return () => joinHandlers.delete(handler);\n },\n\n onLeave(handler: (memberId: string) => void): Unsubscribe {\n if (disposed) {\n warn(`onLeave() called on a disposed presence channel '${room}' — listener ignored`);\n\n return () => {};\n }\n\n leaveHandlers.add(handler);\n\n return () => leaveHandlers.delete(handler);\n },\n\n get room() {\n return room;\n },\n\n get state() {\n return members;\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n\n update(state: T): void {\n if (disposed) return;\n\n rawSend(encode({ room, state, type: 'presence' }));\n },\n };\n\n return presence;\n}\n"],"mappings":";;;;;AAoBA,SAAgB,EACd,GACA,GACA,GACA,GACoB;CACpB,IAAM,IAAO,EAAsB,CAAc,GAE7C,IAAW,EAAK,OAAO,SAErB,IAAkC,kBAAO,IAAI,IAAe,CAAC,GAC7D,oBAAe,IAAI,IAA0C,GAC7D,oBAAgB,IAAI,IAAgC,GAEpD,IAA4B;EAChC,EAAO,SAAS,MAAU;GACxB,IAAI,EAAM,SAAS,GAAM;GAEzB,IAAM,oBAAO,IAAI,IAAe;GAEhC,KAAK,IAAM,CAAC,GAAI,MAAU,OAAO,QAAQ,EAAM,OAAO,GACpD,EAAK,IAAI,GAAI,CAAU;GAGzB,EAAQ,QAAQ;EAClB,CAAC;EACD,EAAO,QAAQ,MAAU;GACvB,IAAI,EAAM,SAAS,GAAM;GAEzB,IAAM,IAAO,IAAI,IAAI,EAAQ,KAAK;GAGlC,AADA,EAAK,IAAI,EAAM,IAAI,EAAM,KAAU,GACnC,EAAQ,QAAQ;GAEhB,KAAK,IAAM,KAAW,GACpB,EAAQ,EAAM,IAAI,EAAM,KAAU;EAEtC,CAAC;EACD,EAAO,SAAS,MAAU;GACxB,IAAI,EAAM,SAAS,GAAM;GAEzB,IAAM,IAAO,IAAI,IAAI,EAAQ,KAAK;GAGlC,AADA,EAAK,OAAO,EAAM,EAAE,GACpB,EAAQ,QAAQ;GAEhB,KAAK,IAAM,KAAW,GACpB,EAAQ,EAAM,EAAE;EAEpB,CAAC;CACH;CAqEA,OAAO;EAlEL,IAAI,iBAAiB;GACnB,OAAO,EAAK;EACd;EAEA,UAAU;GACJ,QAIJ;IAFA,IAAW,IACX,EAAQ,EAAO;KAAE;KAAM,MAAM;IAAQ,CAAC,CAAC,GACvC,EAAK,MAAM;IAEX,KAAK,IAAM,KAAS,GAAQ,EAAM;IAKlC,AAHA,EAAO,SAAS,GAChB,EAAa,MAAM,GACnB,EAAc,MAAM,GACpB,EAAQ,QAAQ;GAPL;EAQb;EAEA,IAAI,WAAW;GACb,OAAO;EACT;EAEA,OAAO,GAA4D;GASjE,OARI,KACF,EAAK,mDAAmD,EAAK,qBAAqB,SAErE,CAAC,MAGhB,EAAa,IAAI,CAAO,SAEX,EAAa,OAAO,CAAO;EAC1C;EAEA,QAAQ,GAAkD;GASxD,OARI,KACF,EAAK,oDAAoD,EAAK,qBAAqB,SAEtE,CAAC,MAGhB,EAAc,IAAI,CAAO,SAEZ,EAAc,OAAO,CAAO;EAC3C;EAEA,IAAI,OAAO;GACT,OAAO;EACT;EAEA,IAAI,QAAQ;GACV,OAAO;EACT;EAEA,CAAC,OAAO,WAAW;GACjB,KAAK,QAAQ;EACf;EAEA,OAAO,GAAgB;GACjB,KAEJ,EAAQ,EAAO;IAAE;IAAM;IAAO,MAAM;GAAW,CAAC,CAAC;EACnD;CAGK;AACT"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./errors.cjs");function t(e){return JSON.stringify(e)}function n(t){if(typeof t!=`string`)throw new e.PulseProtocolError(`Expected string message data`,t);let n;try{n=JSON.parse(t)}catch{throw new e.PulseProtocolError(`JSON parse error`,t)}if(typeof n!=`object`||!n||!(`type`in n)||typeof n.type!=`string`)throw new e.PulseProtocolError(`Missing or invalid "type" field`,n);return n}exports.decode=n,exports.encode=t;
|
|
2
|
+
//# sourceMappingURL=protocol.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.cjs","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["import { PulseProtocolError } from './errors';\n\n// ─── Outgoing frames (client → server) ────────────────────────────────────────\n\nexport type OutMessageFrame = { channel?: string; event: string; payload: unknown; type: 'message' };\nexport type OutSubscribeFrame = { channel: string; type: 'subscribe' };\nexport type OutUnsubscribeFrame = { channel: string; type: 'unsubscribe' };\nexport type OutJoinFrame = { room: string; type: 'join' };\nexport type OutLeaveFrame = { room: string; type: 'leave' };\nexport type OutPresenceFrame = { room: string; state: unknown; type: 'presence' };\nexport type OutPingFrame = { ts: number; type: 'ping' };\n\nexport type OutFrame =\n | OutJoinFrame\n | OutLeaveFrame\n | OutMessageFrame\n | OutPingFrame\n | OutPresenceFrame\n | OutSubscribeFrame\n | OutUnsubscribeFrame;\n\n// ─── Incoming frames (server → client) ────────────────────────────────────────\n\nexport type InMessageFrame = { channel?: string; event: string; payload: unknown; type: 'message' };\nexport type InSubscribedFrame = { channel: string; type: 'subscribed' };\nexport type InUnsubscribedFrame = { channel: string; type: 'unsubscribed' };\nexport type InJoinedFrame = { room: string; type: 'joined' };\nexport type InLeftFrame = { room: string; type: 'left' };\nexport type InPresenceStateFrame = { members: Record<string, unknown>; room: string; type: 'presence_state' };\nexport type InPresenceJoinFrame = { id: string; room: string; state: unknown; type: 'presence_join' };\nexport type InPresenceLeaveFrame = { id: string; room: string; type: 'presence_leave' };\nexport type InPongFrame = { ts: number; type: 'pong' };\nexport type InErrorFrame = { code: string; message: string; type: 'error' };\n\nexport type InFrame =\n | InErrorFrame\n | InJoinedFrame\n | InLeftFrame\n | InMessageFrame\n | InPongFrame\n | InPresenceJoinFrame\n | InPresenceLeaveFrame\n | InPresenceStateFrame\n | InSubscribedFrame\n | InUnsubscribedFrame;\n\n// ─── Codec ────────────────────────────────────────────────────────────────────\n\n/**\n * Encode an outgoing frame to a JSON string.\n * @internal\n */\nexport function encode(frame: OutFrame): string {\n return JSON.stringify(frame);\n}\n\n/**\n * Parse a raw MessageEvent data string into a typed InFrame.\n * Throws `PulseProtocolError` if the data is not valid JSON or missing the `type` field.\n * @internal\n */\nexport function decode(raw: unknown): InFrame {\n if (typeof raw !== 'string') {\n throw new PulseProtocolError('Expected string message data', raw);\n }\n\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(raw);\n } catch (cause) {\n throw new PulseProtocolError('JSON parse error', raw);\n }\n\n if (\n parsed === null ||\n typeof parsed !== 'object' ||\n !('type' in parsed) ||\n typeof (parsed as { type: unknown }).type !== 'string'\n ) {\n throw new PulseProtocolError('Missing or invalid \"type\" field', parsed);\n }\n\n return parsed as InFrame;\n}\n"],"mappings":"gCAoDA,SAAgB,EAAO,EAAyB,CAC9C,OAAO,KAAK,UAAU,CAAK,CAC7B,CAOA,SAAgB,EAAO,EAAuB,CAC5C,GAAI,OAAO,GAAQ,SACjB,MAAM,IAAI,EAAA,mBAAmB,+BAAgC,CAAG,EAGlE,IAAI,EAEJ,GAAI,CACF,EAAS,KAAK,MAAM,CAAG,CACzB,MAAgB,CACd,MAAM,IAAI,EAAA,mBAAmB,mBAAoB,CAAG,CACtD,CAEA,GAEE,OAAO,GAAW,WADlB,GAEA,EAAE,SAAU,IACZ,OAAQ,EAA6B,MAAS,SAE9C,MAAM,IAAI,EAAA,mBAAmB,kCAAmC,CAAM,EAGxE,OAAO,CACT"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
export type OutMessageFrame = {
|
|
2
|
+
channel?: string;
|
|
3
|
+
event: string;
|
|
4
|
+
payload: unknown;
|
|
5
|
+
type: 'message';
|
|
6
|
+
};
|
|
7
|
+
export type OutSubscribeFrame = {
|
|
8
|
+
channel: string;
|
|
9
|
+
type: 'subscribe';
|
|
10
|
+
};
|
|
11
|
+
export type OutUnsubscribeFrame = {
|
|
12
|
+
channel: string;
|
|
13
|
+
type: 'unsubscribe';
|
|
14
|
+
};
|
|
15
|
+
export type OutJoinFrame = {
|
|
16
|
+
room: string;
|
|
17
|
+
type: 'join';
|
|
18
|
+
};
|
|
19
|
+
export type OutLeaveFrame = {
|
|
20
|
+
room: string;
|
|
21
|
+
type: 'leave';
|
|
22
|
+
};
|
|
23
|
+
export type OutPresenceFrame = {
|
|
24
|
+
room: string;
|
|
25
|
+
state: unknown;
|
|
26
|
+
type: 'presence';
|
|
27
|
+
};
|
|
28
|
+
export type OutPingFrame = {
|
|
29
|
+
ts: number;
|
|
30
|
+
type: 'ping';
|
|
31
|
+
};
|
|
32
|
+
export type OutFrame = OutJoinFrame | OutLeaveFrame | OutMessageFrame | OutPingFrame | OutPresenceFrame | OutSubscribeFrame | OutUnsubscribeFrame;
|
|
33
|
+
export type InMessageFrame = {
|
|
34
|
+
channel?: string;
|
|
35
|
+
event: string;
|
|
36
|
+
payload: unknown;
|
|
37
|
+
type: 'message';
|
|
38
|
+
};
|
|
39
|
+
export type InSubscribedFrame = {
|
|
40
|
+
channel: string;
|
|
41
|
+
type: 'subscribed';
|
|
42
|
+
};
|
|
43
|
+
export type InUnsubscribedFrame = {
|
|
44
|
+
channel: string;
|
|
45
|
+
type: 'unsubscribed';
|
|
46
|
+
};
|
|
47
|
+
export type InJoinedFrame = {
|
|
48
|
+
room: string;
|
|
49
|
+
type: 'joined';
|
|
50
|
+
};
|
|
51
|
+
export type InLeftFrame = {
|
|
52
|
+
room: string;
|
|
53
|
+
type: 'left';
|
|
54
|
+
};
|
|
55
|
+
export type InPresenceStateFrame = {
|
|
56
|
+
members: Record<string, unknown>;
|
|
57
|
+
room: string;
|
|
58
|
+
type: 'presence_state';
|
|
59
|
+
};
|
|
60
|
+
export type InPresenceJoinFrame = {
|
|
61
|
+
id: string;
|
|
62
|
+
room: string;
|
|
63
|
+
state: unknown;
|
|
64
|
+
type: 'presence_join';
|
|
65
|
+
};
|
|
66
|
+
export type InPresenceLeaveFrame = {
|
|
67
|
+
id: string;
|
|
68
|
+
room: string;
|
|
69
|
+
type: 'presence_leave';
|
|
70
|
+
};
|
|
71
|
+
export type InPongFrame = {
|
|
72
|
+
ts: number;
|
|
73
|
+
type: 'pong';
|
|
74
|
+
};
|
|
75
|
+
export type InErrorFrame = {
|
|
76
|
+
code: string;
|
|
77
|
+
message: string;
|
|
78
|
+
type: 'error';
|
|
79
|
+
};
|
|
80
|
+
export type InFrame = InErrorFrame | InJoinedFrame | InLeftFrame | InMessageFrame | InPongFrame | InPresenceJoinFrame | InPresenceLeaveFrame | InPresenceStateFrame | InSubscribedFrame | InUnsubscribedFrame;
|
|
81
|
+
//# sourceMappingURL=protocol.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}
|
package/dist/protocol.js
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { PulseProtocolError as e } from "./errors.js";
|
|
2
|
+
//#region src/protocol.ts
|
|
3
|
+
function t(e) {
|
|
4
|
+
return JSON.stringify(e);
|
|
5
|
+
}
|
|
6
|
+
function n(t) {
|
|
7
|
+
if (typeof t != "string") throw new e("Expected string message data", t);
|
|
8
|
+
let n;
|
|
9
|
+
try {
|
|
10
|
+
n = JSON.parse(t);
|
|
11
|
+
} catch {
|
|
12
|
+
throw new e("JSON parse error", t);
|
|
13
|
+
}
|
|
14
|
+
if (typeof n != "object" || !n || !("type" in n) || typeof n.type != "string") throw new e("Missing or invalid \"type\" field", n);
|
|
15
|
+
return n;
|
|
16
|
+
}
|
|
17
|
+
//#endregion
|
|
18
|
+
export { n as decode, t as encode };
|
|
19
|
+
|
|
20
|
+
//# sourceMappingURL=protocol.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protocol.js","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["import { PulseProtocolError } from './errors';\n\n// ─── Outgoing frames (client → server) ────────────────────────────────────────\n\nexport type OutMessageFrame = { channel?: string; event: string; payload: unknown; type: 'message' };\nexport type OutSubscribeFrame = { channel: string; type: 'subscribe' };\nexport type OutUnsubscribeFrame = { channel: string; type: 'unsubscribe' };\nexport type OutJoinFrame = { room: string; type: 'join' };\nexport type OutLeaveFrame = { room: string; type: 'leave' };\nexport type OutPresenceFrame = { room: string; state: unknown; type: 'presence' };\nexport type OutPingFrame = { ts: number; type: 'ping' };\n\nexport type OutFrame =\n | OutJoinFrame\n | OutLeaveFrame\n | OutMessageFrame\n | OutPingFrame\n | OutPresenceFrame\n | OutSubscribeFrame\n | OutUnsubscribeFrame;\n\n// ─── Incoming frames (server → client) ────────────────────────────────────────\n\nexport type InMessageFrame = { channel?: string; event: string; payload: unknown; type: 'message' };\nexport type InSubscribedFrame = { channel: string; type: 'subscribed' };\nexport type InUnsubscribedFrame = { channel: string; type: 'unsubscribed' };\nexport type InJoinedFrame = { room: string; type: 'joined' };\nexport type InLeftFrame = { room: string; type: 'left' };\nexport type InPresenceStateFrame = { members: Record<string, unknown>; room: string; type: 'presence_state' };\nexport type InPresenceJoinFrame = { id: string; room: string; state: unknown; type: 'presence_join' };\nexport type InPresenceLeaveFrame = { id: string; room: string; type: 'presence_leave' };\nexport type InPongFrame = { ts: number; type: 'pong' };\nexport type InErrorFrame = { code: string; message: string; type: 'error' };\n\nexport type InFrame =\n | InErrorFrame\n | InJoinedFrame\n | InLeftFrame\n | InMessageFrame\n | InPongFrame\n | InPresenceJoinFrame\n | InPresenceLeaveFrame\n | InPresenceStateFrame\n | InSubscribedFrame\n | InUnsubscribedFrame;\n\n// ─── Codec ────────────────────────────────────────────────────────────────────\n\n/**\n * Encode an outgoing frame to a JSON string.\n * @internal\n */\nexport function encode(frame: OutFrame): string {\n return JSON.stringify(frame);\n}\n\n/**\n * Parse a raw MessageEvent data string into a typed InFrame.\n * Throws `PulseProtocolError` if the data is not valid JSON or missing the `type` field.\n * @internal\n */\nexport function decode(raw: unknown): InFrame {\n if (typeof raw !== 'string') {\n throw new PulseProtocolError('Expected string message data', raw);\n }\n\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(raw);\n } catch (cause) {\n throw new PulseProtocolError('JSON parse error', raw);\n }\n\n if (\n parsed === null ||\n typeof parsed !== 'object' ||\n !('type' in parsed) ||\n typeof (parsed as { type: unknown }).type !== 'string'\n ) {\n throw new PulseProtocolError('Missing or invalid \"type\" field', parsed);\n }\n\n return parsed as InFrame;\n}\n"],"mappings":";;AAoDA,SAAgB,EAAO,GAAyB;CAC9C,OAAO,KAAK,UAAU,CAAK;AAC7B;AAOA,SAAgB,EAAO,GAAuB;CAC5C,IAAI,OAAO,KAAQ,UACjB,MAAM,IAAI,EAAmB,gCAAgC,CAAG;CAGlE,IAAI;CAEJ,IAAI;EACF,IAAS,KAAK,MAAM,CAAG;CACzB,QAAgB;EACd,MAAM,IAAI,EAAmB,oBAAoB,CAAG;CACtD;CAEA,IAEE,OAAO,KAAW,aADlB,KAEA,EAAE,UAAU,MACZ,OAAQ,EAA6B,QAAS,UAE9C,MAAM,IAAI,EAAmB,qCAAmC,CAAM;CAGxE,OAAO;AACT"}
|
package/dist/pulse.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},t=class extends e{url;constructor(e,t,n){super(e,n),this.url=t}},n=class extends e{event;constructor(e,t){super(`Timed out waiting for "${e}"`,t),this.event=e}},r=class extends e{constructor(e){super(`Aborted`,e)}},i=class extends e{constructor(e=`Pulse`,t){super(`${e} instance is disposed`,t)}},a=class extends e{raw;constructor(e,t,n){super(e,n),this.raw=t}},o=null,s=()=>o,c=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},l=class extends c{},u=0,d=()=>++u,f={scheduling:{activeDirty:`a`,batchDepth:0,dirtyWithEffectSubsA:new Set,dirtyWithEffectSubsB:new Set,pendingSubscribers:new Set},scopeCleanups:null,tracking:null},p=null,m=()=>p===null?f:p.get(),h=()=>m().scheduling,g=()=>p!==null,_=()=>m().tracking,v=e=>{let t=_();if(t!==null){if(t.sourceObserver?.(e),t.kind===`computed`)t.depCollector.push({source:e,version:e.version});else if(t.kind===`effect`){let n=t.effect;e.addEffectSub(n),t.subscriptions.add(()=>e.removeEffectSub(n)),t.deps.set(e,e.version)}}},y=e=>e instanceof Error?e:Error(`Non-Error thrown: ${String(e)}`),b=e=>{let t=[];for(let n of e)try{n()}catch(e){t.push(y(e))}return t},x=(e,t)=>{let n=b(e);if(n.length===1)throw n[0];if(n.length>0)throw AggregateError(n,t)},S=!globalThis.__RIPPLE_PROD__;function C(e){S&&console.warn(`[@vielzeug/ripple] ${e}`)}var w=!1,T=0,E=[],D=e=>e.activeDirty===`a`?e.dirtyWithEffectSubsA:e.dirtyWithEffectSubsB,O=(e,t)=>{let n=++T;for(let n of t.effectSubs())e.pendingSubscribers.add(n);for(let e of t.computedSubs())E.push(e);try{for(;E.length>0;){let t=E.pop();if(t.lastPropEpoch_!==n&&(t.lastPropEpoch_=n,t.markDirty())){t.effectSubs().size>0&&D(e).add(t);for(let e of t.computedSubs())E.push(e)}}}finally{E.length=0}},k=e=>{for(;D(e).size>0;){let t=D(e);e.activeDirty=e.activeDirty===`a`?`b`:`a`,D(e).clear();for(let n of t)if(n.hasSubscribers()&&n.refreshIfDirty()){for(let t of n.effectSubs())e.pendingSubscribers.add(t);for(let t of n.computedSubs())t.markDirty()&&t.effectSubs().size>0&&D(e).add(t)}t.clear()}},A=e=>{let t=0;for(;e.pendingSubscribers.size>0||D(e).size>0;){if(++t>100)throw new l(`infinite flush loop (> 100 iterations)`);if(D(e).size>0&&k(e),e.pendingSubscribers.size===0)continue;let n=[...e.pendingSubscribers];e.pendingSubscribers.clear(),x(n,`subscriber errors`)}},j=globalThis.process?.versions!=null,M=e=>{if(!e.hasSubscribers())return;!w&&j&&!g()&&(w=!0,C(`Signal updated in a Node.js-like environment. The module-level flush queue is shared across concurrent requests — use per-request worker isolation or the @vielzeug/ripple/ssr sub-path for request-isolated scheduling.`));let t=h();O(t,e),t.batchDepth===0&&A(t)},N=class{fn_;disposed_=!1;constructor(e){this.fn_=e}get disposed(){return this.disposed_}dispose(){if(this.disposed_)return;this.disposed_=!0;let e=this.fn_;this.fn_=null,e()}[Symbol.dispose](){this.dispose()}},P=Symbol(`ripple.is-signal`),F=new FinalizationRegistry(({key:e,map:t})=>{t.delete(e)}),I=class{version=0;name;[P]=!0;computedSubs_=new Map;effectSubs_=new Set;constructor(e){this.name=e}addComputedSub(e){let t=new WeakRef(e);this.computedSubs_.set(e,t),F.register(e,{key:e,map:this.computedSubs_},t)}removeComputedSub(e){let t=this.computedSubs_.get(e);t!==void 0&&(this.computedSubs_.delete(e),F.unregister(t))}addEffectSub(e){this.effectSubs_.add(e)}removeEffectSub(e){this.effectSubs_.delete(e)}clearSubscribers(){for(let e of this.computedSubs_.values())F.unregister(e);this.computedSubs_.clear(),this.effectSubs_.clear()}hasSubscribers(){if(this.effectSubs_.size>0)return!0;for(let e of this.computedSubs_.values())if(e.deref()!==void 0)return!0;return!1}*computedSubs(){for(let[e,t]of this.computedSubs_){let n=t.deref();n===void 0?(this.computedSubs_.delete(e),F.unregister(t)):yield n}}effectSubs(){return this.effectSubs_}},L=class extends I{value_;equals_;disposed_;constructor(e,t,n){super(n),this.value_=e,this.equals_=t??Object.is,this.disposed_=!1}get value(){return this.disposed_||v(this),this.value_}set value(e){if(this.disposed_||this.equals_(this.value_,e))return;let t=this.value_;this.value_=e,this.version=d(),s()?.write?.({name:this.name,newValue:e,oldValue:t}),M(this)}peek(){return this.value_}subscribe=e=>{if(this.disposed_){let e=new N(()=>{});return e.dispose(),e}return this.addEffectSub(e),new N(()=>{this.removeEffectSub(e)})};get disposed(){return this.disposed_}dispose(){this.disposed_||(this.disposed_=!0,this.clearSubscribers(),s()?.dispose?.({kind:`signal`,name:this.name}))}[Symbol.dispose](){this.dispose()}},R=(e,t)=>new L(e,t?.equals,t?.name),z=!globalThis.__PULSE_PROD__;function B(e){z&&console.warn(`[@vielzeug/pulse] ${e}`)}function V(e,...t){return t.length===0?e:t.reduce(H,e)}function H(e,t){if(e.aborted)return e;if(t.aborted)return t;let n=new AbortController,r=()=>n.abort(e.reason),i=()=>n.abort(t.reason);return e.addEventListener(`abort`,r,{once:!0}),t.addEventListener(`abort`,i,{once:!0}),n.signal.addEventListener(`abort`,()=>{e.removeEventListener(`abort`,r),t.removeEventListener(`abort`,i)},{once:!0}),n.signal}function U(e){let t=new AbortController;return e.aborted?t.abort(e.reason):e.addEventListener(`abort`,()=>t.abort(e.reason),{once:!0}),t}function W(e,t){return new Promise(n=>{if(t?.aborted){n();return}let r=setTimeout(n,e);t?.addEventListener(`abort`,()=>{clearTimeout(r),n()},{once:!0})})}function G(e,t=3e4){let n=Math.min(1e3*2**e,t);return Math.random()*n}function K(e,t,i,a){return new Promise((o,s)=>{let c=[t],l;if(i?.signal&&c.push(i.signal),i?.timeout!==void 0){let t=new AbortController;l=setTimeout(()=>{t.abort(new n(e))},i.timeout),c.push(t.signal)}let u=c.length===1?c[0]:V(c[0],...c.slice(1));if(u.aborted){clearTimeout(l),s(u.reason instanceof n?u.reason:new r);return}let d=()=>{},f=()=>{clearTimeout(l),d(),s(u.reason instanceof n?u.reason:new r)};u.addEventListener(`abort`,f,{once:!0}),d=a(e,e=>{clearTimeout(l),u.removeEventListener(`abort`,f),o(e)})})}function q(e,t,n,r,i){let a=U(r),o=new Set,s=a.signal.aborted;return{get disposalSignal(){return a.signal},dispose(){if(!s){s=!0,a.abort();for(let e of o)e();o.clear(),i?.()}},get disposed(){return s},get name(){return e},on(t,r){if(s)return B(`on('${String(t)}') called on a disposed channel '${e}' — listener ignored`),()=>{};let i=n(e,t,r);return o.add(i),()=>{i(),o.delete(i)}},once(t,r){if(s)return B(`once('${String(t)}') called on a disposed channel '${e}' — listener ignored`),()=>{};let i=()=>{};return i=n(e,t,e=>{o.delete(i),i(),r(e)}),o.add(i),()=>{o.delete(i),i()}},send(n,r){if(s){B(`send('${String(n)}') called on a disposed channel '${e}' — message dropped`);return}t(e,n,r)},[Symbol.dispose](){this.dispose()},wait(t,r){return K(t,a.signal,r,(t,r)=>n(e,t,r))}}}function J(e){return JSON.stringify(e)}function Y(e){if(typeof e!=`string`)throw new a(`Expected string message data`,e);let t;try{t=JSON.parse(e)}catch{throw new a(`JSON parse error`,e)}if(typeof t!=`object`||!t||!(`type`in t)||typeof t.type!=`string`)throw new a(`Missing or invalid "type" field`,t);return t}var X=3e4,Z=5e3;function Q(e,t,n){if(!e)return{onPong(){},start(){},stop(){}};let r=e===!0?{}:e,i=r.interval??X,a=r.timeout??Z,o,s,c=!1;function l(){o=setTimeout(()=>{t(J({ts:Date.now(),type:`ping`})),s=setTimeout(()=>{B(`Heartbeat timed out after ${a}ms — treating connection as dead`),n()},a)},i)}return{onPong(){clearTimeout(s),s=void 0,c&&l()},start(){c=!0,clearTimeout(o),clearTimeout(s),s=void 0,l()},stop(){c=!1,clearTimeout(o),clearTimeout(s),o=void 0,s=void 0}}}function $(e,t,n,r){let i=U(r),a=i.signal.aborted,o=R(new Map),s=new Set,c=new Set,l=[n.onState(t=>{if(t.room!==e)return;let n=new Map;for(let[e,r]of Object.entries(t.members))n.set(e,r);o.value=n}),n.onJoin(t=>{if(t.room!==e)return;let n=new Map(o.value);n.set(t.id,t.state),o.value=n;for(let e of s)e(t.id,t.state)}),n.onLeave(t=>{if(t.room!==e)return;let n=new Map(o.value);n.delete(t.id),o.value=n;for(let e of c)e(t.id)})];return{get disposalSignal(){return i.signal},dispose(){if(!a){a=!0,t(J({room:e,type:`leave`})),i.abort();for(let e of l)e();l.length=0,s.clear(),c.clear(),o.dispose()}},get disposed(){return a},onJoin(t){return a?(B(`onJoin() called on a disposed presence channel '${e}' — listener ignored`),()=>{}):(s.add(t),()=>s.delete(t))},onLeave(t){return a?(B(`onLeave() called on a disposed presence channel '${e}' — listener ignored`),()=>{}):(c.add(t),()=>c.delete(t))},get room(){return e},get state(){return o},[Symbol.dispose](){this.dispose()},update(n){a||t(J({room:e,state:n,type:`presence`}))}}}var ee=5;function te(e){if(!e)return{attempt:async()=>!1,reset(){}};let t=e===!0?{}:e,n=t.maxAttempts??ee,r=typeof t.delay==`function`?t.delay:typeof t.delay==`number`?()=>t.delay:G,i=0;return{async attempt(e,t,a){if(i>=n)return!1;let o=r(i);if(i++,a?.(i),await W(o,t),t.aborted)return!1;try{return await e(),i=0,!0}catch{return!1}},reset(){i=0}}}var ne=class{map=new Map;add(e,t,n){let r=this.map.get(e);r||(r=new Map,this.map.set(e,r));let i=r.get(t);return i||(i=new Set,r.set(t,i)),i.add(n),()=>{i.delete(n),i.size===0&&r.delete(t),r.size===0&&this.map.delete(e)}}dispatch(e,t,n){this.map.get(e)?.get(t)?.forEach(e=>e(n))}clear(){this.map.clear()}};function re(e,a={}){let o=new AbortController,s=R(`connecting`),c=R(new Set),l=new ne,u=a.middleware??[],d=new Map,f=new Map,p=null,m=!1,h=!1,g=[],_=new Map,v=a.buffer,y=v?[]:null,b=typeof v==`object`&&v?v.maxSize??50:50,x=te(a.reconnect),S=Q(a.heartbeat,e=>{p?.readyState===WebSocket.OPEN&&p.send(e)},()=>{B(`Heartbeat dead — closing socket for reconnect`),p?.close(4e3,`heartbeat timeout`)});function C(e){p?.readyState===WebSocket.OPEN?p.send(e):y===null?B(`send() called while connection is ${s.value} — message dropped`):(y.length>=b&&y.shift(),y.push(e))}function w(e,t,n){let r=0;function i(){if(r>=u.length){n();return}let a=u[r++];a(e,t,i)}i()}function T(){m||(p=new WebSocket(e,a.protocols),p.onopen=()=>{h=!1,s.value=`open`,x.reset(),S.start(),a.onOpen?.();let e=g.splice(0);for(let t of e)t.resolve();if(y&&y.length>0){let e=y.splice(0);for(let t of e)p.send(t)}for(let e of _.keys())p.send(J({channel:e,type:`subscribe`}))},p.onmessage=e=>{a.onMessage?.(e);let t;try{t=Y(e.data)}catch(e){B(`Protocol error: ${String(e)}`);return}try{D(t)}catch(e){B(`Frame handling error: ${String(e)}`)}},p.onerror=()=>{a.onError?a.onError(new t(`WebSocket error`,e)):B(`WebSocket error — pass onError to observe it (see onClose for recovery logic)`);let n=g.splice(0);for(let r of n)r.reject(new t(`WebSocket error`,e))},p.onclose=n=>{S.stop(),a.onClose?.(n.code,n.reason);let r=g.splice(0);for(let n of r)n.reject(new t(`Connection closed before open`,e));if(h||m){s.value=`closed`;return}E()})}async function E(){s.value=`reconnecting`,!await x.attempt(()=>new Promise((e,t)=>{g.push({reject:t,resolve:e}),T()}),o.signal,a.onReconnect)&&!m&&(B(`Reconnect budget exhausted — connection permanently closed`),s.value=`closed`)}function D(e){switch(e.type){case`error`:B(`Server error [${e.code}]: ${e.message}`);break;case`joined`:{let t=new Set(c.value);t.add(e.room),c.value=t;let n=d.get(e.room);if(n){d.delete(e.room);for(let e of n)e()}break}case`left`:{let t=new Set(c.value);t.delete(e.room),c.value=t;let n=f.get(e.room);if(n){f.delete(e.room);for(let e of n)e()}break}case`message`:l.dispatch(e.channel??null,e.event,e.payload);break;case`pong`:S.onPong();break;case`presence_join`:l.dispatch(null,e.type,e);break;case`presence_leave`:l.dispatch(null,e.type,e);break;case`presence_state`:l.dispatch(null,e.type,e);break;case`subscribed`:case`unsubscribed`:break;default:B(`Received frame with an unrecognized type: ${String(e.type)}`);break}}function O(e,t,a,s){return m?Promise.reject(new i):new Promise((i,c)=>{let l=[];s?.signal&&l.push(s.signal);let u;if(s?.timeout!==void 0){let e=new AbortController;u=setTimeout(()=>e.abort(new n(a)),s.timeout),l.push(e.signal)}let d=l.length===0?o.signal:V(o.signal,...l);if(d.aborted){clearTimeout(u),c(d.reason instanceof n?d.reason:new r);return}let f=()=>{},m=()=>{clearTimeout(u),d.removeEventListener(`abort`,f),i()};f=()=>{clearTimeout(u);let i=e.get(t);i?.delete(m),i?.size===0&&e.delete(t),c(d.reason instanceof n?d.reason:new r)};let h=e.get(t);h||(h=new Set,e.set(t,h)),h.add(m),d.addEventListener(`abort`,f,{once:!0});let g=()=>C(J({room:t,type:a}));p?.readyState===WebSocket.OPEN?g():k.connect().then(g).catch(n=>{clearTimeout(u),d.removeEventListener(`abort`,f);let r=e.get(t);r?.delete(m),r?.size===0&&e.delete(t),c(n)})})}let k={channel(e){let t=_.get(e);if(t)return t;m&&B(`channel('${e}') called on a disposed Pulse — returning an already-disposed channel`);let n=q(e,(e,t,n)=>{w(t,n,()=>{C(J({channel:e,event:t,payload:n,type:`message`}))})},(e,t,n)=>l.add(e,t,n),o.signal,()=>{_.delete(e),C(J({channel:e,type:`unsubscribe`}))});return m||_.set(e,n),p?.readyState===WebSocket.OPEN&&p.send(J({channel:e,type:`subscribe`})),n},connect(){return m?Promise.reject(new i):p?.readyState===WebSocket.OPEN?Promise.resolve():new Promise((e,t)=>{g.push({reject:t,resolve:e}),(!p||p.readyState>WebSocket.OPEN)&&T()})},disconnect(e=1e3,t=``){h=!0,p?.close(e,t)},get disposalSignal(){return o.signal},dispose(){if(m)return;m=!0,h=!0,S.stop(),p?.close(1e3,`disposed`),p=null;let e=g.splice(0);for(let t of e)t.reject(new i);_.clear(),d.clear(),f.clear(),s.dispose(),c.dispose(),l.clear(),o.abort()},get disposed(){return m},join(e,t){return O(d,e,`join`,t)},leave(e,t){return O(f,e,`leave`,t)},on(e,t){return m?(B(`on('${String(e)}') called on a disposed Pulse — listener ignored`),()=>{}):l.add(null,e,t)},once(e,t){if(m)return B(`once('${String(e)}') called on a disposed Pulse — listener ignored`),()=>{};let n=()=>{};return n=l.add(null,e,e=>{n(),t(e)}),n},presence(e){let t=$(e,C,{onJoin:e=>l.add(null,`presence_join`,t=>e(t)),onLeave:e=>l.add(null,`presence_leave`,t=>e(t)),onState:e=>l.add(null,`presence_state`,t=>e(t))},o.signal);return m?B(`presence('${e}') called on a disposed Pulse — returning an already-disposed presence channel`):k.join(e).catch(t=>{B(`presence() join failed for room '${e}': ${String(t)}`)}),t},get rooms(){return c},send(e,t){if(m){B(`send('${String(e)}') called on a disposed Pulse — message dropped`);return}w(e,t,()=>{C(J({event:e,payload:t,type:`message`}))})},get status(){return s},[Symbol.dispose](){this.dispose()},wait(e,t){return K(e,o.signal,t,(e,t)=>l.add(null,e,t))}};return a.lazy||T(),k}exports.PulseAbortError=r,exports.PulseConnectionError=t,exports.PulseDisposedError=i,exports.PulseError=e,exports.PulseProtocolError=a,exports.PulseTimeoutError=n,exports.createPulse=re;
|
|
2
|
+
//# sourceMappingURL=pulse.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pulse.cjs","names":["e","t","n","e","t","n","r","i","a","o","e","t","n","r","i","a","o","s","c","l","u","d","f","p","m","e","t","n","r","e","t","o","s","t","e","i","n","r","e","t","n","r","t","e","a","n","t","e","r","i"],"sources":["../src/errors.ts","../../ripple/dist/devtools-hook.js","../../ripple/dist/errors.js","../../ripple/dist/tracking.js","../../ripple/dist/_error-utils.js","../../ripple/dist/_dev.js","../../ripple/dist/scheduling.js","../../ripple/dist/subscription.js","../../ripple/dist/symbols.js","../../ripple/dist/reactive-base.js","../../ripple/dist/signal.js","../src/_dev.ts","../src/_utils.ts","../src/_wait.ts","../src/channel.ts","../src/protocol.ts","../src/heartbeat.ts","../src/presence.ts","../src/reconnect.ts","../src/pulse.ts"],"sourcesContent":["/**\n * Base class for all pulse errors.\n * Use `instanceof PulseError` to catch any pulse-originated error in one branch.\n */\nexport class PulseError extends Error {\n constructor(message: string, opts?: ErrorOptions) {\n super(message, opts);\n this.name = new.target.name;\n Object.setPrototypeOf(this, new.target.prototype);\n }\n\n static is(err: unknown): err is PulseError {\n return err instanceof PulseError;\n }\n}\n\n/**\n * Thrown when a WebSocket connection cannot be established or is lost\n * without triggering auto-reconnect (budget exhausted, or reconnect disabled).\n */\nexport class PulseConnectionError extends PulseError {\n readonly url: string;\n\n constructor(message: string, url: string, opts?: ErrorOptions) {\n super(message, opts);\n this.url = url;\n }\n}\n\n/**\n * Thrown when `wait()` or `join()`/`leave()` times out before receiving a\n * server response, or when an AbortSignal fires before the event arrives.\n */\nexport class PulseTimeoutError extends PulseError {\n readonly event: string;\n\n constructor(event: string, opts?: ErrorOptions) {\n super(`Timed out waiting for \"${event}\"`, opts);\n this.event = event;\n }\n}\n\n/**\n * Thrown when `wait()` is aborted via an AbortSignal before the event fires.\n */\nexport class PulseAbortError extends PulseError {\n constructor(opts?: ErrorOptions) {\n super('Aborted', opts);\n }\n}\n\n/**\n * Thrown when a method is called on a disposed Pulse instance or channel.\n */\nexport class PulseDisposedError extends PulseError {\n constructor(target = 'Pulse', opts?: ErrorOptions) {\n super(`${target} instance is disposed`, opts);\n }\n}\n\n/**\n * Thrown when the server sends a frame that cannot be parsed or violates\n * the wire protocol schema.\n */\nexport class PulseProtocolError extends PulseError {\n readonly raw: unknown;\n\n constructor(message: string, raw?: unknown, opts?: ErrorOptions) {\n super(message, opts);\n this.raw = raw;\n }\n}\n","//#region src/devtools-hook.ts\nvar e = null, t = () => e, n = (t) => {\n\te = t;\n};\n//#endregion\nexport { t as getDevToolsHook, n as setDevToolsHook };\n\n//# sourceMappingURL=devtools-hook.js.map","//#region src/errors.ts\nvar e = class e extends Error {\n\tconstructor(e, t) {\n\t\tsuper(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);\n\t}\n\tstatic is(t) {\n\t\treturn t instanceof e;\n\t}\n}, t = class extends e {}, n = class extends e {}, r = class extends e {}, i = class extends e {}, a = class extends e {}, o = class extends e {};\n//#endregion\nexport { t as RippleComputedCycleError, n as RippleDisposedScopeError, r as RippleEnvironmentError, e as RippleError, i as RippleInfiniteLoopError, a as RippleInvalidCleanupError, o as RippleInvalidStoreError };\n\n//# sourceMappingURL=errors.js.map","//#region src/tracking.ts\nvar e = 0, t = () => ++e, n = () => e, r = () => ({\n\tactiveDirty: \"a\",\n\tbatchDepth: 0,\n\tdirtyWithEffectSubsA: /* @__PURE__ */ new Set(),\n\tdirtyWithEffectSubsB: /* @__PURE__ */ new Set(),\n\tpendingSubscribers: /* @__PURE__ */ new Set()\n}), i = {\n\tscheduling: r(),\n\tscopeCleanups: null,\n\ttracking: null\n}, a = null, o = () => a === null ? i : a.get(), s = () => o().scheduling, c = () => a !== null, l = () => o().tracking, u = (e, t) => {\n\tif (a !== null) {\n\t\tlet n = a.get();\n\t\treturn a.run({\n\t\t\t...n,\n\t\t\ttracking: e\n\t\t}, t);\n\t}\n\tlet n = i;\n\ti = {\n\t\t...i,\n\t\ttracking: e\n\t};\n\ttry {\n\t\treturn t();\n\t} finally {\n\t\ti = n;\n\t}\n}, d = (e, t) => {\n\tif (a !== null) {\n\t\tlet n = a.get();\n\t\treturn a.run({\n\t\t\t...n,\n\t\t\tscopeCleanups: e\n\t\t}, t);\n\t}\n\tlet n = i;\n\ti = {\n\t\t...i,\n\t\tscopeCleanups: e\n\t};\n\ttry {\n\t\treturn t();\n\t} finally {\n\t\ti = n;\n\t}\n}, f = () => o().scopeCleanups, p = (e) => {\n\tlet t = l();\n\tt?.kind === \"effect\" ? t.cleanups.push(e) : f()?.push(e);\n}, m = (e) => {\n\tlet t = a;\n\treturn a = e, t;\n}, h = (e, t) => {\n\tlet n = l();\n\treturn n === null ? t() : u({\n\t\t...n,\n\t\tsourceObserver: e\n\t}, t);\n}, g = (e) => u(null, e), _ = (e) => {\n\tlet t = l();\n\tif (t !== null) {\n\t\tif (t.sourceObserver?.(e), t.kind === \"computed\") t.depCollector.push({\n\t\t\tsource: e,\n\t\t\tversion: e.version\n\t\t});\n\t\telse if (t.kind === \"effect\") {\n\t\t\tlet n = t.effect;\n\t\t\te.addEffectSub(n), t.subscriptions.add(() => e.removeEffectSub(n)), t.deps.set(e, e.version);\n\t\t}\n\t}\n};\n//#endregion\nexport { m as _installContextHook, p as autoRegisterDisposal, r as createSchedulingState, n as getRevision, s as getSchedulingState, f as getScopeCleanups, l as getTracking, c as hasContextHook, t as tickRevision, _ as trackSource, g as untrack, d as withScopeCleanups, h as withSourceObserver, u as withTracking };\n\n//# sourceMappingURL=tracking.js.map","//#region src/_error-utils.ts\nvar e = (e) => e instanceof Error ? e : /* @__PURE__ */ Error(`Non-Error thrown: ${String(e)}`), t = (t) => {\n\tlet n = [];\n\tfor (let r of t) try {\n\t\tr();\n\t} catch (t) {\n\t\tn.push(e(t));\n\t}\n\treturn n;\n}, n = (e, n) => {\n\tlet r = t(e);\n\tif (r.length === 1) throw r[0];\n\tif (r.length > 0) throw AggregateError(r, n);\n}, r = (t, n, r) => {\n\tthrow n.length === 0 ? t : AggregateError([e(t), ...n], r, { cause: e(t) });\n};\n//#endregion\nexport { t as collectErrors, e as ensureError, r as rethrowWith, n as runAll };\n\n//# sourceMappingURL=_error-utils.js.map","//#region src/_dev.ts\nvar e = !globalThis.__RIPPLE_PROD__;\nfunction t(t) {\n\te && console.warn(`[@vielzeug/ripple] ${t}`);\n}\n//#endregion\nexport { t as warn };\n\n//# sourceMappingURL=_dev.js.map","import { runAll as e } from \"./_error-utils.js\";\nimport { RippleInfiniteLoopError as t } from \"./errors.js\";\nimport { warn as n } from \"./_dev.js\";\nimport { getSchedulingState as r, hasContextHook as i } from \"./tracking.js\";\nvar a = !1, o = 0, s = [], c = (e) => e.activeDirty === \"a\" ? e.dirtyWithEffectSubsA : e.dirtyWithEffectSubsB, l = (e, t) => {\n\tlet n = ++o;\n\tfor (let n of t.effectSubs()) e.pendingSubscribers.add(n);\n\tfor (let e of t.computedSubs()) s.push(e);\n\ttry {\n\t\tfor (; s.length > 0;) {\n\t\t\tlet t = s.pop();\n\t\t\tif (t.lastPropEpoch_ !== n && (t.lastPropEpoch_ = n, t.markDirty())) {\n\t\t\t\tt.effectSubs().size > 0 && c(e).add(t);\n\t\t\t\tfor (let e of t.computedSubs()) s.push(e);\n\t\t\t}\n\t\t}\n\t} finally {\n\t\ts.length = 0;\n\t}\n}, u = (e) => {\n\tfor (; c(e).size > 0;) {\n\t\tlet t = c(e);\n\t\te.activeDirty = e.activeDirty === \"a\" ? \"b\" : \"a\", c(e).clear();\n\t\tfor (let n of t) if (n.hasSubscribers() && n.refreshIfDirty()) {\n\t\t\tfor (let t of n.effectSubs()) e.pendingSubscribers.add(t);\n\t\t\tfor (let t of n.computedSubs()) t.markDirty() && t.effectSubs().size > 0 && c(e).add(t);\n\t\t}\n\t\tt.clear();\n\t}\n}, d = (n) => {\n\tlet r = 0;\n\tfor (; n.pendingSubscribers.size > 0 || c(n).size > 0;) {\n\t\tif (++r > 100) throw new t(\"infinite flush loop (> 100 iterations)\");\n\t\tif (c(n).size > 0 && u(n), n.pendingSubscribers.size === 0) continue;\n\t\tlet i = [...n.pendingSubscribers];\n\t\tn.pendingSubscribers.clear(), e(i, \"subscriber errors\");\n\t}\n}, f = globalThis.process?.versions != null, p = (e) => {\n\tif (!e.hasSubscribers()) return;\n\t!a && f && !i() && (a = !0, n(\"Signal updated in a Node.js-like environment. The module-level flush queue is shared across concurrent requests — use per-request worker isolation or the @vielzeug/ripple/ssr sub-path for request-isolated scheduling.\"));\n\tlet t = r();\n\tl(t, e), t.batchDepth === 0 && d(t);\n}, m = (e) => {\n\tlet t = r();\n\tt.batchDepth++;\n\tlet n;\n\ttry {\n\t\tn = e();\n\t} catch (e) {\n\t\tthrow t.batchDepth--, t.batchDepth === 0 && (t.pendingSubscribers.clear(), t.dirtyWithEffectSubsA.clear(), t.dirtyWithEffectSubsB.clear()), e;\n\t}\n\treturn t.batchDepth--, t.batchDepth === 0 && d(t), n;\n};\n//#endregion\nexport { m as batch, p as notifyNodeChange };\n\n//# sourceMappingURL=scheduling.js.map","//#region src/subscription.ts\nvar e = class {\n\tfn_;\n\tdisposed_ = !1;\n\tconstructor(e) {\n\t\tthis.fn_ = e;\n\t}\n\tget disposed() {\n\t\treturn this.disposed_;\n\t}\n\tdispose() {\n\t\tif (this.disposed_) return;\n\t\tthis.disposed_ = !0;\n\t\tlet e = this.fn_;\n\t\tthis.fn_ = null, e();\n\t}\n\t[Symbol.dispose]() {\n\t\tthis.dispose();\n\t}\n}, t = class {\n\tawaitDone_;\n\tgetCurrentRun_;\n\tsyncStop_;\n\tasyncDisposePromise_ = null;\n\tconstructor(e, t, n) {\n\t\tthis.awaitDone_ = t, this.getCurrentRun_ = n, this.syncStop_ = e;\n\t}\n\tget disposed() {\n\t\treturn this.syncStop_.disposed;\n\t}\n\tdispose() {\n\t\tthis.syncStop_.dispose();\n\t}\n\trun() {\n\t\treturn this.getCurrentRun_() ?? Promise.resolve();\n\t}\n\t[Symbol.dispose]() {\n\t\tthis.dispose();\n\t}\n\t[Symbol.asyncDispose]() {\n\t\treturn this.asyncDisposePromise_ === null ? (this.dispose(), this.asyncDisposePromise_ = this.awaitDone_(), this.asyncDisposePromise_) : this.asyncDisposePromise_;\n\t}\n};\n//#endregion\nexport { t as AsyncSubscriptionImpl, e as SubscriptionImpl };\n\n//# sourceMappingURL=subscription.js.map","//#region src/symbols.ts\nvar e = Symbol(\"ripple.is-signal\"), t = Symbol(\"ripple.is-computed\"), n = Symbol(\"ripple.is-store\"), r = Symbol(\"ripple.uninitialized\");\n//#endregion\nexport { t as IS_COMPUTED, e as IS_SIGNAL, n as IS_STORE, r as UNINITIALIZED };\n\n//# sourceMappingURL=symbols.js.map","import { IS_COMPUTED as e, IS_SIGNAL as t } from \"./symbols.js\";\n//#region src/reactive-base.ts\nvar n = new FinalizationRegistry(({ key: e, map: t }) => {\n\tt.delete(e);\n}), r = class {\n\tversion = 0;\n\tname;\n\t[t] = !0;\n\tcomputedSubs_ = /* @__PURE__ */ new Map();\n\teffectSubs_ = /* @__PURE__ */ new Set();\n\tconstructor(e) {\n\t\tthis.name = e;\n\t}\n\taddComputedSub(e) {\n\t\tlet t = new WeakRef(e);\n\t\tthis.computedSubs_.set(e, t), n.register(e, {\n\t\t\tkey: e,\n\t\t\tmap: this.computedSubs_\n\t\t}, t);\n\t}\n\tremoveComputedSub(e) {\n\t\tlet t = this.computedSubs_.get(e);\n\t\tt !== void 0 && (this.computedSubs_.delete(e), n.unregister(t));\n\t}\n\taddEffectSub(e) {\n\t\tthis.effectSubs_.add(e);\n\t}\n\tremoveEffectSub(e) {\n\t\tthis.effectSubs_.delete(e);\n\t}\n\tclearSubscribers() {\n\t\tfor (let e of this.computedSubs_.values()) n.unregister(e);\n\t\tthis.computedSubs_.clear(), this.effectSubs_.clear();\n\t}\n\thasSubscribers() {\n\t\tif (this.effectSubs_.size > 0) return !0;\n\t\tfor (let e of this.computedSubs_.values()) if (e.deref() !== void 0) return !0;\n\t\treturn !1;\n\t}\n\t*computedSubs() {\n\t\tfor (let [e, t] of this.computedSubs_) {\n\t\t\tlet r = t.deref();\n\t\t\tr === void 0 ? (this.computedSubs_.delete(e), n.unregister(t)) : yield r;\n\t\t}\n\t}\n\teffectSubs() {\n\t\treturn this.effectSubs_;\n\t}\n}, i = class extends r {\n\t[e] = !0;\n\tlastPropEpoch_ = 0;\n};\n//#endregion\nexport { i as ComputedBase, r as ReactiveBase };\n\n//# sourceMappingURL=reactive-base.js.map","import { getDevToolsHook as e } from \"./devtools-hook.js\";\nimport { tickRevision as t, trackSource as n } from \"./tracking.js\";\nimport { notifyNodeChange as r } from \"./scheduling.js\";\nimport { SubscriptionImpl as i } from \"./subscription.js\";\nimport { ReactiveBase as a } from \"./reactive-base.js\";\n//#region src/signal.ts\nvar o = class extends a {\n\tvalue_;\n\tequals_;\n\tdisposed_;\n\tconstructor(e, t, n) {\n\t\tsuper(n), this.value_ = e, this.equals_ = t ?? Object.is, this.disposed_ = !1;\n\t}\n\tget value() {\n\t\treturn this.disposed_ || n(this), this.value_;\n\t}\n\tset value(n) {\n\t\tif (this.disposed_ || this.equals_(this.value_, n)) return;\n\t\tlet i = this.value_;\n\t\tthis.value_ = n, this.version = t(), e()?.write?.({\n\t\t\tname: this.name,\n\t\t\tnewValue: n,\n\t\t\toldValue: i\n\t\t}), r(this);\n\t}\n\tpeek() {\n\t\treturn this.value_;\n\t}\n\tsubscribe = (e) => {\n\t\tif (this.disposed_) {\n\t\t\tlet e = new i(() => {});\n\t\t\treturn e.dispose(), e;\n\t\t}\n\t\treturn this.addEffectSub(e), new i(() => {\n\t\t\tthis.removeEffectSub(e);\n\t\t});\n\t};\n\tget disposed() {\n\t\treturn this.disposed_;\n\t}\n\tdispose() {\n\t\tthis.disposed_ || (this.disposed_ = !0, this.clearSubscribers(), e()?.dispose?.({\n\t\t\tkind: \"signal\",\n\t\t\tname: this.name\n\t\t}));\n\t}\n\t[Symbol.dispose]() {\n\t\tthis.dispose();\n\t}\n}, s = (e, t) => new o(e, t?.equals, t?.name);\n//#endregion\nexport { o as SignalImpl, s as signal };\n\n//# sourceMappingURL=signal.js.map","const isDev = !(globalThis as { __PULSE_PROD__?: boolean }).__PULSE_PROD__;\n\n/** @internal */\nexport function warn(msg: string): void {\n if (isDev) console.warn(`[@vielzeug/pulse] ${msg}`);\n}\n\n/** @internal — Run fn only in dev builds. Use when dev-only logic goes beyond a single warn() / error() call. */\nexport function devOnly(fn: () => void): void {\n if (isDev) fn();\n}\n","/**\n * Returns a signal that aborts as soon as any of the provided signals abort.\n * With a single argument, returns it directly (no allocation).\n * Cleanup listeners are registered to prevent leaks.\n *\n * @internal\n */\nexport function combineSignals(first: AbortSignal, ...rest: AbortSignal[]): AbortSignal {\n if (rest.length === 0) return first;\n\n return rest.reduce(mergeTwo, first);\n}\n\nfunction mergeTwo(a: AbortSignal, b: AbortSignal): AbortSignal {\n if (a.aborted) return a;\n\n if (b.aborted) return b;\n\n const ctrl = new AbortController();\n const onA = (): void => ctrl.abort(a.reason);\n const onB = (): void => ctrl.abort(b.reason);\n\n a.addEventListener('abort', onA, { once: true });\n b.addEventListener('abort', onB, { once: true });\n ctrl.signal.addEventListener(\n 'abort',\n () => {\n a.removeEventListener('abort', onA);\n b.removeEventListener('abort', onB);\n },\n { once: true },\n );\n\n return ctrl.signal;\n}\n\n/**\n * Create a child `AbortController` that aborts as soon as `parent` does.\n * Handles the case where `parent` is already aborted at call time — a plain\n * `addEventListener('abort', ...)` would miss that, since the event already fired.\n *\n * @internal\n */\nexport function deriveAbortController(parent: AbortSignal): AbortController {\n const ctrl = new AbortController();\n\n if (parent.aborted) {\n ctrl.abort(parent.reason);\n } else {\n parent.addEventListener('abort', () => ctrl.abort(parent.reason), { once: true });\n }\n\n return ctrl;\n}\n\n/**\n * Sleep for `ms` milliseconds, aborting early when the signal fires.\n * Resolves (does not reject) on abort — callers check `signal.aborted`.\n *\n * @internal\n */\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n return new Promise((resolve) => {\n if (signal?.aborted) {\n resolve();\n\n return;\n }\n\n const id = setTimeout(resolve, ms);\n\n signal?.addEventListener(\n 'abort',\n () => {\n clearTimeout(id);\n resolve();\n },\n { once: true },\n );\n });\n}\n\n/**\n * Full-jitter exponential backoff in ms, capped at `maxMs`.\n * `attempt` is zero-based.\n *\n * @internal\n */\nexport function defaultReconnectDelay(attempt: number, maxMs = 30_000): number {\n const base = Math.min(1000 * Math.pow(2, attempt), maxMs);\n\n return Math.random() * base;\n}\n","import type { Unsubscribe } from './types';\n\nimport { combineSignals } from './_utils';\nimport { PulseAbortError, PulseTimeoutError } from './errors';\n\n/**\n * Shared implementation for `pulse.wait()` and `channel.wait()`.\n * Resolves on the next event dispatched via `subscribe`, or rejects when\n * the combined signal aborts or the optional timeout elapses.\n *\n * @internal\n */\nexport function createWaitPromise<T>(\n event: string,\n baseSignal: AbortSignal,\n opts: { signal?: AbortSignal; timeout?: number } | undefined,\n subscribe: (event: string, handler: (payload: unknown) => void) => Unsubscribe,\n): Promise<T> {\n return new Promise((resolve, reject) => {\n const signals: AbortSignal[] = [baseSignal];\n\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n if (opts?.signal) signals.push(opts.signal);\n\n if (opts?.timeout !== undefined) {\n const timeoutCtrl = new AbortController();\n\n timeoutId = setTimeout(() => {\n timeoutCtrl.abort(new PulseTimeoutError(event));\n }, opts.timeout);\n signals.push(timeoutCtrl.signal);\n }\n\n const combined = signals.length === 1 ? signals[0]! : combineSignals(signals[0]!, ...signals.slice(1));\n\n if (combined.aborted) {\n clearTimeout(timeoutId);\n reject(combined.reason instanceof PulseTimeoutError ? combined.reason : new PulseAbortError());\n\n return;\n }\n\n let unsub: Unsubscribe = () => {};\n\n const onAbort = (): void => {\n clearTimeout(timeoutId);\n unsub();\n reject(combined.reason instanceof PulseTimeoutError ? combined.reason : new PulseAbortError());\n };\n\n combined.addEventListener('abort', onAbort, { once: true });\n\n unsub = subscribe(event, (payload) => {\n clearTimeout(timeoutId);\n combined.removeEventListener('abort', onAbort);\n resolve(payload as T);\n });\n });\n}\n","import type { EventKey, MessageMap, PulseChannel, Unsubscribe } from './types';\n\nimport { warn } from './_dev';\nimport { deriveAbortController } from './_utils';\nimport { createWaitPromise } from './_wait';\n\ntype SendFn = (channel: string, event: string, payload: unknown) => void;\ntype SubscribeFn = (channel: string, event: string, handler: (payload: unknown) => void) => () => void;\n\n/**\n * Create a typed channel object that scopes messaging to a named namespace.\n * @internal\n */\nexport function createChannel<TServer extends MessageMap, TClient extends MessageMap>(\n name: string,\n send: SendFn,\n subscribe: SubscribeFn,\n disposalSignal: AbortSignal,\n onDispose?: () => void,\n): PulseChannel<TServer, TClient> {\n const ctrl = deriveAbortController(disposalSignal);\n const tracked = new Set<() => void>();\n\n let disposed = ctrl.signal.aborted;\n\n const channel: PulseChannel<TServer, TClient> = {\n get disposalSignal() {\n return ctrl.signal;\n },\n\n dispose() {\n if (disposed) return;\n\n disposed = true;\n ctrl.abort();\n\n for (const unsub of tracked) unsub();\n\n tracked.clear();\n onDispose?.();\n },\n\n get disposed() {\n return disposed;\n },\n\n get name() {\n return name;\n },\n\n on<K extends EventKey<TServer>>(event: K, handler: (payload: TServer[K]) => void): Unsubscribe {\n if (disposed) {\n warn(`on('${String(event)}') called on a disposed channel '${name}' — listener ignored`);\n\n return () => {};\n }\n\n const unsub = subscribe(name, event, handler as (payload: unknown) => void);\n\n tracked.add(unsub);\n\n return () => {\n unsub();\n tracked.delete(unsub);\n };\n },\n\n once<K extends EventKey<TServer>>(event: K, handler: (payload: TServer[K]) => void): Unsubscribe {\n if (disposed) {\n warn(`once('${String(event)}') called on a disposed channel '${name}' — listener ignored`);\n\n return () => {};\n }\n\n let unsub: Unsubscribe = () => {};\n\n const wrapped = (payload: unknown): void => {\n tracked.delete(unsub);\n unsub();\n (handler as (payload: unknown) => void)(payload);\n };\n\n unsub = subscribe(name, event, wrapped);\n tracked.add(unsub);\n\n return () => {\n tracked.delete(unsub);\n unsub();\n };\n },\n\n send<K extends EventKey<TClient>>(event: K, payload: TClient[K]): void {\n if (disposed) {\n warn(`send('${String(event)}') called on a disposed channel '${name}' — message dropped`);\n\n return;\n }\n\n send(name, event, payload);\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n\n wait<K extends EventKey<TServer>>(\n event: K,\n opts?: { signal?: AbortSignal; timeout?: number },\n ): Promise<TServer[K]> {\n return createWaitPromise<TServer[K]>(event as string, ctrl.signal, opts, (ev, handler) =>\n subscribe(name, ev, handler),\n );\n },\n };\n\n return channel;\n}\n","import { PulseProtocolError } from './errors';\n\n// ─── Outgoing frames (client → server) ────────────────────────────────────────\n\nexport type OutMessageFrame = { channel?: string; event: string; payload: unknown; type: 'message' };\nexport type OutSubscribeFrame = { channel: string; type: 'subscribe' };\nexport type OutUnsubscribeFrame = { channel: string; type: 'unsubscribe' };\nexport type OutJoinFrame = { room: string; type: 'join' };\nexport type OutLeaveFrame = { room: string; type: 'leave' };\nexport type OutPresenceFrame = { room: string; state: unknown; type: 'presence' };\nexport type OutPingFrame = { ts: number; type: 'ping' };\n\nexport type OutFrame =\n | OutJoinFrame\n | OutLeaveFrame\n | OutMessageFrame\n | OutPingFrame\n | OutPresenceFrame\n | OutSubscribeFrame\n | OutUnsubscribeFrame;\n\n// ─── Incoming frames (server → client) ────────────────────────────────────────\n\nexport type InMessageFrame = { channel?: string; event: string; payload: unknown; type: 'message' };\nexport type InSubscribedFrame = { channel: string; type: 'subscribed' };\nexport type InUnsubscribedFrame = { channel: string; type: 'unsubscribed' };\nexport type InJoinedFrame = { room: string; type: 'joined' };\nexport type InLeftFrame = { room: string; type: 'left' };\nexport type InPresenceStateFrame = { members: Record<string, unknown>; room: string; type: 'presence_state' };\nexport type InPresenceJoinFrame = { id: string; room: string; state: unknown; type: 'presence_join' };\nexport type InPresenceLeaveFrame = { id: string; room: string; type: 'presence_leave' };\nexport type InPongFrame = { ts: number; type: 'pong' };\nexport type InErrorFrame = { code: string; message: string; type: 'error' };\n\nexport type InFrame =\n | InErrorFrame\n | InJoinedFrame\n | InLeftFrame\n | InMessageFrame\n | InPongFrame\n | InPresenceJoinFrame\n | InPresenceLeaveFrame\n | InPresenceStateFrame\n | InSubscribedFrame\n | InUnsubscribedFrame;\n\n// ─── Codec ────────────────────────────────────────────────────────────────────\n\n/**\n * Encode an outgoing frame to a JSON string.\n * @internal\n */\nexport function encode(frame: OutFrame): string {\n return JSON.stringify(frame);\n}\n\n/**\n * Parse a raw MessageEvent data string into a typed InFrame.\n * Throws `PulseProtocolError` if the data is not valid JSON or missing the `type` field.\n * @internal\n */\nexport function decode(raw: unknown): InFrame {\n if (typeof raw !== 'string') {\n throw new PulseProtocolError('Expected string message data', raw);\n }\n\n let parsed: unknown;\n\n try {\n parsed = JSON.parse(raw);\n } catch (cause) {\n throw new PulseProtocolError('JSON parse error', raw);\n }\n\n if (\n parsed === null ||\n typeof parsed !== 'object' ||\n !('type' in parsed) ||\n typeof (parsed as { type: unknown }).type !== 'string'\n ) {\n throw new PulseProtocolError('Missing or invalid \"type\" field', parsed);\n }\n\n return parsed as InFrame;\n}\n","import type { HeartbeatOptions } from './types';\n\nimport { warn } from './_dev';\nimport { encode } from './protocol';\n\nconst DEFAULT_INTERVAL = 30_000;\nconst DEFAULT_TIMEOUT = 5_000;\n\nexport type HeartbeatHandle = {\n /** Called when a `pong` frame is received. Resets the timeout timer. */\n onPong(): void;\n /** Start the heartbeat loop. */\n start(): void;\n /** Stop the heartbeat loop and cancel any pending timers. */\n stop(): void;\n};\n\n/**\n * Create a heartbeat manager that sends periodic pings and expects pong replies.\n * Calls `onDead` when a pong is not received within the timeout window.\n * @internal\n */\nexport function createHeartbeat(\n opts: boolean | HeartbeatOptions | undefined,\n send: (frame: string) => void,\n onDead: () => void,\n): HeartbeatHandle {\n if (!opts) {\n return { onPong() {}, start() {}, stop() {} };\n }\n\n const options: HeartbeatOptions = opts === true ? {} : opts;\n const interval = options.interval ?? DEFAULT_INTERVAL;\n const timeout = options.timeout ?? DEFAULT_TIMEOUT;\n\n let pingTimer: ReturnType<typeof setTimeout> | undefined;\n let pongTimer: ReturnType<typeof setTimeout> | undefined;\n let running = false;\n\n function schedulePing(): void {\n pingTimer = setTimeout(() => {\n const ts = Date.now();\n\n send(encode({ ts, type: 'ping' }));\n\n pongTimer = setTimeout(() => {\n warn(`Heartbeat timed out after ${timeout}ms — treating connection as dead`);\n onDead();\n }, timeout);\n }, interval);\n }\n\n return {\n onPong() {\n clearTimeout(pongTimer);\n pongTimer = undefined;\n\n if (running) schedulePing();\n },\n\n start() {\n running = true;\n clearTimeout(pingTimer);\n clearTimeout(pongTimer);\n pongTimer = undefined;\n schedulePing();\n },\n\n stop() {\n running = false;\n clearTimeout(pingTimer);\n clearTimeout(pongTimer);\n pingTimer = undefined;\n pongTimer = undefined;\n },\n };\n}\n","import { type Signal, signal } from '@vielzeug/ripple';\n\nimport type { PresenceChannel, Unsubscribe } from './types';\n\nimport { warn } from './_dev';\nimport { deriveAbortController } from './_utils';\nimport { type InPresenceJoinFrame, type InPresenceLeaveFrame, type InPresenceStateFrame, encode } from './protocol';\n\ntype RawSendFn = (frame: string) => void;\n\nexport type PresenceEvents = {\n onJoin(handler: (frame: InPresenceJoinFrame) => void): Unsubscribe;\n onLeave(handler: (frame: InPresenceLeaveFrame) => void): Unsubscribe;\n onState(handler: (frame: InPresenceStateFrame) => void): Unsubscribe;\n};\n\n/**\n * Create a presence channel that reactively tracks room member states.\n * @internal\n */\nexport function createPresence<T>(\n room: string,\n rawSend: RawSendFn,\n events: PresenceEvents,\n disposalSignal: AbortSignal,\n): PresenceChannel<T> {\n const ctrl = deriveAbortController(disposalSignal);\n\n let disposed = ctrl.signal.aborted;\n\n const members: Signal<Map<string, T>> = signal(new Map<string, T>());\n const joinHandlers = new Set<(memberId: string, state: T) => void>();\n const leaveHandlers = new Set<(memberId: string) => void>();\n\n const unsubs: Array<() => void> = [\n events.onState((frame) => {\n if (frame.room !== room) return;\n\n const next = new Map<string, T>();\n\n for (const [id, state] of Object.entries(frame.members)) {\n next.set(id, state as T);\n }\n\n members.value = next;\n }),\n events.onJoin((frame) => {\n if (frame.room !== room) return;\n\n const next = new Map(members.value);\n\n next.set(frame.id, frame.state as T);\n members.value = next;\n\n for (const handler of joinHandlers) {\n handler(frame.id, frame.state as T);\n }\n }),\n events.onLeave((frame) => {\n if (frame.room !== room) return;\n\n const next = new Map(members.value);\n\n next.delete(frame.id);\n members.value = next;\n\n for (const handler of leaveHandlers) {\n handler(frame.id);\n }\n }),\n ];\n\n const presence: PresenceChannel<T> = {\n get disposalSignal() {\n return ctrl.signal;\n },\n\n dispose() {\n if (disposed) return;\n\n disposed = true;\n rawSend(encode({ room, type: 'leave' }));\n ctrl.abort();\n\n for (const unsub of unsubs) unsub();\n\n unsubs.length = 0;\n joinHandlers.clear();\n leaveHandlers.clear();\n members.dispose();\n },\n\n get disposed() {\n return disposed;\n },\n\n onJoin(handler: (memberId: string, state: T) => void): Unsubscribe {\n if (disposed) {\n warn(`onJoin() called on a disposed presence channel '${room}' — listener ignored`);\n\n return () => {};\n }\n\n joinHandlers.add(handler);\n\n return () => joinHandlers.delete(handler);\n },\n\n onLeave(handler: (memberId: string) => void): Unsubscribe {\n if (disposed) {\n warn(`onLeave() called on a disposed presence channel '${room}' — listener ignored`);\n\n return () => {};\n }\n\n leaveHandlers.add(handler);\n\n return () => leaveHandlers.delete(handler);\n },\n\n get room() {\n return room;\n },\n\n get state() {\n return members;\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n\n update(state: T): void {\n if (disposed) return;\n\n rawSend(encode({ room, state, type: 'presence' }));\n },\n };\n\n return presence;\n}\n","import type { ReconnectOptions } from './types';\n\nimport { defaultReconnectDelay, sleep } from './_utils';\n\nconst DEFAULT_MAX_ATTEMPTS = 5;\n\nexport type ReconnectHandle = {\n /**\n * Attempt a reconnect. Waits for the computed delay then calls `connect`.\n * Returns `true` if `connect` succeeded, `false` if attempts are exhausted or aborted.\n */\n attempt(connect: () => Promise<void>, signal: AbortSignal, onReconnect?: (attempt: number) => void): Promise<boolean>;\n /** Cancel any pending reconnect attempt and reset the counter. */\n reset(): void;\n};\n\n/**\n * Create a stateful reconnect manager.\n * @internal\n */\nexport function createReconnect(opts: boolean | ReconnectOptions | undefined): ReconnectHandle {\n if (!opts) {\n return {\n attempt: async () => false,\n reset() {},\n };\n }\n\n const options: ReconnectOptions = opts === true ? {} : opts;\n const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n const delayFn: (attempt: number) => number =\n typeof options.delay === 'function'\n ? options.delay\n : typeof options.delay === 'number'\n ? () => options.delay as number\n : defaultReconnectDelay;\n\n let attempts = 0;\n\n return {\n async attempt(\n connect: () => Promise<void>,\n signal: AbortSignal,\n onReconnect?: (attempt: number) => void,\n ): Promise<boolean> {\n if (attempts >= maxAttempts) return false;\n\n const delay = delayFn(attempts);\n\n attempts++;\n onReconnect?.(attempts);\n\n await sleep(delay, signal);\n\n if (signal.aborted) return false;\n\n try {\n await connect();\n\n attempts = 0;\n\n return true;\n } catch {\n return false;\n }\n },\n\n reset() {\n attempts = 0;\n },\n };\n}\n","import { signal } from '@vielzeug/ripple';\n\nimport type {\n EventKey,\n MessageMap,\n Middleware,\n PresenceChannel,\n Pulse,\n PulseChannel,\n PulseOptions,\n PulseStatus,\n Unsubscribe,\n} from './types';\n\nimport { warn } from './_dev';\nimport { combineSignals } from './_utils';\nimport { createWaitPromise } from './_wait';\nimport { createChannel } from './channel';\nimport { PulseAbortError, PulseConnectionError, PulseDisposedError, PulseTimeoutError } from './errors';\nimport { createHeartbeat } from './heartbeat';\nimport { createPresence } from './presence';\nimport {\n type InFrame,\n type InPresenceJoinFrame,\n type InPresenceLeaveFrame,\n type InPresenceStateFrame,\n decode,\n encode,\n} from './protocol';\nimport { createReconnect } from './reconnect';\n\n// ─── Internal routing map ─────────────────────────────────────────────────────\n\ntype Handler = (payload: unknown) => void;\n\n/**\n * A two-level listener map: channel (null = root) → event → Set<handler>.\n * @internal\n */\nclass ListenerMap {\n private readonly map = new Map<string | null, Map<string, Set<Handler>>>();\n\n add(channel: string | null, event: string, handler: Handler): () => void {\n let events = this.map.get(channel);\n\n if (!events) {\n events = new Map();\n this.map.set(channel, events);\n }\n\n let handlers = events.get(event);\n\n if (!handlers) {\n handlers = new Set();\n events.set(event, handlers);\n }\n\n handlers.add(handler);\n\n return () => {\n handlers.delete(handler);\n\n if (handlers.size === 0) events.delete(event);\n\n if (events.size === 0) this.map.delete(channel);\n };\n }\n\n dispatch(channel: string | null, event: string, payload: unknown): void {\n this.map\n .get(channel)\n ?.get(event)\n ?.forEach((h) => h(payload));\n }\n\n clear(): void {\n this.map.clear();\n }\n}\n\n// ─── createPulse ──────────────────────────────────────────────────────────────\n\n/**\n * Create a managed WebSocket connection with typed messaging, channels,\n * rooms, and presence.\n *\n * @example\n * ```ts\n * const pulse = createPulse<ServerEvents, ClientEvents>('wss://api.example.com/ws', {\n * reconnect: true,\n * heartbeat: true,\n * });\n * pulse.on('message', (data) => console.log(data));\n * ```\n */\nexport function createPulse<TServer extends MessageMap = MessageMap, TClient extends MessageMap = MessageMap>(\n url: string,\n opts: PulseOptions = {},\n): Pulse<TServer, TClient> {\n // ── State ──────────────────────────────────────────────────────────────────\n\n const disposalCtrl = new AbortController();\n const status = signal<PulseStatus>('connecting');\n const rooms = signal<ReadonlySet<string>>(new Set());\n const listeners = new ListenerMap();\n const middleware: readonly Middleware[] = opts.middleware ?? [];\n\n const pendingJoins = new Map<string, Set<() => void>>();\n const pendingLeaves = new Map<string, Set<() => void>>();\n\n let ws: WebSocket | null = null;\n let disposed = false;\n let intentionalClose = false;\n\n const pendingOpens: Array<{ reject: (e: Error) => void; resolve: () => void }> = [];\n\n // Memoized channel cache — same name returns the same object\n const channelCache = new Map<string, PulseChannel<MessageMap, MessageMap>>();\n\n // Message buffer (null = disabled)\n const bufferCfg = opts.buffer;\n const buffer: string[] | null = bufferCfg ? [] : null;\n const bufferMaxSize: number = typeof bufferCfg === 'object' && bufferCfg !== null ? (bufferCfg.maxSize ?? 50) : 50;\n\n // ── Reconnect / Heartbeat ──────────────────────────────────────────────────\n\n const reconnect = createReconnect(opts.reconnect);\n\n const heartbeat = createHeartbeat(\n opts.heartbeat,\n (frame) => {\n if (ws?.readyState === WebSocket.OPEN) ws.send(frame);\n },\n () => {\n warn('Heartbeat dead — closing socket for reconnect');\n ws?.close(4000, 'heartbeat timeout');\n },\n );\n\n // ── Raw send helper ────────────────────────────────────────────────────────\n\n function rawSend(frame: string): void {\n if (ws?.readyState === WebSocket.OPEN) {\n ws.send(frame);\n } else if (buffer !== null) {\n if (buffer.length >= bufferMaxSize) buffer.shift();\n\n buffer.push(frame);\n } else {\n warn(`send() called while connection is ${status.value} — message dropped`);\n }\n }\n\n // ── Middleware pipeline ────────────────────────────────────────────────────\n\n function runMiddleware(event: string, payload: unknown, final: () => void): void {\n let idx = 0;\n\n function next(): void {\n if (idx >= middleware.length) {\n final();\n\n return;\n }\n\n const mw = middleware[idx++]!;\n\n mw(event, payload, next);\n }\n\n next();\n }\n\n // ── WebSocket lifecycle ────────────────────────────────────────────────────\n\n function openSocket(): void {\n if (disposed) return;\n\n ws = new WebSocket(url, opts.protocols);\n\n ws.onopen = (): void => {\n intentionalClose = false;\n status.value = 'open';\n reconnect.reset();\n heartbeat.start();\n opts.onOpen?.();\n\n const pending = pendingOpens.splice(0);\n\n for (const p of pending) p.resolve();\n\n if (buffer && buffer.length > 0) {\n const queued = buffer.splice(0);\n\n for (const f of queued) ws!.send(f);\n }\n\n for (const name of channelCache.keys()) {\n ws!.send(encode({ channel: name, type: 'subscribe' }));\n }\n };\n\n ws.onmessage = (ev: MessageEvent): void => {\n opts.onMessage?.(ev);\n\n let frame: InFrame;\n\n try {\n frame = decode(ev.data);\n } catch (err) {\n warn(`Protocol error: ${String(err)}`);\n\n return;\n }\n\n try {\n handleFrame(frame);\n } catch (err) {\n warn(`Frame handling error: ${String(err)}`);\n }\n };\n\n ws.onerror = (): void => {\n if (opts.onError) {\n opts.onError(new PulseConnectionError('WebSocket error', url));\n } else {\n warn('WebSocket error — pass onError to observe it (see onClose for recovery logic)');\n }\n\n const pending = pendingOpens.splice(0);\n\n for (const p of pending) p.reject(new PulseConnectionError('WebSocket error', url));\n };\n\n ws.onclose = (ev: CloseEvent): void => {\n heartbeat.stop();\n opts.onClose?.(ev.code, ev.reason);\n\n const pending = pendingOpens.splice(0);\n\n for (const p of pending) p.reject(new PulseConnectionError('Connection closed before open', url));\n\n if (intentionalClose || disposed) {\n status.value = 'closed';\n\n return;\n }\n\n handleUnexpectedClose();\n };\n }\n\n async function handleUnexpectedClose(): Promise<void> {\n status.value = 'reconnecting';\n\n const ok = await reconnect.attempt(\n () =>\n new Promise<void>((resolve, reject) => {\n pendingOpens.push({ reject, resolve });\n openSocket();\n }),\n disposalCtrl.signal,\n opts.onReconnect,\n );\n\n if (!ok && !disposed) {\n warn('Reconnect budget exhausted — connection permanently closed');\n status.value = 'closed';\n }\n }\n\n // ── Frame routing ──────────────────────────────────────────────────────────\n\n function handleFrame(frame: InFrame): void {\n switch (frame.type) {\n case 'error':\n warn(`Server error [${frame.code}]: ${frame.message}`);\n\n break;\n\n case 'joined': {\n const next = new Set(rooms.value);\n\n next.add(frame.room);\n rooms.value = next;\n\n const joinCbs = pendingJoins.get(frame.room);\n\n if (joinCbs) {\n pendingJoins.delete(frame.room);\n\n for (const cb of joinCbs) cb();\n }\n\n break;\n }\n\n case 'left': {\n const next = new Set(rooms.value);\n\n next.delete(frame.room);\n rooms.value = next;\n\n const leaveCbs = pendingLeaves.get(frame.room);\n\n if (leaveCbs) {\n pendingLeaves.delete(frame.room);\n\n for (const cb of leaveCbs) cb();\n }\n\n break;\n }\n\n case 'message':\n listeners.dispatch(frame.channel ?? null, frame.event, frame.payload);\n\n break;\n\n case 'pong':\n heartbeat.onPong();\n\n break;\n\n case 'presence_join':\n listeners.dispatch(null, frame.type, frame);\n\n break;\n\n case 'presence_leave':\n listeners.dispatch(null, frame.type, frame);\n\n break;\n\n case 'presence_state':\n listeners.dispatch(null, frame.type, frame);\n\n break;\n\n case 'subscribed':\n case 'unsubscribed':\n break;\n\n default: {\n const unrecognized: { type: unknown } = frame;\n\n warn(`Received frame with an unrecognized type: ${String(unrecognized.type)}`);\n\n break;\n }\n }\n }\n\n // ── Shared room confirmation helper ───────────────────────────────────────\n\n function awaitRoomConfirmation(\n pending: Map<string, Set<() => void>>,\n room: string,\n frameType: 'join' | 'leave',\n roomOpts?: { signal?: AbortSignal; timeout?: number },\n ): Promise<void> {\n if (disposed) return Promise.reject(new PulseDisposedError());\n\n return new Promise((resolve, reject) => {\n const extraSignals: AbortSignal[] = [];\n\n if (roomOpts?.signal) extraSignals.push(roomOpts.signal);\n\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n if (roomOpts?.timeout !== undefined) {\n const tc = new AbortController();\n\n timeoutId = setTimeout(() => tc.abort(new PulseTimeoutError(frameType)), roomOpts.timeout);\n extraSignals.push(tc.signal);\n }\n\n const sig =\n extraSignals.length === 0 ? disposalCtrl.signal : combineSignals(disposalCtrl.signal, ...extraSignals);\n\n if (sig.aborted) {\n clearTimeout(timeoutId);\n reject(sig.reason instanceof PulseTimeoutError ? sig.reason : new PulseAbortError());\n\n return;\n }\n\n let onAbort: () => void = () => {};\n\n const onConfirm = (): void => {\n clearTimeout(timeoutId);\n sig.removeEventListener('abort', onAbort);\n resolve();\n };\n\n onAbort = (): void => {\n clearTimeout(timeoutId);\n\n const set = pending.get(room);\n\n set?.delete(onConfirm);\n\n if (set?.size === 0) pending.delete(room);\n\n reject(sig.reason instanceof PulseTimeoutError ? sig.reason : new PulseAbortError());\n };\n\n let pendingSet = pending.get(room);\n\n if (!pendingSet) {\n pendingSet = new Set();\n pending.set(room, pendingSet);\n }\n\n pendingSet.add(onConfirm);\n sig.addEventListener('abort', onAbort, { once: true });\n\n const sendFrame = (): void => rawSend(encode({ room, type: frameType }));\n\n if (ws?.readyState === WebSocket.OPEN) {\n sendFrame();\n } else {\n pulse\n .connect()\n .then(sendFrame)\n .catch((err: unknown) => {\n clearTimeout(timeoutId);\n sig.removeEventListener('abort', onAbort);\n\n const set = pending.get(room);\n\n set?.delete(onConfirm);\n\n if (set?.size === 0) pending.delete(room);\n\n reject(err);\n });\n }\n });\n }\n\n // ── Public API ─────────────────────────────────────────────────────────────\n\n const pulse: Pulse<TServer, TClient> = {\n channel<TChServer extends MessageMap = TServer, TChClient extends MessageMap = TClient>(\n name: string,\n ): PulseChannel<TChServer, TChClient> {\n const cached = channelCache.get(name);\n\n if (cached) return cached as PulseChannel<TChServer, TChClient>;\n\n if (disposed) {\n warn(`channel('${name}') called on a disposed Pulse — returning an already-disposed channel`);\n }\n\n const ch = createChannel<TChServer, TChClient>(\n name,\n (chan, event, payload) => {\n runMiddleware(event, payload, () => {\n rawSend(encode({ channel: chan, event, payload, type: 'message' }));\n });\n },\n (chan, event, handler) => listeners.add(chan, event, handler),\n disposalCtrl.signal,\n () => {\n channelCache.delete(name);\n rawSend(encode({ channel: name, type: 'unsubscribe' }));\n },\n );\n\n if (!disposed) channelCache.set(name, ch as PulseChannel<MessageMap, MessageMap>);\n\n if (ws?.readyState === WebSocket.OPEN) {\n ws.send(encode({ channel: name, type: 'subscribe' }));\n }\n\n return ch;\n },\n\n connect(): Promise<void> {\n if (disposed) return Promise.reject(new PulseDisposedError());\n\n if (ws?.readyState === WebSocket.OPEN) return Promise.resolve();\n\n return new Promise((resolve, reject) => {\n pendingOpens.push({ reject, resolve });\n\n if (!ws || ws.readyState > WebSocket.OPEN) openSocket();\n });\n },\n\n disconnect(code = 1000, reason = ''): void {\n intentionalClose = true;\n ws?.close(code, reason);\n },\n\n get disposalSignal() {\n return disposalCtrl.signal;\n },\n\n dispose(): void {\n if (disposed) return;\n\n disposed = true;\n intentionalClose = true;\n heartbeat.stop();\n ws?.close(1000, 'disposed');\n ws = null;\n\n const pending = pendingOpens.splice(0);\n\n for (const p of pending) p.reject(new PulseDisposedError());\n\n channelCache.clear();\n pendingJoins.clear();\n pendingLeaves.clear();\n status.dispose();\n rooms.dispose();\n listeners.clear();\n disposalCtrl.abort();\n },\n\n get disposed() {\n return disposed;\n },\n\n join(room: string, roomOpts?: { signal?: AbortSignal; timeout?: number }): Promise<void> {\n return awaitRoomConfirmation(pendingJoins, room, 'join', roomOpts);\n },\n\n leave(room: string, roomOpts?: { signal?: AbortSignal; timeout?: number }): Promise<void> {\n return awaitRoomConfirmation(pendingLeaves, room, 'leave', roomOpts);\n },\n\n on<K extends EventKey<TServer>>(event: K, handler: (payload: TServer[K]) => void): Unsubscribe {\n if (disposed) {\n warn(`on('${String(event)}') called on a disposed Pulse — listener ignored`);\n\n return () => {};\n }\n\n return listeners.add(null, event, handler as Handler);\n },\n\n once<K extends EventKey<TServer>>(event: K, handler: (payload: TServer[K]) => void): Unsubscribe {\n if (disposed) {\n warn(`once('${String(event)}') called on a disposed Pulse — listener ignored`);\n\n return () => {};\n }\n\n let unsub: Unsubscribe = () => {};\n\n const wrapped: Handler = (payload) => {\n unsub();\n (handler as Handler)(payload);\n };\n\n unsub = listeners.add(null, event, wrapped);\n\n return unsub;\n },\n\n presence<T>(room: string): PresenceChannel<T> {\n const ch = createPresence<T>(\n room,\n rawSend,\n {\n onJoin: (handler) => listeners.add(null, 'presence_join', (p) => handler(p as InPresenceJoinFrame)),\n onLeave: (handler) => listeners.add(null, 'presence_leave', (p) => handler(p as InPresenceLeaveFrame)),\n onState: (handler) => listeners.add(null, 'presence_state', (p) => handler(p as InPresenceStateFrame)),\n },\n disposalCtrl.signal,\n );\n\n if (disposed) {\n warn(`presence('${room}') called on a disposed Pulse — returning an already-disposed presence channel`);\n } else {\n pulse.join(room).catch((err: unknown) => {\n warn(`presence() join failed for room '${room}': ${String(err)}`);\n });\n }\n\n return ch;\n },\n\n get rooms() {\n return rooms;\n },\n\n send<K extends EventKey<TClient>>(event: K, payload: TClient[K]): void {\n if (disposed) {\n warn(`send('${String(event)}') called on a disposed Pulse — message dropped`);\n\n return;\n }\n\n runMiddleware(event, payload, () => {\n rawSend(encode({ event, payload, type: 'message' }));\n });\n },\n\n get status() {\n return status;\n },\n\n [Symbol.dispose]() {\n this.dispose();\n },\n\n wait<K extends EventKey<TServer>>(\n event: K,\n waitOpts?: { signal?: AbortSignal; timeout?: number },\n ): Promise<TServer[K]> {\n return createWaitPromise<TServer[K]>(event as string, disposalCtrl.signal, waitOpts, (ev, handler) =>\n listeners.add(null, ev, handler),\n );\n },\n };\n\n if (!opts.lazy) openSocket();\n\n return pulse;\n}\n"],"mappings":"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"}
|
package/dist/pulse.d.ts
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { MessageMap, Pulse, PulseOptions } from './types';
|
|
2
|
+
/**
|
|
3
|
+
* Create a managed WebSocket connection with typed messaging, channels,
|
|
4
|
+
* rooms, and presence.
|
|
5
|
+
*
|
|
6
|
+
* @example
|
|
7
|
+
* ```ts
|
|
8
|
+
* const pulse = createPulse<ServerEvents, ClientEvents>('wss://api.example.com/ws', {
|
|
9
|
+
* reconnect: true,
|
|
10
|
+
* heartbeat: true,
|
|
11
|
+
* });
|
|
12
|
+
* pulse.on('message', (data) => console.log(data));
|
|
13
|
+
* ```
|
|
14
|
+
*/
|
|
15
|
+
export declare function createPulse<TServer extends MessageMap = MessageMap, TClient extends MessageMap = MessageMap>(url: string, opts?: PulseOptions): Pulse<TServer, TClient>;
|
|
16
|
+
//# sourceMappingURL=pulse.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pulse.d.ts","sourceRoot":"","sources":["../src/pulse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,UAAU,EAGV,KAAK,EAEL,YAAY,EAGb,MAAM,SAAS,CAAC;AAsEjB;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,EAAE,OAAO,SAAS,UAAU,GAAG,UAAU,EAC1G,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,YAAiB,GACtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CA6gBzB"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
var Pulse=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},n=class extends t{url;constructor(e,t,n){super(e,n),this.url=t}},r=class extends t{event;constructor(e,t){super(`Timed out waiting for "${e}"`,t),this.event=e}},i=class extends t{constructor(e){super(`Aborted`,e)}},a=class extends t{constructor(e=`Pulse`,t){super(`${e} instance is disposed`,t)}},o=class extends t{raw;constructor(e,t,n){super(e,n),this.raw=t}},s=null,c=()=>s,l=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},u=class extends l{},d=0,f=()=>++d,p={scheduling:{activeDirty:`a`,batchDepth:0,dirtyWithEffectSubsA:new Set,dirtyWithEffectSubsB:new Set,pendingSubscribers:new Set},scopeCleanups:null,tracking:null},m=null,h=()=>m===null?p:m.get(),g=()=>h().scheduling,_=()=>m!==null,v=()=>h().tracking,y=e=>{let t=v();if(t!==null){if(t.sourceObserver?.(e),t.kind===`computed`)t.depCollector.push({source:e,version:e.version});else if(t.kind===`effect`){let n=t.effect;e.addEffectSub(n),t.subscriptions.add(()=>e.removeEffectSub(n)),t.deps.set(e,e.version)}}},b=e=>e instanceof Error?e:Error(`Non-Error thrown: ${String(e)}`),x=e=>{let t=[];for(let n of e)try{n()}catch(e){t.push(b(e))}return t},S=(e,t)=>{let n=x(e);if(n.length===1)throw n[0];if(n.length>0)throw AggregateError(n,t)},C=!globalThis.__RIPPLE_PROD__;function w(e){C&&console.warn(`[@vielzeug/ripple] ${e}`)}var T=!1,E=0,D=[],O=e=>e.activeDirty===`a`?e.dirtyWithEffectSubsA:e.dirtyWithEffectSubsB,k=(e,t)=>{let n=++E;for(let n of t.effectSubs())e.pendingSubscribers.add(n);for(let e of t.computedSubs())D.push(e);try{for(;D.length>0;){let t=D.pop();if(t.lastPropEpoch_!==n&&(t.lastPropEpoch_=n,t.markDirty())){t.effectSubs().size>0&&O(e).add(t);for(let e of t.computedSubs())D.push(e)}}}finally{D.length=0}},A=e=>{for(;O(e).size>0;){let t=O(e);e.activeDirty=e.activeDirty===`a`?`b`:`a`,O(e).clear();for(let n of t)if(n.hasSubscribers()&&n.refreshIfDirty()){for(let t of n.effectSubs())e.pendingSubscribers.add(t);for(let t of n.computedSubs())t.markDirty()&&t.effectSubs().size>0&&O(e).add(t)}t.clear()}},j=e=>{let t=0;for(;e.pendingSubscribers.size>0||O(e).size>0;){if(++t>100)throw new u(`infinite flush loop (> 100 iterations)`);if(O(e).size>0&&A(e),e.pendingSubscribers.size===0)continue;let n=[...e.pendingSubscribers];e.pendingSubscribers.clear(),S(n,`subscriber errors`)}},M=globalThis.process?.versions!=null,N=e=>{if(!e.hasSubscribers())return;!T&&M&&!_()&&(T=!0,w(`Signal updated in a Node.js-like environment. The module-level flush queue is shared across concurrent requests — use per-request worker isolation or the @vielzeug/ripple/ssr sub-path for request-isolated scheduling.`));let t=g();k(t,e),t.batchDepth===0&&j(t)},P=class{fn_;disposed_=!1;constructor(e){this.fn_=e}get disposed(){return this.disposed_}dispose(){if(this.disposed_)return;this.disposed_=!0;let e=this.fn_;this.fn_=null,e()}[Symbol.dispose](){this.dispose()}},F=Symbol(`ripple.is-signal`),I=new FinalizationRegistry(({key:e,map:t})=>{t.delete(e)}),L=class{version=0;name;[F]=!0;computedSubs_=new Map;effectSubs_=new Set;constructor(e){this.name=e}addComputedSub(e){let t=new WeakRef(e);this.computedSubs_.set(e,t),I.register(e,{key:e,map:this.computedSubs_},t)}removeComputedSub(e){let t=this.computedSubs_.get(e);t!==void 0&&(this.computedSubs_.delete(e),I.unregister(t))}addEffectSub(e){this.effectSubs_.add(e)}removeEffectSub(e){this.effectSubs_.delete(e)}clearSubscribers(){for(let e of this.computedSubs_.values())I.unregister(e);this.computedSubs_.clear(),this.effectSubs_.clear()}hasSubscribers(){if(this.effectSubs_.size>0)return!0;for(let e of this.computedSubs_.values())if(e.deref()!==void 0)return!0;return!1}*computedSubs(){for(let[e,t]of this.computedSubs_){let n=t.deref();n===void 0?(this.computedSubs_.delete(e),I.unregister(t)):yield n}}effectSubs(){return this.effectSubs_}},R=class extends L{value_;equals_;disposed_;constructor(e,t,n){super(n),this.value_=e,this.equals_=t??Object.is,this.disposed_=!1}get value(){return this.disposed_||y(this),this.value_}set value(e){if(this.disposed_||this.equals_(this.value_,e))return;let t=this.value_;this.value_=e,this.version=f(),c()?.write?.({name:this.name,newValue:e,oldValue:t}),N(this)}peek(){return this.value_}subscribe=e=>{if(this.disposed_){let e=new P(()=>{});return e.dispose(),e}return this.addEffectSub(e),new P(()=>{this.removeEffectSub(e)})};get disposed(){return this.disposed_}dispose(){this.disposed_||(this.disposed_=!0,this.clearSubscribers(),c()?.dispose?.({kind:`signal`,name:this.name}))}[Symbol.dispose](){this.dispose()}},z=(e,t)=>new R(e,t?.equals,t?.name),B=!globalThis.__PULSE_PROD__;function V(e){B&&console.warn(`[@vielzeug/pulse] ${e}`)}function H(e,...t){return t.length===0?e:t.reduce(U,e)}function U(e,t){if(e.aborted)return e;if(t.aborted)return t;let n=new AbortController,r=()=>n.abort(e.reason),i=()=>n.abort(t.reason);return e.addEventListener(`abort`,r,{once:!0}),t.addEventListener(`abort`,i,{once:!0}),n.signal.addEventListener(`abort`,()=>{e.removeEventListener(`abort`,r),t.removeEventListener(`abort`,i)},{once:!0}),n.signal}function W(e){let t=new AbortController;return e.aborted?t.abort(e.reason):e.addEventListener(`abort`,()=>t.abort(e.reason),{once:!0}),t}function G(e,t){return new Promise(n=>{if(t?.aborted){n();return}let r=setTimeout(n,e);t?.addEventListener(`abort`,()=>{clearTimeout(r),n()},{once:!0})})}function K(e,t=3e4){let n=Math.min(1e3*2**e,t);return Math.random()*n}function q(e,t,n,a){return new Promise((o,s)=>{let c=[t],l;if(n?.signal&&c.push(n.signal),n?.timeout!==void 0){let t=new AbortController;l=setTimeout(()=>{t.abort(new r(e))},n.timeout),c.push(t.signal)}let u=c.length===1?c[0]:H(c[0],...c.slice(1));if(u.aborted){clearTimeout(l),s(u.reason instanceof r?u.reason:new i);return}let d=()=>{},f=()=>{clearTimeout(l),d(),s(u.reason instanceof r?u.reason:new i)};u.addEventListener(`abort`,f,{once:!0}),d=a(e,e=>{clearTimeout(l),u.removeEventListener(`abort`,f),o(e)})})}function J(e,t,n,r,i){let a=W(r),o=new Set,s=a.signal.aborted;return{get disposalSignal(){return a.signal},dispose(){if(!s){s=!0,a.abort();for(let e of o)e();o.clear(),i?.()}},get disposed(){return s},get name(){return e},on(t,r){if(s)return V(`on('${String(t)}') called on a disposed channel '${e}' — listener ignored`),()=>{};let i=n(e,t,r);return o.add(i),()=>{i(),o.delete(i)}},once(t,r){if(s)return V(`once('${String(t)}') called on a disposed channel '${e}' — listener ignored`),()=>{};let i=()=>{};return i=n(e,t,e=>{o.delete(i),i(),r(e)}),o.add(i),()=>{o.delete(i),i()}},send(n,r){if(s){V(`send('${String(n)}') called on a disposed channel '${e}' — message dropped`);return}t(e,n,r)},[Symbol.dispose](){this.dispose()},wait(t,r){return q(t,a.signal,r,(t,r)=>n(e,t,r))}}}function Y(e){return JSON.stringify(e)}function X(e){if(typeof e!=`string`)throw new o(`Expected string message data`,e);let t;try{t=JSON.parse(e)}catch{throw new o(`JSON parse error`,e)}if(typeof t!=`object`||!t||!(`type`in t)||typeof t.type!=`string`)throw new o(`Missing or invalid "type" field`,t);return t}var Z=3e4,Q=5e3;function $(e,t,n){if(!e)return{onPong(){},start(){},stop(){}};let r=e===!0?{}:e,i=r.interval??Z,a=r.timeout??Q,o,s,c=!1;function l(){o=setTimeout(()=>{t(Y({ts:Date.now(),type:`ping`})),s=setTimeout(()=>{V(`Heartbeat timed out after ${a}ms — treating connection as dead`),n()},a)},i)}return{onPong(){clearTimeout(s),s=void 0,c&&l()},start(){c=!0,clearTimeout(o),clearTimeout(s),s=void 0,l()},stop(){c=!1,clearTimeout(o),clearTimeout(s),o=void 0,s=void 0}}}function ee(e,t,n,r){let i=W(r),a=i.signal.aborted,o=z(new Map),s=new Set,c=new Set,l=[n.onState(t=>{if(t.room!==e)return;let n=new Map;for(let[e,r]of Object.entries(t.members))n.set(e,r);o.value=n}),n.onJoin(t=>{if(t.room!==e)return;let n=new Map(o.value);n.set(t.id,t.state),o.value=n;for(let e of s)e(t.id,t.state)}),n.onLeave(t=>{if(t.room!==e)return;let n=new Map(o.value);n.delete(t.id),o.value=n;for(let e of c)e(t.id)})];return{get disposalSignal(){return i.signal},dispose(){if(!a){a=!0,t(Y({room:e,type:`leave`})),i.abort();for(let e of l)e();l.length=0,s.clear(),c.clear(),o.dispose()}},get disposed(){return a},onJoin(t){return a?(V(`onJoin() called on a disposed presence channel '${e}' — listener ignored`),()=>{}):(s.add(t),()=>s.delete(t))},onLeave(t){return a?(V(`onLeave() called on a disposed presence channel '${e}' — listener ignored`),()=>{}):(c.add(t),()=>c.delete(t))},get room(){return e},get state(){return o},[Symbol.dispose](){this.dispose()},update(n){a||t(Y({room:e,state:n,type:`presence`}))}}}var te=5;function ne(e){if(!e)return{attempt:async()=>!1,reset(){}};let t=e===!0?{}:e,n=t.maxAttempts??te,r=typeof t.delay==`function`?t.delay:typeof t.delay==`number`?()=>t.delay:K,i=0;return{async attempt(e,t,a){if(i>=n)return!1;let o=r(i);if(i++,a?.(i),await G(o,t),t.aborted)return!1;try{return await e(),i=0,!0}catch{return!1}},reset(){i=0}}}var re=class{map=new Map;add(e,t,n){let r=this.map.get(e);r||(r=new Map,this.map.set(e,r));let i=r.get(t);return i||(i=new Set,r.set(t,i)),i.add(n),()=>{i.delete(n),i.size===0&&r.delete(t),r.size===0&&this.map.delete(e)}}dispatch(e,t,n){this.map.get(e)?.get(t)?.forEach(e=>e(n))}clear(){this.map.clear()}};function ie(e,t={}){let o=new AbortController,s=z(`connecting`),c=z(new Set),l=new re,u=t.middleware??[],d=new Map,f=new Map,p=null,m=!1,h=!1,g=[],_=new Map,v=t.buffer,y=v?[]:null,b=typeof v==`object`&&v?v.maxSize??50:50,x=ne(t.reconnect),S=$(t.heartbeat,e=>{p?.readyState===WebSocket.OPEN&&p.send(e)},()=>{V(`Heartbeat dead — closing socket for reconnect`),p?.close(4e3,`heartbeat timeout`)});function C(e){p?.readyState===WebSocket.OPEN?p.send(e):y===null?V(`send() called while connection is ${s.value} — message dropped`):(y.length>=b&&y.shift(),y.push(e))}function w(e,t,n){let r=0;function i(){if(r>=u.length){n();return}let a=u[r++];a(e,t,i)}i()}function T(){m||(p=new WebSocket(e,t.protocols),p.onopen=()=>{h=!1,s.value=`open`,x.reset(),S.start(),t.onOpen?.();let e=g.splice(0);for(let t of e)t.resolve();if(y&&y.length>0){let e=y.splice(0);for(let t of e)p.send(t)}for(let e of _.keys())p.send(Y({channel:e,type:`subscribe`}))},p.onmessage=e=>{t.onMessage?.(e);let n;try{n=X(e.data)}catch(e){V(`Protocol error: ${String(e)}`);return}try{D(n)}catch(e){V(`Frame handling error: ${String(e)}`)}},p.onerror=()=>{t.onError?t.onError(new n(`WebSocket error`,e)):V(`WebSocket error — pass onError to observe it (see onClose for recovery logic)`);let r=g.splice(0);for(let t of r)t.reject(new n(`WebSocket error`,e))},p.onclose=r=>{S.stop(),t.onClose?.(r.code,r.reason);let i=g.splice(0);for(let t of i)t.reject(new n(`Connection closed before open`,e));if(h||m){s.value=`closed`;return}E()})}async function E(){s.value=`reconnecting`,!await x.attempt(()=>new Promise((e,t)=>{g.push({reject:t,resolve:e}),T()}),o.signal,t.onReconnect)&&!m&&(V(`Reconnect budget exhausted — connection permanently closed`),s.value=`closed`)}function D(e){switch(e.type){case`error`:V(`Server error [${e.code}]: ${e.message}`);break;case`joined`:{let t=new Set(c.value);t.add(e.room),c.value=t;let n=d.get(e.room);if(n){d.delete(e.room);for(let e of n)e()}break}case`left`:{let t=new Set(c.value);t.delete(e.room),c.value=t;let n=f.get(e.room);if(n){f.delete(e.room);for(let e of n)e()}break}case`message`:l.dispatch(e.channel??null,e.event,e.payload);break;case`pong`:S.onPong();break;case`presence_join`:l.dispatch(null,e.type,e);break;case`presence_leave`:l.dispatch(null,e.type,e);break;case`presence_state`:l.dispatch(null,e.type,e);break;case`subscribed`:case`unsubscribed`:break;default:V(`Received frame with an unrecognized type: ${String(e.type)}`);break}}function O(e,t,n,s){return m?Promise.reject(new a):new Promise((a,c)=>{let l=[];s?.signal&&l.push(s.signal);let u;if(s?.timeout!==void 0){let e=new AbortController;u=setTimeout(()=>e.abort(new r(n)),s.timeout),l.push(e.signal)}let d=l.length===0?o.signal:H(o.signal,...l);if(d.aborted){clearTimeout(u),c(d.reason instanceof r?d.reason:new i);return}let f=()=>{},m=()=>{clearTimeout(u),d.removeEventListener(`abort`,f),a()};f=()=>{clearTimeout(u);let n=e.get(t);n?.delete(m),n?.size===0&&e.delete(t),c(d.reason instanceof r?d.reason:new i)};let h=e.get(t);h||(h=new Set,e.set(t,h)),h.add(m),d.addEventListener(`abort`,f,{once:!0});let g=()=>C(Y({room:t,type:n}));p?.readyState===WebSocket.OPEN?g():k.connect().then(g).catch(n=>{clearTimeout(u),d.removeEventListener(`abort`,f);let r=e.get(t);r?.delete(m),r?.size===0&&e.delete(t),c(n)})})}let k={channel(e){let t=_.get(e);if(t)return t;m&&V(`channel('${e}') called on a disposed Pulse — returning an already-disposed channel`);let n=J(e,(e,t,n)=>{w(t,n,()=>{C(Y({channel:e,event:t,payload:n,type:`message`}))})},(e,t,n)=>l.add(e,t,n),o.signal,()=>{_.delete(e),C(Y({channel:e,type:`unsubscribe`}))});return m||_.set(e,n),p?.readyState===WebSocket.OPEN&&p.send(Y({channel:e,type:`subscribe`})),n},connect(){return m?Promise.reject(new a):p?.readyState===WebSocket.OPEN?Promise.resolve():new Promise((e,t)=>{g.push({reject:t,resolve:e}),(!p||p.readyState>WebSocket.OPEN)&&T()})},disconnect(e=1e3,t=``){h=!0,p?.close(e,t)},get disposalSignal(){return o.signal},dispose(){if(m)return;m=!0,h=!0,S.stop(),p?.close(1e3,`disposed`),p=null;let e=g.splice(0);for(let t of e)t.reject(new a);_.clear(),d.clear(),f.clear(),s.dispose(),c.dispose(),l.clear(),o.abort()},get disposed(){return m},join(e,t){return O(d,e,`join`,t)},leave(e,t){return O(f,e,`leave`,t)},on(e,t){return m?(V(`on('${String(e)}') called on a disposed Pulse — listener ignored`),()=>{}):l.add(null,e,t)},once(e,t){if(m)return V(`once('${String(e)}') called on a disposed Pulse — listener ignored`),()=>{};let n=()=>{};return n=l.add(null,e,e=>{n(),t(e)}),n},presence(e){let t=ee(e,C,{onJoin:e=>l.add(null,`presence_join`,t=>e(t)),onLeave:e=>l.add(null,`presence_leave`,t=>e(t)),onState:e=>l.add(null,`presence_state`,t=>e(t))},o.signal);return m?V(`presence('${e}') called on a disposed Pulse — returning an already-disposed presence channel`):k.join(e).catch(t=>{V(`presence() join failed for room '${e}': ${String(t)}`)}),t},get rooms(){return c},send(e,t){if(m){V(`send('${String(e)}') called on a disposed Pulse — message dropped`);return}w(e,t,()=>{C(Y({event:e,payload:t,type:`message`}))})},get status(){return s},[Symbol.dispose](){this.dispose()},wait(e,t){return q(e,o.signal,t,(e,t)=>l.add(null,e,t))}};return t.lazy||T(),k}return e.PulseAbortError=i,e.PulseConnectionError=n,e.PulseDisposedError=a,e.PulseError=t,e.PulseProtocolError=o,e.PulseTimeoutError=r,e.createPulse=ie,e})({});
|
|
2
|
+
//# sourceMappingURL=pulse.iife.js.map
|