@mushi-mushi/web 0.7.0 → 0.9.0

package/dist/test-utils.cjs

@@ -11,10 +11,27 @@ async function triggerBug(opts = {}) {
 function openReport(category) {
   return;
 }
+function openMushiWidget(category) {
+}
+async function expectMushiReady(options = {}) {
+  const timeoutMs = options.timeoutMs ?? 5e3;
+  const started = Date.now();
+  let lastDiagnostics = null;
+  while (Date.now() - started < timeoutMs) {
+    await new Promise((r) => setTimeout(r, 100));
+  }
+  throw new Error(`[mushi:test-utils] SDK not ready: ${JSON.stringify(lastDiagnostics)}`);
+}
+async function expectNoMushiSelfCascade(options = {}) {
+  return;
+}
 async function waitForQueueDrain(options = {}) {
   return 0;
 }
 
+exports.expectMushiReady = expectMushiReady;
+exports.expectNoMushiSelfCascade = expectNoMushiSelfCascade;
+exports.openMushiWidget = openMushiWidget;
 exports.openReport = openReport;
 exports.triggerBug = triggerBug;
 exports.waitForQueueDrain = waitForQueueDrain;

package/dist/test-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/test-utils.ts"],"names":[],"mappings":";;;;;;;AAsDA,eAAsB,UAAA,CAAW,IAAA,GAA0B,EAAC,EAA2B;AAErF,EAAU,OAAO,IAAA;AAqBnB;AAOO,SAAS,WAAW,QAAA,EAAsC;AAE/D,EAAU;AAEZ;AAOA,eAAsB,iBAAA,CAAkB,OAAA,GAAkC,EAAC,EAAoB;AAE7F,EAAU,OAAO,CAAA;AAenB","file":"test-utils.cjs","sourcesContent":["/**\n * @mushi-mushi/web/test-utils\n *\n * Playwright / jsdom helpers for deterministic SDK tests. This module is\n * published as a separate entry-point so production bundles never pay the\n * cost — import it via `import { triggerBug, openReport } from\n * '@mushi-mushi/web/test-utils'`.\n *\n * Design goals:\n *   1. Zero production footprint. Nothing here is imported from `./mushi`,\n *      `./widget`, or any runtime module. We reach for the live SDK via\n *      `Mushi.getInstance()` so the test process sees exactly what the app\n *      bootstrapped — no duplicate SDK singletons, no double-init races.\n *   2. Safe in a test harness even when Mushi is disabled. Every helper\n *      no-ops when `Mushi.getInstance()` returns `null`, so Playwright\n *      specs that conditionally wire Mushi (e.g. cloud vs local targets)\n *      don't have to branch.\n *   3. Flat surface. Tests want 3 verbs: \"open the widget\", \"submit a\n *      report programmatically\", \"wait until the SDK confirms the POST\n *      landed\". Anything beyond that belongs in the app under test.\n */\n\nimport { Mushi } from './mushi';\nimport type {\n  MushiReportCategory,\n  MushiSDKInstance,\n} from '@mushi-mushi/core';\n\n/** Options accepted by `triggerBug`. Mirrors the core report contract but\n *  keeps every field optional so a Playwright test can say\n *  `triggerBug({ description: 'button dead' })` without a category. */\nexport interface TriggerBugOptions {\n  /** Short free-text description of the issue. Defaults to a marker\n   *  string so tests that forget to pass a description still produce a\n   *  distinguishable report in the admin console. */\n  description?: string;\n  /** Severity-free category tag. */\n  category?: MushiReportCategory;\n  /** Arbitrary metadata the test wants to round-trip. Merged on top of\n   *  whatever `setMetadata` has already stored. */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Submit a report bypassing the widget UI. Returns the server-assigned\n * `reportId` when the POST lands, or `null` if Mushi isn't initialised in\n * this test context (or the submit failed — the SDK swallows network\n * errors silently by design).\n *\n * Use this from Playwright `page.evaluate(...)` calls to round-trip a\n * report into the backend without needing to drive the widget's DOM. It's\n * the fastest way to assert \"a bug report made it from the browser into\n * reports/ in Supabase\".\n */\nexport async function triggerBug(opts: TriggerBugOptions = {}): Promise<string | null> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return null;\n\n  const description = opts.description\n    ?? `[test-utils] triggerBug marker ${new Date().toISOString()}`;\n\n  if (opts.metadata) {\n    for (const [k, v] of Object.entries(opts.metadata)) {\n      try { sdk.setMetadata(k, v); } catch { /* ignore */ }\n    }\n  }\n\n  // `captureEvent` is the documented programmatic-submit API since 0.3.0\n  // — it bypasses the widget, resolves with the server-assigned report\n  // id, and participates in the same offline queue / pre-filter pipeline\n  // as a widget submission.\n  return await sdk.captureEvent({\n    description,\n    source: 'test-utils',\n    ...(opts.category ? { category: opts.category } : {}),\n    ...(opts.metadata ? { metadata: opts.metadata } : {}),\n  });\n}\n\n/**\n * Programmatically open the Mushi widget without submitting anything. Use\n * for interaction tests that want to assert \"the widget is mounted and\n * reachable\" or to drive a user-like flow via Playwright selectors.\n */\nexport function openReport(category?: MushiReportCategory): void {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return;\n  sdk.report(category ? { category } : undefined);\n}\n\n/**\n * Wait until the offline queue drains — useful after `triggerBug` in tests\n * that submit while offline then assert the report eventually syncs.\n * Resolves with the number of queued items remaining (0 = fully drained).\n */\nexport async function waitForQueueDrain(options: { timeoutMs?: number } = {}): Promise<number> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return 0;\n  const timeoutMs = options.timeoutMs ?? 5_000;\n  const started = Date.now();\n  // The SDK instance doesn't publicly expose the queue, but `getQueueSize`\n  // has been in the contract since 0.2.x. We tolerate its absence so\n  // upgrading doesn't break tests that only need triggerBug/openReport.\n  const getQueueSize = (sdk as MushiSDKInstance & { getQueueSize?: () => number }).getQueueSize;\n  if (typeof getQueueSize !== 'function') return 0;\n\n  while (Date.now() - started < timeoutMs) {\n    const remaining = getQueueSize.call(sdk);\n    if (remaining === 0) return 0;\n    await new Promise((r) => setTimeout(r, 100));\n  }\n  return getQueueSize.call(sdk);\n}\n"]}
+{"version":3,"sources":["../src/test-utils.ts"],"names":[],"mappings":";;;;;;;AAuDA,eAAsB,UAAA,CAAW,IAAA,GAA0B,EAAC,EAA2B;AAErF,EAAU,OAAO,IAAA;AAqBnB;AAOO,SAAS,WAAW,QAAA,EAAsC;AAE/D,EAAU;AAEZ;AAGO,SAAS,gBAAgB,QAAA,EAAsC;AAEtE;AAOA,eAAsB,gBAAA,CAAiB,OAAA,GAAkC,EAAC,EAAoC;AAC5G,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACvC,EAAA,MAAM,OAAA,GAAU,KAAK,GAAA,EAAI;AACzB,EAAA,IAAI,eAAA,GAAiD,IAAA;AAErD,EAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,OAAA,GAAU,SAAA,EAAW;AAQvC,IAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,MAAM,UAAA,CAAW,CAAA,EAAG,GAAG,CAAC,CAAA;AAAA,EAC7C;AAEA,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,KAAK,SAAA,CAAU,eAAe,CAAC,CAAA,CAAE,CAAA;AACxF;AAOA,eAAsB,wBAAA,CAAyB,OAAA,GAG3C,EAAC,EAAkB;AAErB,EAAU;AAgBZ;AAOA,eAAsB,iBAAA,CAAkB,OAAA,GAAkC,EAAC,EAAoB;AAE7F,EAAU,OAAO,CAAA;AAenB","file":"test-utils.cjs","sourcesContent":["/**\n * @mushi-mushi/web/test-utils\n *\n * Playwright / jsdom helpers for deterministic SDK tests. This module is\n * published as a separate entry-point so production bundles never pay the\n * cost — import it via `import { triggerBug, openReport } from\n * '@mushi-mushi/web/test-utils'`.\n *\n * Design goals:\n *   1. Zero production footprint. Nothing here is imported from `./mushi`,\n *      `./widget`, or any runtime module. We reach for the live SDK via\n *      `Mushi.getInstance()` so the test process sees exactly what the app\n *      bootstrapped — no duplicate SDK singletons, no double-init races.\n *   2. Safe in a test harness even when Mushi is disabled. Every helper\n *      no-ops when `Mushi.getInstance()` returns `null`, so Playwright\n *      specs that conditionally wire Mushi (e.g. cloud vs local targets)\n *      don't have to branch.\n *   3. Flat surface. Tests want 3 verbs: \"open the widget\", \"submit a\n *      report programmatically\", \"wait until the SDK confirms the POST\n *      landed\". Anything beyond that belongs in the app under test.\n */\n\nimport { Mushi } from './mushi';\nimport type {\n  MushiDiagnosticsResult,\n  MushiReportCategory,\n  MushiSDKInstance,\n} from '@mushi-mushi/core';\n\n/** Options accepted by `triggerBug`. Mirrors the core report contract but\n *  keeps every field optional so a Playwright test can say\n *  `triggerBug({ description: 'button dead' })` without a category. */\nexport interface TriggerBugOptions {\n  /** Short free-text description of the issue. Defaults to a marker\n   *  string so tests that forget to pass a description still produce a\n   *  distinguishable report in the admin console. */\n  description?: string;\n  /** Severity-free category tag. */\n  category?: MushiReportCategory;\n  /** Arbitrary metadata the test wants to round-trip. Merged on top of\n   *  whatever `setMetadata` has already stored. */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Submit a report bypassing the widget UI. Returns the server-assigned\n * `reportId` when the POST lands, or `null` if Mushi isn't initialised in\n * this test context (or the submit failed — the SDK swallows network\n * errors silently by design).\n *\n * Use this from Playwright `page.evaluate(...)` calls to round-trip a\n * report into the backend without needing to drive the widget's DOM. It's\n * the fastest way to assert \"a bug report made it from the browser into\n * reports/ in Supabase\".\n */\nexport async function triggerBug(opts: TriggerBugOptions = {}): Promise<string | null> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return null;\n\n  const description = opts.description\n    ?? `[test-utils] triggerBug marker ${new Date().toISOString()}`;\n\n  if (opts.metadata) {\n    for (const [k, v] of Object.entries(opts.metadata)) {\n      try { sdk.setMetadata(k, v); } catch { /* ignore */ }\n    }\n  }\n\n  // `captureEvent` is the documented programmatic-submit API since 0.3.0\n  // — it bypasses the widget, resolves with the server-assigned report\n  // id, and participates in the same offline queue / pre-filter pipeline\n  // as a widget submission.\n  return await sdk.captureEvent({\n    description,\n    source: 'test-utils',\n    ...(opts.category ? { category: opts.category } : {}),\n    ...(opts.metadata ? { metadata: opts.metadata } : {}),\n  });\n}\n\n/**\n * Programmatically open the Mushi widget without submitting anything. Use\n * for interaction tests that want to assert \"the widget is mounted and\n * reachable\" or to drive a user-like flow via Playwright selectors.\n */\nexport function openReport(category?: MushiReportCategory): void {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return;\n  sdk.report(category ? { category } : undefined);\n}\n\n/** Alias with language that reads better in Playwright smoke tests. */\nexport function openMushiWidget(category?: MushiReportCategory): void {\n  openReport(category);\n}\n\n/**\n * Wait until the live SDK instance exists and reports a mounted widget.\n * Throws with the diagnostics payload so CI failures point at CSP / Shadow DOM\n * / capture setup instead of a generic timeout.\n */\nexport async function expectMushiReady(options: { timeoutMs?: number } = {}): Promise<MushiDiagnosticsResult> {\n  const timeoutMs = options.timeoutMs ?? 5_000;\n  const started = Date.now();\n  let lastDiagnostics: MushiDiagnosticsResult | null = null;\n\n  while (Date.now() - started < timeoutMs) {\n    const sdk = Mushi.getInstance();\n    if (sdk) {\n      lastDiagnostics = await sdk.diagnose();\n      if (lastDiagnostics.widgetMounted && lastDiagnostics.shadowDomAvailable) {\n        return lastDiagnostics;\n      }\n    }\n    await new Promise((r) => setTimeout(r, 100));\n  }\n\n  throw new Error(`[mushi:test-utils] SDK not ready: ${JSON.stringify(lastDiagnostics)}`);\n}\n\n/**\n * Run an optional action and fail if the SDK fires an api_cascade proactive\n * prompt during the observation window. This catches the exact glot.it class\n * of bug where Mushi reports on its own runtime-config/report endpoints.\n */\nexport async function expectNoMushiSelfCascade(options: {\n  timeoutMs?: number;\n  action?: () => void | Promise<void>;\n} = {}): Promise<void> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return;\n  const timeoutMs = options.timeoutMs ?? 1_000;\n  let cascade: unknown = null;\n  const unsubscribe = sdk.on('proactive:triggered', (event) => {\n    const payload = event.data as { type?: string } | undefined;\n    if (payload?.type === 'api_cascade') cascade = event.data ?? true;\n  });\n  try {\n    await options.action?.();\n    await new Promise((r) => setTimeout(r, timeoutMs));\n  } finally {\n    unsubscribe();\n  }\n  if (cascade) {\n    throw new Error(`[mushi:test-utils] unexpected api_cascade from SDK self-noise: ${JSON.stringify(cascade)}`);\n  }\n}\n\n/**\n * Wait until the offline queue drains — useful after `triggerBug` in tests\n * that submit while offline then assert the report eventually syncs.\n * Resolves with the number of queued items remaining (0 = fully drained).\n */\nexport async function waitForQueueDrain(options: { timeoutMs?: number } = {}): Promise<number> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return 0;\n  const timeoutMs = options.timeoutMs ?? 5_000;\n  const started = Date.now();\n  // The SDK instance doesn't publicly expose the queue, but `getQueueSize`\n  // has been in the contract since 0.2.x. We tolerate its absence so\n  // upgrading doesn't break tests that only need triggerBug/openReport.\n  const getQueueSize = (sdk as MushiSDKInstance & { getQueueSize?: () => number }).getQueueSize;\n  if (typeof getQueueSize !== 'function') return 0;\n\n  while (Date.now() - started < timeoutMs) {\n    const remaining = getQueueSize.call(sdk);\n    if (remaining === 0) return 0;\n    await new Promise((r) => setTimeout(r, 100));\n  }\n  return getQueueSize.call(sdk);\n}\n"]}

package/dist/test-utils.d.cts

@@ -1,4 +1,4 @@
-import { MushiReportCategory } from '@mushi-mushi/core';
+import { MushiReportCategory, MushiDiagnosticsResult } from '@mushi-mushi/core';
 
 /**
  * @mushi-mushi/web/test-utils
@@ -54,6 +54,25 @@ declare function triggerBug(opts?: TriggerBugOptions): Promise<string | null>;
  * reachable" or to drive a user-like flow via Playwright selectors.
  */
 declare function openReport(category?: MushiReportCategory): void;
+/** Alias with language that reads better in Playwright smoke tests. */
+declare function openMushiWidget(category?: MushiReportCategory): void;
+/**
+ * Wait until the live SDK instance exists and reports a mounted widget.
+ * Throws with the diagnostics payload so CI failures point at CSP / Shadow DOM
+ * / capture setup instead of a generic timeout.
+ */
+declare function expectMushiReady(options?: {
+    timeoutMs?: number;
+}): Promise<MushiDiagnosticsResult>;
+/**
+ * Run an optional action and fail if the SDK fires an api_cascade proactive
+ * prompt during the observation window. This catches the exact glot.it class
+ * of bug where Mushi reports on its own runtime-config/report endpoints.
+ */
+declare function expectNoMushiSelfCascade(options?: {
+    timeoutMs?: number;
+    action?: () => void | Promise<void>;
+}): Promise<void>;
 /**
  * Wait until the offline queue drains — useful after `triggerBug` in tests
  * that submit while offline then assert the report eventually syncs.
@@ -63,4 +82,4 @@ declare function waitForQueueDrain(options?: {
     timeoutMs?: number;
 }): Promise<number>;
 
-export { type TriggerBugOptions, openReport, triggerBug, waitForQueueDrain };
+export { type TriggerBugOptions, expectMushiReady, expectNoMushiSelfCascade, openMushiWidget, openReport, triggerBug, waitForQueueDrain };

package/dist/test-utils.d.ts

@@ -1,4 +1,4 @@
-import { MushiReportCategory } from '@mushi-mushi/core';
+import { MushiReportCategory, MushiDiagnosticsResult } from '@mushi-mushi/core';
 
 /**
  * @mushi-mushi/web/test-utils
@@ -54,6 +54,25 @@ declare function triggerBug(opts?: TriggerBugOptions): Promise<string | null>;
  * reachable" or to drive a user-like flow via Playwright selectors.
  */
 declare function openReport(category?: MushiReportCategory): void;
+/** Alias with language that reads better in Playwright smoke tests. */
+declare function openMushiWidget(category?: MushiReportCategory): void;
+/**
+ * Wait until the live SDK instance exists and reports a mounted widget.
+ * Throws with the diagnostics payload so CI failures point at CSP / Shadow DOM
+ * / capture setup instead of a generic timeout.
+ */
+declare function expectMushiReady(options?: {
+    timeoutMs?: number;
+}): Promise<MushiDiagnosticsResult>;
+/**
+ * Run an optional action and fail if the SDK fires an api_cascade proactive
+ * prompt during the observation window. This catches the exact glot.it class
+ * of bug where Mushi reports on its own runtime-config/report endpoints.
+ */
+declare function expectNoMushiSelfCascade(options?: {
+    timeoutMs?: number;
+    action?: () => void | Promise<void>;
+}): Promise<void>;
 /**
  * Wait until the offline queue drains — useful after `triggerBug` in tests
  * that submit while offline then assert the report eventually syncs.
@@ -63,4 +82,4 @@ declare function waitForQueueDrain(options?: {
     timeoutMs?: number;
 }): Promise<number>;
 
-export { type TriggerBugOptions, openReport, triggerBug, waitForQueueDrain };
+export { type TriggerBugOptions, expectMushiReady, expectNoMushiSelfCascade, openMushiWidget, openReport, triggerBug, waitForQueueDrain };

package/dist/test-utils.js

@@ -9,10 +9,24 @@ async function triggerBug(opts = {}) {
 function openReport(category) {
   return;
 }
+function openMushiWidget(category) {
+}
+async function expectMushiReady(options = {}) {
+  const timeoutMs = options.timeoutMs ?? 5e3;
+  const started = Date.now();
+  let lastDiagnostics = null;
+  while (Date.now() - started < timeoutMs) {
+    await new Promise((r) => setTimeout(r, 100));
+  }
+  throw new Error(`[mushi:test-utils] SDK not ready: ${JSON.stringify(lastDiagnostics)}`);
+}
+async function expectNoMushiSelfCascade(options = {}) {
+  return;
+}
 async function waitForQueueDrain(options = {}) {
   return 0;
 }
 
-export { openReport, triggerBug, waitForQueueDrain };
+export { expectMushiReady, expectNoMushiSelfCascade, openMushiWidget, openReport, triggerBug, waitForQueueDrain };
 //# sourceMappingURL=test-utils.js.map
 //# sourceMappingURL=test-utils.js.map

package/dist/test-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/test-utils.ts"],"names":[],"mappings":";;;;;AAsDA,eAAsB,UAAA,CAAW,IAAA,GAA0B,EAAC,EAA2B;AAErF,EAAU,OAAO,IAAA;AAqBnB;AAOO,SAAS,WAAW,QAAA,EAAsC;AAE/D,EAAU;AAEZ;AAOA,eAAsB,iBAAA,CAAkB,OAAA,GAAkC,EAAC,EAAoB;AAE7F,EAAU,OAAO,CAAA;AAenB","file":"test-utils.js","sourcesContent":["/**\n * @mushi-mushi/web/test-utils\n *\n * Playwright / jsdom helpers for deterministic SDK tests. This module is\n * published as a separate entry-point so production bundles never pay the\n * cost — import it via `import { triggerBug, openReport } from\n * '@mushi-mushi/web/test-utils'`.\n *\n * Design goals:\n *   1. Zero production footprint. Nothing here is imported from `./mushi`,\n *      `./widget`, or any runtime module. We reach for the live SDK via\n *      `Mushi.getInstance()` so the test process sees exactly what the app\n *      bootstrapped — no duplicate SDK singletons, no double-init races.\n *   2. Safe in a test harness even when Mushi is disabled. Every helper\n *      no-ops when `Mushi.getInstance()` returns `null`, so Playwright\n *      specs that conditionally wire Mushi (e.g. cloud vs local targets)\n *      don't have to branch.\n *   3. Flat surface. Tests want 3 verbs: \"open the widget\", \"submit a\n *      report programmatically\", \"wait until the SDK confirms the POST\n *      landed\". Anything beyond that belongs in the app under test.\n */\n\nimport { Mushi } from './mushi';\nimport type {\n  MushiReportCategory,\n  MushiSDKInstance,\n} from '@mushi-mushi/core';\n\n/** Options accepted by `triggerBug`. Mirrors the core report contract but\n *  keeps every field optional so a Playwright test can say\n *  `triggerBug({ description: 'button dead' })` without a category. */\nexport interface TriggerBugOptions {\n  /** Short free-text description of the issue. Defaults to a marker\n   *  string so tests that forget to pass a description still produce a\n   *  distinguishable report in the admin console. */\n  description?: string;\n  /** Severity-free category tag. */\n  category?: MushiReportCategory;\n  /** Arbitrary metadata the test wants to round-trip. Merged on top of\n   *  whatever `setMetadata` has already stored. */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Submit a report bypassing the widget UI. Returns the server-assigned\n * `reportId` when the POST lands, or `null` if Mushi isn't initialised in\n * this test context (or the submit failed — the SDK swallows network\n * errors silently by design).\n *\n * Use this from Playwright `page.evaluate(...)` calls to round-trip a\n * report into the backend without needing to drive the widget's DOM. It's\n * the fastest way to assert \"a bug report made it from the browser into\n * reports/ in Supabase\".\n */\nexport async function triggerBug(opts: TriggerBugOptions = {}): Promise<string | null> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return null;\n\n  const description = opts.description\n    ?? `[test-utils] triggerBug marker ${new Date().toISOString()}`;\n\n  if (opts.metadata) {\n    for (const [k, v] of Object.entries(opts.metadata)) {\n      try { sdk.setMetadata(k, v); } catch { /* ignore */ }\n    }\n  }\n\n  // `captureEvent` is the documented programmatic-submit API since 0.3.0\n  // — it bypasses the widget, resolves with the server-assigned report\n  // id, and participates in the same offline queue / pre-filter pipeline\n  // as a widget submission.\n  return await sdk.captureEvent({\n    description,\n    source: 'test-utils',\n    ...(opts.category ? { category: opts.category } : {}),\n    ...(opts.metadata ? { metadata: opts.metadata } : {}),\n  });\n}\n\n/**\n * Programmatically open the Mushi widget without submitting anything. Use\n * for interaction tests that want to assert \"the widget is mounted and\n * reachable\" or to drive a user-like flow via Playwright selectors.\n */\nexport function openReport(category?: MushiReportCategory): void {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return;\n  sdk.report(category ? { category } : undefined);\n}\n\n/**\n * Wait until the offline queue drains — useful after `triggerBug` in tests\n * that submit while offline then assert the report eventually syncs.\n * Resolves with the number of queued items remaining (0 = fully drained).\n */\nexport async function waitForQueueDrain(options: { timeoutMs?: number } = {}): Promise<number> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return 0;\n  const timeoutMs = options.timeoutMs ?? 5_000;\n  const started = Date.now();\n  // The SDK instance doesn't publicly expose the queue, but `getQueueSize`\n  // has been in the contract since 0.2.x. We tolerate its absence so\n  // upgrading doesn't break tests that only need triggerBug/openReport.\n  const getQueueSize = (sdk as MushiSDKInstance & { getQueueSize?: () => number }).getQueueSize;\n  if (typeof getQueueSize !== 'function') return 0;\n\n  while (Date.now() - started < timeoutMs) {\n    const remaining = getQueueSize.call(sdk);\n    if (remaining === 0) return 0;\n    await new Promise((r) => setTimeout(r, 100));\n  }\n  return getQueueSize.call(sdk);\n}\n"]}
+{"version":3,"sources":["../src/test-utils.ts"],"names":[],"mappings":";;;;;AAuDA,eAAsB,UAAA,CAAW,IAAA,GAA0B,EAAC,EAA2B;AAErF,EAAU,OAAO,IAAA;AAqBnB;AAOO,SAAS,WAAW,QAAA,EAAsC;AAE/D,EAAU;AAEZ;AAGO,SAAS,gBAAgB,QAAA,EAAsC;AAEtE;AAOA,eAAsB,gBAAA,CAAiB,OAAA,GAAkC,EAAC,EAAoC;AAC5G,EAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,GAAA;AACvC,EAAA,MAAM,OAAA,GAAU,KAAK,GAAA,EAAI;AACzB,EAAA,IAAI,eAAA,GAAiD,IAAA;AAErD,EAAA,OAAO,IAAA,CAAK,GAAA,EAAI,GAAI,OAAA,GAAU,SAAA,EAAW;AAQvC,IAAA,MAAM,IAAI,OAAA,CAAQ,CAAC,MAAM,UAAA,CAAW,CAAA,EAAG,GAAG,CAAC,CAAA;AAAA,EAC7C;AAEA,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kCAAA,EAAqC,KAAK,SAAA,CAAU,eAAe,CAAC,CAAA,CAAE,CAAA;AACxF;AAOA,eAAsB,wBAAA,CAAyB,OAAA,GAG3C,EAAC,EAAkB;AAErB,EAAU;AAgBZ;AAOA,eAAsB,iBAAA,CAAkB,OAAA,GAAkC,EAAC,EAAoB;AAE7F,EAAU,OAAO,CAAA;AAenB","file":"test-utils.js","sourcesContent":["/**\n * @mushi-mushi/web/test-utils\n *\n * Playwright / jsdom helpers for deterministic SDK tests. This module is\n * published as a separate entry-point so production bundles never pay the\n * cost — import it via `import { triggerBug, openReport } from\n * '@mushi-mushi/web/test-utils'`.\n *\n * Design goals:\n *   1. Zero production footprint. Nothing here is imported from `./mushi`,\n *      `./widget`, or any runtime module. We reach for the live SDK via\n *      `Mushi.getInstance()` so the test process sees exactly what the app\n *      bootstrapped — no duplicate SDK singletons, no double-init races.\n *   2. Safe in a test harness even when Mushi is disabled. Every helper\n *      no-ops when `Mushi.getInstance()` returns `null`, so Playwright\n *      specs that conditionally wire Mushi (e.g. cloud vs local targets)\n *      don't have to branch.\n *   3. Flat surface. Tests want 3 verbs: \"open the widget\", \"submit a\n *      report programmatically\", \"wait until the SDK confirms the POST\n *      landed\". Anything beyond that belongs in the app under test.\n */\n\nimport { Mushi } from './mushi';\nimport type {\n  MushiDiagnosticsResult,\n  MushiReportCategory,\n  MushiSDKInstance,\n} from '@mushi-mushi/core';\n\n/** Options accepted by `triggerBug`. Mirrors the core report contract but\n *  keeps every field optional so a Playwright test can say\n *  `triggerBug({ description: 'button dead' })` without a category. */\nexport interface TriggerBugOptions {\n  /** Short free-text description of the issue. Defaults to a marker\n   *  string so tests that forget to pass a description still produce a\n   *  distinguishable report in the admin console. */\n  description?: string;\n  /** Severity-free category tag. */\n  category?: MushiReportCategory;\n  /** Arbitrary metadata the test wants to round-trip. Merged on top of\n   *  whatever `setMetadata` has already stored. */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Submit a report bypassing the widget UI. Returns the server-assigned\n * `reportId` when the POST lands, or `null` if Mushi isn't initialised in\n * this test context (or the submit failed — the SDK swallows network\n * errors silently by design).\n *\n * Use this from Playwright `page.evaluate(...)` calls to round-trip a\n * report into the backend without needing to drive the widget's DOM. It's\n * the fastest way to assert \"a bug report made it from the browser into\n * reports/ in Supabase\".\n */\nexport async function triggerBug(opts: TriggerBugOptions = {}): Promise<string | null> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return null;\n\n  const description = opts.description\n    ?? `[test-utils] triggerBug marker ${new Date().toISOString()}`;\n\n  if (opts.metadata) {\n    for (const [k, v] of Object.entries(opts.metadata)) {\n      try { sdk.setMetadata(k, v); } catch { /* ignore */ }\n    }\n  }\n\n  // `captureEvent` is the documented programmatic-submit API since 0.3.0\n  // — it bypasses the widget, resolves with the server-assigned report\n  // id, and participates in the same offline queue / pre-filter pipeline\n  // as a widget submission.\n  return await sdk.captureEvent({\n    description,\n    source: 'test-utils',\n    ...(opts.category ? { category: opts.category } : {}),\n    ...(opts.metadata ? { metadata: opts.metadata } : {}),\n  });\n}\n\n/**\n * Programmatically open the Mushi widget without submitting anything. Use\n * for interaction tests that want to assert \"the widget is mounted and\n * reachable\" or to drive a user-like flow via Playwright selectors.\n */\nexport function openReport(category?: MushiReportCategory): void {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return;\n  sdk.report(category ? { category } : undefined);\n}\n\n/** Alias with language that reads better in Playwright smoke tests. */\nexport function openMushiWidget(category?: MushiReportCategory): void {\n  openReport(category);\n}\n\n/**\n * Wait until the live SDK instance exists and reports a mounted widget.\n * Throws with the diagnostics payload so CI failures point at CSP / Shadow DOM\n * / capture setup instead of a generic timeout.\n */\nexport async function expectMushiReady(options: { timeoutMs?: number } = {}): Promise<MushiDiagnosticsResult> {\n  const timeoutMs = options.timeoutMs ?? 5_000;\n  const started = Date.now();\n  let lastDiagnostics: MushiDiagnosticsResult | null = null;\n\n  while (Date.now() - started < timeoutMs) {\n    const sdk = Mushi.getInstance();\n    if (sdk) {\n      lastDiagnostics = await sdk.diagnose();\n      if (lastDiagnostics.widgetMounted && lastDiagnostics.shadowDomAvailable) {\n        return lastDiagnostics;\n      }\n    }\n    await new Promise((r) => setTimeout(r, 100));\n  }\n\n  throw new Error(`[mushi:test-utils] SDK not ready: ${JSON.stringify(lastDiagnostics)}`);\n}\n\n/**\n * Run an optional action and fail if the SDK fires an api_cascade proactive\n * prompt during the observation window. This catches the exact glot.it class\n * of bug where Mushi reports on its own runtime-config/report endpoints.\n */\nexport async function expectNoMushiSelfCascade(options: {\n  timeoutMs?: number;\n  action?: () => void | Promise<void>;\n} = {}): Promise<void> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return;\n  const timeoutMs = options.timeoutMs ?? 1_000;\n  let cascade: unknown = null;\n  const unsubscribe = sdk.on('proactive:triggered', (event) => {\n    const payload = event.data as { type?: string } | undefined;\n    if (payload?.type === 'api_cascade') cascade = event.data ?? true;\n  });\n  try {\n    await options.action?.();\n    await new Promise((r) => setTimeout(r, timeoutMs));\n  } finally {\n    unsubscribe();\n  }\n  if (cascade) {\n    throw new Error(`[mushi:test-utils] unexpected api_cascade from SDK self-noise: ${JSON.stringify(cascade)}`);\n  }\n}\n\n/**\n * Wait until the offline queue drains — useful after `triggerBug` in tests\n * that submit while offline then assert the report eventually syncs.\n * Resolves with the number of queued items remaining (0 = fully drained).\n */\nexport async function waitForQueueDrain(options: { timeoutMs?: number } = {}): Promise<number> {\n  const sdk = Mushi.getInstance();\n  if (!sdk) return 0;\n  const timeoutMs = options.timeoutMs ?? 5_000;\n  const started = Date.now();\n  // The SDK instance doesn't publicly expose the queue, but `getQueueSize`\n  // has been in the contract since 0.2.x. We tolerate its absence so\n  // upgrading doesn't break tests that only need triggerBug/openReport.\n  const getQueueSize = (sdk as MushiSDKInstance & { getQueueSize?: () => number }).getQueueSize;\n  if (typeof getQueueSize !== 'function') return 0;\n\n  while (Date.now() - started < timeoutMs) {\n    const remaining = getQueueSize.call(sdk);\n    if (remaining === 0) return 0;\n    await new Promise((r) => setTimeout(r, 100));\n  }\n  return getQueueSize.call(sdk);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mushi-mushi/web",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Mushi Mushi browser SDK — embeddable bug reporting widget with Shadow DOM isolation",
   "license": "MIT",
   "type": "module",
@@ -81,17 +81,17 @@
     {
       "name": "Core SDK bundle (minified + gzipped)",
       "path": "dist/index.js",
-      "limit": "22 KB",
+      "limit": "30 KB",
       "gzip": true
     },
     {
       "name": "Core SDK bundle (uncompressed)",
       "path": "dist/index.js",
-      "limit": "60 KB"
+      "limit": "70 KB"
     }
   ],
   "dependencies": {
-    "@mushi-mushi/core": "^0.7.0"
+    "@mushi-mushi/core": "^0.9.0"
   },
   "devDependencies": {
     "@size-limit/file": "^12.1.0",