@sazabi/browser-sdk

Sazabi's browser observability SDK: a lightweight semantic event stream (errors, clicks, SPA navigation, network) with W3C trace-context propagation, so frontend events correlate to backend logs by trace_id. Session replay lands as a later, optional evidence layer.

import { init, identify, addEvent } from "@sazabi/browser-sdk";

init({
  publicKey: "sazabi_public_...",
  intakeHost: "https://web.<region>.intake.sazabi.com",
  serviceName: "my-web-app",
});

identify("user_123", { plan: "pro" });
addEvent("checkout_started", { cartValue: 42 });

Development

Tool versions are pinned via mise (.tool-versions).

bun install
bun run test        # Vitest browser mode (real Chromium; `bunx playwright install chromium` once)
bun run typecheck
bun run lint
bun run build       # ESM bundle + type declarations into dist/

Design context lives in the Sazabi monorepo: docs/design/app/frontend-observability/design.md. Agent-facing conventions: CLAUDE.md.