@addonova/browser 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hemanta-gayen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,435 @@
-# Temporary Holding Version
+[![Addonova Browser Social Banner](https://raw.githubusercontent.com/addonova/.github/refs/heads/main/profile/image/addonova_browser_banner.png)](https://github.com/addonova)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Browser extension APIs are similar but not identical. `@addonova/browser`
+normalizes the differences that can be normalized safely:
+
+- one Promise-based method shape for asynchronous APIs;
+- unchanged native events with `addListener`, `removeListener`, and
+  `hasListener`;
+- typed errors for missing APIs, missing permissions, and native failures;
+- support for `chrome`, `chromium`, `edge`, and `firefox` targets;
+- browser-specific entry points for build-time code elimination.
+
+The package does not generate manifests, inject content scripts, grant
+permissions, or emulate an API the browser does not provide. See the verified
+[compatibility matrix](docs/compatibility-matrix.md) for the exact support
+surface.
+
+## Installation
+
+```sh
+npm install @addonova/browser
+```
+
+Requirements:
+
+- ESM bundler or extension runtime with ES module support.
+- Node.js `>=20` for development and the Guchho-based test tooling.
+- No runtime dependency on Addonova Build.
+
+Package entries:
+
+| Import | Purpose |
+| --- | --- |
+| `@addonova/browser` | Runtime browser detection; default fallback. |
+| `@addonova/browser/chrome` | Fixed Chrome target. |
+| `@addonova/browser/chromium` | Fixed Chromium target. |
+| `@addonova/browser/edge` | Fixed Edge target. |
+| `@addonova/browser/firefox` | Fixed Firefox target. |
+
+## Quick start
+
+```ts
+import { action, storage, tabs } from '@addonova/browser';
+
+export async function updateBadge(): Promise<void> {
+  const [tab] = await tabs.query({ active: true, currentWindow: true });
+
+  if (tab?.id === undefined) {
+    return;
+  }
+
+  const { enabled = false } = await storage.local.get('enabled');
+
+  await tabs.sendMessage(tab.id, {
+    type: 'set-enabled',
+    enabled,
+  });
+  await action.setBadgeText({ text: enabled ? 'ON' : '' });
+}
+```
+
+Register listeners at the top level of a service worker or event page:
+
+```ts
+import { runtime } from '@addonova/browser';
+
+runtime.onInstalled.addListener((details) => {
+  console.log('Installed/updated:', details.reason);
+});
+```
+
+## Browser compatibility
+
+The verified matrix is in
+[`docs/compatibility-matrix.md`](docs/compatibility-matrix.md). The short
+version:
+
+- Chrome, Chromium, and Edge share one Chromium adapter. Current stable
+  releases target Manifest V3; legacy MV2 is outside current support scope.
+- Edge legacy MV2 is still in Microsoft's deprecation transition and is
+  conditional.
+- Firefox supports both MV2 and MV3. Firefox MV3 uses `background.scripts`
+  event pages, not a service worker.
+- Firefox 102+ exposes `scripting` in MV2; Chromium MV2 does not.
+- `tabs.executeScript` and blocking `webRequest` APIs are intentionally not
+  exposed. Use `scripting` and observational `webRequest` events instead.
+- Firefox does not support `notifications.update()` or
+  `notifications.onButtonClicked`.
+
+Run `supports()` before using an optional API when an extension must work across
+older browser versions.
+
+## API reference
+
+The root export exposes a `browser` object plus named namespaces:
+
+```ts
+import {
+  action,
+  alarms,
+  bookmarks,
+  browser,
+  browserInfo,
+  commands,
+  contextMenus,
+  cookies,
+  downloads,
+  getAvailability,
+  getBrowserInfo,
+  i18n,
+  isBrowserSupported,
+  notifications,
+  permissions,
+  runtime,
+  scripting,
+  sessions,
+  storage,
+  supports,
+  tabs,
+  webNavigation,
+  webRequest,
+  windows,
+  BrowserApiError,
+} from '@addonova/browser';
+```
+
+| Namespace | Representative methods |
+| --- | --- |
+| `runtime` | `id`, `getManifest`, `getURL`, `sendMessage`, `connect`, events |
+| `storage` | `local`, `sync`, `session`, `managed`, `isAreaAvailable` |
+| `tabs` | `query`, `get`, `create`, `update`, `remove`, `reload`, `sendMessage` |
+| `windows` | `getCurrent`, `create`, `update`, `remove`, `getAll` |
+| `action` | badge text/color, title, icon, `openPopup`, `onClicked` |
+| `alarms` | `create`, `get`, `getAll`, `clear`, `clearAll`, `onAlarm` |
+| `commands` | `getAll`, `onCommand` |
+| `contextMenus` | `create`, `update`, `remove`, `removeAll`, `onClicked` |
+| `notifications` | `create`, `update`, `clear`, `getAll`, events |
+| `permissions` | `contains`, `request`, `remove`, `getAll`, events |
+| `scripting` | `executeScript`, `insertCSS`, `removeCSS` |
+| `bookmarks` | `getTree`, `search`, CRUD, events |
+| `cookies` | `get`, `getAll`, `set`, `remove`, `onChanged` |
+| `downloads` | `download`, `cancel`, `search`, `onChanged` |
+| `sessions` | `getRecentlyClosed`, `restore`, `onChanged` |
+| `webNavigation` | navigation event passthrough |
+| `webRequest` | observational request event passthrough |
+| `i18n` | `getMessage`, `getUILanguage`, `detectLanguage` |
+
+Shared exports:
+
+- `browserInfo`: lazily resolved browser metadata.
+- `getBrowserInfo()`: resolves the browser name, version, engine, and manifest
+  version.
+- `supports('namespace.method')`: boolean feature check.
+- `getAvailability('namespace.method')`: typed availability result with a
+  reason.
+- `isBrowserSupported()`: whether an extension runtime is available.
+- `BrowserApiError`: normalized error class with a `code`.
+- `callbackToPromise`, `promisifyMethod`, and event helpers for advanced
+  integrations.
+
+## TypeScript examples
+
+All public types are exported from the package root.
+
+```ts
+import {
+  BrowserApiError,
+  runtime,
+  storage,
+  type StorageChange,
+} from '@addonova/browser';
+
+interface Settings {
+  enabled: boolean;
+  theme: 'light' | 'dark';
+}
+
+export async function readSettings(): Promise<Settings> {
+  const values = await storage.local.get(['enabled', 'theme']);
+
+  return {
+    enabled: values.enabled === true,
+    theme: values.theme === 'dark' ? 'dark' : 'light',
+  };
+}
+
+storage.onChanged.addListener(
+  (changes: Record<string, StorageChange>, areaName) => {
+    if (areaName !== 'local' || changes.enabled === undefined) {
+      return;
+    }
+
+    console.log('enabled changed:', changes.enabled.newValue);
+  },
+);
+
+export async function sendHello(): Promise<void> {
+  try {
+    await runtime.sendMessage({ type: 'hello' });
+  } catch (error) {
+    if (error instanceof BrowserApiError) {
+      console.error(error.code, error.api, error.message);
+    }
+  }
+}
+```
+
+## Browser detection
+
+```ts
+import { browserInfo, getBrowserInfo } from '@addonova/browser';
+
+console.log(browserInfo.name); // 'chrome' | 'chromium' | 'edge' | 'firefox' | 'unknown'
+console.log(browserInfo.engine); // 'chromium' | 'gecko' | 'unknown'
+
+const info = getBrowserInfo();
+console.log(info);
+```
+
+Detection is feature-first: it checks the extension runtime and API shape before
+parsing the user agent. Outside an extension, the package returns an unknown
+environment instead of throwing at import time.
+
+## 8. Feature detection
+
+```ts
+import { getAvailability, storage, supports } from '@addonova/browser';
+
+if (supports('scripting.executeScript')) {
+  // The native API is present.
+}
+
+const availability = getAvailability('storage.session');
+console.log(availability.available, availability.reason);
+
+if (storage.isAreaAvailable('session')) {
+  await storage.session.set({ draft: 'saved for this browser session' });
+}
+```
+
+`supports()` is a fast capability check. `getAvailability()` explains why a
+capability is unavailable. Accessing a missing method or event throws
+`BrowserApiError` with `BROWSER_UNSUPPORTED_API`.
+
+## 9. Browser-specific adapters
+
+Use the root import for runtime detection, or a fixed subpath when the target is
+known at build time:
+
+```ts
+import { tabs } from '@addonova/browser/chrome';
+```
+
+Chrome, Chromium, and Edge share the Chromium adapter implementation. Firefox
+uses a separate Gecko adapter with native Promises. All entries expose the same
+public surface. Application code should normally import the root; the build
+integration chooses the subpath.
+
+## Browser-specific tree shaking
+
+Use static imports so a bundler can remove unused APIs:
+
+```ts
+import { tabs } from '@addonova/browser';
+
+const [tab] = await tabs.query({ active: true, currentWindow: true });
+```
+
+Aliasing the root to a browser subpath also removes unrelated adapters:
+
+```js
+// Vite-style alias
+resolve: {
+  alias: {
+    '@addonova/browser': '@addonova/browser/chrome',
+  },
+}
+```
+
+The repository verifies real generated bundles with Guchho in
+`tests/build/tree-shaking.test.ts`. A Chrome build retains Chrome plus shared
+Chromium code, a Firefox build retains Firefox code, and an Edge build retains
+Edge plus shared Chromium code. Importing only `tabs` removes unrelated API
+modules. Dynamic access through the `browser` object intentionally retains every
+API. See [`docs/build-integration.md`](docs/build-integration.md).
+
+## Build-time API selection
+
+The optional compile-time definition `__ADDONOVA_BROWSER__` accepts `'chrome'`,
+`'chromium'`, `'firefox'`, `'edge'`, or `'auto'`:
+
+```js
+define: {
+  __ADDONOVA_BROWSER__: '"chrome"',
+}
+```
+
+It makes target-dependent runtime behavior deterministic. It does not replace
+the subpath alias for code elimination. Invalid or missing values fall back to
+`'auto'`.
+
+## Runtime resolution
+
+The default root import resolves the adapter on first use and memoizes it:
+
+1. Read the build-time target, if present.
+2. Detect the extension runtime and browser API shape.
+3. Select Chrome, Chromium, Edge, or Firefox.
+4. Fall back to an unknown environment that reports explicit unsupported errors.
+
+Runtime resolution always remains available. It does not require Addonova Build,
+a define, or an alias. Fixed subpaths skip detection and use their target
+provider directly.
+
+## Manifest compatibility
+
+The library does not create or edit `manifest.json`.
+
+Manifest V3:
+
+```json
+{
+  "manifest_version": 3,
+  "background": { "service_worker": "background.js", "type": "module" },
+  "action": { "default_popup": "popup.html" },
+  "permissions": ["storage", "tabs"],
+  "host_permissions": ["https://example.com/*"]
+}
+```
+
+For Firefox MV3, use an event page instead of a service worker:
+
+```json
+{
+  "manifest_version": 3,
+  "background": { "scripts": ["background.js"] },
+  "action": { "default_popup": "popup.html" },
+  "browser_specific_settings": {
+    "gecko": { "id": "example@addonova.dev" }
+  }
+}
+```
+
+Manifest V2 for Firefox uses `browser_action` or `page_action`, host
+permissions inside `permissions`, and background scripts or a background page.
+Chromium legacy MV2 is outside current support scope; Edge MV2 is conditional.
+See the [compatibility matrix](docs/compatibility-matrix.md) for background
+shapes, `webRequestBlocking`, `scripting`, and host-permission differences.
+
+Register event listeners synchronously at the top level of a service worker or
+event page. Do not wait for asynchronous initialization before registering
+listeners.
+
+## Error handling
+
+```ts
+import { BrowserApiError, runtime } from '@addonova/browser';
+
+try {
+  await runtime.sendMessage({ type: 'ping' });
+} catch (error) {
+  if (error instanceof BrowserApiError) {
+    switch (error.code) {
+      case 'BROWSER_UNSUPPORTED_API':
+      case 'BROWSER_UNSUPPORTED_ENVIRONMENT':
+      case 'BROWSER_PERMISSION_DENIED':
+      case 'BROWSER_API_FAILED':
+        console.error(error.code, error.api, error.message);
+        break;
+    }
+  }
+}
+```
+
+Error codes:
+
+| Code | Meaning |
+| --- | --- |
+| `BROWSER_UNSUPPORTED_API` | Namespace, method, or event is unavailable. |
+| `BROWSER_UNSUPPORTED_ENVIRONMENT` | No extension runtime was detected. |
+| `BROWSER_PERMISSION_DENIED` | The browser reported a permission failure. |
+| `BROWSER_API_FAILED` | A native API failed for another reason. |
+
+No module fakes success, silently no-ops, or falls back to an unrequested API.
+
+## Permissions
+
+Permissions are never requested or granted automatically. Declare static
+permissions in the manifest and request optional permissions from a permitted
+user gesture:
+
+```ts
+import { permissions } from '@addonova/browser';
+
+const granted = await permissions.request({
+  permissions: ['bookmarks'],
+});
+
+if (!granted) {
+  console.warn('Bookmarks permission was not granted.');
+}
+```
+
+Module permission mapping:
+
+| Module | Requirement |
+| --- | --- |
+| `storage` | `storage` |
+| `tabs` | `tabs` for sensitive fields; host permissions for page access |
+| `alarms` | `alarms` |
+| `contextMenus` | `contextMenus` |
+| `notifications` | `notifications` |
+| `bookmarks` | `bookmarks` |
+| `cookies` | `cookies` plus host permissions |
+| `downloads` | `downloads` |
+| `sessions` | `sessions` |
+| `webNavigation` | `webNavigation` |
+| `webRequest` | `webRequest` plus host permissions |
+| `scripting` | `scripting` plus host permissions or `activeTab` |
+| `runtime`, `action`, `commands`, `i18n` | No extra runtime permission |
+
+Static host permissions are granted at install time subject to browser policy.
+`permissions.request()` asks the user; it can return `false` or reject. See
+[`docs/api-compatibility.md`](docs/api-compatibility.md) and the
+[compatibility matrix](docs/compatibility-matrix.md).
+
+Packaging and manual browser smoke-test steps are in
+[`docs/integration-testing.md`](docs/integration-testing.md).
+
+Do not publish to npm without explicit authorization. Security issues should be
+reported according to [`SECURITY`](https://github.com/addonova/.github/blob/main/.github/SECURITY.md).
+
+## License
+
+Addonova is licensed under **MIT**. Copyright © [CodeHemu](https://github.com/code-hemu).

package/dist/adapters/chrome/index.d.ts

@@ -0,0 +1,9 @@
+import type { ManifestVersion } from '../../shared/capabilities.ts';
+import type { BrowserAdapter } from '../types.ts';
+export interface ChromeAdapterOptions {
+    api: unknown;
+    manifestVersion: ManifestVersion | null;
+    callbackBased?: boolean;
+}
+export declare function createChromeAdapter(options: ChromeAdapterOptions): BrowserAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/chrome/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/chrome/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,OAAO,CAAC;IACb,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,cAAc,CAShB"}

package/dist/adapters/chrome/index.js

@@ -0,0 +1,12 @@
+import { createChromiumAdapter } from '../chromium/index.js';
+export function createChromeAdapter(options) {
+    return createChromiumAdapter({
+        target: 'chrome',
+        api: options.api,
+        manifestVersion: options.manifestVersion,
+        ...(options.callbackBased === undefined
+            ? {}
+            : { callbackBased: options.callbackBased }),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/chrome/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/chrome/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,MAAM,UAAU,mBAAmB,CACjC,OAA6B;IAE7B,OAAO,qBAAqB,CAAC;QAC3B,MAAM,EAAE,QAAQ;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;YACrC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/chromium/index.d.ts

@@ -0,0 +1,12 @@
+import type { ManifestVersion } from '../../shared/capabilities.ts';
+import type { BrowserAdapter } from '../types.ts';
+import { type CapabilityOverride } from '../shared/adapter.ts';
+export interface ChromiumAdapterOptions {
+    target: 'chrome' | 'chromium' | 'edge';
+    api: unknown;
+    manifestVersion: ManifestVersion | null;
+    callbackBased?: boolean;
+    overrides?: CapabilityOverride;
+}
+export declare function createChromiumAdapter(options: ChromiumAdapterOptions): BrowserAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/chromium/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/chromium/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,GAAG,EAAE,OAAO,CAAC;IACb,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,cAAc,CAShB"}

package/dist/adapters/chromium/index.js

@@ -0,0 +1,12 @@
+import { createAdapter, } from '../shared/adapter.js';
+export function createChromiumAdapter(options) {
+    return createAdapter({
+        target: options.target,
+        engine: 'chromium',
+        callbackBased: options.callbackBased ?? true,
+        api: options.api,
+        manifestVersion: options.manifestVersion,
+        ...(options.overrides === undefined ? {} : { overrides: options.overrides }),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/chromium/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/chromium/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,GAEd,MAAM,sBAAsB,CAAC;AAU9B,MAAM,UAAU,qBAAqB,CACnC,OAA+B;IAE/B,OAAO,aAAa,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,UAAU;QAClB,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;KAC7E,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/edge/index.d.ts

@@ -0,0 +1,11 @@
+import type { ManifestVersion } from '../../shared/capabilities.ts';
+import type { BrowserAdapter } from '../types.ts';
+import type { CapabilityOverride } from '../shared/adapter.ts';
+export interface EdgeAdapterOptions {
+    api: unknown;
+    manifestVersion: ManifestVersion | null;
+    callbackBased?: boolean;
+    overrides?: CapabilityOverride;
+}
+export declare function createEdgeAdapter(options: EdgeAdapterOptions): BrowserAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/edge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/edge/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,cAAc,CAUhB"}

package/dist/adapters/edge/index.js

@@ -0,0 +1,13 @@
+import { createChromiumAdapter } from '../chromium/index.js';
+export function createEdgeAdapter(options) {
+    return createChromiumAdapter({
+        target: 'edge',
+        api: options.api,
+        manifestVersion: options.manifestVersion,
+        ...(options.callbackBased === undefined
+            ? {}
+            : { callbackBased: options.callbackBased }),
+        ...(options.overrides === undefined ? {} : { overrides: options.overrides }),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/edge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/edge/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAU7D,MAAM,UAAU,iBAAiB,CAC/B,OAA2B;IAE3B,OAAO,qBAAqB,CAAC;QAC3B,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS;YACrC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QAC7C,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;KAC7E,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/firefox/index.d.ts

@@ -0,0 +1,10 @@
+import type { ManifestVersion } from '../../shared/capabilities.ts';
+import type { BrowserAdapter } from '../types.ts';
+import { type CapabilityOverride } from '../shared/adapter.ts';
+export interface FirefoxAdapterOptions {
+    api: unknown;
+    manifestVersion: ManifestVersion | null;
+    overrides?: CapabilityOverride;
+}
+export declare function createFirefoxAdapter(options: FirefoxAdapterOptions): BrowserAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/firefox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/firefox/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,OAAO,CAAC;IACb,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAShB"}

package/dist/adapters/firefox/index.js

@@ -0,0 +1,12 @@
+import { createAdapter, } from '../shared/adapter.js';
+export function createFirefoxAdapter(options) {
+    return createAdapter({
+        target: 'firefox',
+        engine: 'gecko',
+        callbackBased: false,
+        api: options.api,
+        manifestVersion: options.manifestVersion,
+        ...(options.overrides === undefined ? {} : { overrides: options.overrides }),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/firefox/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/firefox/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,GAEd,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,UAAU,oBAAoB,CAClC,OAA8B;IAE9B,OAAO,aAAa,CAAC;QACnB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,OAAO;QACf,aAAa,EAAE,KAAK;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;KAC7E,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/shared/adapter.d.ts

@@ -0,0 +1,13 @@
+import type { ApiAvailability, BrowserEngine, BrowserTarget, CapabilityQuery, ManifestVersion } from '../../shared/capabilities.ts';
+import type { BrowserAdapter } from '../types.ts';
+export type CapabilityOverride = (query: CapabilityQuery, availability: ApiAvailability) => ApiAvailability;
+export interface CreateAdapterOptions {
+    target: BrowserTarget;
+    engine: BrowserEngine;
+    callbackBased: boolean;
+    api: unknown;
+    manifestVersion: ManifestVersion | null;
+    overrides?: CapabilityOverride;
+}
+export declare function createAdapter(options: CreateAdapterOptions): BrowserAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/shared/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/shared/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,eAAe,KAC1B,eAAe,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,cAAc,CAuBhB"}

package/dist/adapters/shared/adapter.js

@@ -0,0 +1,24 @@
+import { detectAvailability, readNamespace } from './namespace.js';
+export function createAdapter(options) {
+    const availability = (query) => {
+        const detected = detectAvailability(options.api, query);
+        return options.overrides === undefined
+            ? detected
+            : options.overrides(query, detected);
+    };
+    return {
+        target: options.target,
+        engine: options.engine,
+        manifestVersion: options.manifestVersion,
+        callbackBased: options.callbackBased,
+        api: options.api,
+        namespace(name) {
+            return readNamespace(options.api, name);
+        },
+        supports(query) {
+            return availability(query).available;
+        },
+        availability,
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/shared/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/shared/adapter.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAgBnE,MAAM,UAAU,aAAa,CAC3B,OAA6B;IAE7B,MAAM,YAAY,GAAG,CAAC,KAAsB,EAAmB,EAAE;QAC/D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAExD,OAAO,OAAO,CAAC,SAAS,KAAK,SAAS;YACpC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,SAAS,CAAc,IAAY;YACjC,OAAO,aAAa,CAAI,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,QAAQ,CAAC,KAAsB;YAC7B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC;QACvC,CAAC;QACD,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/adapters/shared/namespace.d.ts

@@ -0,0 +1,4 @@
+import type { ApiAvailability, CapabilityQuery } from '../../shared/capabilities.ts';
+export declare function readNamespace<T = unknown>(api: unknown, name: string): T | undefined;
+export declare function detectAvailability(api: unknown, query: CapabilityQuery): ApiAvailability;
+//# sourceMappingURL=namespace.d.ts.map

package/dist/adapters/shared/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/adapters/shared/namespace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAChB,MAAM,8BAA8B,CAAC;AAGtC,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS,CAIf;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,eAAe,GACrB,eAAe,CAgBjB"}