@foony/chat 0.0.1

package/lib-cjs/messages.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Per-room message API: send, edit, delete, subscribe, and history.
+ *
+ * One {@link MessageReconciler} is shared across every subscriber and the
+ * history backfill, so live and replayed frames converge on identical state.
+ * Subscribers see only live frames; history is returned as a separate page
+ * (the app renders backfill itself, matching Ably's historyBeforeSubscribe).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Messages = void 0;
+const protocol_js_1 = require("./protocol.js");
+const reconciler_js_1 = require("./reconciler.js");
+const util_js_1 = require("./util.js");
+/**
+ * Retention requested for chat messages: the maximum the platform offers (1
+ * year). The edge clamps this down to the app's plan ceiling, so a chat message
+ * persists as long as the plan allows — versus typing/reactions, which are left
+ * at the short ephemeral default. One year in milliseconds.
+ */
+const MESSAGE_TTL_MS = 365 * 24 * 60 * 60 * 1000;
+/** The message feature of a {@link Room}. */
+class Messages {
+    channel;
+    roomName;
+    getClientId;
+    reconciler;
+    listeners = new Set();
+    channelUnsubscribe = null;
+    constructor(channel, roomName, getClientId) {
+        this.channel = channel;
+        this.roomName = roomName;
+        this.getClientId = getClientId;
+        this.reconciler = new reconciler_js_1.MessageReconciler(roomName);
+    }
+    /** Send a new message. Returns the message optimistically; its `id` is stable. */
+    async send(params) {
+        const id = (0, util_js_1.newMessageId)();
+        const payload = {
+            v: protocol_js_1.PAYLOAD_VERSION,
+            action: 'create',
+            id,
+            text: params.text,
+            ...(params.metadata === undefined ? {} : { metadata: params.metadata }),
+            ...(params.headers === undefined ? {} : { headers: params.headers }),
+        };
+        await this.channel.publish(protocol_js_1.MESSAGE_EVENT, payload, { ttlMs: MESSAGE_TTL_MS });
+        const now = new Date();
+        return {
+            id,
+            clientId: this.getClientId() ?? '',
+            roomName: this.roomName,
+            text: params.text,
+            metadata: params.metadata ?? {},
+            headers: params.headers ?? {},
+            createdAt: now,
+            updatedAt: now,
+            action: 'create',
+            deleted: false,
+        };
+    }
+    /** Edit a message by id. Replaces text/metadata/headers (omitted fields clear). */
+    async update(id, params) {
+        const payload = {
+            v: protocol_js_1.PAYLOAD_VERSION,
+            action: 'update',
+            id,
+            text: params.text,
+            ...(params.metadata === undefined ? {} : { metadata: params.metadata }),
+            ...(params.headers === undefined ? {} : { headers: params.headers }),
+        };
+        await this.channel.publish(protocol_js_1.MESSAGE_EVENT, payload, { ttlMs: MESSAGE_TTL_MS });
+    }
+    /** Delete a message by id. */
+    async delete(id) {
+        const payload = { v: protocol_js_1.PAYLOAD_VERSION, action: 'delete', id };
+        await this.channel.publish(protocol_js_1.MESSAGE_EVENT, payload, { ttlMs: MESSAGE_TTL_MS });
+    }
+    /**
+     * Subscribe to live message changes. The first subscriber attaches the
+     * underlying channel subscription; the last to unsubscribe removes it.
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        this.ensureChannelSubscription();
+        return () => {
+            this.listeners.delete(listener);
+            if (this.listeners.size === 0 && this.channelUnsubscribe) {
+                this.channelUnsubscribe();
+                this.channelUnsubscribe = null;
+            }
+        };
+    }
+    /**
+     * Fetch a page of past messages, oldest-first, materialized through the same
+     * reconciler as the live stream. Pass `cursor` (a previous page's
+     * `nextCursor`) to page further back.
+     */
+    async history(params) {
+        const { messages: frames, more } = await this.channel.history({
+            ...(params?.limit === undefined ? {} : { limit: params.limit }),
+            ...(params?.cursor === undefined ? {} : { start: params.cursor }),
+        });
+        const touched = [];
+        for (const frame of frames) {
+            if (frame.name !== protocol_js_1.MESSAGE_EVENT) {
+                continue;
+            }
+            this.reconciler.apply(frame);
+            const id = messageIdOf(frame);
+            if (id !== null && !touched.includes(id)) {
+                touched.push(id);
+            }
+        }
+        const messages = touched
+            .map((id) => this.reconciler.get(id))
+            .filter((message) => message !== undefined);
+        return {
+            messages,
+            hasMore: more,
+            ...(frames.length > 0 && frames[0] ? { nextCursor: frames[0].messageId } : {}),
+        };
+    }
+    /** Lazily attach the single channel subscription that feeds the reconciler. */
+    ensureChannelSubscription() {
+        if (this.channelUnsubscribe) {
+            return;
+        }
+        this.channelUnsubscribe = this.channel.subscribe(protocol_js_1.MESSAGE_EVENT, (frame) => {
+            const event = this.reconciler.apply(frame);
+            if (event === null) {
+                return;
+            }
+            for (const listener of [...this.listeners]) {
+                listener(event);
+            }
+        });
+    }
+}
+exports.Messages = Messages;
+/** The chat message id a frame refers to (payload `id`), or null if unparseable. */
+function messageIdOf(frame) {
+    const data = frame.data;
+    if (typeof data !== 'object' || data === null) {
+        return null;
+    }
+    const id = data['id'];
+    return typeof id === 'string' && id !== '' ? id : null;
+}
+//# sourceMappingURL=messages.js.map

package/lib-cjs/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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"}

package/lib-cjs/occupancy.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Per-room occupancy, derived entirely from the presence set — no edge call.
+ *
+ * `connections` counts distinct (clientId, connectionId) pairs present (a user
+ * on two devices = two connections); `presenceMembers` counts distinct client
+ * ids. This reuses presence's TTL-based ghost-leave detection, so counts
+ * self-heal after a crash. Limitation: it only counts members who entered
+ * presence — always the case in a chat room, where joining enters presence.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Occupancy = void 0;
+/** Default debounce for occupancy change events. */
+const DEFAULT_DEBOUNCE_MS = 1_000;
+/** The occupancy feature of a {@link Room}. */
+class Occupancy {
+    presence;
+    listeners = new Set();
+    debounceMs;
+    debounceTimer = null;
+    lastEmitted = null;
+    membersChangedUnsubscribe = null;
+    constructor(presence, debounceMs) {
+        this.presence = presence;
+        this.debounceMs = debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    }
+    /** Current occupancy snapshot, computed from the local presence member set. */
+    get() {
+        const members = this.presence.get();
+        const clientIds = new Set(members.map((member) => member.clientId));
+        return { connections: members.length, presenceMembers: clientIds.size };
+    }
+    /** Subscribe to occupancy changes (debounced, deduplicated). */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        if (!this.membersChangedUnsubscribe) {
+            this.membersChangedUnsubscribe = this.presence.onMembersChanged(() => this.scheduleEmit());
+        }
+        return () => {
+            this.listeners.delete(listener);
+            if (this.listeners.size === 0 && this.membersChangedUnsubscribe) {
+                this.membersChangedUnsubscribe();
+                this.membersChangedUnsubscribe = null;
+                if (this.debounceTimer) {
+                    clearTimeout(this.debounceTimer);
+                    this.debounceTimer = null;
+                }
+            }
+        };
+    }
+    scheduleEmit() {
+        if (this.debounceTimer) {
+            return;
+        }
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            const current = this.get();
+            if (this.lastEmitted && this.lastEmitted.connections === current.connections && this.lastEmitted.presenceMembers === current.presenceMembers) {
+                return;
+            }
+            this.lastEmitted = current;
+            for (const listener of [...this.listeners]) {
+                listener(current);
+            }
+        }, this.debounceMs);
+    }
+}
+exports.Occupancy = Occupancy;
+//# sourceMappingURL=occupancy.js.map

