@typokit/otel 0.1.4

package/dist/metrics.js.map

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

package/dist/redact.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Redacts sensitive fields from a data object based on glob-style patterns.
+ * Patterns like "*.password" match any key named "password" at any depth.
+ * Patterns like "authorization" match the exact key at root level.
+ */
+export declare function redactFields(data: Record<string, unknown>, patterns: string[]): Record<string, unknown>;
+//# sourceMappingURL=redact.d.ts.map

package/dist/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB"}

package/dist/redact.js

@@ -0,0 +1,46 @@
+/**
+ * Redacts sensitive fields from a data object based on glob-style patterns.
+ * Patterns like "*.password" match any key named "password" at any depth.
+ * Patterns like "authorization" match the exact key at root level.
+ */
+export function redactFields(data, patterns) {
+    if (patterns.length === 0)
+        return data;
+    const fieldNames = new Set();
+    for (const pattern of patterns) {
+        // "*.fieldName" → match fieldName at any depth
+        if (pattern.startsWith("*.")) {
+            fieldNames.add(pattern.slice(2));
+        }
+        else {
+            // exact key name match at any depth
+            fieldNames.add(pattern);
+        }
+    }
+    return redactObject(data, fieldNames);
+}
+function redactObject(obj, fieldNames) {
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        const value = obj[key];
+        if (fieldNames.has(key)) {
+            result[key] = "[REDACTED]";
+        }
+        else if (isPlainObject(value)) {
+            result[key] = redactObject(value, fieldNames);
+        }
+        else if (Array.isArray(value)) {
+            result[key] = value.map((item) => isPlainObject(item)
+                ? redactObject(item, fieldNames)
+                : item);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=redact.js.map

package/dist/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,IAA6B,EAC7B,QAAkB;IAElB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,+CAA+C;QAC/C,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,YAAY,CACnB,GAA4B,EAC5B,UAAuB;IAEvB,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAgC,EAAE,UAAU,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,aAAa,CAAC,IAAI,CAAC;gBACjB,CAAC,CAAC,YAAY,CAAC,IAA+B,EAAE,UAAU,CAAC;gBAC3D,CAAC,CAAC,IAAI,CACT,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/tracing.d.ts

@@ -0,0 +1,94 @@
+import type { SpanData, SpanStatus, SpanExporter, TracingConfig, TelemetryConfig } from "./types.js";
+/** Generate a 32-char hex trace ID */
+export declare function generateTraceId(): string;
+/** Generate a 16-char hex span ID */
+export declare function generateSpanId(): string;
+/** Exports spans to stdout as structured JSON (dev mode) */
+export declare class ConsoleSpanExporter implements SpanExporter {
+    export(spans: SpanData[]): void;
+}
+/** No-op exporter that silently discards spans */
+export declare class NoopSpanExporter implements SpanExporter {
+    export(_spans: SpanData[]): void;
+}
+/** Exports spans to an OTLP-compatible HTTP endpoint */
+export declare class OtlpSpanExporter implements SpanExporter {
+    private readonly endpoint;
+    constructor(endpoint?: string);
+    export(spans: SpanData[]): void;
+}
+/** A mutable span representing one phase of request processing */
+export declare class Span {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId?: string;
+    readonly name: string;
+    readonly kind: "server" | "internal";
+    readonly startTime: string;
+    readonly attributes: Record<string, string | number | boolean>;
+    private _endTime?;
+    private _durationMs?;
+    private _status;
+    constructor(options: {
+        traceId: string;
+        spanId?: string;
+        parentSpanId?: string;
+        name: string;
+        kind: "server" | "internal";
+        attributes?: Record<string, string | number | boolean>;
+    });
+    /** Set a key-value attribute on the span */
+    setAttribute(key: string, value: string | number | boolean): void;
+    /** Mark the span as successful and end it */
+    setOk(): void;
+    /** Mark the span as errored with an optional message */
+    setError(message?: string): void;
+    /** End the span and record its duration */
+    end(): void;
+    /** Whether this span has been ended */
+    get ended(): boolean;
+    get status(): SpanStatus;
+    /** Convert to a plain data object for export */
+    toData(): SpanData;
+}
+/** Resolves a TelemetryConfig into a normalized TracingConfig */
+export declare function resolveTracingConfig(telemetry?: TelemetryConfig): TracingConfig;
+/** Creates the appropriate SpanExporter from config */
+export declare function createExporter(config: TracingConfig): SpanExporter;
+/**
+ * Tracer creates and manages spans for a single request trace.
+ * Each request gets its own Tracer instance with a unique traceId.
+ */
+export declare class Tracer {
+    readonly traceId: string;
+    private readonly spans;
+    private readonly exporter;
+    private readonly serviceName;
+    private readonly enabled;
+    private rootSpan?;
+    constructor(options?: {
+        traceId?: string;
+        exporter?: SpanExporter;
+        serviceName?: string;
+        enabled?: boolean;
+    });
+    /** Start a root span for the incoming request */
+    startRootSpan(name: string, attributes?: Record<string, string | number | boolean>): Span;
+    /** Start a child span under the root (or specified parent) */
+    startSpan(name: string, options?: {
+        parentSpanId?: string;
+        attributes?: Record<string, string | number | boolean>;
+    }): Span;
+    /** End all open spans and export them */
+    flush(): void;
+    /** Get all collected spans as data objects */
+    getSpans(): SpanData[];
+    /** Get the root span if one was started */
+    getRootSpan(): Span | undefined;
+}
+/**
+ * Creates a Tracer for an incoming request, configured from TelemetryConfig.
+ * This is the main entry point for request-level tracing.
+ */
+export declare function createRequestTracer(telemetry?: TelemetryConfig, exporterOverride?: SpanExporter): Tracer;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

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

package/dist/tracing.js

@@ -0,0 +1,292 @@
+// ─── ID Generation ───────────────────────────────────────────
+function randomHex(bytes) {
+    const arr = new Uint8Array(bytes);
+    const cryptoObj = globalThis.crypto;
+    if (cryptoObj?.getRandomValues) {
+        cryptoObj.getRandomValues(arr);
+    }
+    else {
+        for (let i = 0; i < bytes; i++) {
+            arr[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    return Array.from(arr, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+/** Generate a 32-char hex trace ID */
+export function generateTraceId() {
+    return randomHex(16);
+}
+/** Generate a 16-char hex span ID */
+export function generateSpanId() {
+    return randomHex(8);
+}
+// ─── Console Span Exporter ───────────────────────────────────
+/** Exports spans to stdout as structured JSON (dev mode) */
+export class ConsoleSpanExporter {
+    export(spans) {
+        const proc = globalThis.process;
+        for (const span of spans) {
+            const output = JSON.stringify({ type: "span", ...span });
+            if (proc?.stdout?.write) {
+                proc.stdout.write(output + "\n");
+            }
+        }
+    }
+}
+/** No-op exporter that silently discards spans */
+export class NoopSpanExporter {
+    export(_spans) {
+        // intentionally empty
+    }
+}
+/** Exports spans to an OTLP-compatible HTTP endpoint */
+export class OtlpSpanExporter {
+    endpoint;
+    constructor(endpoint) {
+        this.endpoint = endpoint ?? "http://localhost:4318/v1/traces";
+    }
+    export(spans) {
+        // Best-effort fire-and-forget POST to OTLP endpoint
+        const fetchFn = globalThis.fetch;
+        if (fetchFn) {
+            const payload = {
+                resourceSpans: [
+                    {
+                        resource: { attributes: [] },
+                        scopeSpans: [
+                            {
+                                scope: { name: "@typokit/otel" },
+                                spans: spans.map((s) => ({
+                                    traceId: s.traceId,
+                                    spanId: s.spanId,
+                                    parentSpanId: s.parentSpanId,
+                                    name: s.name,
+                                    kind: s.kind === "server" ? 2 : 1,
+                                    startTimeUnixNano: new Date(s.startTime).getTime() * 1_000_000,
+                                    endTimeUnixNano: s.endTime
+                                        ? new Date(s.endTime).getTime() * 1_000_000
+                                        : undefined,
+                                    status: {
+                                        code: s.status === "ok" ? 1 : s.status === "error" ? 2 : 0,
+                                    },
+                                    attributes: Object.entries(s.attributes).map(([key, value]) => ({
+                                        key,
+                                        value: typeof value === "string"
+                                            ? { stringValue: value }
+                                            : typeof value === "number"
+                                                ? { intValue: value }
+                                                : { boolValue: value },
+                                    })),
+                                })),
+                            },
+                        ],
+                    },
+                ],
+            };
+            fetchFn(this.endpoint, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(payload),
+            }).catch(() => {
+                // Silently ignore export failures
+            });
+        }
+    }
+}
+// ─── Span ────────────────────────────────────────────────────
+/** A mutable span representing one phase of request processing */
+export class Span {
+    traceId;
+    spanId;
+    parentSpanId;
+    name;
+    kind;
+    startTime;
+    attributes;
+    _endTime;
+    _durationMs;
+    _status = "unset";
+    constructor(options) {
+        this.traceId = options.traceId;
+        this.spanId = options.spanId ?? generateSpanId();
+        this.parentSpanId = options.parentSpanId;
+        this.name = options.name;
+        this.kind = options.kind;
+        this.startTime = new Date().toISOString();
+        this.attributes = { ...options.attributes };
+    }
+    /** Set a key-value attribute on the span */
+    setAttribute(key, value) {
+        this.attributes[key] = value;
+    }
+    /** Mark the span as successful and end it */
+    setOk() {
+        this._status = "ok";
+    }
+    /** Mark the span as errored with an optional message */
+    setError(message) {
+        this._status = "error";
+        if (message) {
+            this.attributes["error.message"] = message;
+        }
+    }
+    /** End the span and record its duration */
+    end() {
+        this._endTime = new Date().toISOString();
+        this._durationMs =
+            new Date(this._endTime).getTime() - new Date(this.startTime).getTime();
+    }
+    /** Whether this span has been ended */
+    get ended() {
+        return this._endTime !== undefined;
+    }
+    get status() {
+        return this._status;
+    }
+    /** Convert to a plain data object for export */
+    toData() {
+        return {
+            traceId: this.traceId,
+            spanId: this.spanId,
+            ...(this.parentSpanId !== undefined
+                ? { parentSpanId: this.parentSpanId }
+                : {}),
+            name: this.name,
+            kind: this.kind,
+            startTime: this.startTime,
+            ...(this._endTime !== undefined ? { endTime: this._endTime } : {}),
+            ...(this._durationMs !== undefined
+                ? { durationMs: this._durationMs }
+                : {}),
+            status: this._status,
+            attributes: { ...this.attributes },
+        };
+    }
+}
+// ─── Tracer ──────────────────────────────────────────────────
+/** Resolves a TelemetryConfig into a normalized TracingConfig */
+export function resolveTracingConfig(telemetry) {
+    if (!telemetry) {
+        return { enabled: true, exporter: "console" };
+    }
+    if (typeof telemetry.tracing === "boolean") {
+        return {
+            enabled: telemetry.tracing,
+            exporter: telemetry.exporter ?? "console",
+            endpoint: telemetry.endpoint,
+            serviceName: telemetry.serviceName,
+        };
+    }
+    if (typeof telemetry.tracing === "object") {
+        return {
+            enabled: telemetry.tracing.enabled ?? true,
+            exporter: telemetry.tracing.exporter ?? telemetry.exporter ?? "console",
+            endpoint: telemetry.tracing.endpoint ?? telemetry.endpoint,
+            serviceName: telemetry.tracing.serviceName ?? telemetry.serviceName,
+        };
+    }
+    return {
+        enabled: true,
+        exporter: telemetry.exporter ?? "console",
+        endpoint: telemetry.endpoint,
+        serviceName: telemetry.serviceName,
+    };
+}
+/** Creates the appropriate SpanExporter from config */
+export function createExporter(config) {
+    if (!config.enabled) {
+        return new NoopSpanExporter();
+    }
+    if (config.exporter === "otlp") {
+        return new OtlpSpanExporter(config.endpoint);
+    }
+    return new ConsoleSpanExporter();
+}
+/**
+ * Tracer creates and manages spans for a single request trace.
+ * Each request gets its own Tracer instance with a unique traceId.
+ */
+export class Tracer {
+    traceId;
+    spans = [];
+    exporter;
+    serviceName;
+    enabled;
+    rootSpan;
+    constructor(options) {
+        this.traceId = options?.traceId ?? generateTraceId();
+        this.exporter = options?.exporter ?? new NoopSpanExporter();
+        this.serviceName = options?.serviceName ?? "typokit";
+        this.enabled = options?.enabled ?? true;
+    }
+    /** Start a root span for the incoming request */
+    startRootSpan(name, attributes) {
+        const span = new Span({
+            traceId: this.traceId,
+            name,
+            kind: "server",
+            attributes: {
+                "service.name": this.serviceName,
+                ...attributes,
+            },
+        });
+        this.rootSpan = span;
+        this.spans.push(span);
+        return span;
+    }
+    /** Start a child span under the root (or specified parent) */
+    startSpan(name, options) {
+        if (!this.enabled) {
+            // Return a no-op span that won't be exported
+            return new Span({
+                traceId: this.traceId,
+                name,
+                kind: "internal",
+            });
+        }
+        const parentId = options?.parentSpanId ?? this.rootSpan?.spanId;
+        const span = new Span({
+            traceId: this.traceId,
+            parentSpanId: parentId,
+            name,
+            kind: "internal",
+            attributes: options?.attributes,
+        });
+        this.spans.push(span);
+        return span;
+    }
+    /** End all open spans and export them */
+    flush() {
+        // End any spans that haven't been ended
+        for (const span of this.spans) {
+            if (!span.ended) {
+                span.end();
+            }
+        }
+        if (this.enabled && this.spans.length > 0) {
+            this.exporter.export(this.spans.map((s) => s.toData()));
+        }
+    }
+    /** Get all collected spans as data objects */
+    getSpans() {
+        return this.spans.map((s) => s.toData());
+    }
+    /** Get the root span if one was started */
+    getRootSpan() {
+        return this.rootSpan;
+    }
+}
+/**
+ * Creates a Tracer for an incoming request, configured from TelemetryConfig.
+ * This is the main entry point for request-level tracing.
+ */
+export function createRequestTracer(telemetry, exporterOverride) {
+    const config = resolveTracingConfig(telemetry);
+    const exporter = exporterOverride ?? createExporter(config);
+    return new Tracer({
+        exporter,
+        serviceName: config.serviceName,
+        enabled: config.enabled,
+    });
+}
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,117 @@
+export declare const LOG_LEVELS: readonly ["trace", "debug", "info", "warn", "error", "fatal"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+/** Metadata automatically attached to every log entry */
+export interface LogMetadata {
+    traceId?: string;
+    route?: string;
+    phase?: string;
+    requestId?: string;
+    serverAdapter?: string;
+}
+/** A single structured log entry */
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: string;
+    data?: Record<string, unknown>;
+    traceId?: string;
+    route?: string;
+    phase?: string;
+    requestId?: string;
+    serverAdapter?: string;
+}
+/** Configuration for the logging system */
+export interface LoggingConfig {
+    /** Minimum log level (default: "info" in production, "debug" in development) */
+    level?: LogLevel;
+    /** Glob-style paths to redact from log output (e.g., "*.password", "authorization") */
+    redact?: string[];
+}
+/** A sink that receives structured log entries */
+export interface LogSink {
+    write(entry: LogEntry): void;
+}
+/** Status of a span */
+export type SpanStatus = "ok" | "error" | "unset";
+/** A single span representing a phase of request processing */
+export interface SpanData {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: "server" | "internal";
+    startTime: string;
+    endTime?: string;
+    durationMs?: number;
+    status: SpanStatus;
+    attributes: Record<string, string | number | boolean>;
+}
+/** Configuration for the tracing system */
+export interface TracingConfig {
+    /** Enable tracing (default: true in dev) */
+    enabled?: boolean;
+    /** Exporter type: 'console' for dev, 'otlp' for collectors */
+    exporter?: "console" | "otlp";
+    /** OTel Collector endpoint (default: http://localhost:4318) */
+    endpoint?: string;
+    /** Service name for OTel resource */
+    serviceName?: string;
+}
+/** Full telemetry configuration for createApp() */
+export interface TelemetryConfig {
+    tracing?: boolean | TracingConfig;
+    metrics?: boolean | MetricsConfig;
+    exporter?: "console" | "otlp";
+    endpoint?: string;
+    serviceName?: string;
+}
+/** Interface for exporting completed spans */
+export interface SpanExporter {
+    export(spans: SpanData[]): void;
+}
+/** Configuration for the metrics system */
+export interface MetricsConfig {
+    /** Enable metrics collection (default: true) */
+    enabled?: boolean;
+    /** Exporter type: 'console' for dev, 'otlp' for collectors */
+    exporter?: "console" | "otlp";
+    /** OTel Collector endpoint (default: http://localhost:4318) */
+    endpoint?: string;
+    /** Service name for OTel resource */
+    serviceName?: string;
+}
+/** Labels applied to all request metrics */
+export interface MetricLabels {
+    route: string;
+    method: string;
+    status: number;
+}
+/** A single histogram data point */
+export interface HistogramDataPoint {
+    labels: MetricLabels;
+    value: number;
+    timestamp: string;
+}
+/** A single gauge data point */
+export interface GaugeDataPoint {
+    labels: Partial<MetricLabels>;
+    value: number;
+    timestamp: string;
+}
+/** A single counter data point */
+export interface CounterDataPoint {
+    labels: MetricLabels;
+    value: number;
+    timestamp: string;
+}
+/** Collected metric data for export */
+export interface MetricData {
+    name: string;
+    type: "histogram" | "gauge" | "counter";
+    dataPoints: (HistogramDataPoint | GaugeDataPoint | CounterDataPoint)[];
+}
+/** Interface for exporting collected metrics */
+export interface MetricExporter {
+    export(metrics: MetricData[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,UAAU,+DAOb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC9B;AAID,uBAAuB;AACvB,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAElD,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACvD;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAClC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;CACjC;AAID,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,CAAC,kBAAkB,GAAG,cAAc,GAAG,gBAAgB,CAAC,EAAE,CAAC;CACxE;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;CACrC"}

package/dist/types.js

@@ -0,0 +1,10 @@
+// Log levels ordered by severity
+export const LOG_LEVELS = [
+    "trace",
+    "debug",
+    "info",
+    "warn",
+    "error",
+    "fatal",
+];
+//# 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,iCAAiC;AACjC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;CACC,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@typokit/otel",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "version": "0.1.4",
+  "type": "module",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@typokit/types": "0.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KyleBastien/typokit",
+    "directory": "packages/otel"
+  },
+  "scripts": {
+    "test": "rstest run --passWithNoTests"
+  }
+}