@extension-report/js

Telemetry SDK for https://extension.report.

Install

pnpm add @extension-report/js

Quick start (background / service worker)

import { init } from "@extension-report/js";

const sdk = init({
  projectPublicKey: "pk_er_..."
});

await sdk.registerExtensionLifecycle();
await sdk.trackBgWake("startup");

What this enables automatically

• installs, updates, version tracking
• active users (daily heartbeat)
• uninstall tracking (after the first event is sent)
• live view (events appear as they arrive)

What you should call to unlock the rest

• UI usage: trackUiOpen, trackUiAction, trackUiClose
• Content scripts: trackCsInjected, trackCsAction
• Errors: trackError
• Daily usage counters: incrementCounter

Manifest requirements

{
  "permissions": ["storage", "alarms"],
  "host_permissions": ["https://extension.report/*"],
  "background": { "service_worker": "background.js", "type": "module" }
}

Notes

• The SDK keeps a persistent queue and sends batches with retry/backoff.
• If your UI or content scripts run in another context, send a message to the background to call the SDK there.