@unhingged/logit 0.0.0-stage → 0.1.0

package/dist/otel.js

@@ -0,0 +1,304 @@
+import {
+  CLEF_MEDIA_TYPE,
+  DEFAULT_DESTRUCTURING,
+  DEFAULT_OUTPUT_TEMPLATE,
+  LEVELS,
+  LEVEL_CODES,
+  LEVEL_NUMBERS,
+  LEVEL_ORDER,
+  LevelSwitch,
+  LogContext,
+  LogEvent,
+  Logger,
+  LoggerConfiguration,
+  Matching,
+  Operation,
+  SERILOG_LEVEL_NAMES,
+  ansi,
+  audit,
+  batchingSink,
+  byExcluding,
+  byIncludingOnly,
+  byTransforming,
+  callbackSink,
+  captureError,
+  captureProperty,
+  captureValue,
+  clefFormatter,
+  closeAndFlush,
+  conditional,
+  configure,
+  consoleSink,
+  createLogger,
+  detectColors,
+  diagnosticContext,
+  formatDate,
+  formatError,
+  formatLevel,
+  formatNumber,
+  fromLogContext,
+  httpSink,
+  isLevel,
+  isoTimestamp,
+  jsonFormatter,
+  jsonReplacer,
+  levelAtLeast,
+  log,
+  mapSink,
+  memorySink,
+  parseLevel,
+  parseTemplate,
+  prettyFormatter,
+  rateLimited,
+  renderTemplate,
+  renderValue,
+  resolveFormatter,
+  resolveLevel,
+  resolveStyles,
+  restricted,
+  sampled,
+  selfLog,
+  seqSink,
+  streamSink,
+  templateHash,
+  textFormatter,
+  toJson,
+  withComputed,
+  withEnvironment,
+  withProperties,
+  withProperty,
+  withTraceContext
+} from "./chunk-GW7WQELF.js";
+
+// src/otel.ts
+var OTEL_SEVERITY = {
+  verbose: { number: 1, text: "TRACE" },
+  debug: { number: 5, text: "DEBUG" },
+  info: { number: 9, text: "INFO" },
+  warn: { number: 13, text: "WARN" },
+  error: { number: 17, text: "ERROR" },
+  fatal: { number: 21, text: "FATAL" }
+};
+function toAnyValue(value) {
+  if (value === null || value === void 0) return { stringValue: "" };
+  switch (typeof value) {
+    case "string":
+      return { stringValue: value };
+    case "number":
+      return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };
+    case "boolean":
+      return { boolValue: value };
+    case "bigint":
+      return { intValue: value.toString() };
+    default:
+      break;
+  }
+  if (value instanceof Date) return { stringValue: value.toISOString() };
+  if (Array.isArray(value)) return { arrayValue: { values: value.map(toAnyValue) } };
+  if (typeof value === "object") return { kvlistValue: { values: toKeyValues(value) } };
+  return { stringValue: String(value) };
+}
+function toKeyValues(record) {
+  return Object.keys(record).map((key) => ({ key, value: toAnyValue(record[key]) }));
+}
+function encodeOtlpLogs(events, options = {}) {
+  const templateAttribute = options.templateAttribute === void 0 ? "message_template.text" : options.templateAttribute;
+  return {
+    resourceLogs: [
+      {
+        resource: { attributes: toKeyValues({ ...options.resource }) },
+        scopeLogs: [
+          {
+            scope: options.scope ?? { name: "@unhingged/logit" },
+            logRecords: events.map((event) => {
+              const attributes = [];
+              if (templateAttribute) attributes.push({ key: templateAttribute, value: { stringValue: event.messageTemplate } });
+              for (const key of Object.keys(event.properties)) attributes.push({ key, value: toAnyValue(event.properties[key]) });
+              if (event.error) {
+                attributes.push({ key: "exception.type", value: { stringValue: event.error.name } });
+                attributes.push({ key: "exception.message", value: { stringValue: event.error.message } });
+                attributes.push({ key: "exception.stacktrace", value: { stringValue: formatError(event.error) } });
+              }
+              const severity = OTEL_SEVERITY[event.level];
+              const nanos = `${event.timestamp.getTime()}000000`;
+              return {
+                timeUnixNano: nanos,
+                observedTimeUnixNano: nanos,
+                severityNumber: severity.number,
+                severityText: severity.text,
+                body: { stringValue: event.renderMessage({ literal: true }) },
+                attributes,
+                ...event.traceId ? { traceId: event.traceId } : {},
+                ...event.spanId ? { spanId: event.spanId } : {}
+              };
+            })
+          }
+        ]
+      }
+    ]
+  };
+}
+function env(name) {
+  return globalThis.process?.env?.[name];
+}
+function envHeaders() {
+  const raw = env("OTEL_EXPORTER_OTLP_LOGS_HEADERS") ?? env("OTEL_EXPORTER_OTLP_HEADERS");
+  const out = {};
+  if (!raw) return out;
+  for (const pair of raw.split(",")) {
+    const i = pair.indexOf("=");
+    if (i > 0) out[pair.slice(0, i).trim()] = decodeURIComponent(pair.slice(i + 1).trim());
+  }
+  return out;
+}
+function otlpHttpSink(options = {}) {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  if (!fetchImpl) throw new Error("logit: otlpHttpSink needs fetch \u2014 pass one in options.fetch");
+  const url = options.url ?? env("OTEL_EXPORTER_OTLP_LOGS_ENDPOINT") ?? `${(env("OTEL_EXPORTER_OTLP_ENDPOINT") ?? "http://localhost:4318").replace(/\/$/, "")}/v1/logs`;
+  const serviceName = env("OTEL_SERVICE_NAME");
+  const resource = { ...serviceName ? { "service.name": serviceName } : {}, ...options.resource };
+  const timeout = options.timeout ?? 1e4;
+  return batchingSink(
+    async (events) => {
+      const controller = typeof AbortController === "function" ? new AbortController() : void 0;
+      const timer = controller ? setTimeout(() => controller.abort(), timeout) : void 0;
+      timer?.unref?.();
+      try {
+        const response = await fetchImpl(url, {
+          method: "POST",
+          headers: { "content-type": "application/json", ...envHeaders(), ...options.headers },
+          body: JSON.stringify(encodeOtlpLogs(events, { ...options, resource })),
+          signal: controller?.signal,
+          keepalive: true
+        });
+        if (!response.ok) throw new Error(`OTLP export failed: HTTP ${response.status}`);
+      } finally {
+        if (timer) clearTimeout(timer);
+      }
+    },
+    { name: `otlp(${url})`, ...options }
+  );
+}
+function flattenAttributes(record, prefix = "", into = {}) {
+  for (const key of Object.keys(record)) {
+    const value = record[key];
+    const name = prefix ? `${prefix}.${key}` : key;
+    if (value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date)) {
+      flattenAttributes(value, name, into);
+    } else if (value instanceof Date) {
+      into[name] = value.toISOString();
+    } else if (Array.isArray(value)) {
+      into[name] = value.every((v) => v === null || ["string", "number", "boolean"].includes(typeof v)) ? value : JSON.stringify(value);
+    } else {
+      into[name] = value;
+    }
+  }
+  return into;
+}
+function otelBridgeSink(provider, options = {}) {
+  const scope = options.scope ?? { name: "@unhingged/logit" };
+  const otelLogger = provider.getLogger(scope.name, scope.version);
+  const templateAttribute = options.templateAttribute === void 0 ? "message_template.text" : options.templateAttribute;
+  const flatten = options.flatten ?? true;
+  return {
+    name: "otel-bridge",
+    restrictedToMinimumLevel: options.restrictedToMinimumLevel,
+    audit: options.audit,
+    emit(event) {
+      const raw = { ...event.properties };
+      if (templateAttribute) raw[templateAttribute] = event.messageTemplate;
+      if (event.error) {
+        raw["exception.type"] = event.error.name;
+        raw["exception.message"] = event.error.message;
+        raw["exception.stacktrace"] = formatError(event.error);
+      }
+      const severity = OTEL_SEVERITY[event.level];
+      otelLogger.emit({
+        timestamp: event.timestamp,
+        observedTimestamp: event.timestamp,
+        severityNumber: severity.number,
+        severityText: severity.text,
+        body: event.renderMessage({ literal: true }),
+        attributes: flatten ? flattenAttributes(raw) : raw
+      });
+    }
+  };
+}
+export {
+  CLEF_MEDIA_TYPE,
+  DEFAULT_DESTRUCTURING,
+  DEFAULT_OUTPUT_TEMPLATE,
+  LEVELS,
+  LEVEL_CODES,
+  LEVEL_NUMBERS,
+  LEVEL_ORDER,
+  LevelSwitch,
+  LogContext,
+  LogEvent,
+  Logger,
+  LoggerConfiguration,
+  Matching,
+  OTEL_SEVERITY,
+  Operation,
+  SERILOG_LEVEL_NAMES,
+  ansi,
+  audit,
+  batchingSink,
+  byExcluding,
+  byIncludingOnly,
+  byTransforming,
+  callbackSink,
+  captureError,
+  captureProperty,
+  captureValue,
+  clefFormatter,
+  closeAndFlush,
+  conditional,
+  configure,
+  consoleSink,
+  createLogger,
+  detectColors,
+  diagnosticContext,
+  encodeOtlpLogs,
+  flattenAttributes,
+  formatDate,
+  formatError,
+  formatLevel,
+  formatNumber,
+  fromLogContext,
+  httpSink,
+  isLevel,
+  isoTimestamp,
+  jsonFormatter,
+  jsonReplacer,
+  levelAtLeast,
+  log,
+  mapSink,
+  memorySink,
+  otelBridgeSink,
+  otlpHttpSink,
+  parseLevel,
+  parseTemplate,
+  prettyFormatter,
+  rateLimited,
+  renderTemplate,
+  renderValue,
+  resolveFormatter,
+  resolveLevel,
+  resolveStyles,
+  restricted,
+  sampled,
+  selfLog,
+  seqSink,
+  streamSink,
+  templateHash,
+  textFormatter,
+  toAnyValue,
+  toJson,
+  withComputed,
+  withEnvironment,
+  withProperties,
+  withProperty,
+  withTraceContext
+};
+//# sourceMappingURL=otel.js.map

