@kubit-ai/sentry 0.1.0

package/dist/sentryToOtel.js

@@ -0,0 +1,316 @@
+"use strict";
+/**
+ * Sentry `Event` -> OTLP/HTTP+JSON (`ExportTraceServiceRequest`).
+ *
+ * Two entry points behind one dispatcher (`sentryEventToOtlp`):
+ *   - transactions (`event.type === 'transaction'`) -> spans (root from
+ *     `contexts.trace`, one child per `event.spans[]`).
+ *   - errors (everything else) -> a single span carrying an `exception` span
+ *     event per `exception.values[]`, with `status.code = ERROR`.
+ *
+ * Pure functions — no Sentry SDK calls, no I/O, no randomness. Error events
+ * without a trace context are anchored on the Sentry `event_id` (a 32-hex
+ * string, valid as an OTLP trace id) so the transform stays deterministic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sentryEventToOtlp = exports.sentryErrorToOtlp = exports.sentryTransactionToOtlp = void 0;
+const SCOPE_NAME = "kubit.sentry";
+const SCOPE_VERSION = "0.1.0";
+const SPAN_KIND_INTERNAL = 1;
+// OTel Status enum
+const STATUS_UNSET = 0;
+const STATUS_OK = 1;
+const STATUS_ERROR = 2;
+const STATUS_ERROR_VALUES = new Set([
+    "cancelled",
+    "unknown",
+    "unknown_error",
+    "invalid_argument",
+    "deadline_exceeded",
+    "not_found",
+    "already_exists",
+    "permission_denied",
+    "resource_exhausted",
+    "failed_precondition",
+    "aborted",
+    "out_of_range",
+    "unimplemented",
+    "internal_error",
+    "unavailable",
+    "data_loss",
+    "unauthenticated",
+]);
+const mapStatus = (status) => {
+    if (status === "ok") {
+        return STATUS_OK;
+    }
+    if (status !== undefined && STATUS_ERROR_VALUES.has(status)) {
+        return STATUS_ERROR;
+    }
+    return STATUS_UNSET;
+};
+/**
+ * Seconds-float -> integer-nanosecond string. Computed as whole seconds plus
+ * padded fractional nanos rather than `seconds * 1e9`: the product (~1.7e18)
+ * exceeds Number.MAX_SAFE_INTEGER and would quantize timestamps to ~256 ns,
+ * distorting sub-microsecond span durations.
+ */
+const toUnixNano = (secondsFloat) => {
+    if (typeof secondsFloat !== "number" ||
+        !Number.isFinite(secondsFloat) ||
+        secondsFloat < 0) {
+        return "0";
+    }
+    let seconds = Math.floor(secondsFloat);
+    let nanos = Math.round((secondsFloat - seconds) * 1e9);
+    if (nanos >= 1e9) {
+        seconds += 1;
+        nanos = 0;
+    }
+    return seconds === 0
+        ? nanos.toString()
+        : `${seconds}${nanos.toString().padStart(9, "0")}`;
+};
+const toAnyValue = (value) => {
+    if (typeof value === "string") {
+        return { stringValue: value };
+    }
+    if (typeof value === "boolean") {
+        return { boolValue: value };
+    }
+    if (typeof value === "number") {
+        return Number.isInteger(value)
+            ? { intValue: Math.trunc(value).toString() }
+            : { doubleValue: value };
+    }
+    if (Array.isArray(value)) {
+        const values = value
+            .map(toAnyValue)
+            .filter((v) => v !== null);
+        return { arrayValue: { values } };
+    }
+    if (value === null || value === undefined) {
+        return null;
+    }
+    // Plain objects -> OTLP kvlistValue (recursively), so nested structure reaches
+    // the collector as real key/values instead of a JSON string. This is what lets
+    // e.g. each item in a `product_items` array arrive as an object, not a string.
+    // Arrays and scalars are already handled above.
+    if (typeof value === "object") {
+        const values = [];
+        for (const [key, child] of Object.entries(value)) {
+            const childValue = toAnyValue(child);
+            if (childValue !== null) {
+                values.push({ key, value: childValue });
+            }
+        }
+        return { kvlistValue: { values } };
+    }
+    // Non-object, non-scalar leftovers (bigint, symbol, function) -> string.
+    try {
+        return { stringValue: JSON.stringify(value) };
+    }
+    catch {
+        return { stringValue: "[uncoercible]" };
+    }
+};
+const toAttributes = (data) => {
+    if (!data) {
+        return [];
+    }
+    const out = [];
+    for (const [key, raw] of Object.entries(data)) {
+        const value = toAnyValue(raw);
+        if (value !== null) {
+            out.push({ key, value });
+        }
+    }
+    return out;
+};
+/** Conditional single string attribute — empty array when absent/blank. */
+const strAttr = (key, value) => typeof value === "string" && value.length > 0
+    ? [{ key, value: { stringValue: value } }]
+    : [];
+/**
+ * Build the OTLP `resource.attributes` array.
+ *
+ * `service.name` / `service.version` come from config first (so a customer's
+ * own app identity flows through), then fall back to the Sentry event's
+ * `release`. Browser / OS / device contexts map to OTel resource semconv.
+ */
+const buildResourceAttributes = (event, config) => {
+    const browser = event.contexts?.browser;
+    const os = event.contexts?.os;
+    const device = event.contexts?.device;
+    return [
+        ...strAttr("service.name", config.serviceName ?? "sentry-app"),
+        ...strAttr("service.version", config.serviceVersion ?? event.release),
+        ...strAttr("deployment.environment", event.environment),
+        // SDK identity
+        ...strAttr("telemetry.sdk.name", event.sdk?.name),
+        ...strAttr("telemetry.sdk.version", event.sdk?.version),
+        ...strAttr("telemetry.sdk.language", event.platform),
+        // Browser / OS / device context (typed `unknown` via the index signature)
+        ...strAttr("browser.name", browser?.name),
+        ...strAttr("browser.version", browser?.version),
+        ...strAttr("os.name", os?.name),
+        ...strAttr("os.version", os?.version),
+        ...strAttr("device.model.name", device?.model),
+        ...strAttr("device.manufacturer", device?.brand),
+        ...strAttr("device.model.identifier", device?.family),
+    ];
+};
+/** String form of the Sentry user id (`string | number`). */
+const userIdToString = (id) => {
+    if (typeof id === "string") {
+        return id.length > 0 ? id : undefined;
+    }
+    if (typeof id === "number" || typeof id === "bigint") {
+        return String(id);
+    }
+    return undefined;
+};
+/**
+ * Event-scoped attributes stamped onto every span: the injected `session.id`
+ * plus the Sentry user identity (`Sentry.setUser`). `user.id` is the join key
+ * for per-user behavior analytics — without it, events can't be grouped by user.
+ */
+const eventScopedAttrs = (event, sessionId) => [
+    ...strAttr("session.id", sessionId),
+    ...strAttr("user.id", userIdToString(event.user?.id)),
+    ...strAttr("user.name", event.user?.username),
+    ...strAttr("user.email", event.user?.email),
+];
+/**
+ * Append the given attributes to every span. Single choke point so all span
+ * families (transaction root, children, error) get them uniformly. The transform
+ * stays pure — the values are explicit inputs resolved by the impure tee
+ * boundary, not read here.
+ */
+const withScopedAttrs = (spans, attrs) => attrs.length === 0
+    ? spans
+    : spans.map((span) => ({
+        ...span,
+        attributes: [...span.attributes, ...attrs],
+    }));
+const buildExportRequest = (spans, resourceEvent, config, sessionId) => ({
+    resourceSpans: [
+        {
+            resource: { attributes: buildResourceAttributes(resourceEvent, config) },
+            scopeSpans: [
+                {
+                    scope: { name: SCOPE_NAME, version: SCOPE_VERSION },
+                    spans: withScopedAttrs(spans, eventScopedAttrs(resourceEvent, sessionId)),
+                },
+            ],
+        },
+    ],
+});
+const sentryTransactionToOtlp = (event, config, sessionId) => {
+    const trace = event.contexts?.trace;
+    const spans = [];
+    if (trace?.trace_id && trace.span_id) {
+        spans.push({
+            traceId: trace.trace_id,
+            spanId: trace.span_id,
+            parentSpanId: trace.parent_span_id,
+            name: event.transaction ?? trace.op ?? "transaction",
+            kind: SPAN_KIND_INTERNAL,
+            startTimeUnixNano: toUnixNano(event.start_timestamp),
+            endTimeUnixNano: toUnixNano(event.timestamp),
+            attributes: [
+                ...toAttributes(trace.data),
+                ...strAttr("sentry.op", trace.op),
+                ...strAttr("sentry.source", event.transaction_info?.source),
+            ],
+            status: { code: mapStatus(trace.status) },
+        });
+    }
+    for (const child of event.spans ?? []) {
+        spans.push({
+            traceId: child.trace_id,
+            spanId: child.span_id,
+            parentSpanId: child.parent_span_id,
+            name: child.description ?? child.op ?? "span",
+            kind: SPAN_KIND_INTERNAL,
+            startTimeUnixNano: toUnixNano(child.start_timestamp),
+            endTimeUnixNano: toUnixNano(child.timestamp),
+            attributes: [...toAttributes(child.data), ...strAttr("sentry.op", child.op)],
+            status: { code: mapStatus(child.status) },
+        });
+    }
+    return buildExportRequest(spans, event, config, sessionId);
+};
+exports.sentryTransactionToOtlp = sentryTransactionToOtlp;
+const renderStackFrames = (frames) => frames
+    .map((f) => `  at ${f.function ?? "<anonymous>"} (${f.filename ?? "?"}:${f.lineno ?? 0}:${f.colno ?? 0})`)
+    .join("\n");
+const sentryErrorToOtlp = (event, config, sessionId) => {
+    const trace = event.contexts?.trace;
+    // Anchor on the Sentry event_id (32-hex) when there's no trace context,
+    // so the transform stays pure (no randomness).
+    const traceId = trace?.trace_id ?? event.event_id;
+    if (!traceId) {
+        return buildExportRequest([], event, config, sessionId);
+    }
+    // The error span gets its own id derived from the (unique) event_id and is
+    // parented under the active span. Reusing `trace.span_id` as the span id
+    // would collide with the live span the transaction export also ships.
+    const spanId = event.event_id?.slice(0, 16) ?? traceId.slice(0, 16);
+    const parentSpanId = trace?.span_id;
+    const ts = toUnixNano(event.timestamp);
+    const values = event.exception?.values ?? [];
+    // Sentry orders exceptions outermost-first; the last entry is the innermost
+    // (most specific) error — use it for the span name.
+    const primary = values.length > 0 ? values[values.length - 1] : undefined;
+    const events = values.map((ex) => {
+        const attributes = [
+            ...strAttr("exception.type", ex.type),
+            ...strAttr("exception.message", ex.value),
+        ];
+        const frames = ex.stacktrace?.frames;
+        if (frames && frames.length > 0) {
+            attributes.push({
+                key: "exception.stacktrace",
+                value: { stringValue: renderStackFrames(frames) },
+            });
+        }
+        if (ex.mechanism?.handled !== undefined) {
+            attributes.push({
+                key: "exception.escaped",
+                value: { boolValue: !ex.mechanism?.handled },
+            });
+        }
+        return { timeUnixNano: ts, name: "exception", attributes };
+    });
+    const span = {
+        traceId,
+        spanId,
+        parentSpanId,
+        name: event.transaction ?? primary?.type ?? "error",
+        kind: SPAN_KIND_INTERNAL,
+        startTimeUnixNano: ts,
+        endTimeUnixNano: ts,
+        attributes: [
+            ...toAttributes(event.tags),
+            ...toAttributes(event.extra),
+            ...strAttr("sentry.level", event.level),
+            ...strAttr("exception.type", primary?.type),
+            ...strAttr("exception.message", primary?.value),
+        ],
+        events,
+        status: { code: STATUS_ERROR, message: primary?.value },
+    };
+    return buildExportRequest([span], event, config, sessionId);
+};
+exports.sentryErrorToOtlp = sentryErrorToOtlp;
+const isTransactionEvent = (event) => event.type === "transaction";
+/**
+ * Dispatcher: route a Sentry event to the right transform by `event.type`.
+ * Transactions carry `type: 'transaction'`; error events leave it undefined.
+ */
+const sentryEventToOtlp = (event, config, sessionId) => isTransactionEvent(event)
+    ? (0, exports.sentryTransactionToOtlp)(event, config, sessionId)
+    : (0, exports.sentryErrorToOtlp)(event, config, sessionId);
+exports.sentryEventToOtlp = sentryEventToOtlp;
+//# sourceMappingURL=sentryToOtel.js.map