package/lib-cjs/occupancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occupancy.js","sourceRoot":"","sources":["../src/occupancy.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AASH,oDAAoD;AACpD,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC,+CAA+C;AAC/C,MAAa,SAAS;IAQD;IAPF,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,UAAU,CAAS;IAC5B,aAAa,GAAyC,IAAI,CAAC;IAC3D,WAAW,GAAyB,IAAI,CAAC;IACzC,yBAAyB,GAAyB,IAAI,CAAC;IAE/D,YACmB,QAAkB,EACnC,UAAmB;QADF,aAAQ,GAAR,QAAQ,CAAU;QAGnC,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,mBAAmB,CAAC;IACtD,CAAC;IAED,+EAA+E;IAC/E,GAAG;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;IAC1E,CAAC;IAED,gEAAgE;IAChE,SAAS,CAAC,QAA2B;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC;YACpC,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7F,CAAC;QACD,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;gBAChE,IAAI,CAAC,yBAAyB,EAAE,CAAC;gBACjC,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC;gBACtC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;oBACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,eAAe,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC7I,OAAO;YACT,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;YAC3B,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3C,QAAQ,CAAC,OAAO,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;CACF;AAxDD,8BAwDC"}

package/lib-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/lib-cjs/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAWH,8CAA8C;AAC9C,MAAa,QAAQ;IAOU;IAN7B,oDAAoD;IACnC,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,uBAAuB,GAAG,IAAI,GAAG,EAA0B,CAAC;IACrE,kBAAkB,GAAyB,IAAI,CAAC;IAExD,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD,mEAAmE;IACnE,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,MAAM,CAAC,IAAc;QACzB,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IAED,kFAAkF;IAClF,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,oEAAoE;IACpE,aAAa,CAAC,QAAgB;QAC5B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iFAAiF;IACjF,SAAS,CAAC,QAA0B;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,gBAAgB,CAAC,QAAgC;QAC/C,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAEO,yBAAyB;QAC/B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACpG,CAAC;IAEO,eAAe,CAAC,KAAyB;QAC/C,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACtD,MAAM,MAAM,GAAmB;YAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YACzD,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;SACrC,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,KAAK,GAAkB,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5D,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,uBAAuB,CAAC,EAAE,CAAC;YACzD,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;CACF;AArFD,4BAqFC"}

