feat(chatwoot,#79): bridge opened/closed/startConversation/postback events

Chatwoot's SDK fires four CustomEvents we weren't forwarding to consumers:
chatwoot:opened, chatwoot:closed, chatwoot:on-start-conversation, and
chatwoot:postback. Plumb them through the existing bindDomEvent/on()
typed emitter alongside the message/unreadCountChange/error events.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: productdevbook

src/providers/chatwoot.ts

@@ -46,7 +46,15 @@ const queue = createQueue<ChatwootAPI>()
 const store = createIdentityStore()
 const lifecycle = createLifecycle()
 const unreadListeners = new Set<(count: number) => void>()
-type ChatwootEventName = "ready" | "message" | "unreadCountChange" | "error"
+type ChatwootEventName =
+  | "ready"
+  | "message"
+  | "unreadCountChange"
+  | "error"
+  | "opened"
+  | "closed"
+  | "startConversation"
+  | "postback"
 const eventListeners = new Map<ChatwootEventName, Set<(payload: unknown) => void>>()
 let currentToken: string | undefined
 let currentBaseUrl: string | undefined
@@ -121,6 +129,10 @@ export async function load(options: ChatwootLoadOptions): Promise<void> {
   bindDomEvent("chatwoot:on-message", "message")
   bindDomEvent("chatwoot:on-unread-message-count-changed", "unreadCountChange")
   bindDomEvent("chatwoot:error", "error")
+  bindDomEvent("chatwoot:opened", "opened")
+  bindDomEvent("chatwoot:closed", "closed")
+  bindDomEvent("chatwoot:on-start-conversation", "startConversation")
+  bindDomEvent("chatwoot:postback", "postback")
 
   try {
     await injectScript({

test/chatwoot.browser.test.ts

@@ -115,4 +115,37 @@ describe("chatwoot (browser) — vendor-doc audit fixes (#79)", () => {
     expect(rec.popoutChatWindow).toBe(1)
     await chatwoot.destroy()
   })
+
+  it("bridges chatwoot:opened / closed / on-start-conversation / postback", async () => {
+    const rec: Recorded = {
+      setColorScheme: [],
+      deleteCustomAttribute: [],
+      deleteConversationCustomAttribute: [],
+      popoutChatWindow: 0,
+    }
+    const chatwoot = await bootChatwoot(rec)
+
+    const opened: unknown[] = []
+    const closed: unknown[] = []
+    const started: unknown[] = []
+    const postbacks: unknown[] = []
+    chatwoot.on("opened", (p) => opened.push(p))
+    chatwoot.on("closed", (p) => closed.push(p))
+    chatwoot.on("startConversation", (p) => started.push(p))
+    chatwoot.on("postback", (p) => postbacks.push(p))
+
+    window.dispatchEvent(new CustomEvent("chatwoot:opened"))
+    window.dispatchEvent(new CustomEvent("chatwoot:closed"))
+    window.dispatchEvent(
+      new CustomEvent("chatwoot:on-start-conversation", { detail: { source: "bubble" } }),
+    )
+    window.dispatchEvent(new CustomEvent("chatwoot:postback", { detail: { value: "yes" } }))
+
+    expect(opened).toHaveLength(1)
+    expect(closed).toHaveLength(1)
+    expect(started).toEqual([{ source: "bubble" }])
+    expect(postbacks).toEqual([{ value: "yes" }])
+
+    await chatwoot.destroy()
+  })
 })