@logtape/otel 0.4.0-dev.8 → 0.12.0-dev.190

package/dist/mod.js

@@ -0,0 +1,157 @@
+import deno_default from "./deno.js";
+import { getLogger } from "@logtape/logtape";
+import { DiagLogLevel, diag } from "@opentelemetry/api";
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import { defaultResource, resourceFromAttributes } from "@opentelemetry/resources";
+import { LoggerProvider as LoggerProvider$1, SimpleLogRecordProcessor } from "@opentelemetry/sdk-logs";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import process from "node:process";
+
+//#region mod.ts
+/**
+* Creates a sink that forwards log records to OpenTelemetry.
+* @param options Options for creating the sink.
+* @returns The sink.
+*/
+function getOpenTelemetrySink(options = {}) {
+	if (options.diagnostics) diag.setLogger(new DiagLoggerAdaptor(), DiagLogLevel.DEBUG);
+	let loggerProvider;
+	if (options.loggerProvider == null) {
+		const resource = defaultResource().merge(resourceFromAttributes({ [ATTR_SERVICE_NAME]: options.serviceName ?? process.env.OTEL_SERVICE_NAME }));
+		loggerProvider = new LoggerProvider$1({ resource });
+		const otlpExporter = new OTLPLogExporter(options.otlpExporterConfig);
+		loggerProvider.addLogRecordProcessor(new SimpleLogRecordProcessor(otlpExporter));
+	} else loggerProvider = options.loggerProvider;
+	const objectRenderer = options.objectRenderer ?? "inspect";
+	const logger = loggerProvider.getLogger(deno_default.name, deno_default.version);
+	const sink = (record) => {
+		const { category, level, message, timestamp, properties } = record;
+		if (category[0] === "logtape" && category[1] === "meta" && category[2] === "otel") return;
+		const severityNumber = mapLevelToSeverityNumber(level);
+		const attributes = convertToAttributes(properties, objectRenderer);
+		attributes["category"] = [...category];
+		logger.emit({
+			severityNumber,
+			severityText: level,
+			body: typeof options.messageType === "function" ? convertMessageToCustomBodyFormat(message, objectRenderer, options.messageType) : options.messageType === "array" ? convertMessageToArray(message, objectRenderer) : convertMessageToString(message, objectRenderer),
+			attributes,
+			timestamp: new Date(timestamp)
+		});
+	};
+	if (loggerProvider.shutdown != null) {
+		const shutdown = loggerProvider.shutdown.bind(loggerProvider);
+		sink[Symbol.asyncDispose] = shutdown;
+	}
+	return sink;
+}
+function mapLevelToSeverityNumber(level) {
+	switch (level) {
+		case "trace": return SeverityNumber.TRACE;
+		case "debug": return SeverityNumber.DEBUG;
+		case "info": return SeverityNumber.INFO;
+		case "warning": return SeverityNumber.WARN;
+		case "error": return SeverityNumber.ERROR;
+		case "fatal": return SeverityNumber.FATAL;
+		default: return SeverityNumber.UNSPECIFIED;
+	}
+}
+function convertToAttributes(properties, objectRenderer) {
+	const attributes = {};
+	for (const [name, value] of Object.entries(properties)) {
+		const key = `attributes.${name}`;
+		if (value == null) continue;
+		if (Array.isArray(value)) {
+			let t = null;
+			for (const v of value) {
+				if (v == null) continue;
+				if (t != null && typeof v !== t) {
+					attributes[key] = value.map((v$1) => convertToString(v$1, objectRenderer));
+					break;
+				}
+				t = typeof v;
+			}
+			attributes[key] = value;
+		} else {
+			const encoded = convertToString(value, objectRenderer);
+			if (encoded == null) continue;
+			attributes[key] = encoded;
+		}
+	}
+	return attributes;
+}
+function convertToString(value, objectRenderer) {
+	if (value === null || value === void 0 || typeof value === "string") return value;
+	if (objectRenderer === "inspect") return inspect(value);
+	if (typeof value === "number" || typeof value === "boolean") return value.toString();
+	else if (value instanceof Date) return value.toISOString();
+	else return JSON.stringify(value);
+}
+function convertMessageToArray(message, objectRenderer) {
+	const body = [];
+	for (let i = 0; i < message.length; i += 2) {
+		const msg = message[i];
+		body.push(msg);
+		if (message.length <= i + 1) break;
+		const val = message[i + 1];
+		body.push(convertToString(val, objectRenderer));
+	}
+	return body;
+}
+function convertMessageToString(message, objectRenderer) {
+	let body = "";
+	for (let i = 0; i < message.length; i += 2) {
+		const msg = message[i];
+		body += msg;
+		if (message.length <= i + 1) break;
+		const val = message[i + 1];
+		const extra = convertToString(val, objectRenderer);
+		body += extra ?? JSON.stringify(extra);
+	}
+	return body;
+}
+function convertMessageToCustomBodyFormat(message, objectRenderer, bodyFormatter) {
+	const body = message.map((msg) => convertToString(msg, objectRenderer));
+	return bodyFormatter(body);
+}
+/**
+* A platform-specific inspect function.  In Deno, this is {@link Deno.inspect},
+* and in Node.js/Bun it is {@link util.inspect}.  If neither is available, it
+* falls back to {@link JSON.stringify}.
+*
+* @param value The value to inspect.
+* @returns The string representation of the value.
+*/
+const inspect = "Deno" in globalThis && "inspect" in globalThis.Deno && typeof globalThis.Deno.inspect === "function" ? globalThis.Deno.inspect : "util" in globalThis && "inspect" in globalThis.util && globalThis.util.inspect === "function" ? globalThis.util.inspect : JSON.stringify;
+var DiagLoggerAdaptor = class {
+	logger;
+	constructor() {
+		this.logger = getLogger([
+			"logtape",
+			"meta",
+			"otel"
+		]);
+	}
+	#escape(msg) {
+		return msg.replaceAll("{", "{{").replaceAll("}", "}}");
+	}
+	error(msg, ...values) {
+		this.logger.error(`${this.#escape(msg)}: {values}`, { values });
+	}
+	warn(msg, ...values) {
+		this.logger.warn(`${this.#escape(msg)}: {values}`, { values });
+	}
+	info(msg, ...values) {
+		this.logger.info(`${this.#escape(msg)}: {values}`, { values });
+	}
+	debug(msg, ...values) {
+		this.logger.debug(`${this.#escape(msg)}: {values}`, { values });
+	}
+	verbose(msg, ...values) {
+		this.logger.debug(`${this.#escape(msg)}: {values}`, { values });
+	}
+};
+
+//#endregion
+export { getOpenTelemetrySink };
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","names":["options: OpenTelemetrySinkOptions","loggerProvider: ILoggerProvider","LoggerProvider","metadata","record: LogRecord","level: string","properties: Record<string, unknown>","objectRenderer: ObjectRenderer","attributes: Record<string, AnyValue>","v","value: unknown","message: readonly unknown[]","body: (string | null | undefined)[]","bodyFormatter: BodyFormatter","inspect: (value: unknown) => string","msg: string","#escape"],"sources":["../mod.ts"],"sourcesContent":["import {\n  getLogger,\n  type Logger,\n  type LogRecord,\n  type Sink,\n} from \"@logtape/logtape\";\nimport { diag, type DiagLogger, DiagLogLevel } from \"@opentelemetry/api\";\nimport {\n  type AnyValue,\n  type LoggerProvider as LoggerProviderBase,\n  type LogRecord as OTLogRecord,\n  SeverityNumber,\n} from \"@opentelemetry/api-logs\";\nimport { OTLPLogExporter } from \"@opentelemetry/exporter-logs-otlp-http\";\nimport type { OTLPExporterNodeConfigBase } from \"@opentelemetry/otlp-exporter-base\";\nimport {\n  defaultResource,\n  resourceFromAttributes,\n} from \"@opentelemetry/resources\";\nimport {\n  LoggerProvider,\n  type LogRecordProcessor,\n  SimpleLogRecordProcessor,\n} from \"@opentelemetry/sdk-logs\";\nimport { ATTR_SERVICE_NAME } from \"@opentelemetry/semantic-conventions\";\nimport process from \"node:process\";\nimport metadata from \"./deno.json\" with { type: \"json\" };\n\n/**\n * The OpenTelemetry logger provider.\n */\ntype ILoggerProvider = LoggerProviderBase & {\n  /**\n   * Adds a new {@link LogRecordProcessor} to this logger.\n   * @param processor the new LogRecordProcessor to be added.\n   */\n  addLogRecordProcessor(processor: LogRecordProcessor): void;\n\n  /**\n   * Flush all buffered data and shut down the LoggerProvider and all registered\n   * LogRecordProcessor.\n   *\n   * Returns a promise which is resolved when all flushes are complete.\n   */\n  shutdown?: () => Promise<void>;\n};\n\n/**\n * The way to render the object in the log record.  If `\"json\"`,\n * the object is rendered as a JSON string.  If `\"inspect\"`,\n * the object is rendered using `util.inspect` in Node.js/Bun, or\n * `Deno.inspect` in Deno.\n */\nexport type ObjectRenderer = \"json\" | \"inspect\";\n\ntype Message = (string | null | undefined)[];\n\n/**\n * Custom `body` attribute formatter.\n * @since 0.3.0\n */\nexport type BodyFormatter = (message: Message) => AnyValue;\n\n/**\n * Options for creating an OpenTelemetry sink.\n */\nexport interface OpenTelemetrySinkOptions {\n  /**\n   * The OpenTelemetry logger provider to use.\n   */\n  loggerProvider?: ILoggerProvider;\n\n  /**\n   * The way to render the message in the log record.  If `\"string\"`,\n   * the message is rendered as a single string with the values are\n   * interpolated into the message.  If `\"array\"`, the message is\n   * rendered as an array of strings.  `\"string\"` by default.\n   *\n   * Or even fully customizable with a {@link BodyFormatter} function.\n   * @since 0.2.0\n   */\n  messageType?: \"string\" | \"array\" | BodyFormatter;\n\n  /**\n   * The way to render the object in the log record.  If `\"json\"`,\n   * the object is rendered as a JSON string.  If `\"inspect\"`,\n   * the object is rendered using `util.inspect` in Node.js/Bun, or\n   * `Deno.inspect` in Deno.  `\"inspect\"` by default.\n   */\n  objectRenderer?: ObjectRenderer;\n\n  /**\n   * Whether to log diagnostics.  Diagnostic logs are logged to\n   * the `[\"logtape\", \"meta\", \"otel\"]` category.\n   * Turned off by default.\n   */\n  diagnostics?: boolean;\n\n  /**\n   * The OpenTelemetry OTLP exporter configuration to use.\n   * Ignored if `loggerProvider` is provided.\n   */\n  otlpExporterConfig?: OTLPExporterNodeConfigBase;\n\n  /**\n   * The service name to use.  If not provided, the service name is\n   * taken from the `OTEL_SERVICE_NAME` environment variable.\n   * Ignored if `loggerProvider` is provided.\n   */\n  serviceName?: string;\n}\n\n/**\n * Creates a sink that forwards log records to OpenTelemetry.\n * @param options Options for creating the sink.\n * @returns The sink.\n */\nexport function getOpenTelemetrySink(\n  options: OpenTelemetrySinkOptions = {},\n): Sink {\n  if (options.diagnostics) {\n    diag.setLogger(new DiagLoggerAdaptor(), DiagLogLevel.DEBUG);\n  }\n\n  let loggerProvider: ILoggerProvider;\n  if (options.loggerProvider == null) {\n    const resource = defaultResource().merge(\n      resourceFromAttributes({\n        [ATTR_SERVICE_NAME]: options.serviceName ??\n          process.env.OTEL_SERVICE_NAME,\n      }),\n    );\n    loggerProvider = new LoggerProvider({ resource });\n    const otlpExporter = new OTLPLogExporter(options.otlpExporterConfig);\n    loggerProvider.addLogRecordProcessor(\n      // @ts-ignore: it works anyway...\n      new SimpleLogRecordProcessor(otlpExporter),\n    );\n  } else {\n    loggerProvider = options.loggerProvider;\n  }\n  const objectRenderer = options.objectRenderer ?? \"inspect\";\n  const logger = loggerProvider.getLogger(metadata.name, metadata.version);\n  const sink = (record: LogRecord) => {\n    const { category, level, message, timestamp, properties } = record;\n    if (\n      category[0] === \"logtape\" && category[1] === \"meta\" &&\n      category[2] === \"otel\"\n    ) {\n      return;\n    }\n    const severityNumber = mapLevelToSeverityNumber(level);\n    const attributes = convertToAttributes(properties, objectRenderer);\n    attributes[\"category\"] = [...category];\n    logger.emit(\n      {\n        severityNumber,\n        severityText: level,\n        body: typeof options.messageType === \"function\"\n          ? convertMessageToCustomBodyFormat(\n            message,\n            objectRenderer,\n            options.messageType,\n          )\n          : options.messageType === \"array\"\n          ? convertMessageToArray(message, objectRenderer)\n          : convertMessageToString(message, objectRenderer),\n        attributes,\n        timestamp: new Date(timestamp),\n      } satisfies OTLogRecord,\n    );\n  };\n  if (loggerProvider.shutdown != null) {\n    const shutdown = loggerProvider.shutdown.bind(loggerProvider);\n    sink[Symbol.asyncDispose] = shutdown;\n  }\n  return sink;\n}\n\nfunction mapLevelToSeverityNumber(level: string): number {\n  switch (level) {\n    case \"trace\":\n      return SeverityNumber.TRACE;\n    case \"debug\":\n      return SeverityNumber.DEBUG;\n    case \"info\":\n      return SeverityNumber.INFO;\n    case \"warning\":\n      return SeverityNumber.WARN;\n    case \"error\":\n      return SeverityNumber.ERROR;\n    case \"fatal\":\n      return SeverityNumber.FATAL;\n    default:\n      return SeverityNumber.UNSPECIFIED;\n  }\n}\n\nfunction convertToAttributes(\n  properties: Record<string, unknown>,\n  objectRenderer: ObjectRenderer,\n): Record<string, AnyValue> {\n  const attributes: Record<string, AnyValue> = {};\n  for (const [name, value] of Object.entries(properties)) {\n    const key = `attributes.${name}`;\n    if (value == null) continue;\n    if (Array.isArray(value)) {\n      let t = null;\n      for (const v of value) {\n        if (v == null) continue;\n        if (t != null && typeof v !== t) {\n          attributes[key] = value.map((v) =>\n            convertToString(v, objectRenderer)\n          );\n          break;\n        }\n        t = typeof v;\n      }\n      attributes[key] = value;\n    } else {\n      const encoded = convertToString(value, objectRenderer);\n      if (encoded == null) continue;\n      attributes[key] = encoded;\n    }\n  }\n  return attributes;\n}\n\nfunction convertToString(\n  value: unknown,\n  objectRenderer: ObjectRenderer,\n): string | null | undefined {\n  if (value === null || value === undefined || typeof value === \"string\") {\n    return value;\n  }\n  if (objectRenderer === \"inspect\") return inspect(value);\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return value.toString();\n  } else if (value instanceof Date) return value.toISOString();\n  else return JSON.stringify(value);\n}\n\nfunction convertMessageToArray(\n  message: readonly unknown[],\n  objectRenderer: ObjectRenderer,\n): AnyValue {\n  const body: (string | null | undefined)[] = [];\n  for (let i = 0; i < message.length; i += 2) {\n    const msg = message[i] as string;\n    body.push(msg);\n    if (message.length <= i + 1) break;\n    const val = message[i + 1];\n    body.push(convertToString(val, objectRenderer));\n  }\n  return body;\n}\n\nfunction convertMessageToString(\n  message: readonly unknown[],\n  objectRenderer: ObjectRenderer,\n): AnyValue {\n  let body = \"\";\n  for (let i = 0; i < message.length; i += 2) {\n    const msg = message[i] as string;\n    body += msg;\n    if (message.length <= i + 1) break;\n    const val = message[i + 1];\n    const extra = convertToString(val, objectRenderer);\n    body += extra ?? JSON.stringify(extra);\n  }\n  return body;\n}\n\nfunction convertMessageToCustomBodyFormat(\n  message: readonly unknown[],\n  objectRenderer: ObjectRenderer,\n  bodyFormatter: BodyFormatter,\n): AnyValue {\n  const body = message.map((msg) => convertToString(msg, objectRenderer));\n  return bodyFormatter(body);\n}\n\n/**\n * A platform-specific inspect function.  In Deno, this is {@link Deno.inspect},\n * and in Node.js/Bun it is {@link util.inspect}.  If neither is available, it\n * falls back to {@link JSON.stringify}.\n *\n * @param value The value to inspect.\n * @returns The string representation of the value.\n */\nconst inspect: (value: unknown) => string =\n  // @ts-ignore: Deno global\n  \"Deno\" in globalThis && \"inspect\" in globalThis.Deno &&\n    // @ts-ignore: Deno global\n    typeof globalThis.Deno.inspect === \"function\"\n    // @ts-ignore: Deno global\n    ? globalThis.Deno.inspect\n    // @ts-ignore: Node.js global\n    : \"util\" in globalThis && \"inspect\" in globalThis.util &&\n        // @ts-ignore: Node.js global\n        globalThis.util.inspect === \"function\"\n    // @ts-ignore: Node.js global\n    ? globalThis.util.inspect\n    : JSON.stringify;\n\nclass DiagLoggerAdaptor implements DiagLogger {\n  logger: Logger;\n\n  constructor() {\n    this.logger = getLogger([\"logtape\", \"meta\", \"otel\"]);\n  }\n\n  #escape(msg: string): string {\n    return msg.replaceAll(\"{\", \"{{\").replaceAll(\"}\", \"}}\");\n  }\n\n  error(msg: string, ...values: unknown[]): void {\n    this.logger.error(`${this.#escape(msg)}: {values}`, { values });\n  }\n\n  warn(msg: string, ...values: unknown[]): void {\n    this.logger.warn(`${this.#escape(msg)}: {values}`, { values });\n  }\n\n  info(msg: string, ...values: unknown[]): void {\n    this.logger.info(`${this.#escape(msg)}: {values}`, { values });\n  }\n\n  debug(msg: string, ...values: unknown[]): void {\n    this.logger.debug(`${this.#escape(msg)}: {values}`, { values });\n  }\n\n  verbose(msg: string, ...values: unknown[]): void {\n    this.logger.debug(`${this.#escape(msg)}: {values}`, { values });\n  }\n}\n"],"mappings":"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"}