package/dist/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/otel.ts"],"sourcesContent":["/**\n * `@unhingged/logit/otel` — OpenTelemetry without the SDK:\n *\n *   otlpHttpSink()    OTLP/HTTP JSON straight to a collector, Grafana,\n *                     Honeycomb, Datadog, Dash0… (`/v1/logs`), batched.\n *   otelBridgeSink()  hands events to an OpenTelemetry `LoggerProvider`\n *                     you already have, structurally typed so this package\n *                     does not depend on `@opentelemetry/api-logs`.\n *\n * Mapping follows Serilog.Sinks.OpenTelemetry: the rendered message is the\n * body, every property is an attribute of the same name, the template goes\n * in `message_template.text`, the error in `exception.*`.\n */\nimport type { LogEvent } from './event';\nimport { formatError } from './format/text';\nimport type { LogLevel } from './levels';\nimport { type BatchingOptions, type BatchingSink, batchingSink } from './sinks/batching';\nimport type { FetchLike } from './sinks/http';\nimport type { Sink, SinkOptions } from './sinks/types';\n\nexport * from './index';\n\n/** OpenTelemetry severity numbers for the six levels. */\nexport const OTEL_SEVERITY: Readonly<Record<LogLevel, { number: number; text: string }>> = {\n  verbose: { number: 1, text: 'TRACE' },\n  debug: { number: 5, text: 'DEBUG' },\n  info: { number: 9, text: 'INFO' },\n  warn: { number: 13, text: 'WARN' },\n  error: { number: 17, text: 'ERROR' },\n  fatal: { number: 21, text: 'FATAL' },\n};\n\ntype AnyValue =\n  | { stringValue: string }\n  | { intValue: string }\n  | { doubleValue: number }\n  | { boolValue: boolean }\n  | { arrayValue: { values: AnyValue[] } }\n  | { kvlistValue: { values: KeyValue[] } };\n\ninterface KeyValue {\n  key: string;\n  value: AnyValue;\n}\n\n/** Encodes a captured value as an OTLP `AnyValue` (the protobuf JSON mapping: int64 as a string). */\nexport function toAnyValue(value: unknown): AnyValue {\n  if (value === null || value === undefined) return { stringValue: '' };\n  switch (typeof value) {\n    case 'string':\n      return { stringValue: value };\n    case 'number':\n      return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };\n    case 'boolean':\n      return { boolValue: value };\n    case 'bigint':\n      return { intValue: value.toString() };\n    default:\n      break;\n  }\n  if (value instanceof Date) return { stringValue: value.toISOString() };\n  if (Array.isArray(value)) return { arrayValue: { values: value.map(toAnyValue) } };\n  if (typeof value === 'object') return { kvlistValue: { values: toKeyValues(value as Record<string, unknown>) } };\n  return { stringValue: String(value) };\n}\n\nfunction toKeyValues(record: Record<string, unknown>): KeyValue[] {\n  return Object.keys(record).map((key) => ({ key, value: toAnyValue(record[key]) }));\n}\n\nexport interface OtlpAttributes {\n  [key: string]: unknown;\n}\n\nexport interface OtlpEncodeOptions {\n  /** Resource attributes — `service.name` at least. */\n  resource?: OtlpAttributes;\n  scope?: { name: string; version?: string };\n  /** Attribute name for the message template. Default `message_template.text` (Serilog's). `false` to omit. */\n  templateAttribute?: string | false;\n}\n\n/** Builds the `ExportLogsServiceRequest` JSON for a batch. */\nexport function encodeOtlpLogs(events: LogEvent[], options: OtlpEncodeOptions = {}): unknown {\n  const templateAttribute = options.templateAttribute === undefined ? 'message_template.text' : options.templateAttribute;\n  return {\n    resourceLogs: [\n      {\n        resource: { attributes: toKeyValues({ ...options.resource }) },\n        scopeLogs: [\n          {\n            scope: options.scope ?? { name: '@unhingged/logit' },\n            logRecords: events.map((event) => {\n              const attributes: KeyValue[] = [];\n              if (templateAttribute) attributes.push({ key: templateAttribute, value: { stringValue: event.messageTemplate } });\n              for (const key of Object.keys(event.properties)) attributes.push({ key, value: toAnyValue(event.properties[key]) });\n              if (event.error) {\n                attributes.push({ key: 'exception.type', value: { stringValue: event.error.name } });\n                attributes.push({ key: 'exception.message', value: { stringValue: event.error.message } });\n                attributes.push({ key: 'exception.stacktrace', value: { stringValue: formatError(event.error) } });\n              }\n              const severity = OTEL_SEVERITY[event.level];\n              const nanos = `${event.timestamp.getTime()}000000`;\n              return {\n                timeUnixNano: nanos,\n                observedTimeUnixNano: nanos,\n                severityNumber: severity.number,\n                severityText: severity.text,\n                body: { stringValue: event.renderMessage({ literal: true }) },\n                attributes,\n                ...(event.traceId ? { traceId: event.traceId } : {}),\n                ...(event.spanId ? { spanId: event.spanId } : {}),\n              };\n            }),\n          },\n        ],\n      },\n    ],\n  };\n}\n\nexport interface OtlpHttpSinkOptions extends BatchingOptions, OtlpEncodeOptions {\n  /** Default `http://localhost:4318/v1/logs`, or `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` / `OTEL_EXPORTER_OTLP_ENDPOINT` + `/v1/logs`. */\n  url?: string;\n  headers?: Record<string, string>;\n  timeout?: number;\n  fetch?: FetchLike;\n}\n\nfunction env(name: string): string | undefined {\n  return (globalThis as { process?: { env?: Record<string, string | undefined> } }).process?.env?.[name];\n}\n\n/** `OTEL_EXPORTER_OTLP_HEADERS=\"key=value,key2=value2\"` */\nfunction envHeaders(): Record<string, string> {\n  const raw = env('OTEL_EXPORTER_OTLP_LOGS_HEADERS') ?? env('OTEL_EXPORTER_OTLP_HEADERS');\n  const out: Record<string, string> = {};\n  if (!raw) return out;\n  for (const pair of raw.split(',')) {\n    const i = pair.indexOf('=');\n    if (i > 0) out[pair.slice(0, i).trim()] = decodeURIComponent(pair.slice(i + 1).trim());\n  }\n  return out;\n}\n\n/** OTLP/HTTP JSON to `/v1/logs`. Honours the standard `OTEL_EXPORTER_OTLP_*` variables. */\nexport function otlpHttpSink(options: OtlpHttpSinkOptions = {}): BatchingSink {\n  const fetchImpl: FetchLike = options.fetch ?? ((globalThis as { fetch?: FetchLike }).fetch as FetchLike);\n  if (!fetchImpl) throw new Error('logit: otlpHttpSink needs fetch — pass one in options.fetch');\n  const url = options.url ?? env('OTEL_EXPORTER_OTLP_LOGS_ENDPOINT') ?? `${(env('OTEL_EXPORTER_OTLP_ENDPOINT') ?? 'http://localhost:4318').replace(/\\/$/, '')}/v1/logs`;\n  const serviceName = env('OTEL_SERVICE_NAME');\n  const resource = { ...(serviceName ? { 'service.name': serviceName } : {}), ...options.resource };\n  const timeout = options.timeout ?? 10_000;\n\n  return batchingSink(\n    async (events) => {\n      const controller = typeof AbortController === 'function' ? new AbortController() : undefined;\n      const timer = controller ? setTimeout(() => controller.abort(), timeout) : undefined;\n      (timer as { unref?: () => void } | undefined)?.unref?.();\n      try {\n        const response = await fetchImpl(url, {\n          method: 'POST',\n          headers: { 'content-type': 'application/json', ...envHeaders(), ...options.headers },\n          body: JSON.stringify(encodeOtlpLogs(events, { ...options, resource })),\n          signal: controller?.signal,\n          keepalive: true,\n        });\n        if (!response.ok) throw new Error(`OTLP export failed: HTTP ${response.status}`);\n      } finally {\n        if (timer) clearTimeout(timer);\n      }\n    },\n    { name: `otlp(${url})`, ...options },\n  );\n}\n\n/** The slice of `@opentelemetry/api-logs` we call — structural on purpose. */\nexport interface OtelLogRecord {\n  timestamp?: number | Date;\n  observedTimestamp?: number | Date;\n  severityNumber?: number;\n  severityText?: string;\n  body?: string;\n  attributes?: Record<string, unknown>;\n}\n\nexport interface OtelLogger {\n  emit(record: OtelLogRecord): void;\n}\n\nexport interface OtelLoggerProvider {\n  getLogger(name: string, version?: string, options?: unknown): OtelLogger;\n}\n\nexport interface OtelBridgeOptions extends SinkOptions {\n  scope?: { name: string; version?: string };\n  templateAttribute?: string | false;\n  /** OpenTelemetry attributes are flat: nested objects are flattened with dots (`user.id`). Default true; `false` passes them through. */\n  flatten?: boolean;\n}\n\n/** Flattens nested objects into dotted keys for the OTel attributes API. */\nexport function flattenAttributes(record: Record<string, unknown>, prefix = '', into: Record<string, unknown> = {}): Record<string, unknown> {\n  for (const key of Object.keys(record)) {\n    const value = record[key];\n    const name = prefix ? `${prefix}.${key}` : key;\n    if (value !== null && typeof value === 'object' && !Array.isArray(value) && !(value instanceof Date)) {\n      flattenAttributes(value as Record<string, unknown>, name, into);\n    } else if (value instanceof Date) {\n      into[name] = value.toISOString();\n    } else if (Array.isArray(value)) {\n      into[name] = value.every((v) => v === null || ['string', 'number', 'boolean'].includes(typeof v)) ? value : JSON.stringify(value);\n    } else {\n      into[name] = value as unknown;\n    }\n  }\n  return into;\n}\n\n/**\n * Hands each event to `provider.getLogger(scope)` — use it when the OTel SDK\n * is already set up (`logs.getLoggerProvider()`), so trace context, resource\n * and exporters are all the SDK's.\n */\nexport function otelBridgeSink(provider: OtelLoggerProvider, options: OtelBridgeOptions = {}): Sink {\n  const scope = options.scope ?? { name: '@unhingged/logit' };\n  const otelLogger = provider.getLogger(scope.name, scope.version);\n  const templateAttribute = options.templateAttribute === undefined ? 'message_template.text' : options.templateAttribute;\n  const flatten = options.flatten ?? true;\n  return {\n    name: 'otel-bridge',\n    restrictedToMinimumLevel: options.restrictedToMinimumLevel,\n    audit: options.audit,\n    emit(event: LogEvent) {\n      const raw: Record<string, unknown> = { ...event.properties };\n      if (templateAttribute) raw[templateAttribute] = event.messageTemplate;\n      if (event.error) {\n        raw['exception.type'] = event.error.name;\n        raw['exception.message'] = event.error.message;\n        raw['exception.stacktrace'] = formatError(event.error);\n      }\n      const severity = OTEL_SEVERITY[event.level];\n      otelLogger.emit({\n        timestamp: event.timestamp,\n        observedTimestamp: event.timestamp,\n        severityNumber: severity.number,\n        severityText: severity.text,\n        body: event.renderMessage({ literal: true }),\n        attributes: flatten ? flattenAttributes(raw) : raw,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBO,IAAM,gBAA8E;AAAA,EACzF,SAAS,EAAE,QAAQ,GAAG,MAAM,QAAQ;AAAA,EACpC,OAAO,EAAE,QAAQ,GAAG,MAAM,QAAQ;AAAA,EAClC,MAAM,EAAE,QAAQ,GAAG,MAAM,OAAO;AAAA,EAChC,MAAM,EAAE,QAAQ,IAAI,MAAM,OAAO;AAAA,EACjC,OAAO,EAAE,QAAQ,IAAI,MAAM,QAAQ;AAAA,EACnC,OAAO,EAAE,QAAQ,IAAI,MAAM,QAAQ;AACrC;AAgBO,SAAS,WAAW,OAA0B;AACnD,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO,EAAE,aAAa,GAAG;AACpE,UAAQ,OAAO,OAAO;AAAA,IACpB,KAAK;AACH,aAAO,EAAE,aAAa,MAAM;AAAA,IAC9B,KAAK;AACH,aAAO,OAAO,UAAU,KAAK,IAAI,EAAE,UAAU,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,MAAM;AAAA,IACtF,KAAK;AACH,aAAO,EAAE,WAAW,MAAM;AAAA,IAC5B,KAAK;AACH,aAAO,EAAE,UAAU,MAAM,SAAS,EAAE;AAAA,IACtC;AACE;AAAA,EACJ;AACA,MAAI,iBAAiB,KAAM,QAAO,EAAE,aAAa,MAAM,YAAY,EAAE;AACrE,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,EAAE,YAAY,EAAE,QAAQ,MAAM,IAAI,UAAU,EAAE,EAAE;AACjF,MAAI,OAAO,UAAU,SAAU,QAAO,EAAE,aAAa,EAAE,QAAQ,YAAY,KAAgC,EAAE,EAAE;AAC/G,SAAO,EAAE,aAAa,OAAO,KAAK,EAAE;AACtC;AAEA,SAAS,YAAY,QAA6C;AAChE,SAAO,OAAO,KAAK,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,OAAO,WAAW,OAAO,GAAG,CAAC,EAAE,EAAE;AACnF;AAeO,SAAS,eAAe,QAAoB,UAA6B,CAAC,GAAY;AAC3F,QAAM,oBAAoB,QAAQ,sBAAsB,SAAY,0BAA0B,QAAQ;AACtG,SAAO;AAAA,IACL,cAAc;AAAA,MACZ;AAAA,QACE,UAAU,EAAE,YAAY,YAAY,EAAE,GAAG,QAAQ,SAAS,CAAC,EAAE;AAAA,QAC7D,WAAW;AAAA,UACT;AAAA,YACE,OAAO,QAAQ,SAAS,EAAE,MAAM,mBAAmB;AAAA,YACnD,YAAY,OAAO,IAAI,CAAC,UAAU;AAChC,oBAAM,aAAyB,CAAC;AAChC,kBAAI,kBAAmB,YAAW,KAAK,EAAE,KAAK,mBAAmB,OAAO,EAAE,aAAa,MAAM,gBAAgB,EAAE,CAAC;AAChH,yBAAW,OAAO,OAAO,KAAK,MAAM,UAAU,EAAG,YAAW,KAAK,EAAE,KAAK,OAAO,WAAW,MAAM,WAAW,GAAG,CAAC,EAAE,CAAC;AAClH,kBAAI,MAAM,OAAO;AACf,2BAAW,KAAK,EAAE,KAAK,kBAAkB,OAAO,EAAE,aAAa,MAAM,MAAM,KAAK,EAAE,CAAC;AACnF,2BAAW,KAAK,EAAE,KAAK,qBAAqB,OAAO,EAAE,aAAa,MAAM,MAAM,QAAQ,EAAE,CAAC;AACzF,2BAAW,KAAK,EAAE,KAAK,wBAAwB,OAAO,EAAE,aAAa,YAAY,MAAM,KAAK,EAAE,EAAE,CAAC;AAAA,cACnG;AACA,oBAAM,WAAW,cAAc,MAAM,KAAK;AAC1C,oBAAM,QAAQ,GAAG,MAAM,UAAU,QAAQ,CAAC;AAC1C,qBAAO;AAAA,gBACL,cAAc;AAAA,gBACd,sBAAsB;AAAA,gBACtB,gBAAgB,SAAS;AAAA,gBACzB,cAAc,SAAS;AAAA,gBACvB,MAAM,EAAE,aAAa,MAAM,cAAc,EAAE,SAAS,KAAK,CAAC,EAAE;AAAA,gBAC5D;AAAA,gBACA,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;AAAA,gBAClD,GAAI,MAAM,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;AAAA,cACjD;AAAA,YACF,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAUA,SAAS,IAAI,MAAkC;AAC7C,SAAQ,WAA0E,SAAS,MAAM,IAAI;AACvG;AAGA,SAAS,aAAqC;AAC5C,QAAM,MAAM,IAAI,iCAAiC,KAAK,IAAI,4BAA4B;AACtF,QAAM,MAA8B,CAAC;AACrC,MAAI,CAAC,IAAK,QAAO;AACjB,aAAW,QAAQ,IAAI,MAAM,GAAG,GAAG;AACjC,UAAM,IAAI,KAAK,QAAQ,GAAG;AAC1B,QAAI,IAAI,EAAG,KAAI,KAAK,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,IAAI,mBAAmB,KAAK,MAAM,IAAI,CAAC,EAAE,KAAK,CAAC;AAAA,EACvF;AACA,SAAO;AACT;AAGO,SAAS,aAAa,UAA+B,CAAC,GAAiB;AAC5E,QAAM,YAAuB,QAAQ,SAAW,WAAqC;AACrF,MAAI,CAAC,UAAW,OAAM,IAAI,MAAM,kEAA6D;AAC7F,QAAM,MAAM,QAAQ,OAAO,IAAI,kCAAkC,KAAK,IAAI,IAAI,6BAA6B,KAAK,yBAAyB,QAAQ,OAAO,EAAE,CAAC;AAC3J,QAAM,cAAc,IAAI,mBAAmB;AAC3C,QAAM,WAAW,EAAE,GAAI,cAAc,EAAE,gBAAgB,YAAY,IAAI,CAAC,GAAI,GAAG,QAAQ,SAAS;AAChG,QAAM,UAAU,QAAQ,WAAW;AAEnC,SAAO;AAAA,IACL,OAAO,WAAW;AAChB,YAAM,aAAa,OAAO,oBAAoB,aAAa,IAAI,gBAAgB,IAAI;AACnF,YAAM,QAAQ,aAAa,WAAW,MAAM,WAAW,MAAM,GAAG,OAAO,IAAI;AAC3E,MAAC,OAA8C,QAAQ;AACvD,UAAI;AACF,cAAM,WAAW,MAAM,UAAU,KAAK;AAAA,UACpC,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,oBAAoB,GAAG,WAAW,GAAG,GAAG,QAAQ,QAAQ;AAAA,UACnF,MAAM,KAAK,UAAU,eAAe,QAAQ,EAAE,GAAG,SAAS,SAAS,CAAC,CAAC;AAAA,UACrE,QAAQ,YAAY;AAAA,UACpB,WAAW;AAAA,QACb,CAAC;AACD,YAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,4BAA4B,SAAS,MAAM,EAAE;AAAA,MACjF,UAAE;AACA,YAAI,MAAO,cAAa,KAAK;AAAA,MAC/B;AAAA,IACF;AAAA,IACA,EAAE,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ;AAAA,EACrC;AACF;AA4BO,SAAS,kBAAkB,QAAiC,SAAS,IAAI,OAAgC,CAAC,GAA4B;AAC3I,aAAW,OAAO,OAAO,KAAK,MAAM,GAAG;AACrC,UAAM,QAAQ,OAAO,GAAG;AACxB,UAAM,OAAO,SAAS,GAAG,MAAM,IAAI,GAAG,KAAK;AAC3C,QAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,KAAK,EAAE,iBAAiB,OAAO;AACpG,wBAAkB,OAAkC,MAAM,IAAI;AAAA,IAChE,WAAW,iBAAiB,MAAM;AAChC,WAAK,IAAI,IAAI,MAAM,YAAY;AAAA,IACjC,WAAW,MAAM,QAAQ,KAAK,GAAG;AAC/B,WAAK,IAAI,IAAI,MAAM,MAAM,CAAC,MAAM,MAAM,QAAQ,CAAC,UAAU,UAAU,SAAS,EAAE,SAAS,OAAO,CAAC,CAAC,IAAI,QAAQ,KAAK,UAAU,KAAK;AAAA,IAClI,OAAO;AACL,WAAK,IAAI,IAAI;AAAA,IACf;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,eAAe,UAA8B,UAA6B,CAAC,GAAS;AAClG,QAAM,QAAQ,QAAQ,SAAS,EAAE,MAAM,mBAAmB;AAC1D,QAAM,aAAa,SAAS,UAAU,MAAM,MAAM,MAAM,OAAO;AAC/D,QAAM,oBAAoB,QAAQ,sBAAsB,SAAY,0BAA0B,QAAQ;AACtG,QAAM,UAAU,QAAQ,WAAW;AACnC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,0BAA0B,QAAQ;AAAA,IAClC,OAAO,QAAQ;AAAA,IACf,KAAK,OAAiB;AACpB,YAAM,MAA+B,EAAE,GAAG,MAAM,WAAW;AAC3D,UAAI,kBAAmB,KAAI,iBAAiB,IAAI,MAAM;AACtD,UAAI,MAAM,OAAO;AACf,YAAI,gBAAgB,IAAI,MAAM,MAAM;AACpC,YAAI,mBAAmB,IAAI,MAAM,MAAM;AACvC,YAAI,sBAAsB,IAAI,YAAY,MAAM,KAAK;AAAA,MACvD;AACA,YAAM,WAAW,cAAc,MAAM,KAAK;AAC1C,iBAAW,KAAK;AAAA,QACd,WAAW,MAAM;AAAA,QACjB,mBAAmB,MAAM;AAAA,QACzB,gBAAgB,SAAS;AAAA,QACzB,cAAc,SAAS;AAAA,QACvB,MAAM,MAAM,cAAc,EAAE,SAAS,KAAK,CAAC;AAAA,QAC3C,YAAY,UAAU,kBAAkB,GAAG,IAAI;AAAA,MACjD,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/request-7cW3twuF.d.ts

@@ -0,0 +1,34 @@
+import { Logger, LogLevel } from './index.js';
+
+declare const REQUEST_COMPLETION_TEMPLATE = "HTTP {RequestMethod} {RequestPath} responded {StatusCode} in {Elapsed:0.0000} ms";
+interface RequestInfo {
+    method: string;
+    path: string;
+    /** Full URL or path + query, used for the log only when `includeQuery`. */
+    url?: string;
+    requestId?: string;
+    headers?: {
+        get(name: string): string | null | undefined;
+    } | Record<string, string | string[] | undefined>;
+}
+interface RequestLoggingOptions {
+    logger?: Logger;
+    /** The completion message. Default `REQUEST_COMPLETION_TEMPLATE`. */
+    messageTemplate?: string;
+    /** Picks the level — the default is `error` for an exception or a 5xx, `info` otherwise. */
+    getLevel?: (status: number, elapsedMs: number, error: unknown) => LogLevel;
+    /** Adds properties to the completion event (Serilog's `EnrichDiagnosticContext`). */
+    enrich?: (set: (name: string, value: unknown) => void, request: RequestInfo, response: {
+        status: number;
+    }) => void;
+    /** Requests to skip entirely — health checks, static assets. */
+    ignore?: (request: RequestInfo) => boolean;
+    /** Header to read a request id from (set by load balancers; Vercel sends `x-vercel-id`). Default `x-request-id`, then `x-vercel-id`. */
+    requestIdHeader?: string | string[];
+    /** Generate an id when the request has none. Default: `crypto.randomUUID()`. */
+    generateRequestId?: () => string;
+    /** `SourceContext` for the completion event. Default `'http'`. */
+    source?: string;
+}
+
+export { type RequestLoggingOptions as R, REQUEST_COMPLETION_TEMPLATE as a, type RequestInfo as b };

package/dist/request-DrVrbDze.d.cts

@@ -0,0 +1,34 @@
+import { Logger, LogLevel } from './index.cjs';
+
+declare const REQUEST_COMPLETION_TEMPLATE = "HTTP {RequestMethod} {RequestPath} responded {StatusCode} in {Elapsed:0.0000} ms";
+interface RequestInfo {
+    method: string;
+    path: string;
+    /** Full URL or path + query, used for the log only when `includeQuery`. */
+    url?: string;
+    requestId?: string;
+    headers?: {
+        get(name: string): string | null | undefined;
+    } | Record<string, string | string[] | undefined>;
+}
+interface RequestLoggingOptions {
+    logger?: Logger;
+    /** The completion message. Default `REQUEST_COMPLETION_TEMPLATE`. */
+    messageTemplate?: string;
+    /** Picks the level — the default is `error` for an exception or a 5xx, `info` otherwise. */
+    getLevel?: (status: number, elapsedMs: number, error: unknown) => LogLevel;
+    /** Adds properties to the completion event (Serilog's `EnrichDiagnosticContext`). */
+    enrich?: (set: (name: string, value: unknown) => void, request: RequestInfo, response: {
+        status: number;
+    }) => void;
+    /** Requests to skip entirely — health checks, static assets. */
+    ignore?: (request: RequestInfo) => boolean;
+    /** Header to read a request id from (set by load balancers; Vercel sends `x-vercel-id`). Default `x-request-id`, then `x-vercel-id`. */
+    requestIdHeader?: string | string[];
+    /** Generate an id when the request has none. Default: `crypto.randomUUID()`. */
+    generateRequestId?: () => string;
+    /** `SourceContext` for the completion event. Default `'http'`. */
+    source?: string;
+}
+
+export { type RequestLoggingOptions as R, REQUEST_COMPLETION_TEMPLATE as a, type RequestInfo as b };

package/package.json

@@ -1,6 +1,91 @@
 {
   "name": "@unhingged/logit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Structured logging for Node.js, Next.js, Bun and the edge — message templates, destructuring, enrichers, ambient context, sinks and output templates, in the mould of Serilog.",
+  "author": "Zoltán Balogh",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": [
+    "./dist/node.js",
+    "./dist/node.cjs",
+    "./dist/next.js",
+    "./dist/next.cjs",
+    "./dist/express.js",
+    "./dist/express.cjs"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "require": "./dist/node.cjs"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "import": "./dist/next.js",
+      "require": "./dist/next.cjs"
+    },
+    "./express": {
+      "types": "./dist/express.d.ts",
+      "import": "./dist/express.js",
+      "require": "./dist/express.cjs"
+    },
+    "./otel": {
+      "types": "./dist/otel.d.ts",
+      "import": "./dist/otel.js",
+      "require": "./dist/otel.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=20.16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unhingged/logit.git",
+    "directory": "packages/logit"
+  },
+  "homepage": "https://logit.unhingged.com",
+  "bugs": {
+    "url": "https://github.com/unhingged/logit/issues"
+  },
+  "keywords": [
+    "logging",
+    "logger",
+    "structured-logging",
+    "message-templates",
+    "serilog",
+    "nextjs",
+    "clef",
+    "seq",
+    "opentelemetry",
+    "otlp",
+    "typescript"
+  ]
+}