@fairfox/polly 0.20.1 → 0.21.0

package/dist/src/shared/adapters/index.js.map

@@ -2,20 +2,20 @@
   "version": 3,
   "sources": ["../src/shared/lib/storage-adapter.ts", "../src/shared/lib/sync-adapter.ts", "../src/shared/adapters/chrome/context-menus.chrome.ts", "../src/shared/adapters/chrome/offscreen.chrome.ts", "../src/shared/adapters/chrome/runtime.chrome.ts", "../src/shared/adapters/chrome/storage.chrome.ts", "../src/shared/adapters/chrome/tabs.chrome.ts", "../src/shared/adapters/chrome/window.chrome.ts", "../src/shared/adapters/fetch.adapter.ts", "../src/shared/adapters/logger.adapter.ts", "../src/shared/lib/adapter-factory.ts", "../src/shared/adapters/index.ts"],
   "sourcesContent": [
-    "// Storage adapters for different execution contexts\n// Automatically chooses the right storage mechanism based on environment\n\n/**\n * Universal storage adapter interface\n */\nexport interface StorageAdapter {\n  get<T = unknown>(keys: string[]): Promise<Record<string, T>>;\n  set(items: Record<string, unknown>): Promise<void>;\n  remove(keys: string[]): Promise<void>;\n}\n\n/**\n * IndexedDB adapter for web apps\n */\nexport class IndexedDBAdapter implements StorageAdapter {\n  private dbName: string;\n  private storeName = \"state\";\n  private dbPromise: Promise<IDBDatabase> | null = null;\n\n  constructor(dbName = \"polly-state\") {\n    this.dbName = dbName;\n  }\n\n  private getDB(): Promise<IDBDatabase> {\n    if (this.dbPromise) return this.dbPromise;\n\n    this.dbPromise = new Promise((resolve, reject) => {\n      const request = indexedDB.open(this.dbName, 1);\n\n      request.onerror = () => reject(request.error);\n      request.onsuccess = () => resolve(request.result);\n\n      request.onupgradeneeded = (event) => {\n        const db = (event.target as IDBOpenDBRequest).result;\n        if (!db.objectStoreNames.contains(this.storeName)) {\n          db.createObjectStore(this.storeName);\n        }\n      };\n    });\n\n    return this.dbPromise;\n  }\n\n  async get<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n    try {\n      const db = await this.getDB();\n      const result: Record<string, T> = {};\n\n      await Promise.all(\n        keys.map(\n          (key) =>\n            new Promise<void>((resolve, reject) => {\n              const transaction = db.transaction([this.storeName], \"readonly\");\n              const store = transaction.objectStore(this.storeName);\n              const request = store.get(key);\n\n              request.onerror = () => reject(request.error);\n              request.onsuccess = () => {\n                if (request.result !== undefined) {\n                  result[key] = request.result as T;\n                }\n                resolve();\n              };\n            })\n        )\n      );\n\n      return result;\n    } catch (error) {\n      console.warn(\"[Polly] IndexedDB get failed:\", error);\n      return {};\n    }\n  }\n\n  async set(items: Record<string, unknown>): Promise<void> {\n    try {\n      const db = await this.getDB();\n      await Promise.all(\n        Object.entries(items).map(\n          ([key, value]) =>\n            new Promise<void>((resolve, reject) => {\n              const transaction = db.transaction([this.storeName], \"readwrite\");\n              const store = transaction.objectStore(this.storeName);\n              const request = store.put(value, key);\n\n              request.onerror = () => reject(request.error);\n              request.onsuccess = () => resolve();\n            })\n        )\n      );\n    } catch (error) {\n      console.warn(\"[Polly] IndexedDB set failed:\", error);\n    }\n  }\n\n  async remove(keys: string[]): Promise<void> {\n    try {\n      const db = await this.getDB();\n      await Promise.all(\n        keys.map(\n          (key) =>\n            new Promise<void>((resolve, reject) => {\n              const transaction = db.transaction([this.storeName], \"readwrite\");\n              const store = transaction.objectStore(this.storeName);\n              const request = store.delete(key);\n\n              request.onerror = () => reject(request.error);\n              request.onsuccess = () => resolve();\n            })\n        )\n      );\n    } catch (error) {\n      console.warn(\"[Polly] IndexedDB remove failed:\", error);\n    }\n  }\n}\n\n/**\n * Chrome storage adapter for extensions\n */\nexport class ChromeStorageAdapter implements StorageAdapter {\n  async get<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n    if (typeof chrome === \"undefined\" || !chrome.storage) {\n      return {};\n    }\n\n    try {\n      return (await chrome.storage.local.get(keys)) as Record<string, T>;\n    } catch (error) {\n      console.warn(\"[Polly] Chrome storage get failed:\", error);\n      return {};\n    }\n  }\n\n  async set(items: Record<string, unknown>): Promise<void> {\n    if (typeof chrome === \"undefined\" || !chrome.storage) {\n      return;\n    }\n\n    try {\n      await chrome.storage.local.set(items);\n    } catch (error) {\n      console.warn(\"[Polly] Chrome storage set failed:\", error);\n    }\n  }\n\n  async remove(keys: string[]): Promise<void> {\n    if (typeof chrome === \"undefined\" || !chrome.storage) {\n      return;\n    }\n\n    try {\n      await chrome.storage.local.remove(keys);\n    } catch (error) {\n      console.warn(\"[Polly] Chrome storage remove failed:\", error);\n    }\n  }\n}\n\n/**\n * In-memory adapter (no persistence) for testing or server contexts\n */\nexport class MemoryStorageAdapter implements StorageAdapter {\n  private storage = new Map<string, unknown>();\n\n  async get<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n    const result: Record<string, T> = {};\n    for (const key of keys) {\n      const value = this.storage.get(key);\n      if (value !== undefined) {\n        result[key] = value as T;\n      }\n    }\n    return result;\n  }\n\n  async set(items: Record<string, unknown>): Promise<void> {\n    for (const [key, value] of Object.entries(items)) {\n      this.storage.set(key, value);\n    }\n  }\n\n  async remove(keys: string[]): Promise<void> {\n    for (const key of keys) {\n      this.storage.delete(key);\n    }\n  }\n}\n\n/**\n * Detect execution context and return appropriate storage adapter\n */\nexport function createStorageAdapter(): StorageAdapter {\n  // Chrome extension context\n  if (typeof chrome !== \"undefined\" && chrome.storage && chrome.runtime) {\n    return new ChromeStorageAdapter();\n  }\n\n  // Web app context (has IndexedDB)\n  if (typeof indexedDB !== \"undefined\") {\n    return new IndexedDBAdapter();\n  }\n\n  // Server/test context (no persistent storage available)\n  return new MemoryStorageAdapter();\n}\n",
-    "// Sync adapter interface for cross-context state synchronization\n// Abstracts the transport mechanism (chrome.runtime, BroadcastChannel, etc.)\n//\n// Architecture Decision: BroadcastChannel vs SharedWorker\n// ------------------------------------------------------\n// We currently use BroadcastChannel for web app sync because:\n// - Simpler API with no lifecycle management complexity\n// - Decentralized (aligns with local-first/offline-first architecture)\n// - Better browser support (especially Safari and mobile)\n// - Perfect for message-passing with Lamport clock conflict resolution\n// - No single point of failure\n//\n// Future Consideration: SharedWorker Support\n// ------------------------------------------\n// SharedWorker could be added as an optional adapter for use cases requiring:\n// - Central coordination point for complex multi-tab workflows\n// - Shared WebSocket connections (one connection for all tabs)\n// - Heavy computation done once and shared across tabs\n// - Persistent background work when tabs are closed\n// - Transaction coordination across tabs\n//\n// For most Polly use cases, BroadcastChannel's peer-to-peer model is preferred,\n// but SharedWorker support could be valuable for advanced scenarios.\n\n/**\n * Message format for state synchronization\n */\nexport interface StateSyncMessage<T = unknown> {\n  key: string;\n  value: T;\n  clock: number;\n}\n\n/**\n * Sync adapter interface - abstracts the transport mechanism for state sync\n *\n * Different contexts use different transports:\n * - Chrome extensions: chrome.runtime messaging\n * - Web apps (multi-tab): BroadcastChannel\n * - PWAs: BroadcastChannel + Service Worker messaging\n * - Single-context: NoOp (no sync needed)\n */\nexport interface SyncAdapter {\n  /**\n   * Broadcast a state update to other contexts\n   */\n  broadcast<T>(message: StateSyncMessage<T>): void;\n\n  /**\n   * Register a callback for incoming state updates\n   */\n  onMessage<T>(callback: (message: StateSyncMessage<T>) => void): () => void;\n\n  /**\n   * Optional: Connect to the sync mechanism\n   * Some transports require explicit connection setup\n   */\n  connect?(): Promise<void>;\n\n  /**\n   * Optional: Disconnect from the sync mechanism\n   */\n  disconnect?(): void;\n\n  /**\n   * Optional: Check if connected\n   */\n  isConnected?(): boolean;\n}\n\n/**\n * NoOp sync adapter for single-context scenarios (no sync needed)\n */\nexport class NoOpSyncAdapter implements SyncAdapter {\n  broadcast<T>(_message: StateSyncMessage<T>): void {\n    // No-op: single context, no need to sync\n  }\n\n  onMessage<T>(_callback: (message: StateSyncMessage<T>) => void): () => void {\n    // No-op: no messages will ever arrive\n    return () => {\n      // Empty cleanup function - nothing to clean up for null adapter\n    };\n  }\n}\n\n/**\n * Chrome runtime sync adapter for Chrome extensions\n * Uses chrome.runtime.sendMessage for cross-context messaging\n */\nexport class ChromeRuntimeSyncAdapter implements SyncAdapter {\n  private listeners: Array<(message: StateSyncMessage<unknown>) => void> = [];\n  private port: chrome.runtime.Port | null = null;\n\n  constructor() {\n    // Set up listener for incoming messages\n    if (typeof chrome !== \"undefined\" && chrome.runtime) {\n      chrome.runtime.onMessage.addListener((message, _sender, _sendResponse) => {\n        if (message.type === \"STATE_SYNC\") {\n          this.listeners.forEach((listener) => {\n            listener(message);\n          });\n        }\n      });\n    }\n  }\n\n  broadcast<T>(message: StateSyncMessage<T>): void {\n    if (typeof chrome === \"undefined\" || !chrome.runtime) {\n      console.warn(\"[SyncAdapter] chrome.runtime not available\");\n      return;\n    }\n\n    try {\n      chrome.runtime.sendMessage({\n        type: \"STATE_SYNC\",\n        key: message.key,\n        value: message.value,\n        clock: message.clock,\n      });\n    } catch (error) {\n      console.warn(\"[SyncAdapter] Failed to broadcast state update:\", error);\n    }\n  }\n\n  onMessage<T>(callback: (message: StateSyncMessage<T>) => void): () => void {\n    this.listeners.push(callback as (message: StateSyncMessage<unknown>) => void);\n\n    // Return cleanup function\n    return () => {\n      const index = this.listeners.indexOf(\n        callback as (message: StateSyncMessage<unknown>) => void\n      );\n      if (index > -1) {\n        this.listeners.splice(index, 1);\n      }\n    };\n  }\n\n  connect(): Promise<void> {\n    // Chrome runtime is always connected\n    return Promise.resolve();\n  }\n\n  disconnect(): void {\n    this.listeners = [];\n    if (this.port) {\n      this.port.disconnect();\n      this.port = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return typeof chrome !== \"undefined\" && !!chrome.runtime;\n  }\n}\n\n/**\n * BroadcastChannel sync adapter for web apps (multi-tab)\n * Uses BroadcastChannel API for cross-tab messaging\n */\nexport class BroadcastChannelSyncAdapter implements SyncAdapter {\n  private channel: BroadcastChannel | null = null;\n  private listeners: Array<(message: StateSyncMessage<unknown>) => void> = [];\n\n  constructor(channelName = \"polly-sync\") {\n    if (typeof BroadcastChannel === \"undefined\") {\n      console.warn(\"[SyncAdapter] BroadcastChannel not available\");\n    } else {\n      this.channel = new BroadcastChannel(channelName);\n\n      this.channel.onmessage = (event) => {\n        if (event.data.type === \"STATE_SYNC\") {\n          this.listeners.forEach((listener) => {\n            listener(event.data);\n          });\n        }\n      };\n    }\n  }\n\n  broadcast<T>(message: StateSyncMessage<T>): void {\n    if (!this.channel) {\n      console.warn(\"[SyncAdapter] BroadcastChannel not initialized\");\n      return;\n    }\n\n    try {\n      this.channel.postMessage({\n        type: \"STATE_SYNC\",\n        key: message.key,\n        value: message.value,\n        clock: message.clock,\n      });\n    } catch (error) {\n      console.warn(\"[SyncAdapter] Failed to broadcast state update:\", error);\n    }\n  }\n\n  onMessage<T>(callback: (message: StateSyncMessage<T>) => void): () => void {\n    this.listeners.push(callback as (message: StateSyncMessage<unknown>) => void);\n\n    // Return cleanup function\n    return () => {\n      const index = this.listeners.indexOf(\n        callback as (message: StateSyncMessage<unknown>) => void\n      );\n      if (index > -1) {\n        this.listeners.splice(index, 1);\n      }\n    };\n  }\n\n  connect(): Promise<void> {\n    // BroadcastChannel connects immediately on construction\n    return Promise.resolve();\n  }\n\n  disconnect(): void {\n    this.listeners = [];\n    if (this.channel) {\n      this.channel.close();\n      this.channel = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return this.channel !== null;\n  }\n}\n\n/**\n * Detect available sync mechanisms and create appropriate adapter\n */\nexport function createSyncAdapter(): SyncAdapter {\n  // Chrome extension context - use chrome.runtime\n  if (typeof chrome !== \"undefined\" && chrome.runtime) {\n    return new ChromeRuntimeSyncAdapter();\n  }\n\n  // Web app with multi-tab support - use BroadcastChannel\n  if (typeof BroadcastChannel !== \"undefined\") {\n    return new BroadcastChannelSyncAdapter();\n  }\n\n  // Single context or no sync available - use NoOp\n  return new NoOpSyncAdapter();\n}\n",
+    "// Storage adapters for different execution contexts\n// Automatically chooses the right storage mechanism based on environment\n\n/**\n * Universal storage adapter interface\n */\nexport interface StorageAdapter {\n  get<T = unknown>(keys: string[]): Promise<Record<string, T>>;\n  set(items: Record<string, unknown>): Promise<void>;\n  remove(keys: string[]): Promise<void>;\n}\n\n/**\n * IndexedDB adapter for web apps\n */\nexport class IndexedDBAdapter implements StorageAdapter {\n  private dbName: string;\n  private storeName = \"state\";\n  private dbPromise: Promise<IDBDatabase> | null = null;\n\n  constructor(dbName = \"polly-state\") {\n    this.dbName = dbName;\n  }\n\n  private getDB(): Promise<IDBDatabase> {\n    if (this.dbPromise) return this.dbPromise;\n\n    this.dbPromise = new Promise((resolve, reject) => {\n      const request = indexedDB.open(this.dbName, 1);\n\n      request.onerror = () => reject(request.error);\n      request.onsuccess = () => resolve(request.result);\n\n      request.onupgradeneeded = (event) => {\n        const db = (event.target as unknown as IDBOpenDBRequest).result;\n        if (!db.objectStoreNames.contains(this.storeName)) {\n          db.createObjectStore(this.storeName);\n        }\n      };\n    });\n\n    return this.dbPromise;\n  }\n\n  async get<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n    try {\n      const db = await this.getDB();\n      const result: Record<string, T> = {};\n\n      await Promise.all(\n        keys.map(\n          (key) =>\n            new Promise<void>((resolve, reject) => {\n              const transaction = db.transaction([this.storeName], \"readonly\");\n              const store = transaction.objectStore(this.storeName);\n              const request = store.get(key);\n\n              request.onerror = () => reject(request.error);\n              request.onsuccess = () => {\n                if (request.result !== undefined) {\n                  result[key] = request.result as unknown as T;\n                }\n                resolve();\n              };\n            })\n        )\n      );\n\n      return result;\n    } catch (error) {\n      console.warn(\"[Polly] IndexedDB get failed:\", error);\n      return {};\n    }\n  }\n\n  async set(items: Record<string, unknown>): Promise<void> {\n    try {\n      const db = await this.getDB();\n      await Promise.all(\n        Object.entries(items).map(\n          ([key, value]) =>\n            new Promise<void>((resolve, reject) => {\n              const transaction = db.transaction([this.storeName], \"readwrite\");\n              const store = transaction.objectStore(this.storeName);\n              const request = store.put(value, key);\n\n              request.onerror = () => reject(request.error);\n              request.onsuccess = () => resolve();\n            })\n        )\n      );\n    } catch (error) {\n      console.warn(\"[Polly] IndexedDB set failed:\", error);\n    }\n  }\n\n  async remove(keys: string[]): Promise<void> {\n    try {\n      const db = await this.getDB();\n      await Promise.all(\n        keys.map(\n          (key) =>\n            new Promise<void>((resolve, reject) => {\n              const transaction = db.transaction([this.storeName], \"readwrite\");\n              const store = transaction.objectStore(this.storeName);\n              const request = store.delete(key);\n\n              request.onerror = () => reject(request.error);\n              request.onsuccess = () => resolve();\n            })\n        )\n      );\n    } catch (error) {\n      console.warn(\"[Polly] IndexedDB remove failed:\", error);\n    }\n  }\n}\n\n/**\n * Chrome storage adapter for extensions\n */\nexport class ChromeStorageAdapter implements StorageAdapter {\n  async get<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n    if (typeof chrome === \"undefined\" || !chrome.storage) {\n      return {};\n    }\n\n    try {\n      return (await chrome.storage.local.get(keys)) as Record<string, T>;\n    } catch (error) {\n      console.warn(\"[Polly] Chrome storage get failed:\", error);\n      return {};\n    }\n  }\n\n  async set(items: Record<string, unknown>): Promise<void> {\n    if (typeof chrome === \"undefined\" || !chrome.storage) {\n      return;\n    }\n\n    try {\n      await chrome.storage.local.set(items);\n    } catch (error) {\n      console.warn(\"[Polly] Chrome storage set failed:\", error);\n    }\n  }\n\n  async remove(keys: string[]): Promise<void> {\n    if (typeof chrome === \"undefined\" || !chrome.storage) {\n      return;\n    }\n\n    try {\n      await chrome.storage.local.remove(keys);\n    } catch (error) {\n      console.warn(\"[Polly] Chrome storage remove failed:\", error);\n    }\n  }\n}\n\n/**\n * In-memory adapter (no persistence) for testing or server contexts\n */\nexport class MemoryStorageAdapter implements StorageAdapter {\n  private storage = new Map<string, unknown>();\n\n  async get<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n    const result: Record<string, T> = {};\n    for (const key of keys) {\n      const value = this.storage.get(key);\n      if (value !== undefined) {\n        result[key] = value as unknown as T;\n      }\n    }\n    return result;\n  }\n\n  async set(items: Record<string, unknown>): Promise<void> {\n    for (const [key, value] of Object.entries(items)) {\n      this.storage.set(key, value);\n    }\n  }\n\n  async remove(keys: string[]): Promise<void> {\n    for (const key of keys) {\n      this.storage.delete(key);\n    }\n  }\n}\n\n/**\n * Detect execution context and return appropriate storage adapter\n */\nexport function createStorageAdapter(): StorageAdapter {\n  // Chrome extension context\n  if (typeof chrome !== \"undefined\" && chrome.storage && chrome.runtime) {\n    return new ChromeStorageAdapter();\n  }\n\n  // Web app context (has IndexedDB)\n  if (typeof indexedDB !== \"undefined\") {\n    return new IndexedDBAdapter();\n  }\n\n  // Server/test context (no persistent storage available)\n  return new MemoryStorageAdapter();\n}\n",
+    "// Sync adapter interface for cross-context state synchronization\n// Abstracts the transport mechanism (chrome.runtime, BroadcastChannel, etc.)\n//\n// Architecture Decision: BroadcastChannel vs SharedWorker\n// ------------------------------------------------------\n// We currently use BroadcastChannel for web app sync because:\n// - Simpler API with no lifecycle management complexity\n// - Decentralized (aligns with local-first/offline-first architecture)\n// - Better browser support (especially Safari and mobile)\n// - Perfect for message-passing with Lamport clock conflict resolution\n// - No single point of failure\n//\n// Future Consideration: SharedWorker Support\n// ------------------------------------------\n// SharedWorker could be added as an optional adapter for use cases requiring:\n// - Central coordination point for complex multi-tab workflows\n// - Shared WebSocket connections (one connection for all tabs)\n// - Heavy computation done once and shared across tabs\n// - Persistent background work when tabs are closed\n// - Transaction coordination across tabs\n//\n// For most Polly use cases, BroadcastChannel's peer-to-peer model is preferred,\n// but SharedWorker support could be valuable for advanced scenarios.\n\n/**\n * Message format for state synchronization\n */\nexport interface StateSyncMessage<T = unknown> {\n  key: string;\n  value: T;\n  clock: number;\n}\n\n/**\n * Sync adapter interface - abstracts the transport mechanism for state sync\n *\n * Different contexts use different transports:\n * - Chrome extensions: chrome.runtime messaging\n * - Web apps (multi-tab): BroadcastChannel\n * - PWAs: BroadcastChannel + Service Worker messaging\n * - Single-context: NoOp (no sync needed)\n */\nexport interface SyncAdapter {\n  /**\n   * Broadcast a state update to other contexts\n   */\n  broadcast<T>(message: StateSyncMessage<T>): void;\n\n  /**\n   * Register a callback for incoming state updates\n   */\n  onMessage<T>(callback: (message: StateSyncMessage<T>) => void): () => void;\n\n  /**\n   * Optional: Connect to the sync mechanism\n   * Some transports require explicit connection setup\n   */\n  connect?(): Promise<void>;\n\n  /**\n   * Optional: Disconnect from the sync mechanism\n   */\n  disconnect?(): void;\n\n  /**\n   * Optional: Check if connected\n   */\n  isConnected?(): boolean;\n}\n\n/**\n * NoOp sync adapter for single-context scenarios (no sync needed)\n */\nexport class NoOpSyncAdapter implements SyncAdapter {\n  broadcast<T>(_message: StateSyncMessage<T>): void {\n    // No-op: single context, no need to sync\n  }\n\n  onMessage<T>(_callback: (message: StateSyncMessage<T>) => void): () => void {\n    // No-op: no messages will ever arrive\n    return () => {\n      // Empty cleanup function - nothing to clean up for null adapter\n    };\n  }\n}\n\n/**\n * Chrome runtime sync adapter for Chrome extensions\n * Uses chrome.runtime.sendMessage for cross-context messaging\n */\nexport class ChromeRuntimeSyncAdapter implements SyncAdapter {\n  private listeners: Array<(message: StateSyncMessage<unknown>) => void> = [];\n  private port: chrome.runtime.Port | null = null;\n\n  constructor() {\n    // Set up listener for incoming messages\n    if (typeof chrome !== \"undefined\" && chrome.runtime) {\n      chrome.runtime.onMessage.addListener((message, _sender, _sendResponse) => {\n        if (message.type === \"STATE_SYNC\") {\n          this.listeners.forEach((listener) => {\n            listener(message);\n          });\n        }\n      });\n    }\n  }\n\n  broadcast<T>(message: StateSyncMessage<T>): void {\n    if (typeof chrome === \"undefined\" || !chrome.runtime) {\n      console.warn(\"[SyncAdapter] chrome.runtime not available\");\n      return;\n    }\n\n    try {\n      chrome.runtime.sendMessage({\n        type: \"STATE_SYNC\",\n        key: message.key,\n        value: message.value,\n        clock: message.clock,\n      });\n    } catch (error) {\n      console.warn(\"[SyncAdapter] Failed to broadcast state update:\", error);\n    }\n  }\n\n  onMessage<T>(callback: (message: StateSyncMessage<T>) => void): () => void {\n    this.listeners.push(callback as unknown as (message: StateSyncMessage<unknown>) => void);\n\n    // Return cleanup function\n    return () => {\n      const index = this.listeners.indexOf(\n        callback as unknown as (message: StateSyncMessage<unknown>) => void\n      );\n      if (index > -1) {\n        this.listeners.splice(index, 1);\n      }\n    };\n  }\n\n  connect(): Promise<void> {\n    // Chrome runtime is always connected\n    return Promise.resolve();\n  }\n\n  disconnect(): void {\n    this.listeners = [];\n    if (this.port) {\n      this.port.disconnect();\n      this.port = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return typeof chrome !== \"undefined\" && !!chrome.runtime;\n  }\n}\n\n/**\n * BroadcastChannel sync adapter for web apps (multi-tab)\n * Uses BroadcastChannel API for cross-tab messaging\n */\nexport class BroadcastChannelSyncAdapter implements SyncAdapter {\n  private channel: BroadcastChannel | null = null;\n  private listeners: Array<(message: StateSyncMessage<unknown>) => void> = [];\n\n  constructor(channelName = \"polly-sync\") {\n    if (typeof BroadcastChannel === \"undefined\") {\n      console.warn(\"[SyncAdapter] BroadcastChannel not available\");\n    } else {\n      this.channel = new BroadcastChannel(channelName);\n\n      this.channel.onmessage = (event) => {\n        if (event.data.type === \"STATE_SYNC\") {\n          this.listeners.forEach((listener) => {\n            listener(event.data);\n          });\n        }\n      };\n    }\n  }\n\n  broadcast<T>(message: StateSyncMessage<T>): void {\n    if (!this.channel) {\n      console.warn(\"[SyncAdapter] BroadcastChannel not initialized\");\n      return;\n    }\n\n    try {\n      this.channel.postMessage({\n        type: \"STATE_SYNC\",\n        key: message.key,\n        value: message.value,\n        clock: message.clock,\n      });\n    } catch (error) {\n      console.warn(\"[SyncAdapter] Failed to broadcast state update:\", error);\n    }\n  }\n\n  onMessage<T>(callback: (message: StateSyncMessage<T>) => void): () => void {\n    this.listeners.push(callback as unknown as (message: StateSyncMessage<unknown>) => void);\n\n    // Return cleanup function\n    return () => {\n      const index = this.listeners.indexOf(\n        callback as unknown as (message: StateSyncMessage<unknown>) => void\n      );\n      if (index > -1) {\n        this.listeners.splice(index, 1);\n      }\n    };\n  }\n\n  connect(): Promise<void> {\n    // BroadcastChannel connects immediately on construction\n    return Promise.resolve();\n  }\n\n  disconnect(): void {\n    this.listeners = [];\n    if (this.channel) {\n      this.channel.close();\n      this.channel = null;\n    }\n  }\n\n  isConnected(): boolean {\n    return this.channel !== null;\n  }\n}\n\n/**\n * Detect available sync mechanisms and create appropriate adapter\n */\nexport function createSyncAdapter(): SyncAdapter {\n  // Chrome extension context - use chrome.runtime\n  if (typeof chrome !== \"undefined\" && chrome.runtime) {\n    return new ChromeRuntimeSyncAdapter();\n  }\n\n  // Web app with multi-tab support - use BroadcastChannel\n  if (typeof BroadcastChannel !== \"undefined\") {\n    return new BroadcastChannelSyncAdapter();\n  }\n\n  // Single context or no sync available - use NoOp\n  return new NoOpSyncAdapter();\n}\n",
     "// Chrome context menus adapter implementation\n\nimport type { ContextMenusAdapter } from \"../context-menus.adapter\";\n\nexport class ChromeContextMenusAdapter implements ContextMenusAdapter {\n  async create(createProperties: chrome.contextMenus.CreateProperties): Promise<void> {\n    return new Promise((resolve, reject) => {\n      chrome.contextMenus.create(createProperties, () => {\n        if (chrome.runtime.lastError) {\n          reject(new Error(chrome.runtime.lastError.message));\n        } else {\n          resolve();\n        }\n      });\n    });\n  }\n\n  async update(\n    id: string,\n    updateProperties: Omit<chrome.contextMenus.CreateProperties, \"id\">\n  ): Promise<void> {\n    await chrome.contextMenus.update(id, updateProperties);\n  }\n\n  async remove(id: string): Promise<void> {\n    await chrome.contextMenus.remove(id);\n  }\n\n  async removeAll(): Promise<void> {\n    await chrome.contextMenus.removeAll();\n  }\n\n  onClicked(\n    callback: (info: chrome.contextMenus.OnClickData, tab?: chrome.tabs.Tab) => void\n  ): void {\n    chrome.contextMenus.onClicked.addListener(callback);\n  }\n}\n",
-    "// Chrome offscreen adapter implementation\n\nimport type { CreateOffscreenDocumentParameters, OffscreenAdapter } from \"../offscreen.adapter\";\n\nexport class ChromeOffscreenAdapter implements OffscreenAdapter {\n  async createDocument(parameters: CreateOffscreenDocumentParameters): Promise<void> {\n    await chrome.offscreen.createDocument({\n      url: parameters.url,\n      reasons: parameters.reasons as chrome.offscreen.Reason[],\n      justification: parameters.justification,\n    });\n  }\n\n  async closeDocument(): Promise<void> {\n    await chrome.offscreen.closeDocument();\n  }\n\n  async hasDocument(): Promise<boolean> {\n    // Chrome doesn't provide a direct API, so we query for offscreen contexts\n    const existingContexts = await chrome.runtime.getContexts({\n      contextTypes: [\"OFFSCREEN_DOCUMENT\" as chrome.runtime.ContextType],\n    });\n    return existingContexts.length > 0;\n  }\n}\n",
-    "// Chrome runtime adapter implementation\n\nimport type { MessageSender, PortAdapter, RuntimeAdapter } from \"../runtime.adapter\";\n\ntype MessageListener = (\n  message: unknown,\n  sender: MessageSender,\n  sendResponse: (response: unknown) => void\n) => undefined | boolean;\n\ntype ChromeMessageListener = (\n  message: unknown,\n  sender: chrome.runtime.MessageSender,\n  sendResponse: (response?: unknown) => void\n) => undefined | boolean;\n\nexport class ChromeRuntimeAdapter implements RuntimeAdapter {\n  private messageListeners = new Map<MessageListener, ChromeMessageListener>();\n  private static listenerCount = 0;\n\n  sendMessage<T>(message: T): Promise<unknown> {\n    return chrome.runtime.sendMessage(message);\n  }\n\n  onMessage(\n    callback: (\n      message: unknown,\n      sender: MessageSender,\n      sendResponse: (response: unknown) => void\n    ) => undefined | boolean\n  ): void {\n    const wrappedCallback = (\n      message: unknown,\n      sender: chrome.runtime.MessageSender,\n      sendResponse: (response?: unknown) => void\n    ) => {\n      const mappedSender: MessageSender = {\n        ...(sender.tab && {\n          tab: {\n            id: sender.tab.id ?? 0,\n            url: sender.tab.url ?? \"\",\n            title: sender.tab.title ?? \"\",\n          },\n        }),\n        ...(sender.frameId !== undefined && { frameId: sender.frameId }),\n        ...(sender.url && { url: sender.url }),\n      };\n      return callback(message, mappedSender, sendResponse);\n    };\n\n    this.messageListeners.set(callback, wrappedCallback);\n    // Chrome's listener signature uses void | boolean, ours uses undefined | boolean\n    // These are compatible - undefined is assignable to void for return types\n    chrome.runtime.onMessage.addListener(\n      wrappedCallback as (\n        message: unknown,\n        sender: chrome.runtime.MessageSender,\n        sendResponse: (response?: unknown) => void\n      ) => undefined | boolean\n    );\n\n    // Track listener count and warn if multiple listeners registered\n    ChromeRuntimeAdapter.listenerCount++;\n\n    if (ChromeRuntimeAdapter.listenerCount > 1) {\n      console.warn(\n        `⚠️  WARNING: ${ChromeRuntimeAdapter.listenerCount} chrome.runtime.onMessage listeners registered!\\n\\nMultiple listeners will cause message handlers to execute multiple times.\\nThis is usually caused by:\\n  1. Creating both MessageBus and MessageRouter with separate listeners\\n  2. Calling createBackground() multiple times\\n  3. Calling getMessageBus('background') after createBackground()\\n\\nFix: In background scripts, use createBackground() ONCE at startup.\\nDo not call getMessageBus('background') separately.`\n      );\n    }\n  }\n\n  removeMessageListener(\n    callback: (\n      message: unknown,\n      sender: MessageSender,\n      sendResponse: (response: unknown) => void\n    ) => undefined | boolean\n  ): void {\n    const wrappedCallback = this.messageListeners.get(callback);\n    if (wrappedCallback) {\n      // Type-safe cast: wrappedCallback is stored with compatible signature\n      chrome.runtime.onMessage.removeListener(\n        wrappedCallback as (\n          message: unknown,\n          sender: chrome.runtime.MessageSender,\n          sendResponse: (response?: unknown) => void\n        ) => undefined | boolean\n      );\n      this.messageListeners.delete(callback);\n\n      // Decrement listener count\n      ChromeRuntimeAdapter.listenerCount = Math.max(0, ChromeRuntimeAdapter.listenerCount - 1);\n    }\n  }\n\n  connect(name: string): PortAdapter {\n    const port = chrome.runtime.connect({ name });\n    return new ChromePortAdapter(port);\n  }\n\n  onConnect(callback: (port: PortAdapter) => void): void {\n    chrome.runtime.onConnect.addListener((port) => {\n      callback(new ChromePortAdapter(port));\n    });\n  }\n\n  getURL(path: string): string {\n    return chrome.runtime.getURL(path);\n  }\n\n  getId(): string {\n    return chrome.runtime.id;\n  }\n\n  openOptionsPage(): void {\n    chrome.runtime.openOptionsPage();\n  }\n}\n\nclass ChromePortAdapter implements PortAdapter {\n  private listeners = {\n    message: new Set<(message: unknown) => void>(),\n    disconnect: new Set<() => void>(),\n  };\n\n  constructor(private port: chrome.runtime.Port) {\n    // Set up Chrome port listeners\n    this.port.onMessage.addListener((message) => {\n      for (const callback of this.listeners.message) {\n        callback(message);\n      }\n    });\n\n    this.port.onDisconnect.addListener(() => {\n      for (const callback of this.listeners.disconnect) {\n        callback();\n      }\n    });\n  }\n\n  get name(): string {\n    return this.port.name;\n  }\n\n  postMessage(message: unknown): void {\n    this.port.postMessage(message);\n  }\n\n  onMessage(callback: (message: unknown) => void): void {\n    this.listeners.message.add(callback);\n  }\n\n  onDisconnect(callback: () => void): void {\n    this.listeners.disconnect.add(callback);\n  }\n\n  disconnect(): void {\n    this.port.disconnect();\n  }\n}\n",
+    "// Chrome offscreen adapter implementation\n\nimport type { CreateOffscreenDocumentParameters, OffscreenAdapter } from \"../offscreen.adapter\";\n\nexport class ChromeOffscreenAdapter implements OffscreenAdapter {\n  async createDocument(parameters: CreateOffscreenDocumentParameters): Promise<void> {\n    await chrome.offscreen.createDocument({\n      url: parameters.url,\n      reasons: parameters.reasons as unknown as chrome.offscreen.Reason[],\n      justification: parameters.justification,\n    });\n  }\n\n  async closeDocument(): Promise<void> {\n    await chrome.offscreen.closeDocument();\n  }\n\n  async hasDocument(): Promise<boolean> {\n    // Chrome doesn't provide a direct API, so we query for offscreen contexts\n    const existingContexts = await chrome.runtime.getContexts({\n      contextTypes: [\"OFFSCREEN_DOCUMENT\" as unknown as chrome.runtime.ContextType],\n    });\n    return existingContexts.length > 0;\n  }\n}\n",
+    "// Chrome runtime adapter implementation\n\nimport type { MessageSender, PortAdapter, RuntimeAdapter } from \"../runtime.adapter\";\n\ntype MessageListener = (\n  message: unknown,\n  sender: MessageSender,\n  sendResponse: (response: unknown) => void\n) => undefined | boolean;\n\ntype ChromeMessageListener = (\n  message: unknown,\n  sender: chrome.runtime.MessageSender,\n  sendResponse: (response?: unknown) => void\n) => undefined | boolean;\n\nexport class ChromeRuntimeAdapter implements RuntimeAdapter {\n  private messageListeners = new Map<MessageListener, ChromeMessageListener>();\n  private static listenerCount = 0;\n\n  sendMessage<T>(message: T): Promise<unknown> {\n    return chrome.runtime.sendMessage(message);\n  }\n\n  onMessage(\n    callback: (\n      message: unknown,\n      sender: MessageSender,\n      sendResponse: (response: unknown) => void\n    ) => undefined | boolean\n  ): void {\n    const wrappedCallback = (\n      message: unknown,\n      sender: chrome.runtime.MessageSender,\n      sendResponse: (response?: unknown) => void\n    ) => {\n      const mappedSender: MessageSender = {\n        ...(sender.tab && {\n          tab: {\n            id: sender.tab.id ?? 0,\n            url: sender.tab.url ?? \"\",\n            title: sender.tab.title ?? \"\",\n          },\n        }),\n        ...(sender.frameId !== undefined && { frameId: sender.frameId }),\n        ...(sender.url && { url: sender.url }),\n      };\n      return callback(message, mappedSender, sendResponse);\n    };\n\n    this.messageListeners.set(callback, wrappedCallback);\n    // Chrome's listener signature uses void | boolean, ours uses undefined | boolean\n    // These are compatible - undefined is assignable to void for return types\n    chrome.runtime.onMessage.addListener(\n      wrappedCallback as unknown as (\n        message: unknown,\n        sender: chrome.runtime.MessageSender,\n        sendResponse: (response?: unknown) => void\n      ) => undefined | boolean\n    );\n\n    // Track listener count and warn if multiple listeners registered\n    ChromeRuntimeAdapter.listenerCount++;\n\n    if (ChromeRuntimeAdapter.listenerCount > 1) {\n      console.warn(\n        `⚠️  WARNING: ${ChromeRuntimeAdapter.listenerCount} chrome.runtime.onMessage listeners registered!\\n\\nMultiple listeners will cause message handlers to execute multiple times.\\nThis is usually caused by:\\n  1. Creating both MessageBus and MessageRouter with separate listeners\\n  2. Calling createBackground() multiple times\\n  3. Calling getMessageBus('background') after createBackground()\\n\\nFix: In background scripts, use createBackground() ONCE at startup.\\nDo not call getMessageBus('background') separately.`\n      );\n    }\n  }\n\n  removeMessageListener(\n    callback: (\n      message: unknown,\n      sender: MessageSender,\n      sendResponse: (response: unknown) => void\n    ) => undefined | boolean\n  ): void {\n    const wrappedCallback = this.messageListeners.get(callback);\n    if (wrappedCallback) {\n      // Type-safe cast: wrappedCallback is stored with compatible signature\n      chrome.runtime.onMessage.removeListener(\n        wrappedCallback as unknown as (\n          message: unknown,\n          sender: chrome.runtime.MessageSender,\n          sendResponse: (response?: unknown) => void\n        ) => undefined | boolean\n      );\n      this.messageListeners.delete(callback);\n\n      // Decrement listener count\n      ChromeRuntimeAdapter.listenerCount = Math.max(0, ChromeRuntimeAdapter.listenerCount - 1);\n    }\n  }\n\n  connect(name: string): PortAdapter {\n    const port = chrome.runtime.connect({ name });\n    return new ChromePortAdapter(port);\n  }\n\n  onConnect(callback: (port: PortAdapter) => void): void {\n    chrome.runtime.onConnect.addListener((port) => {\n      callback(new ChromePortAdapter(port));\n    });\n  }\n\n  getURL(path: string): string {\n    return chrome.runtime.getURL(path);\n  }\n\n  getId(): string {\n    return chrome.runtime.id;\n  }\n\n  openOptionsPage(): void {\n    chrome.runtime.openOptionsPage();\n  }\n}\n\nclass ChromePortAdapter implements PortAdapter {\n  private listeners = {\n    message: new Set<(message: unknown) => void>(),\n    disconnect: new Set<() => void>(),\n  };\n\n  constructor(private port: chrome.runtime.Port) {\n    // Set up Chrome port listeners\n    this.port.onMessage.addListener((message) => {\n      for (const callback of this.listeners.message) {\n        callback(message);\n      }\n    });\n\n    this.port.onDisconnect.addListener(() => {\n      for (const callback of this.listeners.disconnect) {\n        callback();\n      }\n    });\n  }\n\n  get name(): string {\n    return this.port.name;\n  }\n\n  postMessage(message: unknown): void {\n    this.port.postMessage(message);\n  }\n\n  onMessage(callback: (message: unknown) => void): void {\n    this.listeners.message.add(callback);\n  }\n\n  onDisconnect(callback: () => void): void {\n    this.listeners.disconnect.add(callback);\n  }\n\n  disconnect(): void {\n    this.port.disconnect();\n  }\n}\n",
     "// Chrome storage adapter implementation\n\nimport type { StorageAdapter, StorageChanges } from \"../storage.adapter\";\n\nexport class ChromeStorageAdapter implements StorageAdapter {\n  async get<T = Record<string, unknown>>(keys: string | string[] | null): Promise<T> {\n    if (keys === null) {\n      return (await chrome.storage.local.get()) as T;\n    }\n    return (await chrome.storage.local.get(keys as never)) as T;\n  }\n\n  async set(items: Record<string, unknown>): Promise<void> {\n    await chrome.storage.local.set(items);\n  }\n\n  async remove(keys: string | string[]): Promise<void> {\n    await chrome.storage.local.remove(keys);\n  }\n\n  async clear(): Promise<void> {\n    await chrome.storage.local.clear();\n  }\n\n  onChanged(callback: (changes: StorageChanges, areaName: string) => void): void {\n    chrome.storage.onChanged.addListener((changes, areaName) => {\n      const mappedChanges: StorageChanges = {};\n      for (const [key, change] of Object.entries(changes)) {\n        mappedChanges[key] = {\n          oldValue: change.oldValue,\n          newValue: change.newValue,\n        };\n      }\n      callback(mappedChanges, areaName);\n    });\n  }\n}\n",
     "// Chrome tabs adapter implementation\n\nimport type { TabsAdapter } from \"../tabs.adapter\";\n\nexport class ChromeTabsAdapter implements TabsAdapter {\n  async query(queryInfo: chrome.tabs.QueryInfo): Promise<chrome.tabs.Tab[]> {\n    return chrome.tabs.query(queryInfo);\n  }\n\n  async get(tabId: number): Promise<chrome.tabs.Tab> {\n    return chrome.tabs.get(tabId);\n  }\n\n  async sendMessage(tabId: number, message: unknown): Promise<unknown> {\n    return chrome.tabs.sendMessage(tabId, message);\n  }\n\n  async reload(tabId: number, reloadProperties?: { bypassCache?: boolean }): Promise<void> {\n    if (reloadProperties) {\n      await chrome.tabs.reload(tabId, reloadProperties);\n    } else {\n      await chrome.tabs.reload(tabId);\n    }\n  }\n\n  onRemoved(callback: (tabId: number, removeInfo: chrome.tabs.OnRemovedInfo) => void): void {\n    chrome.tabs.onRemoved.addListener(callback);\n  }\n\n  onUpdated(\n    callback: (tabId: number, changeInfo: chrome.tabs.OnUpdatedInfo, tab: chrome.tabs.Tab) => void\n  ): void {\n    chrome.tabs.onUpdated.addListener(callback);\n  }\n\n  onActivated(callback: (activeInfo: { tabId: number; windowId: number }) => void): void {\n    chrome.tabs.onActivated.addListener(callback);\n  }\n\n  async create(createProperties: chrome.tabs.CreateProperties): Promise<chrome.tabs.Tab> {\n    return chrome.tabs.create(createProperties);\n  }\n}\n",
-    "// Chrome window adapter implementation\n\nimport type { WindowAdapter } from \"../window.adapter\";\n\nexport class ChromeWindowAdapter implements WindowAdapter {\n  postMessage(message: unknown, targetOrigin: string): void {\n    window.postMessage(message, targetOrigin);\n  }\n\n  addEventListener(type: \"message\", listener: (event: MessageEvent) => void): void {\n    window.addEventListener(type, listener as EventListener);\n  }\n\n  removeEventListener(type: \"message\", listener: (event: MessageEvent) => void): void {\n    window.removeEventListener(type, listener as EventListener);\n  }\n}\n",
+    "// Chrome window adapter implementation\n\nimport type { WindowAdapter } from \"../window.adapter\";\n\nexport class ChromeWindowAdapter implements WindowAdapter {\n  postMessage(message: unknown, targetOrigin: string): void {\n    window.postMessage(message, targetOrigin);\n  }\n\n  addEventListener(type: \"message\", listener: (event: MessageEvent) => void): void {\n    window.addEventListener(type, listener as unknown as EventListener);\n  }\n\n  removeEventListener(type: \"message\", listener: (event: MessageEvent) => void): void {\n    window.removeEventListener(type, listener as unknown as EventListener);\n  }\n}\n",
     "// Fetch adapter interface (wraps fetch API)\n\nexport interface FetchAdapter {\n  fetch(input: string | URL, init?: RequestInit): Promise<Response>;\n}\n\nexport class BrowserFetchAdapter implements FetchAdapter {\n  fetch(input: string | URL, init?: RequestInit): Promise<Response> {\n    return fetch(input, init);\n  }\n}\n",
     "import type { Context, LogLevel } from \"../types/messages\";\n// Logger adapter interface (message-based centralized logging)\nimport type { RuntimeAdapter } from \"./runtime.adapter\";\n\nexport interface LoggerAdapter {\n  /**\n   * Debug-level logging (verbose, development info)\n   */\n  debug(message: string, context?: Record<string, unknown>): void;\n\n  /**\n   * Info-level logging (general information)\n   */\n  info(message: string, context?: Record<string, unknown>): void;\n\n  /**\n   * Warning-level logging (non-critical issues)\n   */\n  warn(message: string, context?: Record<string, unknown>): void;\n\n  /**\n   * Error-level logging (errors and exceptions)\n   */\n  error(message: string, error?: Error, context?: Record<string, unknown>): void;\n\n  /**\n   * Log with explicit level\n   */\n  log(level: LogLevel, message: string, context?: Record<string, unknown>): void;\n}\n\nexport interface MessageLoggerOptions {\n  consoleMirror?: boolean; // Also log to console (for development)\n  fallbackToConsole?: boolean; // Log to console if message send fails (default: true)\n}\n\n/**\n * Message-based logger that sends LOG messages to background LogStore\n * Uses RuntimeAdapter directly to avoid circular dependency with MessageBus\n */\nexport class MessageLoggerAdapter implements LoggerAdapter {\n  constructor(\n    private runtime: RuntimeAdapter,\n    private sourceContext: Context,\n    private options?: MessageLoggerOptions\n  ) {}\n\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.sendLog(\"debug\", message, context);\n  }\n\n  info(message: string, context?: Record<string, unknown>): void {\n    this.sendLog(\"info\", message, context);\n  }\n\n  warn(message: string, context?: Record<string, unknown>): void {\n    this.sendLog(\"warn\", message, context);\n  }\n\n  error(message: string, error?: Error, context?: Record<string, unknown>): void {\n    this.sendLog(\"error\", message, context, error);\n  }\n\n  log(level: LogLevel, message: string, context?: Record<string, unknown>): void {\n    this.sendLog(level, message, context);\n  }\n\n  private sendLog(\n    level: LogLevel,\n    message: string,\n    context?: Record<string, unknown>,\n    error?: Error\n  ): void {\n    // Optional console mirror for development\n    if (this.options?.consoleMirror) {\n      const consoleMethod = console[level] || console.log;\n      consoleMethod(`[${this.sourceContext}]`, message, context || \"\", error || \"\");\n    }\n\n    // Send LOG message to background (fire-and-forget)\n    const logMessage = {\n      type: \"LOG\" as const,\n      level,\n      message,\n      context,\n      error: error?.message,\n      stack: error?.stack,\n      source: this.sourceContext,\n      timestamp: Date.now(),\n    };\n\n    // Use runtime.sendMessage for fire-and-forget messaging\n    this.runtime.sendMessage(logMessage).catch((sendError) => {\n      // Fallback to console if messaging fails\n      if (this.options?.fallbackToConsole !== false) {\n        console[level](`[${this.sourceContext}] ${message}`, context || \"\", error || \"\");\n        console.warn(\"Failed to send log message:\", sendError);\n      }\n    });\n  }\n}\n",
     "// Adapter factory for automatically creating storage and sync adapters\n\nimport { createStorageAdapter, type StorageAdapter } from \"./storage-adapter\";\nimport { createSyncAdapter, type SyncAdapter } from \"./sync-adapter\";\n\n/**\n * Combined adapters for state management\n */\nexport interface StateAdapters {\n  storage: StorageAdapter;\n  sync: SyncAdapter;\n}\n\n/**\n * Options for adapter creation\n */\nexport interface AdapterOptions {\n  /**\n   * Force a specific context (bypasses auto-detection)\n   */\n  context?: \"chrome-extension\" | \"web-app\" | \"node\" | \"test\";\n\n  /**\n   * Custom storage adapter\n   */\n  storage?: StorageAdapter;\n\n  /**\n   * Custom sync adapter\n   */\n  sync?: SyncAdapter;\n\n  /**\n   * For web apps: force single-tab mode (no sync)\n   */\n  singleTab?: boolean;\n\n  /**\n   * Custom BroadcastChannel name for web app sync\n   */\n  channelName?: string;\n}\n\n/**\n * Automatically create appropriate storage and sync adapters\n * based on the execution context\n *\n * Detection order:\n * 1. Chrome extension → ChromeStorage + ChromeRuntime sync\n * 2. Web app (multi-tab) → IndexedDB + BroadcastChannel sync\n * 3. Web app (single-tab) → IndexedDB + NoOp sync\n * 4. Node.js/test → Memory storage + NoOp sync\n *\n * @example\n * ```typescript\n * // Automatic detection\n * const adapters = createStateAdapters();\n *\n * // Force single-tab mode\n * const adapters = createStateAdapters({ singleTab: true });\n *\n * // Custom adapters\n * const adapters = createStateAdapters({\n *   storage: new CustomStorageAdapter(),\n *   sync: new CustomSyncAdapter()\n * });\n * ```\n */\nexport function createStateAdapters(options: AdapterOptions = {}): StateAdapters {\n  // Use custom adapters if provided\n  if (options.storage && options.sync) {\n    return {\n      storage: options.storage,\n      sync: options.sync,\n    };\n  }\n\n  // Create storage adapter\n  const storage = options.storage || createStorageAdapter();\n\n  // Create sync adapter\n  let sync: SyncAdapter;\n\n  if (options.sync) {\n    sync = options.sync;\n  } else if (options.singleTab) {\n    // Force no sync for single-tab mode\n    const { NoOpSyncAdapter } = require(\"./sync-adapter\");\n    sync = new NoOpSyncAdapter();\n  } else {\n    // Auto-detect sync mechanism\n    sync = createSyncAdapter();\n  }\n\n  return { storage, sync };\n}\n\n/**\n * Create adapters for Chrome extension contexts\n */\nexport function createChromeAdapters(): StateAdapters {\n  const { ChromeStorageAdapter } = require(\"./storage-adapter\");\n  const { ChromeRuntimeSyncAdapter } = require(\"./sync-adapter\");\n\n  return {\n    storage: new ChromeStorageAdapter(),\n    sync: new ChromeRuntimeSyncAdapter(),\n  };\n}\n\n/**\n * Create adapters for web apps / PWAs\n */\nexport function createWebAdapters(\n  options: { singleTab?: boolean; channelName?: string; dbName?: string } = {}\n): StateAdapters {\n  const { IndexedDBAdapter } = require(\"./storage-adapter\");\n  const { BroadcastChannelSyncAdapter, NoOpSyncAdapter } = require(\"./sync-adapter\");\n\n  const storage = new IndexedDBAdapter(options.dbName);\n\n  const sync = options.singleTab\n    ? new NoOpSyncAdapter()\n    : new BroadcastChannelSyncAdapter(options.channelName);\n\n  return { storage, sync };\n}\n\n/**\n * Create adapters for Node.js / server contexts\n */\nexport function createNodeAdapters(): StateAdapters {\n  const { MemoryStorageAdapter } = require(\"./storage-adapter\");\n  const { NoOpSyncAdapter } = require(\"./sync-adapter\");\n\n  return {\n    storage: new MemoryStorageAdapter(),\n    sync: new NoOpSyncAdapter(),\n  };\n}\n\n/**\n * Create adapters for testing\n */\nexport function createMockAdapters(): StateAdapters {\n  const { MemoryStorageAdapter } = require(\"./storage-adapter\");\n  const { NoOpSyncAdapter } = require(\"./sync-adapter\");\n\n  return {\n    storage: new MemoryStorageAdapter(),\n    sync: new NoOpSyncAdapter(),\n  };\n}\n",
     "// Adapter factory and exports\n\nimport type { Context } from \"../types/messages\";\nimport { ChromeContextMenusAdapter } from \"./chrome/context-menus.chrome\";\nimport { ChromeOffscreenAdapter } from \"./chrome/offscreen.chrome\";\nimport { ChromeRuntimeAdapter } from \"./chrome/runtime.chrome\";\nimport { ChromeStorageAdapter } from \"./chrome/storage.chrome\";\nimport { ChromeTabsAdapter } from \"./chrome/tabs.chrome\";\nimport { ChromeWindowAdapter } from \"./chrome/window.chrome\";\nimport type { ContextMenusAdapter } from \"./context-menus.adapter\";\nimport type { FetchAdapter } from \"./fetch.adapter\";\nimport { BrowserFetchAdapter } from \"./fetch.adapter\";\nimport type { LoggerAdapter } from \"./logger.adapter\";\nimport { MessageLoggerAdapter } from \"./logger.adapter\";\nimport type { OffscreenAdapter } from \"./offscreen.adapter\";\nimport type { RuntimeAdapter } from \"./runtime.adapter\";\nimport type { StorageAdapter } from \"./storage.adapter\";\nimport type { TabsAdapter } from \"./tabs.adapter\";\nimport type { WindowAdapter } from \"./window.adapter\";\n\nexport interface ExtensionAdapters {\n  runtime: RuntimeAdapter;\n  storage: StorageAdapter;\n  tabs: TabsAdapter;\n  window: WindowAdapter;\n  offscreen: OffscreenAdapter;\n  contextMenus: ContextMenusAdapter;\n  fetch: FetchAdapter;\n  logger: LoggerAdapter;\n}\n\nexport interface CreateChromeAdaptersOptions {\n  consoleMirror?: boolean; // Mirror logs to console for development\n}\n\n/**\n * Create Chrome-specific adapters with context\n */\nexport function createChromeAdapters(\n  context: Context,\n  options?: CreateChromeAdaptersOptions\n): ExtensionAdapters {\n  const runtime = new ChromeRuntimeAdapter();\n\n  return {\n    runtime,\n    storage: new ChromeStorageAdapter(),\n    tabs: new ChromeTabsAdapter(),\n    window: new ChromeWindowAdapter(),\n    offscreen: new ChromeOffscreenAdapter(),\n    contextMenus: new ChromeContextMenusAdapter(),\n    fetch: new BrowserFetchAdapter(),\n    logger: new MessageLoggerAdapter(runtime, context, {\n      ...(options?.consoleMirror !== undefined && { consoleMirror: options.consoleMirror }),\n      fallbackToConsole: true,\n    }),\n  };\n}\n\nexport {\n  type AdapterOptions,\n  createChromeAdapters as createChromeStateAdapters,\n  createMockAdapters,\n  createNodeAdapters,\n  createStateAdapters,\n  createWebAdapters,\n  type StateAdapters,\n} from \"../lib/adapter-factory\";\n// Re-export state management adapters\n// Note: Avoid duplicate StorageAdapter export - use named exports to prevent conflicts\nexport {\n  ChromeStorageAdapter as UniversalChromeStorageAdapter,\n  createStorageAdapter,\n  IndexedDBAdapter,\n  MemoryStorageAdapter,\n  type StorageAdapter as UniversalStorageAdapter,\n} from \"../lib/storage-adapter\";\nexport {\n  BroadcastChannelSyncAdapter,\n  ChromeRuntimeSyncAdapter,\n  createSyncAdapter,\n  NoOpSyncAdapter,\n  type StateSyncMessage,\n  type SyncAdapter,\n} from \"../lib/sync-adapter\";\nexport * from \"./context-menus.adapter\";\nexport * from \"./fetch.adapter\";\nexport * from \"./logger.adapter\";\nexport * from \"./offscreen.adapter\";\n// Re-export types\nexport * from \"./runtime.adapter\";\nexport * from \"./storage.adapter\";\nexport * from \"./tabs.adapter\";\nexport * from \"./window.adapter\";\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeO,MAAM,iBAA2C;AAAA,EAC9C;AAAA,EACA,YAAY;AAAA,EACZ,YAAyC;AAAA,EAEjD,WAAW,CAAC,SAAS,eAAe;AAAA,IAClC,KAAK,SAAS;AAAA;AAAA,EAGR,KAAK,GAAyB;AAAA,IACpC,IAAI,KAAK;AAAA,MAAW,OAAO,KAAK;AAAA,IAEhC,KAAK,YAAY,IAAI,QAAQ,CAAC,SAAS,WAAW;AAAA,MAChD,MAAM,UAAU,UAAU,KAAK,KAAK,QAAQ,CAAC;AAAA,MAE7C,QAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,MAC5C,QAAQ,YAAY,MAAM,QAAQ,QAAQ,MAAM;AAAA,MAEhD,QAAQ,kBAAkB,CAAC,UAAU;AAAA,QACnC,MAAM,KAAM,MAAM,OAA4B;AAAA,QAC9C,IAAI,CAAC,GAAG,iBAAiB,SAAS,KAAK,SAAS,GAAG;AAAA,UACjD,GAAG,kBAAkB,KAAK,SAAS;AAAA,QACrC;AAAA;AAAA,KAEH;AAAA,IAED,OAAO,KAAK;AAAA;AAAA,OAGR,IAAgB,CAAC,MAA4C;AAAA,IACjE,IAAI;AAAA,MACF,MAAM,KAAK,MAAM,KAAK,MAAM;AAAA,MAC5B,MAAM,SAA4B,CAAC;AAAA,MAEnC,MAAM,QAAQ,IACZ,KAAK,IACH,CAAC,QACC,IAAI,QAAc,CAAC,SAAS,WAAW;AAAA,QACrC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,SAAS,GAAG,UAAU;AAAA,QAC/D,MAAM,QAAQ,YAAY,YAAY,KAAK,SAAS;AAAA,QACpD,MAAM,UAAU,MAAM,IAAI,GAAG;AAAA,QAE7B,QAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC5C,QAAQ,YAAY,MAAM;AAAA,UACxB,IAAI,QAAQ,WAAW,WAAW;AAAA,YAChC,OAAO,OAAO,QAAQ;AAAA,UACxB;AAAA,UACA,QAAQ;AAAA;AAAA,OAEX,CACL,CACF;AAAA,MAEA,OAAO;AAAA,MACP,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,iCAAiC,KAAK;AAAA,MACnD,OAAO,CAAC;AAAA;AAAA;AAAA,OAIN,IAAG,CAAC,OAA+C;AAAA,IACvD,IAAI;AAAA,MACF,MAAM,KAAK,MAAM,KAAK,MAAM;AAAA,MAC5B,MAAM,QAAQ,IACZ,OAAO,QAAQ,KAAK,EAAE,IACpB,EAAE,KAAK,WACL,IAAI,QAAc,CAAC,SAAS,WAAW;AAAA,QACrC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,SAAS,GAAG,WAAW;AAAA,QAChE,MAAM,QAAQ,YAAY,YAAY,KAAK,SAAS;AAAA,QACpD,MAAM,UAAU,MAAM,IAAI,OAAO,GAAG;AAAA,QAEpC,QAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC5C,QAAQ,YAAY,MAAM,QAAQ;AAAA,OACnC,CACL,CACF;AAAA,MACA,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,iCAAiC,KAAK;AAAA;AAAA;AAAA,OAIjD,OAAM,CAAC,MAA+B;AAAA,IAC1C,IAAI;AAAA,MACF,MAAM,KAAK,MAAM,KAAK,MAAM;AAAA,MAC5B,MAAM,QAAQ,IACZ,KAAK,IACH,CAAC,QACC,IAAI,QAAc,CAAC,SAAS,WAAW;AAAA,QACrC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,SAAS,GAAG,WAAW;AAAA,QAChE,MAAM,QAAQ,YAAY,YAAY,KAAK,SAAS;AAAA,QACpD,MAAM,UAAU,MAAM,OAAO,GAAG;AAAA,QAEhC,QAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC5C,QAAQ,YAAY,MAAM,QAAQ;AAAA,OACnC,CACL,CACF;AAAA,MACA,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,oCAAoC,KAAK;AAAA;AAAA;AAG5D;AAAA;AAKO,MAAM,sBAA+C;AAAA,OACpD,IAAgB,CAAC,MAA4C;AAAA,IACjE,IAAI,OAAO,WAAW,eAAe,CAAC,OAAO,SAAS;AAAA,MACpD,OAAO,CAAC;AAAA,IACV;AAAA,IAEA,IAAI;AAAA,MACF,OAAQ,MAAM,OAAO,QAAQ,MAAM,IAAI,IAAI;AAAA,MAC3C,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,sCAAsC,KAAK;AAAA,MACxD,OAAO,CAAC;AAAA;AAAA;AAAA,OAIN,IAAG,CAAC,OAA+C;AAAA,IACvD,IAAI,OAAO,WAAW,eAAe,CAAC,OAAO,SAAS;AAAA,MACpD;AAAA,IACF;AAAA,IAEA,IAAI;AAAA,MACF,MAAM,OAAO,QAAQ,MAAM,IAAI,KAAK;AAAA,MACpC,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,sCAAsC,KAAK;AAAA;AAAA;AAAA,OAItD,OAAM,CAAC,MAA+B;AAAA,IAC1C,IAAI,OAAO,WAAW,eAAe,CAAC,OAAO,SAAS;AAAA,MACpD;AAAA,IACF;AAAA,IAEA,IAAI;AAAA,MACF,MAAM,OAAO,QAAQ,MAAM,OAAO,IAAI;AAAA,MACtC,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,yCAAyC,KAAK;AAAA;AAAA;AAGjE;AAAA;AAKO,MAAM,qBAA+C;AAAA,EAClD,UAAU,IAAI;AAAA,OAEhB,IAAgB,CAAC,MAA4C;AAAA,IACjE,MAAM,SAA4B,CAAC;AAAA,IACnC,WAAW,OAAO,MAAM;AAAA,MACtB,MAAM,QAAQ,KAAK,QAAQ,IAAI,GAAG;AAAA,MAClC,IAAI,UAAU,WAAW;AAAA,QACvB,OAAO,OAAO;AAAA,MAChB;AAAA,IACF;AAAA,IACA,OAAO;AAAA;AAAA,OAGH,IAAG,CAAC,OAA+C;AAAA,IACvD,YAAY,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;AAAA,MAChD,KAAK,QAAQ,IAAI,KAAK,KAAK;AAAA,IAC7B;AAAA;AAAA,OAGI,OAAM,CAAC,MAA+B;AAAA,IAC1C,WAAW,OAAO,MAAM;AAAA,MACtB,KAAK,QAAQ,OAAO,GAAG;AAAA,IACzB;AAAA;AAEJ;AAKO,SAAS,oBAAoB,GAAmB;AAAA,EAErD,IAAI,OAAO,WAAW,eAAe,OAAO,WAAW,OAAO,SAAS;AAAA,IACrE,OAAO,IAAI;AAAA,EACb;AAAA,EAGA,IAAI,OAAO,cAAc,aAAa;AAAA,IACpC,OAAO,IAAI;AAAA,EACb;AAAA,EAGA,OAAO,IAAI;AAAA;;;;;;;;;;;ACpIN,MAAM,gBAAuC;AAAA,EAClD,SAAY,CAAC,UAAqC;AAAA,EAIlD,SAAY,CAAC,WAA+D;AAAA,IAE1E,OAAO,MAAM;AAAA;AAIjB;AAAA;AAMO,MAAM,yBAAgD;AAAA,EACnD,YAAiE,CAAC;AAAA,EAClE,OAAmC;AAAA,EAE3C,WAAW,GAAG;AAAA,IAEZ,IAAI,OAAO,WAAW,eAAe,OAAO,SAAS;AAAA,MACnD,OAAO,QAAQ,UAAU,YAAY,CAAC,SAAS,SAAS,kBAAkB;AAAA,QACxE,IAAI,QAAQ,SAAS,cAAc;AAAA,UACjC,KAAK,UAAU,QAAQ,CAAC,aAAa;AAAA,YACnC,SAAS,OAAO;AAAA,WACjB;AAAA,QACH;AAAA,OACD;AAAA,IACH;AAAA;AAAA,EAGF,SAAY,CAAC,SAAoC;AAAA,IAC/C,IAAI,OAAO,WAAW,eAAe,CAAC,OAAO,SAAS;AAAA,MACpD,QAAQ,KAAK,4CAA4C;AAAA,MACzD;AAAA,IACF;AAAA,IAEA,IAAI;AAAA,MACF,OAAO,QAAQ,YAAY;AAAA,QACzB,MAAM;AAAA,QACN,KAAK,QAAQ;AAAA,QACb,OAAO,QAAQ;AAAA,QACf,OAAO,QAAQ;AAAA,MACjB,CAAC;AAAA,MACD,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,mDAAmD,KAAK;AAAA;AAAA;AAAA,EAIzE,SAAY,CAAC,UAA8D;AAAA,IACzE,KAAK,UAAU,KAAK,QAAwD;AAAA,IAG5E,OAAO,MAAM;AAAA,MACX,MAAM,QAAQ,KAAK,UAAU,QAC3B,QACF;AAAA,MACA,IAAI,QAAQ,IAAI;AAAA,QACd,KAAK,UAAU,OAAO,OAAO,CAAC;AAAA,MAChC;AAAA;AAAA;AAAA,EAIJ,OAAO,GAAkB;AAAA,IAEvB,OAAO,QAAQ,QAAQ;AAAA;AAAA,EAGzB,UAAU,GAAS;AAAA,IACjB,KAAK,YAAY,CAAC;AAAA,IAClB,IAAI,KAAK,MAAM;AAAA,MACb,KAAK,KAAK,WAAW;AAAA,MACrB,KAAK,OAAO;AAAA,IACd;AAAA;AAAA,EAGF,WAAW,GAAY;AAAA,IACrB,OAAO,OAAO,WAAW,eAAe,CAAC,CAAC,OAAO;AAAA;AAErD;AAAA;AAMO,MAAM,4BAAmD;AAAA,EACtD,UAAmC;AAAA,EACnC,YAAiE,CAAC;AAAA,EAE1E,WAAW,CAAC,cAAc,cAAc;AAAA,IACtC,IAAI,OAAO,qBAAqB,aAAa;AAAA,MAC3C,QAAQ,KAAK,8CAA8C;AAAA,IAC7D,EAAO;AAAA,MACL,KAAK,UAAU,IAAI,iBAAiB,WAAW;AAAA,MAE/C,KAAK,QAAQ,YAAY,CAAC,UAAU;AAAA,QAClC,IAAI,MAAM,KAAK,SAAS,cAAc;AAAA,UACpC,KAAK,UAAU,QAAQ,CAAC,aAAa;AAAA,YACnC,SAAS,MAAM,IAAI;AAAA,WACpB;AAAA,QACH;AAAA;AAAA;AAAA;AAAA,EAKN,SAAY,CAAC,SAAoC;AAAA,IAC/C,IAAI,CAAC,KAAK,SAAS;AAAA,MACjB,QAAQ,KAAK,gDAAgD;AAAA,MAC7D;AAAA,IACF;AAAA,IAEA,IAAI;AAAA,MACF,KAAK,QAAQ,YAAY;AAAA,QACvB,MAAM;AAAA,QACN,KAAK,QAAQ;AAAA,QACb,OAAO,QAAQ;AAAA,QACf,OAAO,QAAQ;AAAA,MACjB,CAAC;AAAA,MACD,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK,mDAAmD,KAAK;AAAA;AAAA;AAAA,EAIzE,SAAY,CAAC,UAA8D;AAAA,IACzE,KAAK,UAAU,KAAK,QAAwD;AAAA,IAG5E,OAAO,MAAM;AAAA,MACX,MAAM,QAAQ,KAAK,UAAU,QAC3B,QACF;AAAA,MACA,IAAI,QAAQ,IAAI;AAAA,QACd,KAAK,UAAU,OAAO,OAAO,CAAC;AAAA,MAChC;AAAA;AAAA;AAAA,EAIJ,OAAO,GAAkB;AAAA,IAEvB,OAAO,QAAQ,QAAQ;AAAA;AAAA,EAGzB,UAAU,GAAS;AAAA,IACjB,KAAK,YAAY,CAAC;AAAA,IAClB,IAAI,KAAK,SAAS;AAAA,MAChB,KAAK,QAAQ,MAAM;AAAA,MACnB,KAAK,UAAU;AAAA,IACjB;AAAA;AAAA,EAGF,WAAW,GAAY;AAAA,IACrB,OAAO,KAAK,YAAY;AAAA;AAE5B;AAKO,SAAS,iBAAiB,GAAgB;AAAA,EAE/C,IAAI,OAAO,WAAW,eAAe,OAAO,SAAS;AAAA,IACnD,OAAO,IAAI;AAAA,EACb;AAAA,EAGA,IAAI,OAAO,qBAAqB,aAAa;AAAA,IAC3C,OAAO,IAAI;AAAA,EACb;AAAA,EAGA,OAAO,IAAI;AAAA;;;AClPN,MAAM,0BAAyD;AAAA,OAC9D,OAAM,CAAC,kBAAuE;AAAA,IAClF,OAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AAAA,MACtC,OAAO,aAAa,OAAO,kBAAkB,MAAM;AAAA,QACjD,IAAI,OAAO,QAAQ,WAAW;AAAA,UAC5B,OAAO,IAAI,MAAM,OAAO,QAAQ,UAAU,OAAO,CAAC;AAAA,QACpD,EAAO;AAAA,UACL,QAAQ;AAAA;AAAA,OAEX;AAAA,KACF;AAAA;AAAA,OAGG,OAAM,CACV,IACA,kBACe;AAAA,IACf,MAAM,OAAO,aAAa,OAAO,IAAI,gBAAgB;AAAA;AAAA,OAGjD,OAAM,CAAC,IAA2B;AAAA,IACtC,MAAM,OAAO,aAAa,OAAO,EAAE;AAAA;AAAA,OAG/B,UAAS,GAAkB;AAAA,IAC/B,MAAM,OAAO,aAAa,UAAU;AAAA;AAAA,EAGtC,SAAS,CACP,UACM;AAAA,IACN,OAAO,aAAa,UAAU,YAAY,QAAQ;AAAA;AAEtD;;;ACjCO,MAAM,uBAAmD;AAAA,OACxD,eAAc,CAAC,YAA8D;AAAA,IACjF,MAAM,OAAO,UAAU,eAAe;AAAA,MACpC,KAAK,WAAW;AAAA,MAChB,SAAS,WAAW;AAAA,MACpB,eAAe,WAAW;AAAA,IAC5B,CAAC;AAAA;AAAA,OAGG,cAAa,GAAkB;AAAA,IACnC,MAAM,OAAO,UAAU,cAAc;AAAA;AAAA,OAGjC,YAAW,GAAqB;AAAA,IAEpC,MAAM,mBAAmB,MAAM,OAAO,QAAQ,YAAY;AAAA,MACxD,cAAc,CAAC,oBAAkD;AAAA,IACnE,CAAC;AAAA,IACD,OAAO,iBAAiB,SAAS;AAAA;AAErC;;;ACRO,MAAM,qBAA+C;AAAA,EAClD,mBAAmB,IAAI;AAAA,SAChB,gBAAgB;AAAA,EAE/B,WAAc,CAAC,SAA8B;AAAA,IAC3C,OAAO,OAAO,QAAQ,YAAY,OAAO;AAAA;AAAA,EAG3C,SAAS,CACP,UAKM;AAAA,IACN,MAAM,kBAAkB,CACtB,SACA,QACA,iBACG;AAAA,MACH,MAAM,eAA8B;AAAA,WAC9B,OAAO,OAAO;AAAA,UAChB,KAAK;AAAA,YACH,IAAI,OAAO,IAAI,MAAM;AAAA,YACrB,KAAK,OAAO,IAAI,OAAO;AAAA,YACvB,OAAO,OAAO,IAAI,SAAS;AAAA,UAC7B;AAAA,QACF;AAAA,WACI,OAAO,YAAY,aAAa,EAAE,SAAS,OAAO,QAAQ;AAAA,WAC1D,OAAO,OAAO,EAAE,KAAK,OAAO,IAAI;AAAA,MACtC;AAAA,MACA,OAAO,SAAS,SAAS,cAAc,YAAY;AAAA;AAAA,IAGrD,KAAK,iBAAiB,IAAI,UAAU,eAAe;AAAA,IAGnD,OAAO,QAAQ,UAAU,YACvB,eAKF;AAAA,IAGA,qBAAqB;AAAA,IAErB,IAAI,qBAAqB,gBAAgB,GAAG;AAAA,MAC1C,QAAQ,KACN,gBAAe,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oDACtC;AAAA,IACF;AAAA;AAAA,EAGF,qBAAqB,CACnB,UAKM;AAAA,IACN,MAAM,kBAAkB,KAAK,iBAAiB,IAAI,QAAQ;AAAA,IAC1D,IAAI,iBAAiB;AAAA,MAEnB,OAAO,QAAQ,UAAU,eACvB,eAKF;AAAA,MACA,KAAK,iBAAiB,OAAO,QAAQ;AAAA,MAGrC,qBAAqB,gBAAgB,KAAK,IAAI,GAAG,qBAAqB,gBAAgB,CAAC;AAAA,IACzF;AAAA;AAAA,EAGF,OAAO,CAAC,MAA2B;AAAA,IACjC,MAAM,OAAO,OAAO,QAAQ,QAAQ,EAAE,KAAK,CAAC;AAAA,IAC5C,OAAO,IAAI,kBAAkB,IAAI;AAAA;AAAA,EAGnC,SAAS,CAAC,UAA6C;AAAA,IACrD,OAAO,QAAQ,UAAU,YAAY,CAAC,SAAS;AAAA,MAC7C,SAAS,IAAI,kBAAkB,IAAI,CAAC;AAAA,KACrC;AAAA;AAAA,EAGH,MAAM,CAAC,MAAsB;AAAA,IAC3B,OAAO,OAAO,QAAQ,OAAO,IAAI;AAAA;AAAA,EAGnC,KAAK,GAAW;AAAA,IACd,OAAO,OAAO,QAAQ;AAAA;AAAA,EAGxB,eAAe,GAAS;AAAA,IACtB,OAAO,QAAQ,gBAAgB;AAAA;AAEnC;AAAA;AAEA,MAAM,kBAAyC;AAAA,EAMzB;AAAA,EALZ,YAAY;AAAA,IAClB,SAAS,IAAI;AAAA,IACb,YAAY,IAAI;AAAA,EAClB;AAAA,EAEA,WAAW,CAAS,MAA2B;AAAA,IAA3B;AAAA,IAElB,KAAK,KAAK,UAAU,YAAY,CAAC,YAAY;AAAA,MAC3C,WAAW,YAAY,KAAK,UAAU,SAAS;AAAA,QAC7C,SAAS,OAAO;AAAA,MAClB;AAAA,KACD;AAAA,IAED,KAAK,KAAK,aAAa,YAAY,MAAM;AAAA,MACvC,WAAW,YAAY,KAAK,UAAU,YAAY;AAAA,QAChD,SAAS;AAAA,MACX;AAAA,KACD;AAAA;AAAA,MAGC,IAAI,GAAW;AAAA,IACjB,OAAO,KAAK,KAAK;AAAA;AAAA,EAGnB,WAAW,CAAC,SAAwB;AAAA,IAClC,KAAK,KAAK,YAAY,OAAO;AAAA;AAAA,EAG/B,SAAS,CAAC,UAA4C;AAAA,IACpD,KAAK,UAAU,QAAQ,IAAI,QAAQ;AAAA;AAAA,EAGrC,YAAY,CAAC,UAA4B;AAAA,IACvC,KAAK,UAAU,WAAW,IAAI,QAAQ;AAAA;AAAA,EAGxC,UAAU,GAAS;AAAA,IACjB,KAAK,KAAK,WAAW;AAAA;AAEzB;;;AC3JO,MAAM,qBAA+C;AAAA,OACpD,IAAgC,CAAC,MAA4C;AAAA,IACjF,IAAI,SAAS,MAAM;AAAA,MACjB,OAAQ,MAAM,OAAO,QAAQ,MAAM,IAAI;AAAA,IACzC;AAAA,IACA,OAAQ,MAAM,OAAO,QAAQ,MAAM,IAAI,IAAa;AAAA;AAAA,OAGhD,IAAG,CAAC,OAA+C;AAAA,IACvD,MAAM,OAAO,QAAQ,MAAM,IAAI,KAAK;AAAA;AAAA,OAGhC,OAAM,CAAC,MAAwC;AAAA,IACnD,MAAM,OAAO,QAAQ,MAAM,OAAO,IAAI;AAAA;AAAA,OAGlC,MAAK,GAAkB;AAAA,IAC3B,MAAM,OAAO,QAAQ,MAAM,MAAM;AAAA;AAAA,EAGnC,SAAS,CAAC,UAAqE;AAAA,IAC7E,OAAO,QAAQ,UAAU,YAAY,CAAC,SAAS,aAAa;AAAA,MAC1D,MAAM,gBAAgC,CAAC;AAAA,MACvC,YAAY,KAAK,WAAW,OAAO,QAAQ,OAAO,GAAG;AAAA,QACnD,cAAc,OAAO;AAAA,UACnB,UAAU,OAAO;AAAA,UACjB,UAAU,OAAO;AAAA,QACnB;AAAA,MACF;AAAA,MACA,SAAS,eAAe,QAAQ;AAAA,KACjC;AAAA;AAEL;;;AChCO,MAAM,kBAAyC;AAAA,OAC9C,MAAK,CAAC,WAA8D;AAAA,IACxE,OAAO,OAAO,KAAK,MAAM,SAAS;AAAA;AAAA,OAG9B,IAAG,CAAC,OAAyC;AAAA,IACjD,OAAO,OAAO,KAAK,IAAI,KAAK;AAAA;AAAA,OAGxB,YAAW,CAAC,OAAe,SAAoC;AAAA,IACnE,OAAO,OAAO,KAAK,YAAY,OAAO,OAAO;AAAA;AAAA,OAGzC,OAAM,CAAC,OAAe,kBAA6D;AAAA,IACvF,IAAI,kBAAkB;AAAA,MACpB,MAAM,OAAO,KAAK,OAAO,OAAO,gBAAgB;AAAA,IAClD,EAAO;AAAA,MACL,MAAM,OAAO,KAAK,OAAO,KAAK;AAAA;AAAA;AAAA,EAIlC,SAAS,CAAC,UAAgF;AAAA,IACxF,OAAO,KAAK,UAAU,YAAY,QAAQ;AAAA;AAAA,EAG5C,SAAS,CACP,UACM;AAAA,IACN,OAAO,KAAK,UAAU,YAAY,QAAQ;AAAA;AAAA,EAG5C,WAAW,CAAC,UAA2E;AAAA,IACrF,OAAO,KAAK,YAAY,YAAY,QAAQ;AAAA;AAAA,OAGxC,OAAM,CAAC,kBAA0E;AAAA,IACrF,OAAO,OAAO,KAAK,OAAO,gBAAgB;AAAA;AAE9C;;;ACtCO,MAAM,oBAA6C;AAAA,EACxD,WAAW,CAAC,SAAkB,cAA4B;AAAA,IACxD,OAAO,YAAY,SAAS,YAAY;AAAA;AAAA,EAG1C,gBAAgB,CAAC,MAAiB,UAA+C;AAAA,IAC/E,OAAO,iBAAiB,MAAM,QAAyB;AAAA;AAAA,EAGzD,mBAAmB,CAAC,MAAiB,UAA+C;AAAA,IAClF,OAAO,oBAAoB,MAAM,QAAyB;AAAA;AAE9D;;;ACVO,MAAM,oBAA4C;AAAA,EACvD,KAAK,CAAC,OAAqB,MAAuC;AAAA,IAChE,OAAO,MAAM,OAAO,IAAI;AAAA;AAE5B;;;AC8BO,MAAM,qBAA8C;AAAA,EAE/C;AAAA,EACA;AAAA,EACA;AAAA,EAHV,WAAW,CACD,SACA,eACA,SACR;AAAA,IAHQ;AAAA,IACA;AAAA,IACA;AAAA;AAAA,EAGV,KAAK,CAAC,SAAiB,SAAyC;AAAA,IAC9D,KAAK,QAAQ,SAAS,SAAS,OAAO;AAAA;AAAA,EAGxC,IAAI,CAAC,SAAiB,SAAyC;AAAA,IAC7D,KAAK,QAAQ,QAAQ,SAAS,OAAO;AAAA;AAAA,EAGvC,IAAI,CAAC,SAAiB,SAAyC;AAAA,IAC7D,KAAK,QAAQ,QAAQ,SAAS,OAAO;AAAA;AAAA,EAGvC,KAAK,CAAC,SAAiB,OAAe,SAAyC;AAAA,IAC7E,KAAK,QAAQ,SAAS,SAAS,SAAS,KAAK;AAAA;AAAA,EAG/C,GAAG,CAAC,OAAiB,SAAiB,SAAyC;AAAA,IAC7E,KAAK,QAAQ,OAAO,SAAS,OAAO;AAAA;AAAA,EAG9B,OAAO,CACb,OACA,SACA,SACA,OACM;AAAA,IAEN,IAAI,KAAK,SAAS,eAAe;AAAA,MAC/B,MAAM,gBAAgB,QAAQ,UAAU,QAAQ;AAAA,MAChD,cAAc,IAAI,KAAK,kBAAkB,SAAS,WAAW,IAAI,SAAS,EAAE;AAAA,IAC9E;AAAA,IAGA,MAAM,aAAa;AAAA,MACjB,MAAM;AAAA,MACN;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,OAAO;AAAA,MACd,OAAO,OAAO;AAAA,MACd,QAAQ,KAAK;AAAA,MACb,WAAW,KAAK,IAAI;AAAA,IACtB;AAAA,IAGA,KAAK,QAAQ,YAAY,UAAU,EAAE,MAAM,CAAC,cAAc;AAAA,MAExD,IAAI,KAAK,SAAS,sBAAsB,OAAO;AAAA,QAC7C,QAAQ,OAAO,IAAI,KAAK,kBAAkB,WAAW,WAAW,IAAI,SAAS,EAAE;AAAA,QAC/E,QAAQ,KAAK,+BAA+B,SAAS;AAAA,MACvD;AAAA,KACD;AAAA;AAEL;;;AChCO,SAAS,mBAAmB,CAAC,UAA0B,CAAC,GAAkB;AAAA,EAE/E,IAAI,QAAQ,WAAW,QAAQ,MAAM;AAAA,IACnC,OAAO;AAAA,MACL,SAAS,QAAQ;AAAA,MACjB,MAAM,QAAQ;AAAA,IAChB;AAAA,EACF;AAAA,EAGA,MAAM,UAAU,QAAQ,WAAW,qBAAqB;AAAA,EAGxD,IAAI;AAAA,EAEJ,IAAI,QAAQ,MAAM;AAAA,IAChB,OAAO,QAAQ;AAAA,EACjB,EAAO,SAAI,QAAQ,WAAW;AAAA,IAE5B,QAAQ;AAAA,IACR,OAAO,IAAI;AAAA,EACb,EAAO;AAAA,IAEL,OAAO,kBAAkB;AAAA;AAAA,EAG3B,OAAO,EAAE,SAAS,KAAK;AAAA;AAMlB,SAAS,oBAAoB,GAAkB;AAAA,EACpD,QAAQ;AAAA,EACR,QAAQ;AAAA,EAER,OAAO;AAAA,IACL,SAAS,IAAI;AAAA,IACb,MAAM,IAAI;AAAA,EACZ;AAAA;AAMK,SAAS,iBAAiB,CAC/B,UAA0E,CAAC,GAC5D;AAAA,EACf,QAAQ;AAAA,EACR,QAAQ,2DAA6B;AAAA,EAErC,MAAM,UAAU,IAAI,kBAAiB,QAAQ,MAAM;AAAA,EAEnD,MAAM,OAAO,QAAQ,YACjB,IAAI,mBACJ,IAAI,6BAA4B,QAAQ,WAAW;AAAA,EAEvD,OAAO,EAAE,SAAS,KAAK;AAAA;AAMlB,SAAS,kBAAkB,GAAkB;AAAA,EAClD,QAAQ;AAAA,EACR,QAAQ;AAAA,EAER,OAAO;AAAA,IACL,SAAS,IAAI;AAAA,IACb,MAAM,IAAI;AAAA,EACZ;AAAA;AAMK,SAAS,kBAAkB,GAAkB;AAAA,EAClD,QAAQ;AAAA,EACR,QAAQ;AAAA,EAER,OAAO;AAAA,IACL,SAAS,IAAI;AAAA,IACb,MAAM,IAAI;AAAA,EACZ;AAAA;;;ACjHK,SAAS,qBAAoB,CAClC,SACA,SACmB;AAAA,EACnB,MAAM,WAAU,IAAI;AAAA,EAEpB,OAAO;AAAA,IACL;AAAA,IACA,SAAS,IAAI;AAAA,IACb,MAAM,IAAI;AAAA,IACV,QAAQ,IAAI;AAAA,IACZ,WAAW,IAAI;AAAA,IACf,cAAc,IAAI;AAAA,IAClB,OAAO,IAAI;AAAA,IACX,QAAQ,IAAI,qBAAqB,UAAS,SAAS;AAAA,SAC7C,SAAS,kBAAkB,aAAa,EAAE,eAAe,QAAQ,cAAc;AAAA,MACnF,mBAAmB;AAAA,IACrB,CAAC;AAAA,EACH;AAAA;",
+  "mappings": "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",
   "debugId": "ECA51FC90C3C7E8C64756E2164756E21",
   "names": []
 }