package/lib-cjs/protocol.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Internal wire conventions for the chat layer: the reserved `name` values
+ * used on the underlying realtime channel and the JSON payload shapes carried
+ * in each. Not part of the public API — kept in one place so producers and the
+ * reconciler agree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYLOAD_VERSION = exports.TYPING_EVENT = exports.REACTION_EVENT = exports.MESSAGE_EVENT = void 0;
+exports.roomChannelName = roomChannelName;
+exports.parseMessagePayload = parseMessagePayload;
+exports.parseTypingPayload = parseTypingPayload;
+exports.parseReactionPayload = parseReactionPayload;
+/** Channel name for a room. The edge grammar forbids `$`, so we namespace with `:`. */
+function roomChannelName(roomName) {
+    return `chat:${roomName}`;
+}
+/** Event name carrying message create/update/delete payloads. */
+exports.MESSAGE_EVENT = 'chat.message';
+/** Event name carrying ephemeral room-level reactions. */
+exports.REACTION_EVENT = 'chat.reaction';
+/** Event name carrying ephemeral typing heartbeats and stops. */
+exports.TYPING_EVENT = 'chat.typing';
+/** Payload schema version, bumped if the on-channel shape ever changes. */
+exports.PAYLOAD_VERSION = 1;
+/** Parse an unknown message payload, returning null if it is malformed or a foreign frame. */
+function parseMessagePayload(data) {
+    if (typeof data !== 'object' || data === null) {
+        return null;
+    }
+    const payload = data;
+    const action = payload['action'];
+    const id = payload['id'];
+    if (typeof id !== 'string' || id === '') {
+        return null;
+    }
+    if (action === 'delete') {
+        return { v: exports.PAYLOAD_VERSION, action, id };
+    }
+    if ((action === 'create' || action === 'update') && typeof payload['text'] === 'string') {
+        const text = payload['text'];
+        const metadata = isRecord(payload['metadata']) ? payload['metadata'] : undefined;
+        const headers = isRecord(payload['headers']) ? payload['headers'] : undefined;
+        return {
+            v: exports.PAYLOAD_VERSION,
+            action,
+            id,
+            text,
+            ...(metadata === undefined ? {} : { metadata }),
+            ...(headers === undefined ? {} : { headers }),
+        };
+    }
+    return null;
+}
+/** Parse an unknown typing payload, returning null if malformed. */
+function parseTypingPayload(data) {
+    if (typeof data !== 'object' || data === null) {
+        return null;
+    }
+    const state = data['state'];
+    return state === 'started' || state === 'stopped' ? { state } : null;
+}
+/** Parse an unknown reaction payload, returning null if malformed. */
+function parseReactionPayload(data) {
+    if (typeof data !== 'object' || data === null) {
+        return null;
+    }
+    const name = data['name'];
+    if (typeof name !== 'string' || name === '') {
+        return null;
+    }
+    const metadata = data['metadata'];
+    return metadata === undefined ? { name } : { name, metadata };
+}
+/** True when `value` is a non-null, non-array object. */
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=protocol.js.map

