@foony/chat 0.0.1

package/lib/occupancy.js

@@ -0,0 +1,65 @@
+/**
+ * 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.
+ */
+/** Default debounce for occupancy change events. */
+const DEFAULT_DEBOUNCE_MS = 1_000;
+/** The occupancy feature of a {@link Room}. */
+export 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);
+    }
+}
+//# sourceMappingURL=occupancy.js.map

package/lib/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,MAAM,OAAO,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"}

package/lib/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../src/presence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAsB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEhE,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D,kFAAkF;AAClF,KAAK,sBAAsB,GAAG,MAAM,IAAI,CAAC;AAEzC,8CAA8C;AAC9C,qBAAa,QAAQ;IAOP,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAqC;IAC7E,OAAO,CAAC,kBAAkB,CAA8B;gBAE3B,OAAO,EAAE,OAAO;IAE7C,mEAAmE;IAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,kDAAkD;IAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,6CAA6C;IACvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,kFAAkF;IAClF,GAAG,IAAI,cAAc,EAAE;IAIvB,oEAAoE;IACpE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASxC,iFAAiF;IACjF,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa;IAQpD,sFAAsF;IACtF,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,aAAa;IAQjE,OAAO,CAAC,yBAAyB;IAOjC,OAAO,CAAC,eAAe;CAqBxB"}

package/lib/presence.js.map

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

package/lib/protocol.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ */
+/** Channel name for a room. The edge grammar forbids `$`, so we namespace with `:`. */
+export declare function roomChannelName(roomName: string): string;
+/** Event name carrying message create/update/delete payloads. */
+export declare const MESSAGE_EVENT = "chat.message";
+/** Event name carrying ephemeral room-level reactions. */
+export declare const REACTION_EVENT = "chat.reaction";
+/** Event name carrying ephemeral typing heartbeats and stops. */
+export declare const TYPING_EVENT = "chat.typing";
+/** Payload schema version, bumped if the on-channel shape ever changes. */
+export declare const PAYLOAD_VERSION = 1;
+/** Payload published under {@link MESSAGE_EVENT}. `id` is the message id in all actions. */
+export type MessagePayload = {
+    readonly v: number;
+    readonly action: 'create';
+    readonly id: string;
+    readonly text: string;
+    readonly metadata?: Record<string, unknown>;
+    readonly headers?: Record<string, unknown>;
+} | {
+    readonly v: number;
+    readonly action: 'update';
+    readonly id: string;
+    readonly text: string;
+    readonly metadata?: Record<string, unknown>;
+    readonly headers?: Record<string, unknown>;
+} | {
+    readonly v: number;
+    readonly action: 'delete';
+    readonly id: string;
+};
+/** Payload published under {@link TYPING_EVENT}. */
+export type TypingPayload = {
+    readonly state: 'started' | 'stopped';
+};
+/** Payload published under {@link REACTION_EVENT}. */
+export type ReactionPayload = {
+    readonly name: string;
+    readonly metadata?: unknown;
+};
+/** Parse an unknown message payload, returning null if it is malformed or a foreign frame. */
+export declare function parseMessagePayload(data: unknown): MessagePayload | null;
+/** Parse an unknown typing payload, returning null if malformed. */
+export declare function parseTypingPayload(data: unknown): TypingPayload | null;
+/** Parse an unknown reaction payload, returning null if malformed. */
+export declare function parseReactionPayload(data: unknown): ReactionPayload | null;
+//# sourceMappingURL=protocol.d.ts.map

package/lib/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,iEAAiE;AACjE,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAC5C,0DAA0D;AAC1D,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAC9C,iEAAiE;AACjE,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAE1C,2EAA2E;AAC3E,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,4FAA4F;AAC5F,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtL;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtL;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtE,sDAAsD;AACtD,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAErF,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CA2BxE;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAMtE;AAED,sEAAsE;AACtE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAU1E"}

package/lib/protocol.js

@@ -0,0 +1,72 @@
+/**
+ * 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.
+ */
+/** Channel name for a room. The edge grammar forbids `$`, so we namespace with `:`. */
+export function roomChannelName(roomName) {
+    return `chat:${roomName}`;
+}
+/** Event name carrying message create/update/delete payloads. */
+export const MESSAGE_EVENT = 'chat.message';
+/** Event name carrying ephemeral room-level reactions. */
+export const REACTION_EVENT = 'chat.reaction';
+/** Event name carrying ephemeral typing heartbeats and stops. */
+export const TYPING_EVENT = 'chat.typing';
+/** Payload schema version, bumped if the on-channel shape ever changes. */
+export const PAYLOAD_VERSION = 1;
+/** Parse an unknown message payload, returning null if it is malformed or a foreign frame. */
+export 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: 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: PAYLOAD_VERSION,
+            action,
+            id,
+            text,
+            ...(metadata === undefined ? {} : { metadata }),
+            ...(headers === undefined ? {} : { headers }),
+        };
+    }
+    return null;
+}
+/** Parse an unknown typing payload, returning null if malformed. */
+export 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. */
+export 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/protocol.js.map

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