package/dist/src/shared/lib/_client-only.d.ts

@@ -0,0 +1,38 @@
+/**
+ * _client-only — Phase 1 prototype for the server-side exclusion mechanism
+ * the plan calls for under risk #4.
+ *
+ * The eventual Phase 2 $meshState primitive must not be importable from
+ * server-side code: the primitive has no server-side semantics (no
+ * decryption keys, no signing identity), and an accidental server import
+ * would be a real bug. The plan asked for a "trivial prototype" early in
+ * Phase 0 to verify the exclusion mechanism works before the real $meshState
+ * needs to rely on it. This file is that prototype.
+ *
+ * Mechanism: the module evaluates a runtime guard at import time. When the
+ * importer's environment lacks `globalThis.window` (i.e. Node, Bun, Deno,
+ * any server-side runtime), the import throws a structured error naming
+ * the file and pointing at the plan risk. The throw fires during module
+ * evaluation, not on first symbol use, so a server-side file that even
+ * declares `import "@/shared/lib/_client-only"` will fail loudly.
+ *
+ * This is a runtime mechanism, not a type-level one. The strong static
+ * guarantee — server code cannot even compile against this module — needs
+ * either TypeScript project references with a separate server tsconfig
+ * that excludes this file, or package.json conditional exports that
+ * resolve to a stub on the server side. Both are real build-config
+ * changes that touch the rest of the codebase. The plan deferred the
+ * type-level enforcement to Phase 2 alongside the actual $meshState
+ * machinery, where it becomes load-bearing rather than speculative.
+ *
+ * Until then, the runtime guard demonstrates that Polly knows how to
+ * forbid server imports of a marked module, and the test next to this
+ * file proves the guard fires under Bun's server-side runtime.
+ */
+/**
+ * A sentinel value the prototype exports so that consumers have something
+ * to import. Production code never reads this; the value exists only so
+ * the module has a non-empty default export and the runtime guard above
+ * has something to gate.
+ */
+export declare const clientOnlyMarker = "polly-client-only-prototype";

