@opentabs-dev/browser-extension 0.0.34

package/dist/dispatch-helpers.js

@@ -0,0 +1,149 @@
+import { JSONRPC_ADAPTER_NOT_READY, JSONRPC_INTERNAL_ERROR, JSONRPC_NO_USABLE_TAB } from './json-rpc-errors.js';
+import { sendToServer } from './messaging.js';
+import { getPluginMeta } from './plugin-storage.js';
+import { sanitizeErrorMessage } from './sanitize-error.js';
+import { findAllMatchingTabs, urlMatchesPatterns } from './tab-matching.js';
+import { toErrorMessage } from '@opentabs-dev/shared';
+/**
+ * Whether a DispatchResult is an adapter-not-ready error (JSONRPC_ADAPTER_NOT_READY)
+ * that should trigger fallback to the next matching tab.
+ */
+const isAdapterNotReady = (result) => result.type === 'error' && result.code === JSONRPC_ADAPTER_NOT_READY;
+/**
+ * Look up plugin metadata by name.
+ * Sends a JSONRPC_INTERNAL_ERROR via sendToServer if the plugin is not found.
+ * Returns the plugin metadata on success, or null on failure.
+ */
+const resolvePlugin = async (pluginName, id) => {
+    const plugin = await getPluginMeta(pluginName);
+    if (!plugin) {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_INTERNAL_ERROR, message: `Plugin "${pluginName}" not found` },
+            id,
+        });
+        return null;
+    }
+    return plugin;
+};
+/**
+ * Execute a chrome.scripting.executeScript call with a timeout and extract
+ * the first result. Returns a DispatchResult on success, or throws if the
+ * tab is inaccessible (e.g., closed).
+ *
+ * @param scriptPromise - The promise returned by chrome.scripting.executeScript
+ * @param timeoutMs - Timeout in milliseconds (defaults to SCRIPT_TIMEOUT_MS)
+ * @param fallbackMessage - Error message when no result is returned
+ */
+const executeWithTimeout = async (scriptPromise, timeoutMs, fallbackMessage) => {
+    let timeoutId;
+    const timeoutPromise = new Promise((_resolve, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`Script execution timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    let results;
+    try {
+        results = await Promise.race([scriptPromise, timeoutPromise]);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    const firstResult = results[0];
+    const result = firstResult?.result;
+    if (!result || typeof result !== 'object' || !('type' in result)) {
+        return { type: 'error', code: JSONRPC_INTERNAL_ERROR, message: fallbackMessage };
+    }
+    return result;
+};
+/**
+ * Find matching tabs and iterate through them in ranked order, executing the
+ * given callback on each. Handles TOCTOU URL revalidation, adapter-not-ready
+ * fallback to the next tab, tab-gone detection, and error response routing.
+ *
+ * Sends the JSON-RPC response to the server and returns void.
+ */
+const dispatchWithTabFallback = async (config) => {
+    const { id, pluginName, plugin, operationName, executeOnTab } = config;
+    const matchingTabs = await findAllMatchingTabs(plugin);
+    if (matchingTabs.length === 0) {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_NO_USABLE_TAB, message: `No matching tab for plugin "${pluginName}" (state: closed)` },
+            id,
+        });
+        return;
+    }
+    let firstError;
+    for (const tab of matchingTabs) {
+        if (tab.id === undefined)
+            continue;
+        // Re-validate tab URL to prevent TOCTOU race: the tab may have navigated
+        // between findAllMatchingTabs() and now.
+        try {
+            const currentTab = await chrome.tabs.get(tab.id);
+            if (!currentTab.url || !urlMatchesPatterns(currentTab.url, plugin.urlPatterns)) {
+                firstError ??= { code: JSONRPC_NO_USABLE_TAB, message: 'Tab navigated away from matching URL' };
+                continue;
+            }
+        }
+        catch {
+            firstError ??= { code: JSONRPC_NO_USABLE_TAB, message: `Tab closed before ${operationName}` };
+            continue;
+        }
+        try {
+            const result = await executeOnTab(tab.id);
+            if (result.type === 'success') {
+                sendToServer({ jsonrpc: '2.0', result: { output: result.output }, id });
+                return;
+            }
+            // Adapter-not-ready errors trigger fallback to the next matching tab
+            if (isAdapterNotReady(result) && matchingTabs.length > 1) {
+                firstError ??= { code: result.code, message: sanitizeErrorMessage(result.message) };
+                continue;
+            }
+            sendToServer({
+                jsonrpc: '2.0',
+                error: { code: result.code, message: sanitizeErrorMessage(result.message), data: result.data },
+                id,
+            });
+            return;
+        }
+        catch (err) {
+            const msg = toErrorMessage(err);
+            const isTabGone = msg.includes('No tab with id') || msg.includes('Cannot access');
+            if (isTabGone && matchingTabs.length > 1) {
+                firstError ??= { code: JSONRPC_NO_USABLE_TAB, message: `Tab closed before ${operationName}` };
+                continue;
+            }
+            sendToServer({
+                jsonrpc: '2.0',
+                error: {
+                    code: isTabGone ? JSONRPC_NO_USABLE_TAB : JSONRPC_INTERNAL_ERROR,
+                    message: isTabGone
+                        ? `Tab closed before ${operationName}`
+                        : `Script execution failed: ${sanitizeErrorMessage(msg)}`,
+                },
+                id,
+            });
+            return;
+        }
+    }
+    // All matching tabs failed — return the error from the best-ranked tab
+    if (firstError) {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: firstError.code, message: firstError.message, data: firstError.data },
+            id,
+        });
+    }
+    else {
+        sendToServer({
+            jsonrpc: '2.0',
+            error: { code: JSONRPC_NO_USABLE_TAB, message: 'No usable tab found (all matching tabs have undefined IDs)' },
+            id,
+        });
+    }
+};
+export { dispatchWithTabFallback, executeWithTimeout, resolvePlugin, isAdapterNotReady };
+//# sourceMappingURL=dispatch-helpers.js.map

package/dist/dispatch-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-helpers.js","sourceRoot":"","sources":["../src/dispatch-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAChH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAgBtD;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CAAC,MAAsB,EAAW,EAAE,CAC5D,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAyB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,aAAa,GAAG,KAAK,EAAE,UAAkB,EAAE,EAAmB,EAA8B,EAAE;IAClG,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,YAAY,CAAC;YACX,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,WAAW,UAAU,aAAa,EAAE;YACpF,EAAE;SACH,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,kBAAkB,GAAG,KAAK,EAC9B,aAA0D,EAC1D,SAAiB,EACjB,eAAuB,EACE,EAAE;IAC3B,IAAI,SAAoD,CAAC;IAEzD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC7D,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,SAAS,IAAI,CAAC,CAAC,CAAC;QACvE,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,IAAI,OAA2C,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAChE,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAqC,CAAC;IACnE,MAAM,MAAM,GAAG,WAAW,EAAE,MAAoC,CAAC;IAEjE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACnF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAaF;;;;;;GAMG;AACH,MAAM,uBAAuB,GAAG,KAAK,EAAE,MAAyB,EAAiB,EAAE;IACjF,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAEvE,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,YAAY,CAAC;YACX,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,+BAA+B,UAAU,mBAAmB,EAAE;YAC7G,EAAE;SACH,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,UAMS,CAAC;IAEd,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS;YAAE,SAAS;QAEnC,yEAAyE;QACzE,yCAAyC;QACzC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/E,UAAU,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;gBAChG,SAAS;YACX,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,qBAAqB,aAAa,EAAE,EAAE,CAAC;YAC9F,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAE1C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC9B,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;gBACxE,OAAO;YACT,CAAC;YAED,qEAAqE;YACrE,IAAI,iBAAiB,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzD,UAAU,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpF,SAAS;YACX,CAAC;YAED,YAAY,CAAC;gBACX,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;gBAC9F,EAAE;aACH,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YAClF,IAAI,SAAS,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,UAAU,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,qBAAqB,aAAa,EAAE,EAAE,CAAC;gBAC9F,SAAS;YACX,CAAC;YACD,YAAY,CAAC;gBACX,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,sBAAsB;oBAChE,OAAO,EAAE,SAAS;wBAChB,CAAC,CAAC,qBAAqB,aAAa,EAAE;wBACtC,CAAC,CAAC,4BAA4B,oBAAoB,CAAC,GAAG,CAAC,EAAE;iBAC5D;gBACD,EAAE;aACH,CAAC,CAAC;YACH,OAAO;QACT,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,IAAI,UAAU,EAAE,CAAC;QACf,YAAY,CAAC;YACX,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE;YACpF,EAAE;SACH,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,YAAY,CAAC;YACX,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,4DAA4D,EAAE;YAC7G,EAAE;SACH,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAEF,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/extension-messages.d.ts

@@ -0,0 +1,146 @@
+import type { TabState, TrustTier, WireToolDef } from '@opentabs-dev/shared';
+/** Offscreen → Background: request the MCP server WebSocket URL */
+export interface OffscreenGetUrlMessage {
+    type: 'offscreen:getUrl';
+}
+/** Reason the WebSocket disconnected — enables distinct error states in the side panel */
+export type DisconnectReason = 'connection_refused' | 'auth_failed' | 'timeout';
+/** Background → Offscreen: WebSocket connection state changed */
+export interface WsStateMessage {
+    type: 'ws:state';
+    connected: boolean;
+    /** Present only when connected is false — indicates why the connection failed */
+    disconnectReason?: DisconnectReason;
+}
+/** Background/Offscreen: relay a JSON-RPC message from the MCP server */
+export interface WsDataMessage {
+    type: 'ws:message';
+    data: Record<string, unknown>;
+}
+/** Offscreen/Side panel → Background → Offscreen: send a JSON-RPC message to the MCP server */
+export interface WsSendMessage {
+    type: 'ws:send';
+    data: unknown;
+}
+/** Background → Offscreen: query WebSocket connection state */
+export interface WsGetStateMessage {
+    type: 'ws:getState';
+}
+/** Background → Offscreen: change the MCP server WebSocket URL */
+export interface WsSetUrlMessage {
+    type: 'ws:setUrl';
+    url: string;
+}
+/** Side panel → Background: send a JSON-RPC message to the MCP server */
+export interface BgSendMessage {
+    type: 'bg:send';
+    data: unknown;
+}
+/** Side panel → Background: query WebSocket connection state */
+export interface BgGetConnectionStateMessage {
+    type: 'bg:getConnectionState';
+}
+/** Background → Offscreen: request log entries from the offscreen LogCollector */
+export interface OffscreenGetLogsMessage {
+    type: 'offscreen:getLogs';
+    options?: {
+        level?: 'log' | 'warn' | 'error' | 'info';
+        source?: 'background' | 'offscreen' | 'side-panel';
+        since?: number;
+        limit?: number;
+    };
+}
+/** Background → Offscreen: force WebSocket disconnect and immediate reconnect */
+export interface BgForceReconnectMessage {
+    type: 'bg:forceReconnect';
+}
+/** Background → Side panel: request current React state and rendered HTML */
+export interface SpGetStateMessage {
+    type: 'sp:getState';
+}
+/** Background → Side panel: WebSocket connection state update */
+export interface SpConnectionStateMessage {
+    type: 'sp:connectionState';
+    data: {
+        connected: boolean;
+        disconnectReason?: DisconnectReason;
+    };
+}
+/** Content script relay → Background: batched plugin log entries from adapter IIFE */
+export interface PluginLogsMessage {
+    type: 'plugin:logs';
+    plugin: string;
+    entries: Array<{
+        level: string;
+        message: string;
+        data: unknown[];
+        ts: string;
+    }>;
+}
+/** Background → Side panel: forwarded JSON-RPC message from the MCP server */
+export interface SpRelayMessage {
+    type: 'sp:serverMessage';
+    data: Record<string, unknown>;
+}
+/** Content script relay → Background: tool progress notification from adapter IIFE */
+export interface ToolProgressMessage {
+    type: 'tool:progress';
+    dispatchId: string;
+    progress: number;
+    total: number;
+    message?: string;
+}
+/** Background → Side panel: confirmation request from MCP server */
+export interface SpConfirmationRequestMessage {
+    type: 'sp:confirmationRequest';
+    data: {
+        id: string;
+        tool: string;
+        domain: string | null;
+        tabId?: number;
+        paramsPreview: string;
+        timeoutMs: number;
+    };
+}
+/** Side panel → Background: confirmation response from user */
+export interface SpConfirmationResponseMessage {
+    type: 'sp:confirmationResponse';
+    data: {
+        id: string;
+        decision: 'allow_once' | 'allow_always' | 'deny';
+        scope?: 'tool_domain' | 'tool_all' | 'domain_all';
+    };
+}
+/** Side panel → Background: confirmation timed out without user response */
+export interface SpConfirmationTimeoutMessage {
+    type: 'sp:confirmationTimeout';
+    id: string;
+}
+/** Side panel → Background → Offscreen: MCP server port changed */
+export interface PortChangedMessage {
+    type: 'port-changed';
+    port: number;
+}
+/** All internal message types flowing through chrome.runtime.sendMessage */
+export type InternalMessage = OffscreenGetUrlMessage | WsStateMessage | WsDataMessage | WsSendMessage | WsGetStateMessage | WsSetUrlMessage | BgSendMessage | BgGetConnectionStateMessage | OffscreenGetLogsMessage | BgForceReconnectMessage | PluginLogsMessage | ToolProgressMessage | SpGetStateMessage | SpConnectionStateMessage | SpRelayMessage | SpConfirmationRequestMessage | SpConfirmationResponseMessage | SpConfirmationTimeoutMessage | PortChangedMessage;
+/** Tab state info for a single plugin — shared shape used by tab.stateChanged payloads */
+export interface PluginTabStateInfo {
+    state: TabState;
+    tabId: number | null;
+    url: string | null;
+}
+/** Lightweight plugin metadata stored in the `plugins_meta` index (no IIFE content) */
+export interface PluginMeta {
+    name: string;
+    version: string;
+    displayName: string;
+    urlPatterns: string[];
+    trustTier: TrustTier;
+    sourcePath?: string;
+    adapterHash?: string;
+    adapterFile?: string;
+    iconSvg?: string;
+    iconInactiveSvg?: string;
+    tools: WireToolDef[];
+}
+//# sourceMappingURL=extension-messages.d.ts.map

package/dist/extension-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-messages.d.ts","sourceRoot":"","sources":["../src/extension-messages.ts"],"names":[],"mappings":"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"}

package/dist/extension-messages.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension-messages.js.map

package/dist/extension-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-messages.js","sourceRoot":"","sources":["../src/extension-messages.ts"],"names":[],"mappings":""}

package/dist/iife-injection.d.ts

@@ -0,0 +1,55 @@
+declare const isSafePluginName: (name: string) => boolean;
+/**
+ * Verify that the injected adapter reports the expected version.
+ * Returns true if versions match, false on mismatch or failure.
+ * Logs a warning on mismatch so the injection pipeline continues.
+ */
+declare const verifyAdapterVersion: (tabId: number, pluginName: string, expectedVersion: string) => Promise<boolean>;
+/**
+ * Collect all unique tab IDs matching the given URL patterns.
+ * Queries each pattern independently and deduplicates by tab ID.
+ */
+declare const queryMatchingTabIds: (urlPatterns: string[]) => Promise<number[]>;
+/**
+ * Call an adapter's teardown() function in a tab via chrome.scripting.executeScript.
+ * Swallows errors — the injection pipeline continues regardless of teardown outcome.
+ */
+declare const teardownAdapterInTab: (tabId: number, pluginName: string) => Promise<void>;
+/**
+ * Injects a plugin's adapter IIFE into all tabs matching its URL patterns.
+ *
+ * @param pluginName - The plugin's unique name (validated against reserved names)
+ * @param urlPatterns - Chrome match patterns identifying which tabs to inject into
+ * @param forceReinject - When `true`, re-inject even if the adapter is already
+ *   present (used by plugin.update to overwrite stale adapter code). When `false`
+ *   (default), tabs that already have the adapter are skipped.
+ * @param version - Expected adapter version string for post-injection verification
+ * @param adapterHash - Expected content hash for post-injection integrity check
+ * @param adapterFile - Relative path to the content-hashed adapter file (e.g., "adapters/my-plugin-a1b2c3d4.js")
+ * @returns Tab IDs where injection succeeded
+ */
+declare const injectPluginIntoMatchingTabs: (pluginName: string, urlPatterns: string[], forceReinject?: boolean, version?: string, adapterHash?: string, adapterFile?: string) => Promise<number[]>;
+/**
+ * Injects all stored plugins whose URL patterns match the given tab.
+ * Called on `chrome.tabs.onUpdated` (status=complete) so that tabs opened
+ * after `sync.full` still get their adapter files.
+ *
+ * @param tabId - The Chrome tab ID to inject adapters into
+ * @param tabUrl - The tab's current URL, used to filter plugins by URL pattern match
+ */
+declare const injectPluginsIntoTab: (tabId: number, tabUrl: string) => Promise<void>;
+/**
+ * Removes an injected adapter from all tabs matching the plugin's URL patterns.
+ * Calls the adapter's `teardown()` function and deletes it from `__openTabs.adapters`.
+ *
+ * @param pluginName - The plugin whose adapter should be removed
+ * @param urlPatterns - Chrome match patterns identifying which tabs to clean up
+ */
+declare const cleanupAdaptersInMatchingTabs: (pluginName: string, urlPatterns: string[]) => Promise<void>;
+/**
+ * Re-injects all stored plugins into their matching tabs on extension startup.
+ * Runs all plugin injections in parallel, logging warnings for any failures.
+ */
+declare const reinjectStoredPlugins: () => Promise<void>;
+export { cleanupAdaptersInMatchingTabs, injectPluginIntoMatchingTabs, injectPluginsIntoTab, isSafePluginName, queryMatchingTabIds, reinjectStoredPlugins, teardownAdapterInTab, verifyAdapterVersion, };
+//# sourceMappingURL=iife-injection.d.ts.map

package/dist/iife-injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iife-injection.d.ts","sourceRoot":"","sources":["../src/iife-injection.ts"],"names":[],"mappings":"AAQA,QAAA,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,OAA+D,CAAC;AAwBzG;;;;GAIG;AACH,QAAA,MAAM,oBAAoB,GAAU,OAAO,MAAM,EAAE,YAAY,MAAM,EAAE,iBAAiB,MAAM,KAAG,OAAO,CAAC,OAAO,CA0B/G,CAAC;AA0KF;;;GAGG;AACH,QAAA,MAAM,mBAAmB,GAAU,aAAa,MAAM,EAAE,KAAG,OAAO,CAAC,MAAM,EAAE,CAe1E,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,oBAAoB,GAAU,OAAO,MAAM,EAAE,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CAuBnF,CAAC;AA2DF;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,4BAA4B,GAChC,YAAY,MAAM,EAClB,aAAa,MAAM,EAAE,EACrB,uBAAqB,EACrB,UAAU,MAAM,EAChB,cAAc,MAAM,EACpB,cAAc,MAAM,KACnB,OAAO,CAAC,MAAM,EAAE,CAoClB,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,oBAAoB,GAAU,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAqC/E,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,6BAA6B,GAAU,YAAY,MAAM,EAAE,aAAa,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAuDpG,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,qBAAqB,QAAa,OAAO,CAAC,IAAI,CAwBnD,CAAC;AAEF,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,CAAC"}