@trigger.dev/sdk 4.4.5 → 4.5.0-rc.0

package/dist/esm/v3/chat-tab-coordinator.js

@@ -0,0 +1,231 @@
+/**
+ * Coordinates multi-tab access to chat sessions via BroadcastChannel.
+ *
+ * When multiple browser tabs open the same chat, only one can be the active
+ * sender. Others enter read-only mode. The coordinator uses a simple
+ * claim/release/heartbeat protocol to track ownership per chatId.
+ *
+ * Gracefully degrades to a no-op when BroadcastChannel is unavailable
+ * (SSR, Node.js, old browsers).
+ *
+ * @internal
+ */
+const CHANNEL_NAME = "trigger-chat-tab-coord";
+const HEARTBEAT_INTERVAL_MS = 5_000;
+const HEARTBEAT_TIMEOUT_MS = 10_000;
+export class ChatTabCoordinator {
+    tabId;
+    channel = null;
+    /** Claims held by OTHER tabs: chatId -> { tabId, lastSeen } */
+    claims = new Map();
+    /** chatIds that THIS tab has claimed */
+    myClaims = new Set();
+    listeners = new Set();
+    messagesListeners = new Set();
+    sessionListeners = new Set();
+    heartbeatTimer = null;
+    beforeUnloadHandler = null;
+    constructor() {
+        this.tabId =
+            typeof crypto !== "undefined" && crypto.randomUUID
+                ? crypto.randomUUID()
+                : `tab-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        if (typeof BroadcastChannel === "undefined") {
+            return; // No-op mode
+        }
+        this.channel = new BroadcastChannel(CHANNEL_NAME);
+        this.channel.onmessage = (event) => {
+            this.handleMessage(event.data);
+        };
+        // Heartbeat: send for our claims + check for stale claims from other tabs
+        this.heartbeatTimer = setInterval(() => {
+            this.sendHeartbeats();
+            this.expireStaleClaimsFromOtherTabs();
+        }, HEARTBEAT_INTERVAL_MS);
+        // Best-effort release on tab close
+        this.beforeUnloadHandler = () => this.releaseAll();
+        if (typeof window !== "undefined") {
+            window.addEventListener("beforeunload", this.beforeUnloadHandler);
+        }
+    }
+    /**
+     * Attempt to claim a chatId for sending.
+     * Returns false if another tab already holds it.
+     */
+    claim(chatId) {
+        if (!this.channel)
+            return true; // No-op mode
+        const existing = this.claims.get(chatId);
+        if (existing && existing.tabId !== this.tabId) {
+            return false; // Another tab holds this chat
+        }
+        this.myClaims.add(chatId);
+        this.broadcast({ type: "claim", chatId, tabId: this.tabId });
+        return true;
+    }
+    /** Release a chatId so other tabs can claim it. */
+    release(chatId) {
+        if (!this.channel)
+            return;
+        if (!this.myClaims.has(chatId))
+            return;
+        this.myClaims.delete(chatId);
+        this.broadcast({ type: "release", chatId, tabId: this.tabId });
+    }
+    /** Check if THIS tab currently holds a claim for the chatId. */
+    hasClaim(chatId) {
+        return this.myClaims.has(chatId);
+    }
+    /** Check if another tab holds this chatId. */
+    isReadOnly(chatId) {
+        if (!this.channel)
+            return false;
+        const claim = this.claims.get(chatId);
+        return claim != null && claim.tabId !== this.tabId;
+    }
+    addListener(fn) {
+        this.listeners.add(fn);
+    }
+    removeListener(fn) {
+        this.listeners.delete(fn);
+    }
+    /** Broadcast the current messages to other tabs (for real-time sync). */
+    broadcastMessages(chatId, messages) {
+        if (!this.channel)
+            return;
+        this.broadcast({ type: "messages", chatId, tabId: this.tabId, messages });
+    }
+    addMessagesListener(fn) {
+        this.messagesListeners.add(fn);
+    }
+    removeMessagesListener(fn) {
+        this.messagesListeners.delete(fn);
+    }
+    /** Broadcast session state (lastEventId) to other tabs. */
+    broadcastSession(chatId, session) {
+        if (!this.channel)
+            return;
+        this.broadcast({ type: "session", chatId, tabId: this.tabId, session });
+    }
+    addSessionListener(fn) {
+        this.sessionListeners.add(fn);
+    }
+    removeSessionListener(fn) {
+        this.sessionListeners.delete(fn);
+    }
+    /** Clean up channel, timers, and event listeners. */
+    dispose() {
+        this.releaseAll();
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.beforeUnloadHandler && typeof window !== "undefined") {
+            window.removeEventListener("beforeunload", this.beforeUnloadHandler);
+            this.beforeUnloadHandler = null;
+        }
+        if (this.channel) {
+            this.channel.close();
+            this.channel = null;
+        }
+        this.listeners.clear();
+        this.messagesListeners.clear();
+        this.sessionListeners.clear();
+    }
+    // --- Private ---
+    handleMessage(msg) {
+        if (msg.tabId === this.tabId)
+            return; // Ignore own messages
+        switch (msg.type) {
+            case "claim": {
+                const wasReadOnly = this.isReadOnly(msg.chatId);
+                this.claims.set(msg.chatId, { tabId: msg.tabId, lastSeen: Date.now() });
+                if (!wasReadOnly) {
+                    this.notify(msg.chatId, true);
+                }
+                break;
+            }
+            case "release": {
+                const claim = this.claims.get(msg.chatId);
+                if (claim && claim.tabId === msg.tabId) {
+                    this.claims.delete(msg.chatId);
+                    this.notify(msg.chatId, false);
+                }
+                break;
+            }
+            case "heartbeat": {
+                const claim = this.claims.get(msg.chatId);
+                if (claim && claim.tabId === msg.tabId) {
+                    claim.lastSeen = Date.now();
+                }
+                break;
+            }
+            case "messages": {
+                this.notifyMessages(msg.chatId, msg.messages);
+                break;
+            }
+            case "session": {
+                this.notifySession(msg.chatId, msg.session);
+                break;
+            }
+        }
+    }
+    sendHeartbeats() {
+        for (const chatId of this.myClaims) {
+            this.broadcast({ type: "heartbeat", chatId, tabId: this.tabId });
+        }
+    }
+    expireStaleClaimsFromOtherTabs() {
+        const now = Date.now();
+        for (const [chatId, claim] of this.claims) {
+            if (claim.tabId !== this.tabId && now - claim.lastSeen > HEARTBEAT_TIMEOUT_MS) {
+                this.claims.delete(chatId);
+                this.notify(chatId, false);
+            }
+        }
+    }
+    releaseAll() {
+        for (const chatId of [...this.myClaims]) {
+            this.release(chatId);
+        }
+    }
+    broadcast(msg) {
+        try {
+            this.channel?.postMessage(msg);
+        }
+        catch {
+            // Channel may be closed
+        }
+    }
+    notify(chatId, isReadOnly) {
+        for (const fn of this.listeners) {
+            try {
+                fn(chatId, isReadOnly);
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+    }
+    notifyMessages(chatId, messages) {
+        for (const fn of this.messagesListeners) {
+            try {
+                fn(chatId, messages);
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+    }
+    notifySession(chatId, session) {
+        for (const fn of this.sessionListeners) {
+            try {
+                fn(chatId, session);
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+    }
+}
+//# sourceMappingURL=chat-tab-coordinator.js.map

package/dist/esm/v3/chat-tab-coordinator.js.map

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

package/dist/esm/v3/chat-tab-coordinator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/v3/chat-tab-coordinator.test.js

@@ -0,0 +1,138 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { ChatTabCoordinator } from "./chat-tab-coordinator.js";
+// Mock BroadcastChannel for testing
+class MockBroadcastChannel {
+    name;
+    static instances = [];
+    onmessage = null;
+    closed = false;
+    constructor(name) {
+        this.name = name;
+        MockBroadcastChannel.instances.push(this);
+    }
+    postMessage(data) {
+        if (this.closed)
+            return;
+        // Deliver to all OTHER instances on the same channel
+        for (const instance of MockBroadcastChannel.instances) {
+            if (instance !== this && instance.name === this.name && !instance.closed) {
+                instance.onmessage?.({ data });
+            }
+        }
+    }
+    close() {
+        this.closed = true;
+        MockBroadcastChannel.instances = MockBroadcastChannel.instances.filter((i) => i !== this);
+    }
+}
+describe("ChatTabCoordinator", () => {
+    beforeEach(() => {
+        MockBroadcastChannel.instances = [];
+        vi.stubGlobal("BroadcastChannel", MockBroadcastChannel);
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+    });
+    it("tab A claims, tab B sees isReadOnly", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        expect(b.isReadOnly("chat-1")).toBe(false);
+        a.claim("chat-1");
+        expect(b.isReadOnly("chat-1")).toBe(true);
+        expect(a.isReadOnly("chat-1")).toBe(false); // Owner is not read-only
+        a.dispose();
+        b.dispose();
+    });
+    it("tab A releases, tab B sees isReadOnly = false", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        a.claim("chat-1");
+        expect(b.isReadOnly("chat-1")).toBe(true);
+        a.release("chat-1");
+        expect(b.isReadOnly("chat-1")).toBe(false);
+        a.dispose();
+        b.dispose();
+    });
+    it("fires listener on claim and release", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        const listener = vi.fn();
+        b.addListener(listener);
+        a.claim("chat-1");
+        expect(listener).toHaveBeenCalledWith("chat-1", true);
+        a.release("chat-1");
+        expect(listener).toHaveBeenCalledWith("chat-1", false);
+        a.dispose();
+        b.dispose();
+    });
+    it("removeListener stops notifications", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        const listener = vi.fn();
+        b.addListener(listener);
+        b.removeListener(listener);
+        a.claim("chat-1");
+        expect(listener).not.toHaveBeenCalled();
+        a.dispose();
+        b.dispose();
+    });
+    it("claim returns false when another tab holds the chatId", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        expect(a.claim("chat-1")).toBe(true);
+        expect(b.claim("chat-1")).toBe(false);
+        a.dispose();
+        b.dispose();
+    });
+    it("supports multiple independent chatIds", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        a.claim("chat-1");
+        b.claim("chat-2");
+        expect(a.isReadOnly("chat-1")).toBe(false);
+        expect(a.isReadOnly("chat-2")).toBe(true);
+        expect(b.isReadOnly("chat-1")).toBe(true);
+        expect(b.isReadOnly("chat-2")).toBe(false);
+        a.dispose();
+        b.dispose();
+    });
+    it("heartbeat timeout clears stale claim from crashed tab", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        const listener = vi.fn();
+        b.addListener(listener);
+        a.claim("chat-1");
+        expect(b.isReadOnly("chat-1")).toBe(true);
+        // Simulate tab A crashing (close its channel, stop heartbeats)
+        a.dispose();
+        // Advance past heartbeat timeout (10s)
+        vi.advanceTimersByTime(11_000);
+        expect(b.isReadOnly("chat-1")).toBe(false);
+        expect(listener).toHaveBeenCalledWith("chat-1", false);
+        b.dispose();
+    });
+    it("dispose releases all claims", () => {
+        const a = new ChatTabCoordinator();
+        const b = new ChatTabCoordinator();
+        a.claim("chat-1");
+        a.claim("chat-2");
+        expect(b.isReadOnly("chat-1")).toBe(true);
+        expect(b.isReadOnly("chat-2")).toBe(true);
+        a.dispose();
+        expect(b.isReadOnly("chat-1")).toBe(false);
+        expect(b.isReadOnly("chat-2")).toBe(false);
+        b.dispose();
+    });
+    it("gracefully degrades when BroadcastChannel is unavailable", () => {
+        vi.stubGlobal("BroadcastChannel", undefined);
+        const coord = new ChatTabCoordinator();
+        // All operations are no-ops
+        expect(coord.claim("chat-1")).toBe(true);
+        expect(coord.isReadOnly("chat-1")).toBe(false);
+        coord.release("chat-1"); // No error
+        coord.dispose(); // No error
+    });
+});
+//# sourceMappingURL=chat-tab-coordinator.test.js.map

package/dist/esm/v3/chat-tab-coordinator.test.js.map

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