package/dist/src/shared/lib/access.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Access — declarative read/write authorisation for Polly's peer-first primitives.
+ *
+ * The new $peerState and $meshState primitives ship with a declarative `access`
+ * option that compiles to server share policies ($peerState), signed-op access sets
+ * ($meshState), or both when $peerState opts in via `sign: true`. Application code
+ * expresses "who can read" and "who can write" as a pair of predicates over an
+ * authenticated peer identity, and Polly enforces the predicates uniformly at every
+ * transport and storage boundary.
+ *
+ * This module defines the types and a small set of primitive factories and
+ * compositors. Primitive constructors in Phase 1 and Phase 2 will consume the
+ * {@link Access} shape; the per-primitive "what does this compile to" resolution
+ * lives in those constructors rather than here, because the target varies by
+ * transport.
+ *
+ * @example
+ * ```ts
+ * import { $peerState } from "@fairfox/polly";
+ * import { ownerAccess } from "@/shared/lib/access";
+ *
+ * const notes = $peerState("notes", defaults, {
+ *   access: ownerAccess("peer-abc123"),
+ * });
+ * ```
+ */
+/**
+ * An authenticated peer's identity as seen by Polly's authorisation layer.
+ *
+ * The shape is intentionally minimal: a stable {@link peerId} plus an optional
+ * metadata bag that the transport's authentication hook can populate with
+ * whatever it knows about the peer (session user id, device type, group
+ * memberships, signing public key, etc.). Applications that need stronger
+ * typing can parameterise {@link Access} on a narrower identity type.
+ */
+export interface PeerIdentity {
+    /** Stable identifier for this peer. Must be unique within the application. */
+    peerId: string;
+    /**
+     * Transport-specific metadata attached by the authentication layer. For
+     * $peerState this is usually session data from the Elysia auth hook; for
+     * $meshState this is usually the peer's verified signing public key and any
+     * group memberships derived from it.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A predicate over peer identities. Returns true if the identity satisfies the
+ * access condition, false otherwise. Predicates must be pure — the same input
+ * produces the same output — so that Polly can cache authorisation decisions
+ * and reason about them in TLA+.
+ */
+export type AccessPredicate<Identity = PeerIdentity> = (identity: Identity) => boolean;
+/**
+ * Declarative read/write access for a single logical document. Every Polly
+ * peer-first primitive that accepts an `access` option expects this shape.
+ *
+ * Read and write are independent: a predicate that returns true for read does
+ * not imply anything about write. Applications that want "if you can write,
+ * you can read" express it explicitly, either by reusing the same predicate
+ * or by composing `read: or(readPred, writePred)`.
+ */
+export interface Access<Identity = PeerIdentity> {
+    read: AccessPredicate<Identity>;
+    write: AccessPredicate<Identity>;
+}
+/**
+ * A predicate that accepts every identity. Useful for public documents and
+ * for the "read" half of write-gated-but-publicly-visible patterns.
+ */
+export declare function anyone<Identity = PeerIdentity>(): AccessPredicate<Identity>;
+/**
+ * A predicate that rejects every identity. Useful as an explicit "no-one can
+ * write to this" marker and as the identity element for `or`.
+ */
+export declare function nobody<Identity = PeerIdentity>(): AccessPredicate<Identity>;
+/**
+ * A predicate that accepts exactly one peer by id.
+ */
+export declare function onlyPeer<Identity extends PeerIdentity = PeerIdentity>(peerId: string): AccessPredicate<Identity>;
+/**
+ * A predicate that accepts any peer whose id is in the given set. The set is
+ * captured at factory time and not re-read, so mutating the input array after
+ * calling this has no effect on the returned predicate.
+ */
+export declare function anyOfPeers<Identity extends PeerIdentity = PeerIdentity>(peerIds: readonly string[]): AccessPredicate<Identity>;
+/**
+ * Logical AND of two predicates. Accepts an identity only if both inputs
+ * accept it. Short-circuits on the first false.
+ */
+export declare function and<Identity>(a: AccessPredicate<Identity>, b: AccessPredicate<Identity>): AccessPredicate<Identity>;
+/**
+ * Logical OR of two predicates. Accepts an identity if either input accepts
+ * it. Short-circuits on the first true.
+ */
+export declare function or<Identity>(a: AccessPredicate<Identity>, b: AccessPredicate<Identity>): AccessPredicate<Identity>;
+/**
+ * Logical NOT of a predicate.
+ */
+export declare function not<Identity>(a: AccessPredicate<Identity>): AccessPredicate<Identity>;
+/**
+ * Public read and write for every peer. The default for documents that are
+ * genuinely shared across everyone in the deployment. Not a sensible default
+ * for $meshState, where the signing layer expects a bounded access set.
+ */
+export declare function publicAccess<Identity extends PeerIdentity = PeerIdentity>(): Access<Identity>;
+/**
+ * Read and write restricted to a single owner peer. The strictest common
+ * shape: a personal-notes document, a single-user setting store, anything
+ * scoped to one device chain.
+ */
+export declare function ownerAccess<Identity extends PeerIdentity = PeerIdentity>(peerId: string): Access<Identity>;
+/**
+ * Read and write restricted to a bounded group of peers. Both halves use the
+ * same predicate, which is usually what groups want; applications that need
+ * "some can read, fewer can write" should construct {@link Access} directly.
+ */
+export declare function groupAccess<Identity extends PeerIdentity = PeerIdentity>(peerIds: readonly string[]): Access<Identity>;
+/**
+ * Everyone can read; only the supplied predicate can write. Common for
+ * broadcast-style documents where one peer (or a group) publishes and the
+ * rest observe.
+ */
+export declare function readOnlyExcept<Identity extends PeerIdentity = PeerIdentity>(writer: AccessPredicate<Identity>): Access<Identity>;

package/dist/src/shared/lib/blob-ref.d.ts

@@ -0,0 +1,72 @@
+/**
+ * BlobRef — content-addressed reference to a binary blob.
+ *
+ * CRDT documents held by `$peerState` and `$meshState` primitives should not embed
+ * large binary payloads directly. The Automerge history grows monotonically with every
+ * op, and embedding a file means every op carries the file, memory explodes, and sync
+ * bandwidth is terrible. The sound pattern is to store a reference to the blob inside
+ * the document and keep the bytes in a separate, content-addressed blob store.
+ *
+ * This module defines the reference shape so that applications can hold `BlobRef`
+ * values inside their `$peerState`/`$meshState` documents from day one. The actual
+ * blob store, the upload/fetch API, and transport-specific blob sync are deliberately
+ * out of scope and will land in a follow-up RFC. Provisioning the type now prevents
+ * a data-model migration when that RFC ships.
+ *
+ * @example
+ * ```ts
+ * const doc = $peerState<Document>("doc", { title: "", attachments: [] });
+ *
+ * const bytes = new Uint8Array(await file.arrayBuffer());
+ * const ref = await createBlobRef({
+ *   bytes,
+ *   filename: file.name,
+ *   mimeType: file.type,
+ * });
+ *
+ * doc.value = {
+ *   ...doc.value,
+ *   attachments: [...doc.value.attachments, ref],
+ * };
+ * ```
+ */
+/**
+ * Content-addressed reference to a binary blob.
+ *
+ * The `hash` field is a hex-encoded SHA-256 digest of the blob's bytes. Two blobs
+ * with identical bytes always produce the same hash, so references can be deduplicated
+ * and the blob store (when it ships) can use the hash as its primary key.
+ */
+export type BlobRef = {
+    /** Hex-encoded SHA-256 digest of the blob's bytes (64 lowercase hex characters). */
+    hash: string;
+    /** Length of the blob in bytes. */
+    size: number;
+    /** Filename as supplied by the originating application. Not used for addressing. */
+    filename: string;
+    /** MIME type as supplied by the originating application. Not used for addressing. */
+    mimeType: string;
+};
+/**
+ * Type guard for {@link BlobRef}. Useful at CRDT document boundaries where values
+ * may have been authored by older clients or by clients running different schemas.
+ */
+export declare function isBlobRef(value: unknown): value is BlobRef;
+/**
+ * Compute the SHA-256 hex digest of a byte sequence. Pure and deterministic.
+ */
+export declare function computeBlobHash(bytes: Uint8Array): Promise<string>;
+/**
+ * Arguments for {@link createBlobRef}.
+ */
+export type CreateBlobRefArgs = {
+    bytes: Uint8Array;
+    filename: string;
+    mimeType: string;
+};
+/**
+ * Build a {@link BlobRef} from raw bytes and metadata. The hash is computed from the
+ * bytes; the filename and mimeType are carried from the originating application
+ * verbatim and do not affect the content address.
+ */
+export declare function createBlobRef({ bytes, filename, mimeType, }: CreateBlobRefArgs): Promise<BlobRef>;