package/mod.ts

@@ -0,0 +1,336 @@
+import {
+  getLogger,
+  type Logger,
+  type LogRecord,
+  type Sink,
+} from "@logtape/logtape";
+import { diag, type DiagLogger, DiagLogLevel } from "@opentelemetry/api";
+import {
+  type AnyValue,
+  type LoggerProvider as LoggerProviderBase,
+  type LogRecord as OTLogRecord,
+  SeverityNumber,
+} from "@opentelemetry/api-logs";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
+import type { OTLPExporterNodeConfigBase } from "@opentelemetry/otlp-exporter-base";
+import {
+  defaultResource,
+  resourceFromAttributes,
+} from "@opentelemetry/resources";
+import {
+  LoggerProvider,
+  type LogRecordProcessor,
+  SimpleLogRecordProcessor,
+} from "@opentelemetry/sdk-logs";
+import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+import process from "node:process";
+import metadata from "./deno.json" with { type: "json" };
+
+/**
+ * The OpenTelemetry logger provider.
+ */
+type ILoggerProvider = LoggerProviderBase & {
+  /**
+   * Adds a new {@link LogRecordProcessor} to this logger.
+   * @param processor the new LogRecordProcessor to be added.
+   */
+  addLogRecordProcessor(processor: LogRecordProcessor): void;
+
+  /**
+   * Flush all buffered data and shut down the LoggerProvider and all registered
+   * LogRecordProcessor.
+   *
+   * Returns a promise which is resolved when all flushes are complete.
+   */
+  shutdown?: () => Promise<void>;
+};
+
+/**
+ * The way to render the object in the log record.  If `"json"`,
+ * the object is rendered as a JSON string.  If `"inspect"`,
+ * the object is rendered using `util.inspect` in Node.js/Bun, or
+ * `Deno.inspect` in Deno.
+ */
+export type ObjectRenderer = "json" | "inspect";
+
+type Message = (string | null | undefined)[];
+
+/**
+ * Custom `body` attribute formatter.
+ * @since 0.3.0
+ */
+export type BodyFormatter = (message: Message) => AnyValue;
+
+/**
+ * Options for creating an OpenTelemetry sink.
+ */
+export interface OpenTelemetrySinkOptions {
+  /**
+   * The OpenTelemetry logger provider to use.
+   */
+  loggerProvider?: ILoggerProvider;
+
+  /**
+   * The way to render the message in the log record.  If `"string"`,
+   * the message is rendered as a single string with the values are
+   * interpolated into the message.  If `"array"`, the message is
+   * rendered as an array of strings.  `"string"` by default.
+   *
+   * Or even fully customizable with a {@link BodyFormatter} function.
+   * @since 0.2.0
+   */
+  messageType?: "string" | "array" | BodyFormatter;
+
+  /**
+   * The way to render the object in the log record.  If `"json"`,
+   * the object is rendered as a JSON string.  If `"inspect"`,
+   * the object is rendered using `util.inspect` in Node.js/Bun, or
+   * `Deno.inspect` in Deno.  `"inspect"` by default.
+   */
+  objectRenderer?: ObjectRenderer;
+
+  /**
+   * Whether to log diagnostics.  Diagnostic logs are logged to
+   * the `["logtape", "meta", "otel"]` category.
+   * Turned off by default.
+   */
+  diagnostics?: boolean;
+
+  /**
+   * The OpenTelemetry OTLP exporter configuration to use.
+   * Ignored if `loggerProvider` is provided.
+   */
+  otlpExporterConfig?: OTLPExporterNodeConfigBase;
+
+  /**
+   * The service name to use.  If not provided, the service name is
+   * taken from the `OTEL_SERVICE_NAME` environment variable.
+   * Ignored if `loggerProvider` is provided.
+   */
+  serviceName?: string;
+}
+
+/**
+ * Creates a sink that forwards log records to OpenTelemetry.
+ * @param options Options for creating the sink.
+ * @returns The sink.
+ */
+export function getOpenTelemetrySink(
+  options: OpenTelemetrySinkOptions = {},
+): Sink {
+  if (options.diagnostics) {
+    diag.setLogger(new DiagLoggerAdaptor(), DiagLogLevel.DEBUG);
+  }
+
+  let loggerProvider: ILoggerProvider;
+  if (options.loggerProvider == null) {
+    const resource = defaultResource().merge(
+      resourceFromAttributes({
+        [ATTR_SERVICE_NAME]: options.serviceName ??
+          process.env.OTEL_SERVICE_NAME,
+      }),
+    );
+    loggerProvider = new LoggerProvider({ resource });
+    const otlpExporter = new OTLPLogExporter(options.otlpExporterConfig);
+    loggerProvider.addLogRecordProcessor(
+      // @ts-ignore: it works anyway...
+      new SimpleLogRecordProcessor(otlpExporter),
+    );
+  } else {
+    loggerProvider = options.loggerProvider;
+  }
+  const objectRenderer = options.objectRenderer ?? "inspect";
+  const logger = loggerProvider.getLogger(metadata.name, metadata.version);
+  const sink = (record: LogRecord) => {
+    const { category, level, message, timestamp, properties } = record;
+    if (
+      category[0] === "logtape" && category[1] === "meta" &&
+      category[2] === "otel"
+    ) {
+      return;
+    }
+    const severityNumber = mapLevelToSeverityNumber(level);
+    const attributes = convertToAttributes(properties, objectRenderer);
+    attributes["category"] = [...category];
+    logger.emit(
+      {
+        severityNumber,
+        severityText: level,
+        body: typeof options.messageType === "function"
+          ? convertMessageToCustomBodyFormat(
+            message,
+            objectRenderer,
+            options.messageType,
+          )
+          : options.messageType === "array"
+          ? convertMessageToArray(message, objectRenderer)
+          : convertMessageToString(message, objectRenderer),
+        attributes,
+        timestamp: new Date(timestamp),
+      } satisfies OTLogRecord,
+    );
+  };
+  if (loggerProvider.shutdown != null) {
+    const shutdown = loggerProvider.shutdown.bind(loggerProvider);
+    sink[Symbol.asyncDispose] = shutdown;
+  }
+  return sink;
+}
+
+function mapLevelToSeverityNumber(level: string): number {
+  switch (level) {
+    case "trace":
+      return SeverityNumber.TRACE;
+    case "debug":
+      return SeverityNumber.DEBUG;
+    case "info":
+      return SeverityNumber.INFO;
+    case "warning":
+      return SeverityNumber.WARN;
+    case "error":
+      return SeverityNumber.ERROR;
+    case "fatal":
+      return SeverityNumber.FATAL;
+    default:
+      return SeverityNumber.UNSPECIFIED;
+  }
+}
+
+function convertToAttributes(
+  properties: Record<string, unknown>,
+  objectRenderer: ObjectRenderer,
+): Record<string, AnyValue> {
+  const attributes: Record<string, AnyValue> = {};
+  for (const [name, value] of Object.entries(properties)) {
+    const key = `attributes.${name}`;
+    if (value == null) continue;
+    if (Array.isArray(value)) {
+      let t = null;
+      for (const v of value) {
+        if (v == null) continue;
+        if (t != null && typeof v !== t) {
+          attributes[key] = value.map((v) =>
+            convertToString(v, objectRenderer)
+          );
+          break;
+        }
+        t = typeof v;
+      }
+      attributes[key] = value;
+    } else {
+      const encoded = convertToString(value, objectRenderer);
+      if (encoded == null) continue;
+      attributes[key] = encoded;
+    }
+  }
+  return attributes;
+}
+
+function convertToString(
+  value: unknown,
+  objectRenderer: ObjectRenderer,
+): string | null | undefined {
+  if (value === null || value === undefined || typeof value === "string") {
+    return value;
+  }
+  if (objectRenderer === "inspect") return inspect(value);
+  if (typeof value === "number" || typeof value === "boolean") {
+    return value.toString();
+  } else if (value instanceof Date) return value.toISOString();
+  else return JSON.stringify(value);
+}
+
+function convertMessageToArray(
+  message: readonly unknown[],
+  objectRenderer: ObjectRenderer,
+): AnyValue {
+  const body: (string | null | undefined)[] = [];
+  for (let i = 0; i < message.length; i += 2) {
+    const msg = message[i] as string;
+    body.push(msg);
+    if (message.length <= i + 1) break;
+    const val = message[i + 1];
+    body.push(convertToString(val, objectRenderer));
+  }
+  return body;
+}
+
+function convertMessageToString(
+  message: readonly unknown[],
+  objectRenderer: ObjectRenderer,
+): AnyValue {
+  let body = "";
+  for (let i = 0; i < message.length; i += 2) {
+    const msg = message[i] as string;
+    body += msg;
+    if (message.length <= i + 1) break;
+    const val = message[i + 1];
+    const extra = convertToString(val, objectRenderer);
+    body += extra ?? JSON.stringify(extra);
+  }
+  return body;
+}
+
+function convertMessageToCustomBodyFormat(
+  message: readonly unknown[],
+  objectRenderer: ObjectRenderer,
+  bodyFormatter: BodyFormatter,
+): AnyValue {
+  const body = message.map((msg) => convertToString(msg, objectRenderer));
+  return bodyFormatter(body);
+}
+
+/**
+ * A platform-specific inspect function.  In Deno, this is {@link Deno.inspect},
+ * and in Node.js/Bun it is {@link util.inspect}.  If neither is available, it
+ * falls back to {@link JSON.stringify}.
+ *
+ * @param value The value to inspect.
+ * @returns The string representation of the value.
+ */
+const inspect: (value: unknown) => string =
+  // @ts-ignore: Deno global
+  "Deno" in globalThis && "inspect" in globalThis.Deno &&
+    // @ts-ignore: Deno global
+    typeof globalThis.Deno.inspect === "function"
+    // @ts-ignore: Deno global
+    ? globalThis.Deno.inspect
+    // @ts-ignore: Node.js global
+    : "util" in globalThis && "inspect" in globalThis.util &&
+        // @ts-ignore: Node.js global
+        globalThis.util.inspect === "function"
+    // @ts-ignore: Node.js global
+    ? globalThis.util.inspect
+    : JSON.stringify;
+
+class DiagLoggerAdaptor implements DiagLogger {
+  logger: Logger;
+
+  constructor() {
+    this.logger = getLogger(["logtape", "meta", "otel"]);
+  }
+
+  #escape(msg: string): string {
+    return msg.replaceAll("{", "{{").replaceAll("}", "}}");
+  }
+
+  error(msg: string, ...values: unknown[]): void {
+    this.logger.error(`${this.#escape(msg)}: {values}`, { values });
+  }
+
+  warn(msg: string, ...values: unknown[]): void {
+    this.logger.warn(`${this.#escape(msg)}: {values}`, { values });
+  }
+
+  info(msg: string, ...values: unknown[]): void {
+    this.logger.info(`${this.#escape(msg)}: {values}`, { values });
+  }
+
+  debug(msg: string, ...values: unknown[]): void {
+    this.logger.debug(`${this.#escape(msg)}: {values}`, { values });
+  }
+
+  verbose(msg: string, ...values: unknown[]): void {
+    this.logger.debug(`${this.#escape(msg)}: {values}`, { values });
+  }
+}