package/lib/reactions.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+import type { Channel, UnsubscribeFn } from '@foony/realtime';
+import type { RoomReaction } from './types.js';
+/** Listener invoked for every room reaction. */
+export type ReactionListener = (reaction: RoomReaction) => void;
+/** The room-reaction feature of a {@link Room}. */
+export declare class Reactions {
+    private readonly channel;
+    private readonly getClientId;
+    private readonly listeners;
+    private channelUnsubscribe;
+    constructor(channel: Channel, getClientId: () => string | null);
+    /** Broadcast a room reaction. */
+    send(params: {
+        name: string;
+        metadata?: unknown;
+    }): Promise<void>;
+    /** Subscribe to room reactions. Attaches the channel on first listener. */
+    subscribe(listener: ReactionListener): UnsubscribeFn;
+    private ensureChannelSubscription;
+}
+//# sourceMappingURL=reactions.d.ts.map

package/lib/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../src/reactions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;AAEhE,mDAAmD;AACnD,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAL9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,kBAAkB,CAA8B;gBAGrC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI;IAGnD,iCAAiC;IAC3B,IAAI,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvE,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa;IAQpD,OAAO,CAAC,yBAAyB;CAsBlC"}

package/lib/reactions.js

@@ -0,0 +1,56 @@
+/**
+ * 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.
+ */
+import { parseReactionPayload, REACTION_EVENT } from './protocol.js';
+/** The room-reaction feature of a {@link Room}. */
+export 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(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(REACTION_EVENT, (frame) => {
+            const payload = 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);
+            }
+        });
+    }
+}
+//# sourceMappingURL=reactions.js.map

package/lib/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../src/reactions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAwB,MAAM,eAAe,CAAC;AAM3F,mDAAmD;AACnD,MAAM,OAAO,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,cAAc,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,cAAc,EAAE,CAAC,KAAK,EAAE,EAAE;YACzE,MAAM,OAAO,GAAG,oBAAoB,CAAC,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"}

package/lib/reconciler.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ */
+import type { MessageFrame } from '@foony/realtime';
+import type { ChatMessageEvent, Message } from './types.js';
+/** Stateful reconciler for a single room's messages. */
+export declare class MessageReconciler {
+    private readonly roomName;
+    private readonly byId;
+    constructor(roomName: string);
+    /**
+     * 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: MessageFrame): ChatMessageEvent | null;
+    /** The current materialized state of one message, if known. */
+    get(id: string): Message | undefined;
+    /** Current materialized messages, oldest-first by creation then id. */
+    snapshot(): Message[];
+    private applyCreate;
+    private applyMutation;
+}
+//# sourceMappingURL=reconciler.d.ts.map

package/lib/reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.d.ts","sourceRoot":"","sources":["../src/reconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAe5D,wDAAwD;AACxD,qBAAa,iBAAiB;IAGhB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;gBAEpB,QAAQ,EAAE,MAAM;IAE7C;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI;IAanD,+DAA+D;IAC/D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIpC,uEAAuE;IACvE,QAAQ,IAAI,OAAO,EAAE;IAMrB,OAAO,CAAC,WAAW;IAmDnB,OAAO,CAAC,aAAa;CA+CtB"}

package/lib/reconciler.js