package/dist/sentryToOtel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentryToOtel.js","sourceRoot":"","sources":["../src/sentryToOtel.ts"],"names":[],"mappings":"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"}

package/dist/session.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Session id management for behavior analytics.
+ *
+ * `createRollingSession` returns a provider — call it once per teed event to get
+ * the current session id. A session keeps its id for a fixed window (default 30
+ * min) measured from when it STARTED, regardless of activity: a hard clock cap,
+ * not an inactivity timeout. When the window elapses the next call mints a fresh
+ * id.
+ *
+ * The first session of a fresh visitor can be SEEDED via `initialId` (a string
+ * or a lazy function) — e.g. a hashed access token — so the opening session is
+ * tied to a known identity; every later window uses `generateId`. This is the
+ * "one more layer" some apps want on top of the plain rolling default:
+ *
+ *     // Simple: plain 30-min rolling, random ids
+ *     createRollingSession()
+ *
+ *     // Seeded: first window = a hashed identity, then roll to generated ids
+ *     createRollingSession({ initialId: () => hashAccessToken(token) })
+ *
+ * Persisted to `localStorage` by default so the id survives page navigations;
+ * pass `storage: null` for in-memory only (Node, or privacy-sensitive contexts).
+ */
+/** Minimal storage contract — a subset of the Web Storage API. */
+export interface SessionStorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export interface RollingSessionOptions {
+    /** Hard cap per session, in ms. Default 1_800_000 (30 min). */
+    windowMs?: number;
+    /** Persistence key. Default "kubit-session". */
+    storageKey?: string;
+    /**
+     * Id for the FIRST session of a fresh visitor (no persisted session yet). A
+     * string, or a function evaluated once when that session starts. Every later
+     * window uses `generateId` instead.
+     */
+    initialId?: string | (() => string);
+    /** Id generator for every window after the first. Default: `crypto.randomUUID`. */
+    generateId?: () => string;
+    /**
+     * Storage backend. Defaults to `localStorage` when available, else in-memory.
+     * Pass `null` to force in-memory (no cross-reload persistence).
+     */
+    storage?: SessionStorageLike | null;
+    /** Clock source — injectable for tests. Default `Date.now`. */
+    now?: () => number;
+}
+/** Returns the current session id. Call once per event. */
+export type SessionIdProvider = () => string;
+export declare const createRollingSession: (options?: RollingSessionOptions) => SessionIdProvider;