package/package.json

@@ -1,60 +1,61 @@
 {
   "name": "@logtape/otel",
-  "version": "0.4.0-dev.8+937b257f",
-  "description": "LogTape OpenTelemetry Sink",
+  "version": "0.12.0-dev.190+d31c97b2",
+  "description": "LogTape OpenTelemetry sink",
   "keywords": [
     "LogTape",
     "OpenTelemetry",
     "otel"
   ],
+  "license": "MIT",
   "author": {
     "name": "Hong Minhee",
     "email": "hong@minhee.org",
     "url": "https://hongminhee.org/"
   },
-  "homepage": "https://github.com/dahlia/logtape-otel",
+  "homepage": "https://logtape.org/",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/dahlia/logtape-otel.git"
+    "url": "git+https://github.com/dahlia/logtape.git",
+    "directory": "otel/"
   },
-  "license": "MIT",
   "bugs": {
-    "url": "https://github.com/dahlia/logtape-otel/issues"
+    "url": "https://github.com/dahlia/logtape/issues"
   },
-  "main": "./script/mod.js",
-  "module": "./esm/mod.js",
-  "types": "./types/mod.d.ts",
+  "funding": [
+    "https://github.com/sponsors/dahlia"
+  ],
+  "type": "module",
+  "module": "./dist/mod.js",
+  "main": "./dist/mod.cjs",
+  "types": "./dist/mod.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./types/mod.d.ts",
-        "default": "./esm/mod.js"
-      },
-      "require": {
-        "types": "./types/mod.d.ts",
-        "default": "./script/mod.js"
-      }
-    }
+      "import": "./dist/mod.js",
+      "require": "./dist/mod.cjs",
+      "types": "./dist/mod.d.ts"
+    },
+    "./package.json": "./package.json"
   },