package/lib-cjs/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/lib-cjs/reactions.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Per-room reactions — ephemeral, fire-and-forget broadcasts (e.g. a floating
+ * emoji). Not stored or aggregated; distinct from per-message reactions (which
+ * are out of scope for v1). Pure pub/sub over the channel.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Reactions = void 0;
+const protocol_js_1 = require("./protocol.js");
+/** The room-reaction feature of a {@link Room}. */
+class Reactions {
+    channel;
+    getClientId;
+    listeners = new Set();
+    channelUnsubscribe = null;
+    constructor(channel, getClientId) {
+        this.channel = channel;
+        this.getClientId = getClientId;
+    }
+    /** Broadcast a room reaction. */
+    async send(params) {
+        const payload = {
+            name: params.name,
+            ...(params.metadata === undefined ? {} : { metadata: params.metadata }),
+        };
+        await this.channel.publish(protocol_js_1.REACTION_EVENT, payload);
+    }
+    /** Subscribe to room reactions. Attaches the channel on first listener. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        this.ensureChannelSubscription();
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    ensureChannelSubscription() {
+        if (this.channelUnsubscribe) {
+            return;
+        }
+        this.channelUnsubscribe = this.channel.subscribe(protocol_js_1.REACTION_EVENT, (frame) => {
+            const payload = (0, protocol_js_1.parseReactionPayload)(frame.data);
+            if (payload === null) {
+                return;
+            }
+            const clientId = frame.clientId ?? '';
+            const reaction = {
+                name: payload.name,
+                clientId,
+                ...(payload.metadata === undefined ? {} : { metadata: payload.metadata }),
+                createdAt: new Date(frame.timestamp),
+                isSelf: clientId !== '' && clientId === this.getClientId(),
+            };
+            for (const subscriber of [...this.listeners]) {
+                subscriber(reaction);
+            }
+        });
+    }
+}
+exports.Reactions = Reactions;
+//# sourceMappingURL=reactions.js.map

package/lib-cjs/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../src/reactions.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,+CAA2F;AAM3F,mDAAmD;AACnD,MAAa,SAAS;IAKD;IACA;IALF,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IACjD,kBAAkB,GAAyB,IAAI,CAAC;IAExD,YACmB,OAAgB,EAChB,WAAgC;QADhC,YAAO,GAAP,OAAO,CAAS;QAChB,gBAAW,GAAX,WAAW,CAAqB;IAChD,CAAC;IAEJ,iCAAiC;IACjC,KAAK,CAAC,IAAI,CAAC,MAA4C;QACrD,MAAM,OAAO,GAAoB;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;SACxE,CAAC;QACF,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,4BAAc,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,2EAA2E;IAC3E,SAAS,CAAC,QAA0B;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAEO,yBAAyB;QAC/B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,4BAAc,EAAE,CAAC,KAAK,EAAE,EAAE;YACzE,MAAM,OAAO,GAAG,IAAA,kCAAoB,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAiB;gBAC7B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ;gBACR,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACzE,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;gBACpC,MAAM,EAAE,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,IAAI,CAAC,WAAW,EAAE;aAC3D,CAAC;YACF,KAAK,MAAM,UAAU,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7C,UAAU,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAjDD,8BAiDC"}

package/lib-cjs/reconciler.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Message reconciler: folds a stream of create/update/delete frames into
+ * materialized {@link Message} state, keyed by message id. The same reconciler
+ * runs over the live subscription and over replayed history, so both paths
+ * converge on identical state regardless of delivery order or duplicates.
+ *
+ * Version ordering uses the transport `(timestamp, messageId)` pair: a later
+ * mutation wins, and a re-delivered frame (same messageId) is ignored.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageReconciler = void 0;
+const protocol_js_1 = require("./protocol.js");
+/** Stateful reconciler for a single room's messages. */
+class MessageReconciler {
+    roomName;
+    byId = new Map();
+    constructor(roomName) {
+        this.roomName = roomName;
+    }
+    /**
+     * Fold one channel frame into state. Returns the event a subscriber should
+     * see, or null when the frame is malformed, a duplicate, or stale.
+     */
+    apply(frame) {
+        const payload = (0, protocol_js_1.parseMessagePayload)(frame.data);
+        if (payload === null) {
+            return null;
+        }
+        const timestamp = frame.timestamp;
+        const versionId = frame.messageId;
+        if (payload.action === 'create') {
+            return this.applyCreate(payload, frame.clientId ?? '', timestamp, versionId);
+        }
+        return this.applyMutation(payload, frame.clientId ?? '', timestamp, versionId);
+    }
+    /** The current materialized state of one message, if known. */
+    get(id) {
+        return this.byId.get(id)?.message;
+    }
+    /** Current materialized messages, oldest-first by creation then id. */
+    snapshot() {
+        return [...this.byId.values()]
+            .map((entry) => entry.message)
+            .sort((left, right) => left.createdAt.getTime() - right.createdAt.getTime() || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0));
+    }
+    applyCreate(payload, clientId, timestamp, versionId) {
+        const existing = this.byId.get(payload.id);
+        if (existing) {
+            if (existing.applied.has(versionId)) {
+                return null;
+            }
+            existing.applied.add(versionId);
+            // A mutation arrived before its create: backfill author/createdAt, and
+            // adopt the create's body only if it is newer than the winning mutation
+            // (i.e. no later edit/delete has superseded it).
+            const createdAt = new Date(timestamp);
+            const adoptBody = isNewer(existing.versionTs, existing.versionId, timestamp, versionId);
+            existing.createSeen = true;
+            existing.message = {
+                ...existing.message,
+                clientId,
+                createdAt,
+                ...(adoptBody
+                    ? {
+                        text: payload.text,
+                        metadata: payload.metadata ?? {},
+                        headers: payload.headers ?? {},
+                        updatedAt: createdAt,
+                        action: 'create',
+                        deleted: false,
+                    }
+                    : {}),
+            };
+            if (adoptBody) {
+                existing.versionTs = timestamp;
+                existing.versionId = versionId;
+            }
+            return { type: 'created', message: existing.message };
+        }
+        const createdAt = new Date(timestamp);
+        const message = {
+            id: payload.id,
+            clientId,
+            roomName: this.roomName,
+            text: payload.text,
+            metadata: payload.metadata ?? {},
+            headers: payload.headers ?? {},
+            createdAt,
+            updatedAt: createdAt,
+            action: 'create',
+            deleted: false,
+        };
+        this.byId.set(payload.id, { message, createSeen: true, versionTs: timestamp, versionId, applied: new Set([versionId]) });
+        return { type: 'created', message };
+    }
+    applyMutation(payload, clientId, timestamp, versionId) {
+        let entry = this.byId.get(payload.id);
+        if (!entry) {
+            // Mutation before create: stand up a placeholder the create can complete.
+            const createdAt = new Date(timestamp);
+            const placeholder = {
+                id: payload.id,
+                clientId,
+                roomName: this.roomName,
+                text: '',
+                metadata: {},
+                headers: {},
+                createdAt,
+                updatedAt: createdAt,
+                action: 'create',
+                deleted: false,
+            };
+            entry = { message: placeholder, createSeen: false, versionTs: -1, versionId: '', applied: new Set() };
+            this.byId.set(payload.id, entry);
+        }
+        if (entry.applied.has(versionId)) {
+            return null;
+        }
+        entry.applied.add(versionId);
+        if (!isNewer(entry.versionTs, entry.versionId, timestamp, versionId)) {
+            return null;
+        }
+        const updatedAt = new Date(timestamp);
+        if (payload.action === 'delete') {
+            entry.message = { ...entry.message, text: '', metadata: {}, headers: {}, updatedAt, action: 'delete', deleted: true };
+            entry.versionTs = timestamp;
+            entry.versionId = versionId;
+            return { type: 'deleted', message: entry.message };
+        }
+        entry.message = {
+            ...entry.message,
+            text: payload.text,
+            metadata: payload.metadata ?? {},
+            headers: payload.headers ?? {},
+            updatedAt,
+            action: 'update',
+            deleted: false,
+        };
+        entry.versionTs = timestamp;
+        entry.versionId = versionId;
+        return { type: 'updated', message: entry.message };
+    }
+}
+exports.MessageReconciler = MessageReconciler;
+/** True when `(ts, id)` is strictly newer than `(priorTs, priorId)`. */
+function isNewer(priorTs, priorId, ts, id) {
+    if (ts !== priorTs) {
+        return ts > priorTs;
+    }
+    return id > priorId;
+}
+//# sourceMappingURL=reconciler.js.map

