@extension-report/wxt

Small WXT adapter for @extension-report/js.

Install

pnpm add @extension-report/[email protected] @extension-report/[email protected]

For store builds, pin exact versions in package.json, keep every @extension-report/* package on the same version, and run npx @extension-report/[email protected] against the built manifest before every submission. The store-validation runbook is in the repository docs: https://github.com/Amorem/extension.report/blob/main/docs/sdk-store-validation.md.

WXT Module

// wxt.config.ts
export default defineConfig({
  modules: ["@extension-report/wxt/module"],
  extensionReport: {
    publicKey: "pk_er_...",
  },
});

The module adds the required storage and alarms permissions plus the Extension Report API host permission to the generated manifest. If your project does not have a background entrypoint, set autoBackground: true to generate one during prepare/build.

Manual Background

// entrypoints/background.ts
import { defineBackground } from "wxt/utils/define-background";
import { initExtensionReportWxt } from "@extension-report/wxt";

export default defineBackground(() => {
  const sdk = initExtensionReportWxt({
    projectPublicKey: "pk_er_...",
  });

  return sdk;
});

Popup, Options, Or Side Panel

// entrypoints/popup/main.ts
import { connectExtensionReportWxtUiSession } from "@extension-report/wxt";

connectExtensionReportWxtUiSession({
  surface: "popup",
  entrypoint: "action_icon",
});

The adapter does not wrap WXT internals. It keeps the SDK as the only telemetry engine and only provides WXT-named entrypoint helpers.