@profullstack/group-call 0.2.0 → 0.3.0

package/README.md

@@ -52,6 +52,9 @@ await line.handle(JSON.parse(rawBody).data);
   Telnyx bills this per minute per leg, so it's off unless you ask for it.
 - **Survives restarts.** Conference names carry a keyed hash of the room code. After a restart,
   the first caller into a room joins its running conference, not a new one.
+- **Deploy-proof rooms.** Save `participants(code)` plus each room's conference id from `onJoin`/`onLeave`,
+  and pass them to `restore()` at boot. Each conference is checked against Telnyx, and the legs still in
+  it come back with their names, so a restart neither splits a room nor forgets who is in it.
 - `telnyxSms`, `verifyTelnyx`, `newRoomCode`, `sameSecret` helpers.
 
 MIT

package/dist/index.d.ts

@@ -198,6 +198,21 @@ export declare class GroupCall {
         callers: number;
         startedAt: number;
     }[];
+    /**
+     * Put back rooms a previous process knew about: a deploy or a crash must not
+     * split a room. Each saved conference is checked against Telnyx, and only the
+     * legs still in it come back, with their names. A leg Telnyx has that the save
+     * missed comes back unnamed. Returns how many rooms and legs were restored.
+     */
+    restore(saved: {
+        code: string;
+        conferenceId: string;
+        startedAt: number;
+        participants: Participant[];
+    }[]): Promise<{
+        rooms: number;
+        legs: number;
+    }>;
     /** Who is on the line in a room, earliest first. */
     participants(code: string): Participant[];
     /**

package/dist/index.js

@@ -199,6 +199,42 @@ export class GroupCall {
             .map(({ code, callers, startedAt }) => ({ code, callers, startedAt }))
             .sort((a, b) => b.callers - a.callers || a.startedAt - b.startedAt);
     }
+    /**
+     * Put back rooms a previous process knew about: a deploy or a crash must not
+     * split a room. Each saved conference is checked against Telnyx, and only the
+     * legs still in it come back, with their names. A leg Telnyx has that the save
+     * missed comes back unnamed. Returns how many rooms and legs were restored.
+     */
+    async restore(saved) {
+        let rooms = 0;
+        let legs = 0;
+        for (const r of saved) {
+            const conf = (await this.get(`/conferences/${encodeURIComponent(r.conferenceId)}`));
+            if (!conf?.data || (conf.data.status && conf.data.status !== "in_progress"))
+                continue;
+            const list = (await this.get(`/conferences/${encodeURIComponent(r.conferenceId)}/participants?page[size]=100`));
+            const present = new Set((list?.data ?? []).filter((p) => p.status !== "left" && typeof p.call_control_id === "string").map((p) => p.call_control_id));
+            if (present.size === 0)
+                continue;
+            const room = this.room(r.code);
+            room.conferenceId = r.conferenceId;
+            room.startedAt = r.startedAt;
+            const known = new Map(r.participants.map((p) => [p.leg, p]));
+            for (const leg of present) {
+                const who = known.get(leg) ?? { leg, from: "", name: "", joinedAt: r.startedAt };
+                room.legs.set(leg, who);
+                this.legRoom.set(leg, r.code);
+                if (who.from)
+                    this.legFrom.set(leg, who.from);
+                legs += 1;
+            }
+            room.callers = room.legs.size;
+            rooms += 1;
+        }
+        if (rooms)
+            this.options.onEvent?.(`  restored ${rooms} room(s) with ${legs} on the line.`);
+        return { rooms, legs };
+    }
     /** Who is on the line in a room, earliest first. */
     participants(code) {
         const room = this.rooms.get(code);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/group-call",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A group call on a phone number: dial in, key a room code, talk with everyone else who did, people and AI agents alike. Telnyx Call Control state machine extracted from nixamp's party line; the engine behind nixamp live joins and group.call.pit.world.",
   "license": "MIT",
   "type": "module",