package/lib-cjs/reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.js","sourceRoot":"","sources":["../src/reconciler.ts"],"names":[],"mappings":"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"}

package/lib-cjs/room.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * A chat room: one realtime channel (`chat:<name>`) carrying messages,
+ * presence, typing, reactions and occupancy. Lifecycle (`attach`/`detach`/
+ * status) delegates to the underlying channel rather than duplicating a state
+ * machine.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Room = void 0;
+const messages_js_1 = require("./messages.js");
+const occupancy_js_1 = require("./occupancy.js");
+const presence_js_1 = require("./presence.js");
+const reactions_js_1 = require("./reactions.js");
+const typing_js_1 = require("./typing.js");
+/** A chat room and its features. Obtain via `chatClient.rooms.get(name)`. */
+class Room {
+    name;
+    channel;
+    /** Messages: send, edit, delete, subscribe, history. */
+    messages;
+    /** Presence: enter/update/leave plus a local member snapshot. */
+    presence;
+    /** Typing indicators. */
+    typing;
+    /** Ephemeral room-level reactions. */
+    reactions;
+    /** Occupancy counts derived from presence. */
+    occupancy;
+    discontinuityListeners = new Set();
+    hadBeenAttached = false;
+    constructor(
+    /** Room name (without the `chat:` channel prefix). */
+    name, channel, getClientId, options) {
+        this.name = name;
+        this.channel = channel;
+        this.messages = new messages_js_1.Messages(channel, name, getClientId);
+        this.presence = new presence_js_1.Presence(channel);
+        this.typing = new typing_js_1.Typing(channel, getClientId, options?.typing?.heartbeatThrottleMs);
+        this.reactions = new reactions_js_1.Reactions(channel, getClientId);
+        this.occupancy = new occupancy_js_1.Occupancy(this.presence, options?.occupancy?.debounceMs);
+        channel.on((change) => this.onChannelState(change));
+    }
+    /** Current room status. */
+    get status() {
+        return this.channel.state;
+    }
+    /** Ensure the room is attached so messages and presence flow. */
+    async attach() {
+        await this.channel.attach();
+    }
+    /** Detach from the room (stop receiving). Listeners are preserved. */
+    async detach() {
+        await this.channel.detach();
+    }
+    /** Subscribe to room status changes. Returns an unsubscribe function. */
+    onStatusChange(listener) {
+        return this.channel.on(listener);
+    }
+    /**
+     * Subscribe to continuity gaps — best-effort: fires when the room re-attaches
+     * without a resume, so the app can backfill via `messages.history()`.
+     */
+    onDiscontinuity(listener) {
+        this.discontinuityListeners.add(listener);
+        return () => {
+            this.discontinuityListeners.delete(listener);
+        };
+    }
+    onChannelState(change) {
+        if (change.current === 'attached') {
+            if (this.hadBeenAttached && !change.resumed) {
+                for (const listener of [...this.discontinuityListeners]) {
+                    listener(change.reason);
+                }
+            }
+            this.hadBeenAttached = true;
+        }
+        else if (change.current === 'detached') {
+            // A deliberate detach/re-attach is not a continuity gap.
+            this.hadBeenAttached = false;
+        }
+    }
+}
+exports.Room = Room;
+//# sourceMappingURL=room.js.map

