@fairfox/polly 0.20.1 → 0.22.0

package/dist/tools/quality/src/cli.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env bun
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// tools/quality/src/no-as-casting.ts
+import { readFileSync } from "node:fs";
+import { Glob } from "bun";
+function isLineClean(line) {
+  if (!line.includes(" as "))
+    return true;
+  const trimmed = line.trim();
+  if (trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*")) {
+    return true;
+  }
+  if (line.match(/\bas const\b/)) {
+    const withoutAsConst = line.replace(/\bas const\b/g, "");
+    if (!withoutAsConst.includes(" as "))
+      return true;
+  }
+  if (line.includes(" as unknown as ") || line.trimEnd().endsWith("as unknown as")) {
+    const withoutEscapeHatch = line.replace(/\bas unknown as\b/g, "");
+    if (!withoutEscapeHatch.includes(" as "))
+      return true;
+  }
+  if (line.match(/\b(import|export)\s+.*\s+as\s+\w+/) || line.match(/\b(import|export)\s+\*\s+as\s+\w+/) || line.match(/\b(import|export)\s+type\s+.*\s+as\s+\w+/) || line.match(/^\s*\w+\s+as\s+\w+,?\s*$/) || line.match(/^\s*type\s+\w+\s+as\s+\w+,?\s*$/)) {
+    return true;
+  }
+  if (line.match(/\bas\s*[=:,]/))
+    return true;
+  if (line.match(/\)\s+as\s+\w+/))
+    return true;
+  const idx = line.indexOf(" as ");
+  if (idx >= 0) {
+    const before = line.substring(0, idx);
+    const singleQuotes = (before.match(/'/g) ?? []).length;
+    const doubleQuotes = (before.match(/"/g) ?? []).length;
+    const backticks = (before.match(/`/g) ?? []).length;
+    if (singleQuotes % 2 === 1 || doubleQuotes % 2 === 1 || backticks % 2 === 1) {
+      return true;
+    }
+  }
+  const commentIdx = line.indexOf("//");
+  if (commentIdx >= 0 && line.indexOf(" as ", commentIdx) >= 0) {
+    const beforeComment = line.substring(0, commentIdx);
+    if (!beforeComment.includes(" as "))
+      return true;
+  }
+  if (line.includes(" satisfies "))
+    return true;
+  return false;
+}
+function suggestFix(line) {
+  if (line.includes("JSON.parse")) {
+    return "Use a validation function or type guard to parse and validate the result.";
+  }
+  if (line.includes("as HTMLInputElement") || line.includes("as HTMLTextAreaElement") || line.includes("as HTMLButtonElement")) {
+    return "Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }";
+  }
+  if (line.includes("as HTMLElement") || line.includes("as Element")) {
+    return "Use instanceof: if (el instanceof HTMLElement) { ... }";
+  }
+  if (line.includes(".doc()") && line.includes("as ")) {
+    return "Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.";
+  }
+  if (line.includes("Record<string, unknown>") && (line.includes("window") || line.includes("globalThis"))) {
+    return "Extract a type guard: function getGlobalProp(name: string): unknown { ... }";
+  }
+  if (line.includes("Record<string, unknown>")) {
+    return "Use a type guard function that narrows the unknown value to the target shape.";
+  }
+  if (line.includes("as PeerId") || line.includes("as DocumentId")) {
+    return "Use the library's branded-type constructor if available, or centralise the cast in a factory.";
+  }
+  if (line.includes("as string") || line.includes("as number") || line.includes("as boolean")) {
+    return "Narrow with typeof: if (typeof x === 'string') { ... }";
+  }
+  if (line.includes("as any")) {
+    return "Replace 'any' with 'unknown' and add a type guard or validation at the boundary.";
+  }
+  return;
+}
+async function checkNoAsCasting(options) {
+  const rootDir = options.rootDir;
+  const excludeDirs = new Set(options.exclude ?? ["node_modules", "dist", ".git", ".bun"]);
+  const pattern = options.filePatterns ?? "**/*.{ts,tsx}";
+  const glob = new Glob(pattern);
+  const violations = [];
+  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {
+    const relative = file.replace(`${rootDir}/`, "");
+    const segments = relative.split("/");
+    if (segments.some((s) => excludeDirs.has(s)))
+      continue;
+    const content = readFileSync(file, "utf-8");
+    const lines = content.split(`
+`);
+    for (let i = 0;i < lines.length; i++) {
+      const line = lines[i] ?? "";
+      if (!isLineClean(line)) {
+        violations.push({
+          file: relative,
+          line: i + 1,
+          content: line.trim(),
+          advice: suggestFix(line.trim())
+        });
+      }
+    }
+  }
+  return {
+    violations,
+    print() {
+      if (violations.length === 0) {
+        console.log("[no-as-casting] ✅ No violations found.");
+        return;
+      }
+      console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:
+`);
+      for (const v of violations) {
+        console.log(`  ${v.file}:${v.line}`);
+        console.log(`    ${v.content}`);
+        if (v.advice)
+          console.log(`    \uD83D\uDCA1 ${v.advice}`);
+        console.log();
+      }
+      console.log("[no-as-casting] Use type guards, validation, or fix the types at the source.");
+      console.log('[no-as-casting] Only "as const" and "as unknown as" are allowed.');
+    }
+  };
+}
+
+// tools/quality/src/cli.ts
+var args = process.argv.slice(2);
+function getFlag(name) {
+  const idx = args.indexOf(`--${name}`);
+  return idx >= 0 ? args[idx + 1] : undefined;
+}
+var rootDir = getFlag("root") ?? process.cwd();
+var exclude = getFlag("exclude")?.split(",") ?? ["node_modules", "dist", ".git", ".bun"];
+var filePatterns = getFlag("pattern");
+var result = await checkNoAsCasting({
+  rootDir,
+  exclude,
+  ...filePatterns ? { filePatterns } : {}
+});
+result.print();
+process.exit(result.violations.length > 0 ? 1 : 0);
+
+//# debugId=C4D3FE8A6910608764756E2164756E21

package/dist/tools/quality/src/cli.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../tools/quality/src/no-as-casting.ts", "../tools/quality/src/cli.ts"],
+  "sourcesContent": [
+    "/**\n * No-as-casting conformance check.\n *\n * Bans all TypeScript type assertions (`as Type`) except the allowed\n * patterns: `as const` (literal narrowing), `as unknown as` (explicit\n * escape hatch), import/export renames, and `as` inside strings or\n * comments. Violations include pattern-specific fix advice.\n *\n * This module exports the check logic as a library so consuming\n * applications can import it from `@fairfox/polly/quality` and run it\n * programmatically. Polly's own `scripts/check-no-as-casting.ts` is a\n * thin CLI wrapper around these exports.\n */\n\nimport { readFileSync } from \"node:fs\";\nimport { Glob } from \"bun\";\n\nexport interface Violation {\n  file: string;\n  line: number;\n  content: string;\n  advice?: string;\n}\n\nexport interface CheckResult {\n  violations: Violation[];\n  print: () => void;\n}\n\nexport interface CheckOptions {\n  rootDir: string;\n  exclude?: string[];\n  filePatterns?: string;\n}\n\n/**\n * Check whether a line contains a forbidden `as` type assertion.\n * Returns true if the line is clean (no violation), false if it violates.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Source-text scanning with many skip rules is inherently branchy.\nexport function isLineClean(line: string): boolean {\n  if (!line.includes(\" as \")) return true;\n\n  const trimmed = line.trim();\n\n  if (trimmed.startsWith(\"//\") || trimmed.startsWith(\"*\") || trimmed.startsWith(\"/*\")) {\n    return true;\n  }\n\n  if (line.match(/\\bas const\\b/)) {\n    const withoutAsConst = line.replace(/\\bas const\\b/g, \"\");\n    if (!withoutAsConst.includes(\" as \")) return true;\n  }\n\n  if (line.includes(\" as unknown as \") || line.trimEnd().endsWith(\"as unknown as\")) {\n    const withoutEscapeHatch = line.replace(/\\bas unknown as\\b/g, \"\");\n    if (!withoutEscapeHatch.includes(\" as \")) return true;\n  }\n\n  if (\n    line.match(/\\b(import|export)\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+\\*\\s+as\\s+\\w+/) ||\n    line.match(/\\b(import|export)\\s+type\\s+.*\\s+as\\s+\\w+/) ||\n    line.match(/^\\s*\\w+\\s+as\\s+\\w+,?\\s*$/) ||\n    line.match(/^\\s*type\\s+\\w+\\s+as\\s+\\w+,?\\s*$/)\n  ) {\n    return true;\n  }\n\n  if (line.match(/\\bas\\s*[=:,]/)) return true;\n  if (line.match(/\\)\\s+as\\s+\\w+/)) return true;\n\n  const idx = line.indexOf(\" as \");\n  if (idx >= 0) {\n    const before = line.substring(0, idx);\n    const singleQuotes = (before.match(/'/g) ?? []).length;\n    const doubleQuotes = (before.match(/\"/g) ?? []).length;\n    const backticks = (before.match(/`/g) ?? []).length;\n    if (singleQuotes % 2 === 1 || doubleQuotes % 2 === 1 || backticks % 2 === 1) {\n      return true;\n    }\n  }\n\n  const commentIdx = line.indexOf(\"//\");\n  if (commentIdx >= 0 && line.indexOf(\" as \", commentIdx) >= 0) {\n    const beforeComment = line.substring(0, commentIdx);\n    if (!beforeComment.includes(\" as \")) return true;\n  }\n\n  if (line.includes(\" satisfies \")) return true;\n\n  return false;\n}\n\n/**\n * Suggest a concrete fix for a specific violation pattern.\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Pattern-matching advice is a linear chain of if-returns.\nexport function suggestFix(line: string): string | undefined {\n  if (line.includes(\"JSON.parse\")) {\n    return \"Use a validation function or type guard to parse and validate the result.\";\n  }\n  if (\n    line.includes(\"as HTMLInputElement\") ||\n    line.includes(\"as HTMLTextAreaElement\") ||\n    line.includes(\"as HTMLButtonElement\")\n  ) {\n    return \"Use instanceof: if (el instanceof HTMLInputElement) { el.value ... }\";\n  }\n  if (line.includes(\"as HTMLElement\") || line.includes(\"as Element\")) {\n    return \"Use instanceof: if (el instanceof HTMLElement) { ... }\";\n  }\n  if (line.includes(\".doc()\") && line.includes(\"as \")) {\n    return \"Type the DocHandle generic: repo.find<MyType>(id) returns DocHandle<MyType>.\";\n  }\n  if (\n    line.includes(\"Record<string, unknown>\") &&\n    (line.includes(\"window\") || line.includes(\"globalThis\"))\n  ) {\n    return \"Extract a type guard: function getGlobalProp(name: string): unknown { ... }\";\n  }\n  if (line.includes(\"Record<string, unknown>\")) {\n    return \"Use a type guard function that narrows the unknown value to the target shape.\";\n  }\n  if (line.includes(\"as PeerId\") || line.includes(\"as DocumentId\")) {\n    return \"Use the library's branded-type constructor if available, or centralise the cast in a factory.\";\n  }\n  if (line.includes(\"as string\") || line.includes(\"as number\") || line.includes(\"as boolean\")) {\n    return \"Narrow with typeof: if (typeof x === 'string') { ... }\";\n  }\n  if (line.includes(\"as any\")) {\n    return \"Replace 'any' with 'unknown' and add a type guard or validation at the boundary.\";\n  }\n  return undefined;\n}\n\n/**\n * Run the no-as-casting check against a directory. Returns a result\n * object with the violations and a print function for CLI output.\n */\nexport async function checkNoAsCasting(options: CheckOptions): Promise<CheckResult> {\n  const rootDir = options.rootDir;\n  const excludeDirs = new Set(options.exclude ?? [\"node_modules\", \"dist\", \".git\", \".bun\"]);\n  const pattern = options.filePatterns ?? \"**/*.{ts,tsx}\";\n  const glob = new Glob(pattern);\n  const violations: Violation[] = [];\n\n  for await (const file of glob.scan({ cwd: rootDir, absolute: true })) {\n    const relative = file.replace(`${rootDir}/`, \"\");\n    const segments = relative.split(\"/\");\n    if (segments.some((s) => excludeDirs.has(s))) continue;\n\n    const content = readFileSync(file, \"utf-8\");\n    const lines = content.split(\"\\n\");\n\n    for (let i = 0; i < lines.length; i++) {\n      const line = lines[i] ?? \"\";\n      if (!isLineClean(line)) {\n        violations.push({\n          file: relative,\n          line: i + 1,\n          content: line.trim(),\n          advice: suggestFix(line.trim()),\n        });\n      }\n    }\n  }\n\n  return {\n    violations,\n    print() {\n      if (violations.length === 0) {\n        console.log(\"[no-as-casting] ✅ No violations found.\");\n        return;\n      }\n      console.log(`[no-as-casting] ❌ ${violations.length} violation(s) found:\\n`);\n      for (const v of violations) {\n        console.log(`  ${v.file}:${v.line}`);\n        console.log(`    ${v.content}`);\n        if (v.advice) console.log(`    💡 ${v.advice}`);\n        console.log();\n      }\n      console.log(\"[no-as-casting] Use type guards, validation, or fix the types at the source.\");\n      console.log('[no-as-casting] Only \"as const\" and \"as unknown as\" are allowed.');\n    },\n  };\n}\n",
+    "#!/usr/bin/env bun\n\n/**\n * CLI entry point for Polly quality checks.\n *\n *   polly quality [--root <dir>] [--exclude <dirs>] [--pattern <glob>]\n *\n * Runs all conformance checks (currently: no-as-casting) against the\n * target directory and exits non-zero when violations are found.\n */\n\nimport { checkNoAsCasting } from \"./no-as-casting\";\n\nconst args = process.argv.slice(2);\n\nfunction getFlag(name: string): string | undefined {\n  const idx = args.indexOf(`--${name}`);\n  return idx >= 0 ? args[idx + 1] : undefined;\n}\n\nconst rootDir = getFlag(\"root\") ?? process.cwd();\nconst exclude = getFlag(\"exclude\")?.split(\",\") ?? [\"node_modules\", \"dist\", \".git\", \".bun\"];\nconst filePatterns = getFlag(\"pattern\");\n\nconst result = await checkNoAsCasting({\n  rootDir,\n  exclude,\n  ...(filePatterns ? { filePatterns } : {}),\n});\n\nresult.print();\nprocess.exit(result.violations.length > 0 ? 1 : 0);\n"
+  ],
+  "mappings": "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",
+  "debugId": "C4D3FE8A6910608764756E2164756E21",
+  "names": []
+}

package/dist/tools/test/src/adapters/index.js.map

@@ -3,11 +3,11 @@
   "sources": ["../tools/test/src/adapters/context-menus.mock.ts", "../tools/test/src/adapters/fetch.mock.ts", "../tools/test/src/adapters/logger.mock.ts", "../tools/test/src/adapters/offscreen.mock.ts", "../tools/test/src/adapters/runtime.mock.ts", "../tools/test/src/adapters/storage.mock.ts", "../tools/test/src/adapters/tabs.mock.ts", "../tools/test/src/adapters/window.mock.ts", "../tools/test/src/adapters/index.ts"],
   "sourcesContent": [
     "import type { ContextMenusAdapter } from \"@/shared/adapters/context-menus.adapter\";\n\nexport interface MockContextMenus extends ContextMenusAdapter {\n  _menus: Map<string, chrome.contextMenus.CreateProperties>;\n}\n\nexport function createMockContextMenus(): MockContextMenus {\n  const menus = new Map<string, chrome.contextMenus.CreateProperties>();\n\n  return {\n    create: async (createProperties: chrome.contextMenus.CreateProperties): Promise<void> => {\n      if (createProperties.id) {\n        menus.set(createProperties.id, createProperties);\n      }\n    },\n    update: async (\n      _id: string,\n      _updateProperties: Omit<chrome.contextMenus.CreateProperties, \"id\">\n    ): Promise<void> => {\n      // Mock implementation\n    },\n    remove: async (_id: string): Promise<void> => {\n      // Mock implementation\n    },\n    removeAll: async (): Promise<void> => {\n      // Mock implementation\n    },\n    onClicked: (\n      _callback: (info: chrome.contextMenus.OnClickData, tab?: chrome.tabs.Tab) => void\n    ): void => {\n      // Mock implementation\n    },\n    _menus: menus,\n  };\n}\n",
-    "import type { FetchAdapter } from \"@/shared/adapters/fetch.adapter\";\n\nexport interface MockFetch extends FetchAdapter {\n  _responses: Array<Partial<Response>>;\n  _calls: Array<{ input: string | URL; init?: RequestInit }>;\n}\n\nexport function createMockFetch(): MockFetch {\n  const responses: Array<Partial<Response>> = [];\n  const calls: Array<{ input: string | URL; init?: RequestInit }> = [];\n\n  return {\n    fetch: async (input: string | URL, init?: RequestInit): Promise<Response> => {\n      calls.push({ input, ...(init && { init }) });\n\n      const mockResponse = responses.shift() || {\n        ok: true,\n        status: 200,\n        headers: new Headers(),\n        statusText: \"OK\",\n        json: async () => ({}),\n        text: async () => \"\",\n        blob: async () => new Blob(),\n        arrayBuffer: async () => new ArrayBuffer(0),\n        formData: async () => new FormData(),\n      };\n\n      return mockResponse as Response;\n    },\n    _responses: responses,\n    _calls: calls,\n  };\n}\n",
+    "import type { FetchAdapter } from \"@/shared/adapters/fetch.adapter\";\n\nexport interface MockFetch extends FetchAdapter {\n  _responses: Array<Partial<Response>>;\n  _calls: Array<{ input: string | URL; init?: RequestInit }>;\n}\n\nexport function createMockFetch(): MockFetch {\n  const responses: Array<Partial<Response>> = [];\n  const calls: Array<{ input: string | URL; init?: RequestInit }> = [];\n\n  return {\n    fetch: async (input: string | URL, init?: RequestInit): Promise<Response> => {\n      calls.push({ input, ...(init && { init }) });\n\n      const mockResponse = responses.shift() || {\n        ok: true,\n        status: 200,\n        headers: new Headers(),\n        statusText: \"OK\",\n        json: async () => ({}),\n        text: async () => \"\",\n        blob: async () => new Blob(),\n        arrayBuffer: async () => new ArrayBuffer(0),\n        formData: async () => new FormData(),\n      };\n\n      return mockResponse as unknown as Response;\n    },\n    _responses: responses,\n    _calls: calls,\n  };\n}\n",
     "// Mock logger adapter for testing\nimport type { LoggerAdapter } from \"@/shared/adapters/logger.adapter\";\nimport type { LogLevel } from \"@/shared/types/messages\";\n\nexport interface LogCall {\n  level: LogLevel;\n  message: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n  timestamp: number;\n}\n\nexport interface MockLogger extends LoggerAdapter {\n  _calls: LogCall[];\n  _clear(): void;\n}\n\nexport function createMockLogger(options?: { silent?: boolean }): MockLogger {\n  const calls: LogCall[] = [];\n  const silent = options?.silent ?? true;\n\n  const logToConsole = (level: LogLevel, message: string, context?: Record<string, unknown>) => {\n    if (!silent) {\n      // biome-ignore lint/suspicious/noConsole: Mock logger intentionally uses console for testing\n      const consoleMethod = level === \"debug\" ? console.log : console[level];\n      consoleMethod(message, context);\n    }\n  };\n\n  return {\n    debug(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"debug\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"debug\", message, context);\n    },\n\n    info(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"info\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"info\", message, context);\n    },\n\n    warn(message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"warn\",\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"warn\", message, context);\n    },\n\n    error(message: string, error?: Error, context?: Record<string, unknown>): void {\n      calls.push({\n        level: \"error\",\n        message,\n        ...(error && { error }),\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(\"error\", message, { ...context, error });\n    },\n\n    log(level: LogLevel, message: string, context?: Record<string, unknown>): void {\n      calls.push({\n        level,\n        message,\n        ...(context && { context }),\n        timestamp: Date.now(),\n      });\n      logToConsole(level, message, context);\n    },\n\n    // Test-only internals\n    _calls: calls,\n    _clear() {\n      calls.length = 0;\n    },\n  };\n}\n",
     "import type {\n  CreateOffscreenDocumentParameters,\n  OffscreenAdapter,\n} from \"@/shared/adapters/offscreen.adapter\";\n\nexport interface MockOffscreen extends OffscreenAdapter {\n  _hasDocument: boolean;\n}\n\nexport function createMockOffscreen(): MockOffscreen {\n  let hasDocument = false;\n\n  return {\n    createDocument: async (_parameters: CreateOffscreenDocumentParameters): Promise<void> => {\n      hasDocument = true;\n    },\n    closeDocument: async (): Promise<void> => {\n      hasDocument = false;\n    },\n    hasDocument: async (): Promise<boolean> => {\n      return hasDocument;\n    },\n    _hasDocument: hasDocument,\n  };\n}\n",
     "import type { MessageSender, PortAdapter, RuntimeAdapter } from \"@/shared/adapters/runtime.adapter\";\n\nexport interface MockPort extends PortAdapter {\n  _listeners: Set<(message: unknown) => void>;\n  _disconnectListeners: Set<() => void>;\n}\n\nexport function createMockPort(name: string): MockPort {\n  const listeners = new Set<(message: unknown) => void>();\n  const disconnectListeners = new Set<() => void>();\n\n  return {\n    name,\n    onMessage: (callback) => listeners.add(callback),\n    onDisconnect: (callback) => disconnectListeners.add(callback),\n    postMessage: (message) => {\n      for (const listener of listeners) {\n        listener(message);\n      }\n    },\n    disconnect: () => {\n      for (const listener of disconnectListeners) {\n        listener();\n      }\n    },\n    _listeners: listeners,\n    _disconnectListeners: disconnectListeners,\n  };\n}\n\nexport interface MockRuntime extends RuntimeAdapter {\n  id: string;\n  _messageListeners: Set<\n    (message: unknown, sender: MessageSender, sendResponse: (response: unknown) => void) => void\n  >;\n  _connectListeners: Set<(port: PortAdapter) => void>;\n}\n\nexport function createMockRuntime(id = \"test-extension-id\"): MockRuntime {\n  const messageListeners = new Set<\n    (message: unknown, sender: MessageSender, sendResponse: (response: unknown) => void) => void\n  >();\n  const connectListeners = new Set<(port: PortAdapter) => void>();\n\n  return {\n    id,\n    sendMessage: async <T>(message: T): Promise<unknown> => {\n      // Check if this is a response message\n      if (typeof message === \"object\" && message !== null && \"success\" in message) {\n        // This is a response, route it back to all listeners\n        for (const listener of messageListeners) {\n          listener(message, { url: \"\" }, () => {\n            // Empty response handler for mock\n          });\n        }\n        return undefined;\n      }\n\n      // This is a request, call ALL listeners (Chrome calls all, but only first response is used)\n      if (messageListeners.size === 0) {\n        return undefined;\n      }\n\n      return new Promise((resolve) => {\n        let resolved = false;\n        const sharedSendResponse = (res: unknown) => {\n          if (!resolved) {\n            resolved = true;\n            resolve(res);\n          }\n        };\n\n        // Call all listeners (Chrome behavior)\n        for (const listener of messageListeners) {\n          const result = listener(message, { url: \"\" }, sharedSendResponse);\n          // If listener returns true, it will send response asynchronously\n          // If it returns false/undefined/void and we haven't resolved yet, continue to next listener\n          if (typeof result === \"boolean\" && result === true) {\n            // Listener will send response asynchronously, wait for it\n          }\n        }\n\n        // If no listener handled it, resolve with undefined\n        if (!resolved) {\n          resolve(undefined);\n        }\n      });\n    },\n    onMessage: (\n      callback: (\n        message: unknown,\n        sender: MessageSender,\n        sendResponse: (response: unknown) => void\n      ) => undefined | boolean\n    ) => {\n      messageListeners.add(callback);\n    },\n    removeMessageListener: (\n      callback: (\n        message: unknown,\n        sender: MessageSender,\n        sendResponse: (response: unknown) => void\n      ) => undefined | boolean\n    ) => {\n      messageListeners.delete(callback);\n    },\n    connect: (name: string): PortAdapter => {\n      const port = createMockPort(name);\n      for (const listener of connectListeners) {\n        listener(port);\n      }\n      return port;\n    },\n    onConnect: (callback: (port: PortAdapter) => void) => {\n      connectListeners.add(callback);\n    },\n    getURL: (path: string): string => {\n      return `chrome-extension://${id}/${path}`;\n    },\n    getId: (): string => {\n      return id;\n    },\n    openOptionsPage: (): void => {\n      // Mock implementation - no-op for tests\n    },\n    _messageListeners: messageListeners,\n    _connectListeners: connectListeners,\n  };\n}\n",
-    "import type { StorageAdapter, StorageChanges } from \"@/shared/adapters/storage.adapter\";\n\nexport interface MockStorageArea extends StorageAdapter {\n  _data: Map<string, unknown>;\n}\n\nexport function createMockStorageArea(): MockStorageArea {\n  const data = new Map<string, unknown>();\n\n  return {\n    get: async <T = Record<string, unknown>>(\n      keys?: string | string[] | Record<string, unknown> | null\n      // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Mock storage needs to handle multiple key types\n    ): Promise<T> => {\n      if (!keys) {\n        return Object.fromEntries(data) as T;\n      }\n      if (typeof keys === \"string\") {\n        return (data.has(keys) ? { [keys]: data.get(keys) } : {}) as T;\n      }\n      if (Array.isArray(keys)) {\n        const result: Record<string, unknown> = {};\n        for (const key of keys) {\n          if (data.has(key)) {\n            result[key] = data.get(key);\n          }\n        }\n        return result as T;\n      }\n      // Object with defaults\n      const result: Record<string, unknown> = {};\n      for (const [key, defaultValue] of Object.entries(keys)) {\n        result[key] = data.has(key) ? data.get(key) : defaultValue;\n      }\n      return result as T;\n    },\n    set: async (items) => {\n      for (const [key, value] of Object.entries(items)) {\n        data.set(key, value);\n      }\n    },\n    remove: async (keys) => {\n      const keyArray = Array.isArray(keys) ? keys : [keys];\n      for (const key of keyArray) {\n        data.delete(key);\n      }\n    },\n    clear: async () => {\n      data.clear();\n    },\n    onChanged: (_callback: (changes: StorageChanges, areaName: string) => void) => {\n      // Mock implementation - not needed for current tests\n    },\n    _data: data,\n  };\n}\n",
+    "import type { StorageAdapter, StorageChanges } from \"@/shared/adapters/storage.adapter\";\n\nexport interface MockStorageArea extends StorageAdapter {\n  _data: Map<string, unknown>;\n}\n\nexport function createMockStorageArea(): MockStorageArea {\n  const data = new Map<string, unknown>();\n\n  return {\n    get: async <T = Record<string, unknown>>(\n      keys?: string | string[] | Record<string, unknown> | null\n      // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: Mock storage needs to handle multiple key types\n    ): Promise<T> => {\n      if (!keys) {\n        return Object.fromEntries(data) as T;\n      }\n      if (typeof keys === \"string\") {\n        return (data.has(keys) ? { [keys]: data.get(keys) } : {}) as T;\n      }\n      if (Array.isArray(keys)) {\n        const result: Record<string, unknown> = {};\n        for (const key of keys) {\n          if (data.has(key)) {\n            result[key] = data.get(key);\n          }\n        }\n        return result as unknown as T;\n      }\n      // Object with defaults\n      const result: Record<string, unknown> = {};\n      for (const [key, defaultValue] of Object.entries(keys)) {\n        result[key] = data.has(key) ? data.get(key) : defaultValue;\n      }\n      return result as unknown as T;\n    },\n    set: async (items) => {\n      for (const [key, value] of Object.entries(items)) {\n        data.set(key, value);\n      }\n    },\n    remove: async (keys) => {\n      const keyArray = Array.isArray(keys) ? keys : [keys];\n      for (const key of keyArray) {\n        data.delete(key);\n      }\n    },\n    clear: async () => {\n      data.clear();\n    },\n    onChanged: (_callback: (changes: StorageChanges, areaName: string) => void) => {\n      // Mock implementation - not needed for current tests\n    },\n    _data: data,\n  };\n}\n",
     "import type { TabsAdapter } from \"@/shared/adapters/tabs.adapter\";\n\nexport interface MockTabs extends TabsAdapter {\n  _tabs: Map<number, chrome.tabs.Tab>;\n}\n\nexport function createMockTabs(): MockTabs {\n  const tabs = new Map<number, chrome.tabs.Tab>();\n\n  return {\n    query: async (queryInfo: chrome.tabs.QueryInfo): Promise<chrome.tabs.Tab[]> => {\n      const results: chrome.tabs.Tab[] = [];\n      for (const tab of tabs.values()) {\n        let matches = true;\n        if (queryInfo.active !== undefined && tab.active !== queryInfo.active) {\n          matches = false;\n        }\n        if (queryInfo.currentWindow !== undefined) {\n          matches = false;\n        }\n        if (matches) {\n          results.push(tab);\n        }\n      }\n      return results;\n    },\n    get: async (tabId: number): Promise<chrome.tabs.Tab> => {\n      const tab = tabs.get(tabId);\n      if (!tab) {\n        throw new Error(`Tab ${tabId} not found`);\n      }\n      return tab;\n    },\n    sendMessage: async (_tabId: number, _message: unknown): Promise<unknown> => {\n      return Promise.resolve({ success: true });\n    },\n    reload: async (\n      _tabId: number,\n      _reloadProperties?: { bypassCache?: boolean }\n    ): Promise<void> => {\n      // Mock implementation\n    },\n    onRemoved: (\n      _callback: (tabId: number, removeInfo: chrome.tabs.OnRemovedInfo) => void\n    ): void => {\n      // Mock implementation - register listener\n    },\n    onUpdated: (\n      _callback: (\n        tabId: number,\n        changeInfo: chrome.tabs.OnUpdatedInfo,\n        tab: chrome.tabs.Tab\n      ) => void\n    ): void => {\n      // Mock implementation - register listener\n    },\n    onActivated: (_callback: (activeInfo: { tabId: number; windowId: number }) => void): void => {\n      // Mock implementation - register listener\n    },\n    create: async (createProperties: chrome.tabs.CreateProperties): Promise<chrome.tabs.Tab> => {\n      const newTab: chrome.tabs.Tab = {\n        id: Math.floor(Math.random() * 10000),\n        index: tabs.size,\n        pinned: false,\n        highlighted: false,\n        windowId: 1,\n        active: true,\n        incognito: false,\n        selected: true,\n        discarded: false,\n        autoDiscardable: true,\n        groupId: -1,\n        url: createProperties.url || \"about:blank\",\n        title: createProperties.url || \"New Tab\",\n        frozen: false,\n      };\n      if (newTab.id !== undefined) {\n        tabs.set(newTab.id, newTab);\n      }\n      return newTab;\n    },\n    _tabs: tabs,\n  };\n}\n",
     "import type { WindowAdapter } from \"@/shared/adapters/window.adapter\";\n\nexport interface MockWindow extends WindowAdapter {\n  _messageListeners: Set<(event: MessageEvent) => void>;\n}\n\nexport function createMockWindow(): MockWindow {\n  const messageListeners = new Set<(event: MessageEvent) => void>();\n\n  return {\n    postMessage: (message: unknown, targetOrigin: string) => {\n      const event = new MessageEvent(\"message\", {\n        data: message,\n        origin: targetOrigin,\n        source: null,\n      });\n      for (const listener of messageListeners) {\n        listener(event);\n      }\n    },\n    addEventListener: (type: string, listener: (event: MessageEvent) => void) => {\n      if (type === \"message\") {\n        messageListeners.add(listener);\n      }\n    },\n    removeEventListener: (type: string, listener: (event: MessageEvent) => void) => {\n      if (type === \"message\") {\n        messageListeners.delete(listener);\n      }\n    },\n    _messageListeners: messageListeners,\n  };\n}\n",
     "import { createMockContextMenus, type MockContextMenus } from \"./context-menus.mock\";\nimport { createMockFetch, type MockFetch } from \"./fetch.mock\";\nimport { createMockLogger, type MockLogger } from \"./logger.mock\";\nimport { createMockOffscreen, type MockOffscreen } from \"./offscreen.mock\";\nimport { createMockPort, createMockRuntime, type MockPort, type MockRuntime } from \"./runtime.mock\";\nimport { createMockStorageArea, type MockStorageArea } from \"./storage.mock\";\nimport { createMockTabs, type MockTabs } from \"./tabs.mock\";\nimport { createMockWindow, type MockWindow } from \"./window.mock\";\n\n/**\n * Mock adapters with full type information including mock-specific properties\n */\nexport interface MockExtensionAdapters {\n  runtime: MockRuntime;\n  storage: MockStorageArea;\n  tabs: MockTabs;\n  window: MockWindow;\n  offscreen: MockOffscreen;\n  contextMenus: MockContextMenus;\n  fetch: MockFetch;\n  logger: MockLogger;\n}\n\n/**\n * Convenience interface grouping Chrome-like mock APIs\n * Useful when tests need direct access to internal mock state\n */\nexport interface MockChrome {\n  runtime: MockRuntime;\n  storage: {\n    local: MockStorageArea;\n  };\n  tabs: MockTabs;\n}\n\n/**\n * Create a mock Chrome object with grouped APIs\n * Use this when you need access to internal mock state (e.g., mockChrome.tabs._tabs)\n */\nexport function createMockChrome(): MockChrome {\n  return {\n    runtime: createMockRuntime(),\n    storage: {\n      local: createMockStorageArea(),\n    },\n    tabs: createMockTabs(),\n  };\n}\n\n/**\n * Create a complete set of mock adapters for testing\n * Returns mock adapters with full type information\n */\nexport function createMockAdapters(): MockExtensionAdapters {\n  return {\n    runtime: createMockRuntime(),\n    storage: createMockStorageArea(),\n    tabs: createMockTabs(),\n    window: createMockWindow(),\n    offscreen: createMockOffscreen(),\n    contextMenus: createMockContextMenus(),\n    fetch: createMockFetch(),\n    logger: createMockLogger({ silent: true }),\n  };\n}\n\nexport type {\n  MockContextMenus,\n  MockFetch,\n  MockLogger,\n  MockOffscreen,\n  MockPort,\n  MockRuntime,\n  MockStorageArea,\n  MockTabs,\n  MockWindow,\n};\n// Re-export individual mock factories and types for convenience\nexport {\n  createMockContextMenus,\n  createMockFetch,\n  createMockLogger,\n  createMockOffscreen,\n  createMockPort,\n  createMockRuntime,\n  createMockStorageArea,\n  createMockTabs,\n  createMockWindow,\n};\n"

package/dist/tools/test/src/browser/harness.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Browser-side test harness for Polly applications.
+ *
+ * Provides describe/test/expect/done that run inside a Puppeteer-launched
+ * browser tab and record results on window.__testResults for the Node-side
+ * runner to collect. Matchers cover both value assertions and DOM element
+ * assertions so that Preact component tests and WebRTC adapter tests use
+ * the same harness.
+ *
+ * @example
+ * ```typescript
+ * import { describe, test, expect, done, flush, cleanup } from "@fairfox/polly/test/browser";
+ *
+ * const app = document.getElementById("app")!;
+ *
+ * describe("my feature", () => {
+ *   test("renders correctly", async () => {
+ *     render(<MyComponent />, app);
+ *     await flush();
+ *     expect(app.querySelector("h1")).toHaveTextContent("Hello");
+ *     cleanup(app);
+ *   });
+ * });
+ *
+ * done();
+ * ```
+ */
+export declare function describe(name: string, fn: () => void): void;
+export declare function test(name: string, fn: () => Promise<void> | void): void;
+export declare function expect<T>(actual: T): {
+    toBe(expected: T): void;
+    toEqual(expected: T): void;
+    toContain(sub: string): void;
+    toBeTruthy(): void;
+    toBeFalsy(): void;
+    toBeNull(): void;
+    toBeDefined(): void;
+    toBeUndefined(): void;
+    toBeGreaterThan(expected: number): void;
+    toHaveLength(expected: number): void;
+    toExist(): void;
+    toHaveTextContent(expected: string): void;
+    toBeChecked(): void;
+    toBeDisabled(): void;
+    toHaveValue(expected: string): void;
+    toHaveAttribute(name: string, value?: string): void;
+    not: {
+        toBe(expected: T): void;
+        toEqual(expected: T): void;
+        toContain(sub: string): void;
+        toBeNull(): void;
+        toExist(): void;
+        toBeChecked(): void;
+        toBeDisabled(): void;
+        toHaveAttribute(name: string): void;
+    };
+};
+/**
+ * Flush microtasks and pending DOM updates. Call after signal assignments
+ * or render calls to give the reactive system and the browser a chance to
+ * settle before asserting on the result.
+ */
+export declare function flush(ms?: number): Promise<void>;
+/**
+ * Clear a container's rendered content. Call at the end of each test to
+ * prevent state leaking between tests. If you use Preact's render(), pass
+ * the same container; the function calls render(null, container) if Preact
+ * is available, otherwise sets innerHTML to "".
+ */
+export declare function cleanup(container: Element): void;
+/**
+ * Run all registered tests and write results to window.__testResults.
+ * Call this at the end of every .browser.ts test file.
+ */
+export declare function done(): Promise<void>;
+/**
+ * Wait until a predicate returns true, polling every intervalMs. Rejects
+ * after timeoutMs.
+ */
+export declare function waitFor(predicate: () => boolean | Promise<boolean>, timeoutMs?: number, intervalMs?: number): Promise<void>;

package/dist/tools/test/src/browser/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fairfox/polly/test/browser — browser-side test harness for Polly
+ * applications.
+ *
+ * Provides a lightweight describe/test/expect harness that runs inside a
+ * Puppeteer-launched browser tab. Results are recorded on window.__testResults
+ * and polled by the companion runner (run.ts). Applications import this
+ * module in their *.browser.ts test files and call done() at the end.
+ *
+ * @example
+ * ```typescript
+ * import { describe, test, expect, done, waitFor } from "@fairfox/polly/test/browser";
+ *
+ * describe("my feature", () => {
+ *   test("works in a real browser", async () => {
+ *     expect(1 + 1).toBe(2);
+ *   });
+ * });
+ *
+ * done();
+ * ```
+ *
+ * The runner is at tools/test/src/browser/run.ts and is invoked via:
+ *
+ *   bun tools/test/src/browser/run.ts [filter]
+ *
+ * It bundles each test file with Bun.build (using an internal plugin that
+ * redirects Automerge to the base64 WASM variant), serves it on an
+ * ephemeral port, launches Puppeteer, and collects results. A signalling
+ * server for WebRTC tests starts automatically.
+ */
+export { cleanup, describe, done, expect, flush, test, waitFor } from "./harness";

package/dist/tools/test/src/browser/index.js

@@ -0,0 +1,243 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined")
+    return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// tools/test/src/browser/harness.ts
+var results = [];
+var suites = [];
+function describe(name, fn) {
+  suites.push({ name, tests: [] });
+  fn();
+}
+function test(name, fn) {
+  const suite = suites[suites.length - 1];
+  if (suite) {
+    suite.tests.push({ name, fn });
+  }
+}
+function assertElement(value) {
+  if (!(value instanceof Element)) {
+    throw new Error(`Expected an Element, got ${typeof value}: ${String(value)}`);
+  }
+  return value;
+}
+function expect(actual) {
+  return {
+    toBe(expected) {
+      if (actual !== expected) {
+        throw new Error(`Expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
+      }
+    },
+    toEqual(expected) {
+      if (JSON.stringify(actual) !== JSON.stringify(expected)) {
+        throw new Error(`Expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
+      }
+    },
+    toContain(sub) {
+      if (!String(actual).includes(sub)) {
+        throw new Error(`Expected "${String(actual)}" to contain "${sub}"`);
+      }
+    },
+    toBeTruthy() {
+      if (!actual)
+        throw new Error(`Expected truthy, got ${String(actual)}`);
+    },
+    toBeFalsy() {
+      if (actual)
+        throw new Error(`Expected falsy, got ${String(actual)}`);
+    },
+    toBeNull() {
+      if (actual !== null)
+        throw new Error(`Expected null, got ${String(actual)}`);
+    },
+    toBeDefined() {
+      if (actual === undefined || actual === null) {
+        throw new Error(`Expected value to be defined, got ${String(actual)}`);
+      }
+    },
+    toBeUndefined() {
+      if (actual !== undefined) {
+        throw new Error(`Expected undefined, got ${JSON.stringify(actual)}`);
+      }
+    },
+    toBeGreaterThan(expected) {
+      if (typeof actual !== "number" || actual <= expected) {
+        throw new Error(`Expected ${String(actual)} to be greater than ${expected}`);
+      }
+    },
+    toHaveLength(expected) {
+      const obj = actual;
+      const len = obj && typeof obj === "object" && "length" in obj ? Number(obj.length) : -1;
+      if (len !== expected)
+        throw new Error(`Expected length ${expected}, got ${len}`);
+    },
+    toExist() {
+      if (actual == null)
+        throw new Error(`Expected value to exist, got ${String(actual)}`);
+    },
+    toHaveTextContent(expected) {
+      const el = assertElement(actual);
+      if (!el.textContent?.includes(expected)) {
+        throw new Error(`Expected text content to include ${JSON.stringify(expected)}, got ${JSON.stringify(el.textContent)}`);
+      }
+    },
+    toBeChecked() {
+      const el = assertElement(actual);
+      if (!(el instanceof HTMLInputElement) || !el.checked) {
+        throw new Error("Expected element to be checked");
+      }
+    },
+    toBeDisabled() {
+      const el = assertElement(actual);
+      if (!el.hasAttribute("disabled") && el.getAttribute("aria-disabled") !== "true") {
+        throw new Error("Expected element to be disabled");
+      }
+    },
+    toHaveValue(expected) {
+      const el = assertElement(actual);
+      const inputEl = el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement ? el : null;
+      if (!inputEl || inputEl.value !== expected) {
+        throw new Error(`Expected value ${JSON.stringify(expected)}, got ${JSON.stringify(inputEl?.value ?? "(not an input)")}`);
+      }
+    },
+    toHaveAttribute(name, value) {
+      const el = assertElement(actual);
+      if (!el.hasAttribute(name)) {
+        throw new Error(`Expected element to have attribute "${name}"`);
+      }
+      if (value !== undefined && el.getAttribute(name) !== value) {
+        throw new Error(`Expected attribute "${name}" to be ${JSON.stringify(value)}, got ${JSON.stringify(el.getAttribute(name))}`);
+      }
+    },
+    not: {
+      toBe(expected) {
+        if (actual === expected) {
+          throw new Error(`Expected value NOT to be ${JSON.stringify(expected)}`);
+        }
+      },
+      toEqual(expected) {
+        if (JSON.stringify(actual) === JSON.stringify(expected)) {
+          throw new Error(`Expected value NOT to equal ${JSON.stringify(expected)}`);
+        }
+      },
+      toContain(sub) {
+        if (String(actual).includes(sub)) {
+          throw new Error(`Expected "${String(actual)}" NOT to contain "${sub}"`);
+        }
+      },
+      toBeNull() {
+        if (actual === null)
+          throw new Error("Expected value NOT to be null");
+      },
+      toExist() {
+        if (actual != null)
+          throw new Error(`Expected value NOT to exist, got ${String(actual)}`);
+      },
+      toBeChecked() {
+        const el = assertElement(actual);
+        if (el instanceof HTMLInputElement && el.checked) {
+          throw new Error("Expected element NOT to be checked");
+        }
+      },
+      toBeDisabled() {
+        const el = assertElement(actual);
+        if (el.hasAttribute("disabled") || el.getAttribute("aria-disabled") === "true") {
+          throw new Error("Expected element NOT to be disabled");
+        }
+      },
+      toHaveAttribute(name) {
+        const el = assertElement(actual);
+        if (el.hasAttribute(name)) {
+          throw new Error(`Expected element NOT to have attribute "${name}"`);
+        }
+      }
+    }
+  };
+}
+function flush(ms = 50) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+function cleanup(container) {
+  container.innerHTML = "";
+}
+async function done() {
+  for (const suite of suites) {
+    for (const t of suite.tests) {
+      const fullName = `${suite.name} > ${t.name}`;
+      try {
+        await t.fn();
+        results.push({ name: fullName, passed: true });
+      } catch (err) {
+        results.push({
+          name: fullName,
+          passed: false,
+          error: err instanceof Error ? err.message : String(err)
+        });
+      }
+    }
+  }
+  window["__testResults"] = results;
+  window["__done"] = true;
+}
+async function waitFor(predicate, timeoutMs = 5000, intervalMs = 25) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await predicate())
+      return;
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+  throw new Error(`waitFor timed out after ${timeoutMs}ms`);
+}
+export {
+  waitFor,
+  test,
+  flush,
+  expect,
+  done,
+  describe,
+  cleanup
+};
+
+//# debugId=EC34BC0B21B9981964756E2164756E21

package/dist/tools/test/src/browser/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../tools/test/src/browser/harness.ts"],
+  "sourcesContent": [
+    "/**\n * Browser-side test harness for Polly applications.\n *\n * Provides describe/test/expect/done that run inside a Puppeteer-launched\n * browser tab and record results on window.__testResults for the Node-side\n * runner to collect. Matchers cover both value assertions and DOM element\n * assertions so that Preact component tests and WebRTC adapter tests use\n * the same harness.\n *\n * @example\n * ```typescript\n * import { describe, test, expect, done, flush, cleanup } from \"@fairfox/polly/test/browser\";\n *\n * const app = document.getElementById(\"app\")!;\n *\n * describe(\"my feature\", () => {\n *   test(\"renders correctly\", async () => {\n *     render(<MyComponent />, app);\n *     await flush();\n *     expect(app.querySelector(\"h1\")).toHaveTextContent(\"Hello\");\n *     cleanup(app);\n *   });\n * });\n *\n * done();\n * ```\n */\n\ninterface TestResult {\n  name: string;\n  passed: boolean;\n  error?: string;\n}\n\nconst results: TestResult[] = [];\nconst suites: Array<{\n  name: string;\n  tests: Array<{ name: string; fn: () => Promise<void> | void }>;\n}> = [];\n\nexport function describe(name: string, fn: () => void): void {\n  suites.push({ name, tests: [] });\n  fn();\n}\n\nexport function test(name: string, fn: () => Promise<void> | void): void {\n  const suite = suites[suites.length - 1];\n  if (suite) {\n    suite.tests.push({ name, fn });\n  }\n}\n\nfunction assertElement(value: unknown): Element {\n  if (!(value instanceof Element)) {\n    throw new Error(`Expected an Element, got ${typeof value}: ${String(value)}`);\n  }\n  return value;\n}\n\nexport function expect<T>(actual: T) {\n  return {\n    // ─── Value matchers ───────────────────────────────────────────────\n    toBe(expected: T) {\n      if (actual !== expected) {\n        throw new Error(`Expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);\n      }\n    },\n    toEqual(expected: T) {\n      if (JSON.stringify(actual) !== JSON.stringify(expected)) {\n        throw new Error(`Expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);\n      }\n    },\n    toContain(sub: string) {\n      if (!String(actual).includes(sub)) {\n        throw new Error(`Expected \"${String(actual)}\" to contain \"${sub}\"`);\n      }\n    },\n    toBeTruthy() {\n      if (!actual) throw new Error(`Expected truthy, got ${String(actual)}`);\n    },\n    toBeFalsy() {\n      if (actual) throw new Error(`Expected falsy, got ${String(actual)}`);\n    },\n    toBeNull() {\n      if (actual !== null) throw new Error(`Expected null, got ${String(actual)}`);\n    },\n    toBeDefined() {\n      if (actual === undefined || actual === null) {\n        throw new Error(`Expected value to be defined, got ${String(actual)}`);\n      }\n    },\n    toBeUndefined() {\n      if (actual !== undefined) {\n        throw new Error(`Expected undefined, got ${JSON.stringify(actual)}`);\n      }\n    },\n    toBeGreaterThan(expected: number) {\n      if (typeof actual !== \"number\" || actual <= expected) {\n        throw new Error(`Expected ${String(actual)} to be greater than ${expected}`);\n      }\n    },\n    toHaveLength(expected: number) {\n      const obj = actual;\n      const len = obj && typeof obj === \"object\" && \"length\" in obj ? Number(obj.length) : -1;\n      if (len !== expected) throw new Error(`Expected length ${expected}, got ${len}`);\n    },\n    toExist() {\n      if (actual == null) throw new Error(`Expected value to exist, got ${String(actual)}`);\n    },\n\n    // ─── DOM element matchers ─────────────────────────────────────────\n    toHaveTextContent(expected: string) {\n      const el = assertElement(actual);\n      if (!el.textContent?.includes(expected)) {\n        throw new Error(\n          `Expected text content to include ${JSON.stringify(expected)}, got ${JSON.stringify(el.textContent)}`\n        );\n      }\n    },\n    toBeChecked() {\n      const el = assertElement(actual);\n      if (!(el instanceof HTMLInputElement) || !el.checked) {\n        throw new Error(\"Expected element to be checked\");\n      }\n    },\n    toBeDisabled() {\n      const el = assertElement(actual);\n      if (!el.hasAttribute(\"disabled\") && el.getAttribute(\"aria-disabled\") !== \"true\") {\n        throw new Error(\"Expected element to be disabled\");\n      }\n    },\n    toHaveValue(expected: string) {\n      const el = assertElement(actual);\n      const inputEl =\n        el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement ? el : null;\n      if (!inputEl || inputEl.value !== expected) {\n        throw new Error(\n          `Expected value ${JSON.stringify(expected)}, got ${JSON.stringify(inputEl?.value ?? \"(not an input)\")}`\n        );\n      }\n    },\n    toHaveAttribute(name: string, value?: string) {\n      const el = assertElement(actual);\n      if (!el.hasAttribute(name)) {\n        throw new Error(`Expected element to have attribute \"${name}\"`);\n      }\n      if (value !== undefined && el.getAttribute(name) !== value) {\n        throw new Error(\n          `Expected attribute \"${name}\" to be ${JSON.stringify(value)}, got ${JSON.stringify(el.getAttribute(name))}`\n        );\n      }\n    },\n\n    // ─── .not variants ────────────────────────────────────────────────\n    not: {\n      toBe(expected: T) {\n        if (actual === expected) {\n          throw new Error(`Expected value NOT to be ${JSON.stringify(expected)}`);\n        }\n      },\n      toEqual(expected: T) {\n        if (JSON.stringify(actual) === JSON.stringify(expected)) {\n          throw new Error(`Expected value NOT to equal ${JSON.stringify(expected)}`);\n        }\n      },\n      toContain(sub: string) {\n        if (String(actual).includes(sub)) {\n          throw new Error(`Expected \"${String(actual)}\" NOT to contain \"${sub}\"`);\n        }\n      },\n      toBeNull() {\n        if (actual === null) throw new Error(\"Expected value NOT to be null\");\n      },\n      toExist() {\n        if (actual != null) throw new Error(`Expected value NOT to exist, got ${String(actual)}`);\n      },\n      toBeChecked() {\n        const el = assertElement(actual);\n        if (el instanceof HTMLInputElement && el.checked) {\n          throw new Error(\"Expected element NOT to be checked\");\n        }\n      },\n      toBeDisabled() {\n        const el = assertElement(actual);\n        if (el.hasAttribute(\"disabled\") || el.getAttribute(\"aria-disabled\") === \"true\") {\n          throw new Error(\"Expected element NOT to be disabled\");\n        }\n      },\n      toHaveAttribute(name: string) {\n        const el = assertElement(actual);\n        if (el.hasAttribute(name)) {\n          throw new Error(`Expected element NOT to have attribute \"${name}\"`);\n        }\n      },\n    },\n  };\n}\n\n/**\n * Flush microtasks and pending DOM updates. Call after signal assignments\n * or render calls to give the reactive system and the browser a chance to\n * settle before asserting on the result.\n */\nexport function flush(ms = 50): Promise<void> {\n  return new Promise((r) => setTimeout(r, ms));\n}\n\n/**\n * Clear a container's rendered content. Call at the end of each test to\n * prevent state leaking between tests. If you use Preact's render(), pass\n * the same container; the function calls render(null, container) if Preact\n * is available, otherwise sets innerHTML to \"\".\n */\nexport function cleanup(container: Element): void {\n  container.innerHTML = \"\";\n}\n\n/**\n * Run all registered tests and write results to window.__testResults.\n * Call this at the end of every .browser.ts test file.\n */\nexport async function done(): Promise<void> {\n  for (const suite of suites) {\n    for (const t of suite.tests) {\n      const fullName = `${suite.name} > ${t.name}`;\n      try {\n        await t.fn();\n        results.push({ name: fullName, passed: true });\n      } catch (err) {\n        results.push({\n          name: fullName,\n          passed: false,\n          error: err instanceof Error ? err.message : String(err),\n        });\n      }\n    }\n  }\n\n  (window as unknown as Record<string, unknown>)[\"__testResults\"] = results;\n  (window as unknown as Record<string, unknown>)[\"__done\"] = true;\n}\n\n/**\n * Wait until a predicate returns true, polling every intervalMs. Rejects\n * after timeoutMs.\n */\nexport async function waitFor(\n  predicate: () => boolean | Promise<boolean>,\n  timeoutMs = 5000,\n  intervalMs = 25\n): Promise<void> {\n  const deadline = Date.now() + timeoutMs;\n  while (Date.now() < deadline) {\n    if (await predicate()) return;\n    await new Promise((r) => setTimeout(r, intervalMs));\n  }\n  throw new Error(`waitFor timed out after ${timeoutMs}ms`);\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "EC34BC0B21B9981964756E2164756E21",
+  "names": []
+}