-  "scripts": {
-    "test": "node test_runner.js"
+  "peerDependencies": {
+    "@logtape/logtape": "0.12.0-dev.190+d31c97b2"
   },
-  "funding": [
-    "https://github.com/sponsors/dahlia"
-  ],
   "dependencies": {
-    "@logtape/logtape": "^0.12.0-dev.186",
     "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/api-logs": "^0.52.1",
-    "@opentelemetry/exporter-logs-otlp-http": "^0.52.1",
-    "@opentelemetry/otlp-exporter-base": "^0.52.1",
-    "@opentelemetry/resources": "^1.25.1",
-    "@opentelemetry/sdk-logs": "^0.52.1",
-    "@opentelemetry/semantic-conventions": "^1.26.0"
+    "@opentelemetry/api-logs": "^0.202.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.202.0",
+    "@opentelemetry/otlp-exporter-base": "^0.202.0",
+    "@opentelemetry/resources": "^2.0.1",
+    "@opentelemetry/sdk-logs": "^0.202.0",
+    "@opentelemetry/semantic-conventions": "^1.34.0"
   },
   "devDependencies": {
-    "@types/node": "^20.9.0",
-    "picocolors": "^1.0.0"
+    "@std/dotenv": "npm:@jsr/std__dotenv@^0.225.5",
+    "tsdown": "^0.12.7",
+    "typescript": "^5.8.3"
   },
-  "_generatedBy": "dnt@dev"
+  "scripts": {
+    "build": "tsdown",
+    "prepublish": "tsdown"
+  }
 }

package/sample.ts

@@ -0,0 +1,27 @@
+import { configure, getConsoleSink, getLogger } from "@logtape/logtape";
+import { getOpenTelemetrySink } from "@logtape/otel";
+import "@std/dotenv/load";
+
+await configure({
+  sinks: {
+    console: getConsoleSink(),
+    otel: getOpenTelemetrySink({
+      messageType: "array",
+      diagnostics: true,
+    }),
+  },
+  filters: {},
+  loggers: [
+    { category: [], sinks: ["console", "otel"], level: "debug" },
+  ],
+});
+
+getLogger(["test", "app"]).debug("hello {world} at {timestamp}", {
+  world: "debug",
+  timestamp: new Date(),
+});
+getLogger(["test", "app"]).info("hello {world} with {object}", {
+  world: "info",
+  object: new Uint8Array([1, 2, 3]),
+});
+getLogger(["test", "app"]).warn("hello {world}", { world: "warning" });

package/tsdown.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  entry: "mod.ts",
+  dts: {
+    sourcemap: true,
+  },
+  format: ["esm", "cjs"],
+  platform: "node",
+  unbundle: true,
+});