package/lib-cjs/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,+CAAyC;AACzC,iDAA2C;AAC3C,+CAAyC;AACzC,iDAA2C;AAC3C,2CAAqC;AASrC,6EAA6E;AAC7E,MAAa,IAAI;IAiBJ;IACQ;IAjBnB,wDAAwD;IAC/C,QAAQ,CAAW;IAC5B,iEAAiE;IACxD,QAAQ,CAAW;IAC5B,yBAAyB;IAChB,MAAM,CAAS;IACxB,sCAAsC;IAC7B,SAAS,CAAY;IAC9B,8CAA8C;IACrC,SAAS,CAAY;IAEb,sBAAsB,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnE,eAAe,GAAG,KAAK,CAAC;IAEhC;IACE,sDAAsD;IAC7C,IAAY,EACJ,OAAgB,EACjC,WAAgC,EAChC,OAAqB;QAHZ,SAAI,GAAJ,IAAI,CAAQ;QACJ,YAAO,GAAP,OAAO,CAAS;QAIjC,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACzD,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAQ,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAM,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACrF,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAC9E,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,2BAA2B;IAC3B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED,yEAAyE;IACzE,cAAc,CAAC,QAA8C;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,QAA+B;QAC7C,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,MAA0B;QAC/C,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC5C,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;oBACxD,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACzC,yDAAyD;YACzD,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AA1ED,oBA0EC"}