package/dist/session.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Session id management for behavior analytics.
+ *
+ * `createRollingSession` returns a provider — call it once per teed event to get
+ * the current session id. A session keeps its id for a fixed window (default 30
+ * min) measured from when it STARTED, regardless of activity: a hard clock cap,
+ * not an inactivity timeout. When the window elapses the next call mints a fresh
+ * id.
+ *
+ * The first session of a fresh visitor can be SEEDED via `initialId` (a string
+ * or a lazy function) — e.g. a hashed access token — so the opening session is
+ * tied to a known identity; every later window uses `generateId`. This is the
+ * "one more layer" some apps want on top of the plain rolling default:
+ *
+ *     // Simple: plain 30-min rolling, random ids
+ *     createRollingSession()
+ *
+ *     // Seeded: first window = a hashed identity, then roll to generated ids
+ *     createRollingSession({ initialId: () => hashAccessToken(token) })
+ *
+ * Persisted to `localStorage` by default so the id survives page navigations;
+ * pass `storage: null` for in-memory only (Node, or privacy-sensitive contexts).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRollingSession = void 0;
+const DEFAULT_WINDOW_MS = 30 * 60 * 1000;
+const DEFAULT_STORAGE_KEY = "kubit-session";
+/** `localStorage` when present (browser); null in Node or sandboxed contexts. */
+const getDefaultStorage = () => {
+    try {
+        if (typeof localStorage !== "undefined") {
+            return localStorage;
+        }
+    }
+    catch {
+        // accessing localStorage can throw in sandboxed iframes
+    }
+    return null;
+};
+const defaultGenerateId = () => {
+    try {
+        if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+            return crypto.randomUUID();
+        }
+    }
+    catch {
+        // fall through to the non-crypto id
+    }
+    return `sess-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+};
+const resolveSeed = (seed) => {
+    try {
+        const value = typeof seed === "function" ? seed() : seed;
+        return typeof value === "string" ? value : "";
+    }
+    catch {
+        return "";
+    }
+};
+const isLive = (saved, now, windowMs) => saved !== null && saved.id.length > 0 && now - saved.start < windowMs;
+const createRollingSession = (options = {}) => {
+    const windowMs = options.windowMs ?? DEFAULT_WINDOW_MS;
+    const storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;
+    const generateId = options.generateId ?? defaultGenerateId;
+    const now = options.now ?? (() => Date.now());
+    const storage = options.storage === undefined ? getDefaultStorage() : options.storage;
+    // In-memory mirror — authoritative within a page, backed by `storage` across
+    // reloads / navigations.
+    let memory = null;
+    const read = () => {
+        if (memory) {
+            return memory;
+        }
+        if (!storage) {
+            return null;
+        }
+        try {
+            const raw = storage.getItem(storageKey);
+            if (!raw) {
+                return null;
+            }
+            const parsed = JSON.parse(raw);
+            if (parsed &&
+                typeof parsed.id === "string" &&
+                typeof parsed.start === "number") {
+                return { id: parsed.id, start: parsed.start };
+            }
+        }
+        catch {
+            // unreadable / malformed — treat as no session
+        }
+        return null;
+    };
+    const write = (session) => {
+        memory = session;
+        if (!storage) {
+            return;
+        }
+        try {
+            storage.setItem(storageKey, JSON.stringify(session));
+        }
+        catch {
+            // storage full / unavailable — `memory` still holds the session
+        }
+    };
+    return () => {
+        const t = now();
+        const saved = read();
+        if (isLive(saved, t, windowMs)) {
+            memory = saved;
+            return saved.id;
+        }
+        // Mint a new session. A fresh visitor (no prior session at all) may be
+        // seeded with `initialId`; every later window uses `generateId`.
+        const seeded = saved === null && options.initialId !== undefined
+            ? resolveSeed(options.initialId)
+            : "";
+        const id = seeded.length > 0 ? seeded : generateId();
+        write({ id, start: t });
+        return id;
+    };
+};
+exports.createRollingSession = createRollingSession;
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * OTLP/HTTP+JSON encoding types (trace signal only).
+ *
+ * Reference: OpenTelemetry OTLP/HTTP JSON encoding spec
+ *   https://opentelemetry.io/docs/specs/otlp/#otlphttp-with-json-encoding
+ *
+ * These mirror the subset of the OTLP `ExportTraceServiceRequest` shape we
+ * emit. The Kubit collector accepts both protobuf and JSON; this SDK sends
+ * JSON to keep the browser build free of a protobuf dependency.
+ */
+export type OtlpAnyValue = {
+    stringValue: string;
+} | {
+    intValue: string;
+} | {
+    doubleValue: number;
+} | {
+    boolValue: boolean;
+} | {
+    arrayValue: {
+        values: OtlpAnyValue[];
+    };
+} | {
+    kvlistValue: {
+        values: OtlpKeyValue[];
+    };
+};
+export interface OtlpKeyValue {
+    key: string;
+    value: OtlpAnyValue;
+}
+/** A span event (e.g. a recorded exception). */
+export interface OtlpSpanEvent {
+    timeUnixNano: string;
+    name: string;
+    attributes: OtlpKeyValue[];
+}
+export interface OtlpSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    /** SpanKind enum. 1 = INTERNAL (default for browser-side spans). */
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: OtlpKeyValue[];
+    events?: OtlpSpanEvent[];
+    status: {
+        code: number;
+        message?: string;
+    };
+}
+export interface OtlpExportRequest {
+    resourceSpans: Array<{
+        resource: {
+            attributes: OtlpKeyValue[];
+        };
+        scopeSpans: Array<{
+            scope: {
+                name: string;
+                version: string;
+            };
+            spans: OtlpSpan[];
+        }>;
+    }>;
+}

package/dist/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * OTLP/HTTP+JSON encoding types (trace signal only).
+ *
+ * Reference: OpenTelemetry OTLP/HTTP JSON encoding spec
+ *   https://opentelemetry.io/docs/specs/otlp/#otlphttp-with-json-encoding
+ *
+ * These mirror the subset of the OTLP `ExportTraceServiceRequest` shape we
+ * emit. The Kubit collector accepts both protobuf and JSON; this SDK sends
+ * JSON to keep the browser build free of a protobuf dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kubit-ai/sentry",
+  "version": "0.1.0",
+  "description": "Tee Sentry events (errors + transactions) to Kubit as OTLP for behavior analytics.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "sentry",
+    "opentelemetry",
+    "otel",
+    "kubit",
+    "observability",
+    "behavior-analytics",
+    "tracing"
+  ],
+  "author": {
+    "name": "Kubit Inc",
+    "url": "https://www.kubit.ai"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://www.kubit.ai",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:browser": "node scripts/build-browser.mjs",
+    "build:all": "npm run build && npm run build:browser",
+    "typecheck": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "smoke": "npm run build && node scripts/smoke.js",
+    "prepublishOnly": "npm test && npm run build:all"
+  },
+  "peerDependencies": {
+    "@sentry/core": ">=8.0.0"
+  },
+  "devDependencies": {
+    "@sentry/browser": "^10.57.0",
+    "@sentry/core": "^10.0.0",
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.28.1",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}