Beacon

bun add @absolutejs/beacon

import { initBeacon, captureException } from "@absolutejs/beacon";

initBeacon({
  project: "web",
  endpoint: "https://api.example.com/ingest",
  release: import.meta.env.VITE_RELEASE,
  environment: "production",
  // Optional: detect a tab that stayed open across a deployment. The endpoint
  // may return either `{ commit: "..." }` or `{ release: "..." }`.
  releaseProbe: {
    endpoint: "/version",
    onStale: () => window.location.reload(),
  },
});

// Uncaught errors + unhandled rejections are captured automatically.
// Manual capture anywhere:
try {
  await checkout();
} catch (e) {
  captureException(e, { tags: { component: "billing" } });
}

import { createBeacon } from "@absolutejs/beacon";
const beacon = createBeacon({ project: "web" });
beacon.setUser({ id: currentUserId });
beacon.captureMessage("checkout started", "info");

import { installEarlyLayoutShiftBuffer } from "@absolutejs/beacon/early";

installEarlyLayoutShiftBuffer();

createBeacon(options) => Beacon
initBeacon(options)   => Beacon   // also sets the global singleton
getBeacon()           => Beacon | undefined

// Beacon:
captureException(error, { groupingKey?, level?, traceId?, spanId?, tags?, extra? })
captureMessage(message, level?, { groupingKey?, traceId?, spanId?, tags?, extra? })
addBreadcrumb({ message, type?, data? })
setTags(tags) · setUser(user | null)
observeCapability(name, promise) => Promise
flush() => Promise<void>          // buffered events out now
close() => Promise<void>          // remove listeners + final flush

// Typed names for event.tags.signal in beforeSend policies (all built-ins):
BEACON_SIGNAL.FETCH_FAILED
BEACON_SIGNAL.SLOW_RESPONSE
BEACON_SIGNAL.HTTP_5XX
BEACON_SIGNAL.HTTP_RESPONSE_FAILURE
BEACON_TRACE_HEADER // "x-absolute-trace-id"

// Global helpers (no-op until initBeacon): captureException, captureMessage,
// addBreadcrumb, observeCapability

import { captureException, initBeacon } from '@absolutejs/beacon';

initBeacon({
	endpoint: 'https://api.example.com/ingest',
	environment: 'production',
	project: 'web',
	release: import.meta.env.VITE_RELEASE
});

// Uncaught errors + unhandled rejections are captured automatically.
// Manual capture anywhere:
try {
	await checkout();
} catch (e) {
	captureException(e, { tags: { component: 'billing' } });
}

import { createBeacon } from '@absolutejs/beacon';

const beacon = createBeacon({ project: 'web' });
beacon.setUser({ id: currentUserId });
beacon.captureMessage('checkout started', 'info');

// Buffered events out now:
await beacon.flush();
// Remove listeners + final flush:
await beacon.close();