@@ -0,0 +1,149 @@
+/**
+ * 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.
+ */
+import { parseMessagePayload } from './protocol.js';
+/** Stateful reconciler for a single room's messages. */
+export 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 = 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 };
+    }
+}
+/** 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/reconciler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciler.js","sourceRoot":"","sources":["../src/reconciler.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,mBAAmB,EAAuB,MAAM,eAAe,CAAC;AAgBzE,wDAAwD;AACxD,MAAM,OAAO,iBAAiB;IAGC;IAFZ,IAAI,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEjD,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD;;;OAGG;IACH,KAAK,CAAC,KAAmB;QACvB,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACjF,CAAC;IAED,+DAA+D;IAC/D,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IACpC,CAAC;IAED,uEAAuE;IACvE,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;aAC3B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;aAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3I,CAAC;IAEO,WAAW,CAAC,OAAsD,EAAE,QAAgB,EAAE,SAAiB,EAAE,SAAiB;QAChI,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAChC,uEAAuE;YACvE,wEAAwE;YACxE,iDAAiD;YACjD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACxF,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;YAC3B,QAAQ,CAAC,OAAO,GAAG;gBACjB,GAAG,QAAQ,CAAC,OAAO;gBACnB,QAAQ;gBACR,SAAS;gBACT,GAAG,CAAC,SAAS;oBACX,CAAC,CAAC;wBACE,IAAI,EAAE,OAAO,CAAC,IAAI;wBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;wBAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;wBAC9B,SAAS,EAAE,SAAS;wBACpB,MAAM,EAAE,QAAQ;wBAChB,OAAO,EAAE,KAAK;qBACf;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;YACF,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC/B,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxD,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,QAAQ;YACR,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS;YACT,SAAS,EAAE,SAAS;YACpB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,KAAK;SACf,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QACzH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IAEO,aAAa,CAAC,OAAiE,EAAE,QAAgB,EAAE,SAAiB,EAAE,SAAiB;QAC7I,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,0EAA0E;YAC1E,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;YACtC,MAAM,WAAW,GAAY;gBAC3B,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,QAAQ;gBACR,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,EAAE;gBACR,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,EAAE;gBACX,SAAS;gBACT,SAAS,EAAE,SAAS;gBACpB,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,KAAK;aACf,CAAC;YACF,KAAK,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;YACtG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,OAAO,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACtH,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC5B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,OAAO,GAAG;YACd,GAAG,KAAK,CAAC,OAAO;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;YAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS;YACT,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,KAAK;SACf,CAAC;QACF,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC5B,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC;CACF;AAED,wEAAwE;AACxE,SAAS,OAAO,CAAC,OAAe,EAAE,OAAe,EAAE,EAAU,EAAE,EAAU;IACvE,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,GAAG,OAAO,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,CAAC;AACtB,CAAC"}

package/lib/room.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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.
+ */
+import type { Channel, ChannelStateChange, UnsubscribeFn } from '@foony/realtime';
+import { Messages } from './messages.js';
+import { Occupancy } from './occupancy.js';
+import { Presence } from './presence.js';
+import { Reactions } from './reactions.js';
+import { Typing } from './typing.js';
+import type { RoomOptions } from './types.js';
+/** Room lifecycle status — the underlying channel's state. */
+export type RoomStatus = Channel['state'];
+/** Listener invoked when a continuity gap is detected on (re)attach. */
+export type DiscontinuityListener = (reason?: Error) => void;
+/** A chat room and its features. Obtain via `chatClient.rooms.get(name)`. */
+export declare class Room {
+    /** Room name (without the `chat:` channel prefix). */
+    readonly name: string;
+    private readonly channel;
+    /** Messages: send, edit, delete, subscribe, history. */
+    readonly messages: Messages;
+    /** Presence: enter/update/leave plus a local member snapshot. */
+    readonly presence: Presence;
+    /** Typing indicators. */
+    readonly typing: Typing;
+    /** Ephemeral room-level reactions. */
+    readonly reactions: Reactions;
+    /** Occupancy counts derived from presence. */
+    readonly occupancy: Occupancy;
+    private readonly discontinuityListeners;
+    private hadBeenAttached;
+    constructor(
+    /** Room name (without the `chat:` channel prefix). */
+    name: string, channel: Channel, getClientId: () => string | null, options?: RoomOptions);
+    /** Current room status. */
+    get status(): RoomStatus;
+    /** Ensure the room is attached so messages and presence flow. */
+    attach(): Promise<void>;
+    /** Detach from the room (stop receiving). Listeners are preserved. */
+    detach(): Promise<void>;
+    /** Subscribe to room status changes. Returns an unsubscribe function. */
+    onStatusChange(listener: (change: ChannelStateChange) => void): UnsubscribeFn;
+    /**
+     * 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: DiscontinuityListener): UnsubscribeFn;
+    private onChannelState;
+}
+//# sourceMappingURL=room.d.ts.map

package/lib/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE1C,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;AAE7D,6EAA6E;AAC7E,qBAAa,IAAI;IAgBb,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAjB1B,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoC;IAC3E,OAAO,CAAC,eAAe,CAAS;;IAG9B,sDAAsD;IAC7C,IAAI,EAAE,MAAM,EACJ,OAAO,EAAE,OAAO,EACjC,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,EAChC,OAAO,CAAC,EAAE,WAAW;IAUvB,2BAA2B;IAC3B,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,iEAAiE;IAC3D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,sEAAsE;IAChE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,yEAAyE;IACzE,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,GAAG,aAAa;IAI7E;;;OAGG;IACH,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,aAAa;IAO/D,OAAO,CAAC,cAAc;CAavB"}