@xeonr/telemetry-web 0.0.0-stage → 0.1.0

package/dist/env.d.ts

@@ -0,0 +1,68 @@
+export interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+export interface Listenable {
+    addEventListener(type: string, fn: (ev: unknown) => void, opts?: unknown): void;
+    removeEventListener?(type: string, fn: (ev: unknown) => void, opts?: unknown): void;
+}
+export interface NavigatorLike {
+    onLine?: boolean | undefined;
+    language?: string | undefined;
+    userAgent?: string | undefined;
+    platform?: string | undefined;
+    userAgentData?: {
+        brands?: {
+            brand: string;
+            version: string;
+        }[] | undefined;
+        mobile?: boolean | undefined;
+        platform?: string | undefined;
+    } | undefined;
+    sendBeacon?: ((url: string, data?: BodyInit | null) => boolean) | undefined;
+}
+export type Timer = ReturnType<typeof setTimeout>;
+export interface Env {
+    fetch: typeof fetch | undefined;
+    navigator: NavigatorLike | undefined;
+    local: StorageLike | null;
+    session: StorageLike | null;
+    /** Epoch milliseconds, fractional where the platform allows. */
+    now(): number;
+    /** The page's origin and path; undefined outside a browser. */
+    location: {
+        origin: string;
+        pathname: string;
+        hostname: string;
+        href: string;
+    } | undefined;
+    /** window, for error/unhandledrejection/pagehide/online. */
+    window: Listenable | undefined;
+    /** document, for visibilitychange and the <meta> lookups. */
+    document: (Listenable & {
+        visibilityState?: string | undefined;
+        querySelector?: ((sel: string) => {
+            getAttribute(n: string): string | null;
+        } | null) | undefined;
+    }) | undefined;
+    randomBytes(n: number): Uint8Array;
+    setTimeout(fn: () => void, ms: number): Timer;
+    clearTimeout(t: Timer): void;
+    setInterval(fn: () => void, ms: number): Timer;
+    clearInterval(t: Timer): void;
+    performance: Performance | undefined;
+    PerformanceObserver: typeof PerformanceObserver | undefined;
+    /** console.warn, once-per-message by the caller; quiet in tests. */
+    warn(msg: string): void;
+}
+/** The real browser. Safe to call anywhere; missing pieces come back undefined. */
+export declare function browserEnv(): Env;
+export declare function hex(bytes: Uint8Array): string;
+/** A 16-byte trace id, never all zero. */
+export declare function newTraceId(env: Pick<Env, "randomBytes">): string;
+/** An 8-byte span id, never all zero. */
+export declare function newSpanId(env: Pick<Env, "randomBytes">): string;
+/** The content of `<meta name="…">`, or undefined. */
+export declare function meta(env: Pick<Env, "document">, name: string): string | undefined;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChF,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,GAAG,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACvJ,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7E;AAED,MAAM,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAElD,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,gEAAgE;IAChE,GAAG,IAAI,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC3F,4DAA4D;IAC5D,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,EAAE,CAAC,UAAU,GAAG;QAAE,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,aAAa,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK;YAAE,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IAChL,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC,UAAU,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9C,YAAY,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC;IAC/C,aAAa,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,mBAAmB,EAAE,OAAO,mBAAmB,GAAG,SAAS,CAAC;IAC5D,oEAAoE;IACpE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAsBD,mFAAmF;AACnF,wBAAgB,UAAU,IAAI,GAAG,CAwChC;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI7C;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,MAAM,CAGhE;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,MAAM,CAG/D;AAED,sDAAsD;AACtD,wBAAgB,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOjF"}

package/dist/env.js

