@lightworkai.official/debug-capture 0.19.11 → 0.19.12

package/dist/live.d.ts

@@ -9,6 +9,18 @@ export interface RingingCall {
     ringUntil: string;
     side?: string | null;
 }
+/**
+ * The support host restarting (a deploy — it says 1012 as it stops): every widget on every page of every host app lost
+ * its socket in the same instant, and each came back after exactly 2 s — the whole fleet's tickets, sign-ins and
+ * sockets on the support host's one thread in the same second. Back somewhere in this window instead, at random.
+ */
+export declare const RESTART_SPREAD_MS = 15000;
+/**
+ * How long before trying again — each step ×0.5–1.5, never the same moment as every other widget's (the desk's own tabs
+ * do the same) — `restart`: the host said it restarts (1012); `slow`:
+ * refused for now (429), or nobody signed in yet; else the next step of the ladder. Pure but for the dice, for the tests.
+ */
+export declare function retryWait(how: "restart" | "slow" | null, attempt: number, roll?: () => number): number;
 /** `wss://support.example/api/presence/ws?t=…` — the support host's scheme, the socket's own path. Pure, for the tests. */
 export declare function liveSocketUrl(host: string, ticket: string): string;
 /** Where the card sends them: their request, with the call — the support host rings it there. Pure, for the tests. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightworkai.official/debug-capture",
-  "version": "0.19.11",
+  "version": "0.19.12",
   "description": "Report-a-problem widget: rolling network/console/action capture, optional rrweb session replay, annotated screenshot, and submission to a Lightwork Support host",
   "type": "module",
   "module": "./dist/index.mjs",

package/src/live.ts

@@ -42,6 +42,22 @@ export interface RingingCall {
 }
 
 const RETRY_MS = [2000, 5000, 15_000, 30_000, 60_000];
+/**
+ * The support host restarting (a deploy — it says 1012 as it stops): every widget on every page of every host app lost
+ * its socket in the same instant, and each came back after exactly 2 s — the whole fleet's tickets, sign-ins and
+ * sockets on the support host's one thread in the same second. Back somewhere in this window instead, at random.
+ */
+export const RESTART_SPREAD_MS = 15_000;
+/**
+ * How long before trying again — each step ×0.5–1.5, never the same moment as every other widget's (the desk's own tabs
+ * do the same) — `restart`: the host said it restarts (1012); `slow`:
+ * refused for now (429), or nobody signed in yet; else the next step of the ladder. Pure but for the dice, for the tests.
+ */
+export function retryWait(how: "restart" | "slow" | null, attempt: number, roll: () => number = Math.random): number {
+  if (how === "restart") return 1000 + Math.round(roll() * RESTART_SPREAD_MS);
+  const step = how === "slow" ? RETRY_MS[RETRY_MS.length - 1]! : RETRY_MS[Math.min(attempt, RETRY_MS.length - 1)]!;
+  return Math.round(step * (0.5 + roll()));
+}
 const LIVE_STATES = new Set(["ringing", "active"]);
 const PING_MS = 20_000;
 
@@ -144,9 +160,9 @@ export function stopLiveRing(): void {
   closeCallFrame();
 }
 
-function schedule(slow = false): void {
+function schedule(how: "restart" | "slow" | null = null): void {
   if (stopped) return;
-  const wait = slow ? RETRY_MS[RETRY_MS.length - 1]! : RETRY_MS[Math.min(retry++, RETRY_MS.length - 1)]!;
+  const wait = retryWait(how, how ? retry : retry++);
   clearTimeout(reconnectTimer);
   reconnectTimer = setTimeout(() => void connect(), wait);
 }
@@ -160,7 +176,7 @@ async function connect(): Promise<void> {
       stopped = true;
       return;
     }
-    return schedule(true);
+    return schedule("slow");
   }
   tokenless = 0;
   let res: Response;
@@ -174,7 +190,8 @@ async function connect(): Promise<void> {
     stopped = true;
     return;
   }
-  if (!res.ok) return schedule(res.status === 429);
+  // Refused for now: slowly. The host restarting (its proxy answering for it): back at random within the window.
+  if (!res.ok) return schedule(res.status === 429 ? "slow" : res.status === 502 || res.status === 503 ? "restart" : null);
   let out: { calls?: boolean; ticket?: string | null; call?: RingingCall | null };
   try {
     out = await res.json();
@@ -221,10 +238,11 @@ async function connect(): Promise<void> {
       /* not ours to read */
     }
   };
-  ws.onclose = () => {
+  ws.onclose = (e) => {
     clearInterval(pinger);
     if (socket === ws) socket = null;
-    schedule();
+    // 1012: the support host is restarting — every widget heard it at once; each comes back at its own moment.
+    schedule(e.code === 1012 ? "restart" : null);
   };
 }