@@ -0,0 +1,97 @@
+// Everything the SDK reads from the browser, behind one seam. The browser
+// build reads globalThis; the tests hand in fakes. Every accessor tolerates
+// the thing being absent (SSR, a worker, a privacy mode that throws on
+// storage access), because the one rule is never to throw into the host.
+function storage(get) {
+    try {
+        const s = get();
+        if (!s)
+            return null;
+        // Some privacy modes hand out a Storage that throws on write.
+        const probe = "__xeonr_tw_probe";
+        s.setItem(probe, "1");
+        s.removeItem(probe);
+        return s;
+    }
+    catch {
+        return null;
+    }
+}
+function fallbackRandom(n) {
+    const b = new Uint8Array(n);
+    for (let i = 0; i < n; i++)
+        b[i] = Math.floor(Math.random() * 256);
+    return b;
+}
+/** The real browser. Safe to call anywhere; missing pieces come back undefined. */
+export function browserEnv() {
+    const g = globalThis;
+    const perf = typeof g.performance === "object" ? g.performance : undefined;
+    const origin = perf && typeof perf.timeOrigin === "number" ? perf.timeOrigin : undefined;
+    const loc = typeof g.location === "object" && g.location ? g.location : undefined;
+    const cryptoObj = typeof g.crypto === "object" ? g.crypto : undefined;
+    // Captured now, before anything (a host's own wrapper, or ours) patches it,
+    // so the SDK's own sends never go through a wrapper that reports on them.
+    const rawFetch = typeof g.fetch === "function" ? g.fetch.bind(g) : undefined;
+    return {
+        fetch: rawFetch,
+        navigator: typeof g.navigator === "object" ? g.navigator : undefined,
+        local: storage(() => g.localStorage),
+        session: storage(() => g.sessionStorage),
+        now: () => (perf && origin !== undefined ? origin + perf.now() : Date.now()),
+        location: loc ? { origin: loc.origin, pathname: loc.pathname, hostname: loc.hostname, href: loc.href } : undefined,
+        window: typeof g.addEventListener === "function" && typeof g.document === "object" ? g : undefined,
+        document: typeof g.document === "object" && g.document ? g.document : undefined,
+        randomBytes: (n) => {
+            try {
+                if (cryptoObj?.getRandomValues)
+                    return cryptoObj.getRandomValues(new Uint8Array(n));
+            }
+            catch {
+                /* fall through */
+            }
+            return fallbackRandom(n);
+        },
+        setTimeout: (fn, ms) => g.setTimeout(fn, ms),
+        clearTimeout: (t) => g.clearTimeout(t),
+        setInterval: (fn, ms) => g.setInterval(fn, ms),
+        clearInterval: (t) => g.clearInterval(t),
+        performance: perf,
+        PerformanceObserver: typeof g.PerformanceObserver === "function" ? g.PerformanceObserver : undefined,
+        warn: (msg) => {
+            try {
+                g.console?.warn?.(msg);
+            }
+            catch {
+                /* never */
+            }
+        },
+    };
+}
+export function hex(bytes) {
+    let s = "";
+    for (const b of bytes)
+        s += b.toString(16).padStart(2, "0");
+    return s;
+}
+/** A 16-byte trace id, never all zero. */
+export function newTraceId(env) {
+    const id = hex(env.randomBytes(16));
+    return /^0+$/.test(id) ? newTraceId(env) : id;
+}
+/** An 8-byte span id, never all zero. */
+export function newSpanId(env) {
+    const id = hex(env.randomBytes(8));
+    return /^0+$/.test(id) ? newSpanId(env) : id;
+}
+/** The content of `<meta name="…">`, or undefined. */
+export function meta(env, name) {
+    try {
+        const v = env.document?.querySelector?.(`meta[name="${name}"]`)?.getAttribute("content");
+        return v ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { type CaptureContext, type TelemetryClient, type TelemetryOptions } from "./client.ts";
+export { createClient, isLocalDevHost, noopClient, BREADCRUMBS_KEY, DEFAULT_ENDPOINT, SDK_NAME, SDK_VERSION, type Breadcrumb, type CaptureContext, type RequestEnd, type RequestHandle, type RequestStart, type TelemetryClient, type TelemetryOptions, } from "./client.ts";
+export { traceIdFrom, shortTraceId, TRACE_HEADER } from "./trace.ts";
+export { classify, type ErrorClass } from "./classify.ts";
+export type { AttrValue, Attrs } from "./otlp.ts";
+export type { Env } from "./env.ts";
+/**
+ * Start telemetry for this page and return the client. Once per page: a
+ * second call returns the first client unchanged, so a library (the shell)
+ * and the app can both call it without double-reporting.
+ */
+export declare function init(opts?: TelemetryOptions): TelemetryClient;
+/** The page's client, or undefined before init. */
+export declare function getClient(): TelemetryClient | undefined;
+/** Forget the page's client (shutting it down). For tests and hot reload. */
+export declare function resetClient(): void;
+/** Report an error through the page's client. A no-op before init. Never throws. */
+export declare function captureException(err: unknown, ctx?: CaptureContext): void;
+/** Tell telemetry the route changed. A no-op before init. */
+export declare function trackRoute(path: string): void;
+type ClientRef = TelemetryClient | (() => TelemetryClient | undefined) | undefined;
+/**
+ * A fetch that reports reachability: a request that gets no answer, times
+ * out or answers 5xx becomes a `client.request.failed` record, every request
+ * a breadcrumb, and a sampled one a CLIENT span (with `traceparent` when the
+ * request is same-origin). Behaves exactly like the fetch it wraps otherwise.
+ *
+ *   const api = wrapFetch();              // global fetch, page client
+ *   await api("/api/thing");
+ *
+ * The client is looked up per request, so wrapping before `init` is fine.
+ */
+export declare function wrapFetch(fetchImpl?: typeof fetch, client?: ClientRef): typeof fetch;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAA4B,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEzH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,WAAW,EACX,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClD,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAIpC;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,GAAE,gBAAqB,GAAG,eAAe,CAIjE;AAED,mDAAmD;AACnD,wBAAgB,SAAS,IAAI,eAAe,GAAG,SAAS,CAEvD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAEzE;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,KAAK,SAAS,GAAG,eAAe,GAAG,CAAC,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAOnF;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,KAAK,CA2BpF"}

package/dist/index.js

@@ -0,0 +1,89 @@
+// @xeonr/telemetry-web — browser telemetry for Xeonr consoles, to Lantern.
+//
+//   import { init } from "@xeonr/telemetry-web";
+//   init({ service: "functions-ui", product: "functions" });
+//
+// console-shell's ConsoleProvider does this for every console; call it
+// yourself only on a page that does not mount the shell.
+import { createClient, noopClient } from "./client.js";
+export { createClient, isLocalDevHost, noopClient, BREADCRUMBS_KEY, DEFAULT_ENDPOINT, SDK_NAME, SDK_VERSION, } from "./client.js";
+export { traceIdFrom, shortTraceId, TRACE_HEADER } from "./trace.js";
+export { classify } from "./classify.js";
+let current;
+/**
+ * Start telemetry for this page and return the client. Once per page: a
+ * second call returns the first client unchanged, so a library (the shell)
+ * and the app can both call it without double-reporting.
+ */
+export function init(opts = {}) {
+    if (current)
+        return current;
+    current = createClient(opts);
+    return current;
+}
+/** The page's client, or undefined before init. */
+export function getClient() {
+    return current;
+}
+/** Forget the page's client (shutting it down). For tests and hot reload. */
+export function resetClient() {
+    current?.shutdown();
+    current = undefined;
+}
+/** Report an error through the page's client. A no-op before init. Never throws. */
+export function captureException(err, ctx) {
+    current?.captureException(err, ctx);
+}
+/** Tell telemetry the route changed. A no-op before init. */
+export function trackRoute(path) {
+    current?.trackRoute(path);
+}
+function resolve(ref) {
+    const c = typeof ref === "function" ? ref() : (ref ?? current);
+    return c ?? noopClient();
+}
+/**
+ * A fetch that reports reachability: a request that gets no answer, times
+ * out or answers 5xx becomes a `client.request.failed` record, every request
+ * a breadcrumb, and a sampled one a CLIENT span (with `traceparent` when the
+ * request is same-origin). Behaves exactly like the fetch it wraps otherwise.
+ *
+ *   const api = wrapFetch();              // global fetch, page client
+ *   await api("/api/thing");
+ *
+ * The client is looked up per request, so wrapping before `init` is fine.
+ */
+export function wrapFetch(fetchImpl, client) {
+    const base = fetchImpl ?? ((...a) => globalThis.fetch(...a));
+    const wrapped = async (input, init) => {
+        const c = resolve(client);
+        if (!c.enabled)
+            return base(input, init);
+        const isReq = typeof Request === "function" && input instanceof Request;
+        const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+        if (c.isOwnUrl(url))
+            return base(input, init);
+        const method = init?.method ?? (isReq ? input.method : "GET");
+        const h = c.beginRequest({ url, method });
+        let nextInit = init;
+        if (Object.keys(h.headers).length > 0) {
+            const headers = new Headers(init?.headers ?? (isReq ? input.headers : undefined));
+            for (const [k, v] of Object.entries(h.headers))
+                if (!headers.has(k))
+                    headers.set(k, v);
+            nextInit = { ...init, headers };
+        }
+        let res;
+        try {
+            res = await base(input, nextInit);
+        }
+        catch (err) {
+            h.end({ error: err });
+            throw err;
+        }
+        h.end({ status: res.status, traceId: res.headers.get("x-trace-id") });
+        return res;
+    };
+    return wrapped;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/otlp.d.ts

@@ -0,0 +1,124 @@
+export type AttrValue = string | number | boolean | readonly string[];
+export type Attrs = Record<string, AttrValue | undefined | null>;
+export type AnyValue = {
+    stringValue: string;
+} | {
+    intValue: string;
+} | {
+    doubleValue: number;
+} | {
+    boolValue: boolean;
+} | {
+    arrayValue: {
+        values: {
+            stringValue: string;
+        }[];
+    };
+};
+export interface KeyValue {
+    key: string;
+    value: AnyValue;
+}
+/** Severity numbers from the OTLP log data model. */
+export declare const SEVERITY: {
+    readonly DEBUG: 5;
+    readonly INFO: 9;
+    readonly WARN: 13;
+    readonly ERROR: 17;
+};
+export type SeverityName = keyof typeof SEVERITY;
+/** SPAN_KIND_CLIENT. */
+export declare const SPAN_KIND_CLIENT = 3;
+/** STATUS_CODE_UNSET / OK / ERROR. */
+export declare const STATUS_UNSET = 0;
+export declare const STATUS_ERROR = 2;
+export interface LogRecord {
+    timeUnixNano: string;
+    observedTimeUnixNano: string;
+    severityNumber: number;
+    severityText: SeverityName;
+    body: {
+        stringValue: string;
+    };
+    attributes: KeyValue[];
+    traceId?: string;
+    spanId?: string;
+}
+export interface Span {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes: KeyValue[];
+    status: {
+        code: number;
+        message?: string;
+    };
+}
+export interface Scope {
+    name: string;
+    version: string;
+}
+export interface LogsPayload {
+    resourceLogs: {
+        resource: {
+            attributes: KeyValue[];
+        };
+        scopeLogs: {
+            scope: Scope;
+            logRecords: LogRecord[];
+        }[];
+    }[];
+}
+export interface TracesPayload {
+    resourceSpans: {
+        resource: {
+            attributes: KeyValue[];
+        };
+        scopeSpans: {
+            scope: Scope;
+            spans: Span[];
+        }[];
+    }[];
+}
+/**
+ * One attribute value in OTLP JSON. Integers are intValue (as a string, per the
+ * int64 mapping); other numbers doubleValue; a string list is an arrayValue.
+ */
+export declare function anyValue(v: AttrValue): AnyValue;
+/** An attribute map as OTLP's KeyValue list, dropping undefined/null and empty keys. */
+export declare function attributes(a: Attrs): KeyValue[];
+/**
+ * Epoch milliseconds (possibly fractional, from performance.timeOrigin +
+ * performance.now()) as OTLP's nanosecond string. Goes through whole
+ * microseconds so the arithmetic stays inside a double's exact range.
+ */
+export declare function nanos(epochMs: number): string;
+/** A W3C trace id, or undefined: lower-cased, dashes removed, never all zero. */
+export declare function normaliseTraceId(raw: string | null | undefined): string | undefined;
+export interface LogInput {
+    time: number;
+    severity: SeverityName;
+    body: string;
+    attrs: Attrs;
+    traceId?: string | undefined;
+    spanId?: string | undefined;
+}
+export declare function logRecord(l: LogInput): LogRecord;
+export interface SpanInput {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string | undefined;
+    name: string;
+    start: number;
+    end: number;
+    attrs: Attrs;
+    error?: string | undefined;
+}
+export declare function clientSpan(s: SpanInput): Span;
+export declare function logsPayload(resource: KeyValue[], scope: Scope, records: LogRecord[]): LogsPayload;
+export declare function tracesPayload(resource: KeyValue[], scope: Scope, spans: Span[]): TracesPayload;
+//# sourceMappingURL=otlp.d.ts.map

package/dist/otlp.d.ts.map

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

package/dist/otlp.js

@@ -0,0 +1,105 @@
+// OTLP/HTTP JSON, by hand. The OpenTelemetry JS SDK is ~60 KiB before it
+// sends a byte, and every console pays for whatever this package weighs, so
+// the two payload shapes Lantern's ingest reads are written out here instead.
+//
+// The encoding is protobuf's canonical JSON mapping of the OTLP protos:
+// 64-bit integers (timestamps, intValue) are decimal strings, ids are lower
+// hex, enums are their numbers. https://opentelemetry.io/docs/specs/otlp/#json-protobuf-encoding
+/** Severity numbers from the OTLP log data model. */
+export const SEVERITY = {
+    DEBUG: 5,
+    INFO: 9,
+    WARN: 13,
+    ERROR: 17,
+};
+/** SPAN_KIND_CLIENT. */
+export const SPAN_KIND_CLIENT = 3;
+/** STATUS_CODE_UNSET / OK / ERROR. */
+export const STATUS_UNSET = 0;
+export const STATUS_ERROR = 2;
+/**
+ * One attribute value in OTLP JSON. Integers are intValue (as a string, per the
+ * int64 mapping); other numbers doubleValue; a string list is an arrayValue.
+ */
+export function anyValue(v) {
+    if (typeof v !== "string" && typeof v !== "number" && typeof v !== "boolean") {
+        return { arrayValue: { values: v.map((x) => ({ stringValue: String(x) })) } };
+    }
+    if (typeof v === "boolean")
+        return { boolValue: v };
+    if (typeof v === "number") {
+        if (Number.isInteger(v) && Number.isSafeInteger(v))
+            return { intValue: String(v) };
+        return { doubleValue: Number.isFinite(v) ? v : 0 };
+    }
+    return { stringValue: v };
+}
+/** An attribute map as OTLP's KeyValue list, dropping undefined/null and empty keys. */
+export function attributes(a) {
+    const out = [];
+    for (const key of Object.keys(a)) {
+        const v = a[key];
+        if (v === undefined || v === null || key === "")
+            continue;
+        out.push({ key, value: anyValue(v) });
+    }
+    return out;
+}
+/**
+ * Epoch milliseconds (possibly fractional, from performance.timeOrigin +
+ * performance.now()) as OTLP's nanosecond string. Goes through whole
+ * microseconds so the arithmetic stays inside a double's exact range.
+ */
+export function nanos(epochMs) {
+    const us = Math.round(epochMs * 1000);
+    return us <= 0 ? "0" : `${us}000`;
+}
+const HEX32 = /^[0-9a-f]{32}$/;
+const ZERO32 = "0".repeat(32);
+/** A W3C trace id, or undefined: lower-cased, dashes removed, never all zero. */
+export function normaliseTraceId(raw) {
+    if (!raw)
+        return undefined;
+    const id = raw.trim().toLowerCase().replace(/-/g, "");
+    return HEX32.test(id) && id !== ZERO32 ? id : undefined;
+}
+export function logRecord(l) {
+    const t = nanos(l.time);
+    const rec = {
+        timeUnixNano: t,
+        observedTimeUnixNano: t,
+        severityNumber: SEVERITY[l.severity],
+        severityText: l.severity,
+        body: { stringValue: l.body },
+        attributes: attributes(l.attrs),
+    };
+    const tid = normaliseTraceId(l.traceId);
+    if (tid) {
+        rec.traceId = tid;
+        if (l.spanId && /^[0-9a-f]{16}$/.test(l.spanId))
+            rec.spanId = l.spanId;
+    }
+    return rec;
+}
+export function clientSpan(s) {
+    const span = {
+        traceId: s.traceId,
+        spanId: s.spanId,
+        name: s.name,
+        kind: SPAN_KIND_CLIENT,
+        startTimeUnixNano: nanos(s.start),
+        endTimeUnixNano: nanos(Math.max(s.end, s.start)),
+        attributes: attributes(s.attrs),
+        status: s.error === undefined ? { code: STATUS_UNSET } : { code: STATUS_ERROR, message: s.error },
+    };
+    if (s.parentSpanId)
+        span.parentSpanId = s.parentSpanId;
+    return span;
+}
+export function logsPayload(resource, scope, records) {
+    return { resourceLogs: [{ resource: { attributes: resource }, scopeLogs: [{ scope, logRecords: records }] }] };
+}
+export function tracesPayload(resource, scope, spans) {
+    return { resourceSpans: [{ resource: { attributes: resource }, scopeSpans: [{ scope, spans }] }] };
+}
+//# sourceMappingURL=otlp.js.map

package/dist/otlp.js.map

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

package/dist/queue.d.ts

@@ -0,0 +1,92 @@
+import type { Env } from "./env.ts";
+import { type KeyValue, type LogRecord, type Scope, type Span } from "./otlp.ts";
+/** One queued record. Compact keys: these are what sit in localStorage. */
+export interface Item {
+    /** "l" log record, "s" span */
+    k: "l" | "s";
+    /** service.version it was recorded under, so a replay after a deploy keeps its release */
+    v: string;
+    /** error-or-worse: evicted last */
+    e?: 1;
+    r: LogRecord | Span;
+}
+interface Stored {
+    retryAt: number;
+    items: Item[];
+}
+export interface DeliveryOptions {
+    endpoint: string;
+    service: string;
+    scope: Scope;
+    /** The resource attributes for records of a given service.version. */
+    resource(version: string): KeyValue[];
+    flushIntervalMs?: number | undefined;
+    maxBatch?: number | undefined;
+    maxStored?: number | undefined;
+    maxStoredBytes?: number | undefined;
+    storageKey?: string | undefined;
+}
+export declare const DEFAULTS: {
+    readonly flushIntervalMs: 5000;
+    readonly maxBatch: 50;
+    readonly maxStored: 200;
+    readonly maxStoredBytes: number;
+    readonly storageKey: "xeonr.telemetry.buffer";
+    /** in memory, before the oldest give way: a render loop must not eat the tab */
+    readonly maxMemory: 1000;
+    /** records per request */
+    readonly maxRequest: 500;
+    /** sendBeacon's quota is 64 KiB per page; stay under it per call */
+    readonly beaconBytes: number;
+    /** fetch keepalive has the same 64 KiB budget */
+    readonly keepaliveBytes: number;
+    readonly maxBackoffMs: number;
+};
+/** Retry-After as milliseconds: delta-seconds or an HTTP date. */
+export declare function retryAfterMs(h: string | null | undefined, now: number): number | undefined;
+/** Bound a list to `max` items and `maxBytes` of JSON, dropping the oldest non-error records first, then the oldest. */
+export declare function bound(items: Item[], max: number, maxBytes: number): Item[];
+export declare class Delivery {
+    private readonly env;
+    private readonly o;
+    private mem;
+    private sending;
+    private failures;
+    private timer;
+    private soon;
+    private warned;
+    /** Called right before the hide-time send, so last-moment records (web vitals) make it. */
+    beforeHide: (() => void) | undefined;
+    constructor(env: Env, o: DeliveryOptions);
+    /** Timers and page lifecycle listeners, plus a replay of whatever a previous page left behind. */
+    start(): void;
+    stop(): void;
+    get pending(): number;
+    push(item: Item): void;
+    private schedule;
+    private online;
+    readStore(): Stored;
+    private writeStore;
+    /** Keep records for a later attempt. */
+    persist(items: Item[], retryAt?: number): void;
+    /** Claim stored records for sending, so another tab does not send them too. */
+    private takeStored;
+    private backoff;
+    private url;
+    /** The bodies for a set of items: at most one logs and one traces payload, a resource entry per release. */
+    bodies(items: Item[]): {
+        signal: "logs" | "traces";
+        items: Item[];
+        body: string;
+    }[];
+    private post;
+    /** Send what is queued (and what an earlier page left behind). Never rejects. */
+    flush(): Promise<void>;
+    /** The page is going away (or into the background): everything left goes by beacon now. */
+    hide(): void;
+    flushBeacon(): void;
+    /** Items in groups whose payload stays under the beacon's 64 KiB. */
+    private chunks;
+}
+export {};
+//# sourceMappingURL=queue.d.ts.map