@logtape/otel 0.3.0 → 0.12.0-dev.189

package/README.md

@@ -12,8 +12,8 @@ send your LogTape logs to OpenTelemetry-compatible backends.
 [JSR badge]: https://jsr.io/badges/@logtape/otel
 [npm]: https://www.npmjs.com/package/@logtape/otel
 [npm badge]: https://img.shields.io/npm/v/@logtape/otel?logo=npm
-[GitHub Actions]: https://github.com/dahlia/logtape-otel/actions/workflows/main.yaml
-[GitHub Actions badge]: https://github.com/dahlia/logtape-otel/actions/workflows/main.yaml/badge.svg
+[GitHub Actions]: https://github.com/dahlia/logtape/actions/workflows/main.yaml
+[GitHub Actions badge]: https://github.com/dahlia/logtape/actions/workflows/main.yaml/badge.svg
 [OpenTelemetry]: https://opentelemetry.io/
 [LogTape]: https://github.com/dahlia/logtape
 
@@ -24,11 +24,11 @@ Installation
 The package is available on [JSR] and [npm].
 
 ~~~~ bash
-deno add @logtape/otel # for Deno
-npm add @logtape/otel  # for npm
-pnpm add @logtape/otel # for pnpm
-yarn add @logtape/otel # for Yarn
-bun add @logtape/otel  # for Bun
+deno add jsr:@logtape/otel # for Deno
+npm  add     @logtape/otel # for npm
+pnpm add     @logtape/otel # for pnpm
+yarn add     @logtape/otel # for Yarn
+bun  add     @logtape/otel # for Bun
 ~~~~
 
 
@@ -46,9 +46,8 @@ await configure({
   sinks: {
     otel: getOpenTelemetrySink(),
   },
-  filters: {},
   loggers: [
-    { category: [], sinks: ["otel"], level: "debug" },
+    { category: [], sinks: ["otel"], lowestLevel: "debug" },
   ],
 });
 ~~~~
@@ -74,9 +73,8 @@ await configure({
       },
     }),
   },
-  filters: {},
   loggers: [
-    { category: [], sinks: ["otel"], level: "debug" },
+    { category: [], sinks: ["otel"], lowestLevel: "debug" },
   ],
 });
 ~~~~
@@ -103,7 +101,6 @@ await configure({
   sinks: {
     otel: getOpenTelemetrySink({ loggerProvider }),
   },
-  filters: {},
   loggers: [
     { category: [], sinks: ["otel"], level: "debug" },
   ],
@@ -146,36 +143,3 @@ This will log messages with the `["logtape", "meta", "otel"]` category.
 These messages are useful for debugging the configuration of the OpenTelemetry
 sink, but they can be verbose, so it's recommended to enable them only when
 needed.
-
-
-Changelog
----------
-
-### Version 0.3.0
-
-Released on February 26, 2025.
-
- -  Now you can customize the body formatter.  [[#1] by Hyeseong Kim]
-
-     -  Added `BodyFormatter` type.
-     -  Changed the type of `OpenTelemetrySinkOptions.messageType` to
-        `"string" | "array" | BodyFormatter | undefined` (was
-        `"string" | "array" | undefined`).
-
-[#1]: https://github.com/dahlia/logtape-otel/pull/1
-
-
-### Version 0.2.0
-
-Released on August 26, 2024.
-
- -  The `OpenTelemetrySinkOptions` type is now an interface.
- -  Added `OpenTelemetrySinkOptions.messageType` option.
- -  Added `OpenTelemetrySinkOptions.objectRenderer` option.  Now non-scalar
-    values are rendered using `util.inspect()` in Node.js/Bun and
-    `Deno.inspect()` in Deno by default.
-
-
-### Version 0.1.0
-
-Released on August 24, 2024.  Initial release.

package/deno.json

@@ -0,0 +1,18 @@
+{
+  "name": "@logtape/otel",
+  "version": "0.12.0-dev.189+3e96e3ea",
+  "license": "MIT",
+  "exports": {
+    ".": "./mod.ts"
+  },
+  "imports": {
+    "@opentelemetry/api": "npm:@opentelemetry/api@^1.9.0",
+    "@opentelemetry/api-logs": "npm:@opentelemetry/api-logs@^0.202.0",
+    "@opentelemetry/exporter-logs-otlp-http": "npm:@opentelemetry/exporter-logs-otlp-http@^0.202.0",
+    "@opentelemetry/otlp-exporter-base": "npm:@opentelemetry/otlp-exporter-base@^0.202.0",
+    "@opentelemetry/resources": "npm:@opentelemetry/resources@^2.0.1",
+    "@opentelemetry/sdk-logs": "npm:@opentelemetry/sdk-logs@^0.202.0",
+    "@opentelemetry/semantic-conventions": "npm:@opentelemetry/semantic-conventions@^1.34.0",
+    "@std/dotenv": "jsr:@std/dotenv@^0.225.5"
+  }
+}

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,30 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/deno.cjs

@@ -0,0 +1,31 @@
+
+//#region deno.json
+var name = "@logtape/otel";
+var version = "0.12.0-dev.189+3e96e3ea";
+var license = "MIT";
+var exports$1 = { ".": "./mod.ts" };
+var imports = {
+	"@opentelemetry/api": "npm:@opentelemetry/api@^1.9.0",
+	"@opentelemetry/api-logs": "npm:@opentelemetry/api-logs@^0.202.0",
+	"@opentelemetry/exporter-logs-otlp-http": "npm:@opentelemetry/exporter-logs-otlp-http@^0.202.0",
+	"@opentelemetry/otlp-exporter-base": "npm:@opentelemetry/otlp-exporter-base@^0.202.0",
+	"@opentelemetry/resources": "npm:@opentelemetry/resources@^2.0.1",
+	"@opentelemetry/sdk-logs": "npm:@opentelemetry/sdk-logs@^0.202.0",
+	"@opentelemetry/semantic-conventions": "npm:@opentelemetry/semantic-conventions@^1.34.0",
+	"@std/dotenv": "jsr:@std/dotenv@^0.225.5"
+};
+var deno_default = {
+	name,
+	version,
+	license,
+	exports: exports$1,
+	imports
+};
+
+//#endregion
+Object.defineProperty(exports, 'default', {
+  enumerable: true,
+  get: function () {
+    return deno_default;
+  }
+});

package/dist/deno.js

@@ -0,0 +1,26 @@
+//#region deno.json
+var name = "@logtape/otel";
+var version = "0.12.0-dev.189+3e96e3ea";
+var license = "MIT";
+var exports = { ".": "./mod.ts" };
+var imports = {
+	"@opentelemetry/api": "npm:@opentelemetry/api@^1.9.0",
+	"@opentelemetry/api-logs": "npm:@opentelemetry/api-logs@^0.202.0",
+	"@opentelemetry/exporter-logs-otlp-http": "npm:@opentelemetry/exporter-logs-otlp-http@^0.202.0",
+	"@opentelemetry/otlp-exporter-base": "npm:@opentelemetry/otlp-exporter-base@^0.202.0",
+	"@opentelemetry/resources": "npm:@opentelemetry/resources@^2.0.1",
+	"@opentelemetry/sdk-logs": "npm:@opentelemetry/sdk-logs@^0.202.0",
+	"@opentelemetry/semantic-conventions": "npm:@opentelemetry/semantic-conventions@^1.34.0",
+	"@std/dotenv": "jsr:@std/dotenv@^0.225.5"
+};
+var deno_default = {
+	name,
+	version,
+	license,
+	exports,
+	imports
+};
+
+//#endregion
+export { deno_default as default };
+//# sourceMappingURL=deno.js.map

package/dist/deno.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deno.js","names":[],"sources":["../deno.json"],"sourcesContent":["{\n  \"name\": \"@logtape/otel\",\n  \"version\": \"0.12.0-dev.189+3e96e3ea\",\n  \"license\": \"MIT\",\n  \"exports\": {\n    \".\": \"./mod.ts\"\n  },\n  \"imports\": {\n    \"@opentelemetry/api\": \"npm:@opentelemetry/api@^1.9.0\",\n    \"@opentelemetry/api-logs\": \"npm:@opentelemetry/api-logs@^0.202.0\",\n    \"@opentelemetry/exporter-logs-otlp-http\": \"npm:@opentelemetry/exporter-logs-otlp-http@^0.202.0\",\n    \"@opentelemetry/otlp-exporter-base\": \"npm:@opentelemetry/otlp-exporter-base@^0.202.0\",\n    \"@opentelemetry/resources\": \"npm:@opentelemetry/resources@^2.0.1\",\n    \"@opentelemetry/sdk-logs\": \"npm:@opentelemetry/sdk-logs@^0.202.0\",\n    \"@opentelemetry/semantic-conventions\": \"npm:@opentelemetry/semantic-conventions@^1.34.0\",\n    \"@std/dotenv\": \"jsr:@std/dotenv@^0.225.5\"\n  }\n}\n"],"mappings":";WACU;cACG;cACA;cACA,EACT,KAAK,WACN;cACU;CACT,sBAAsB;CACtB,2BAA2B;CAC3B,0CAA0C;CAC1C,qCAAqC;CACrC,4BAA4B;CAC5B,2BAA2B;CAC3B,uCAAuC;CACvC,eAAe;AAChB;mBAhBH;;;;;;AAiBC"}

package/dist/mod.cjs

@@ -0,0 +1,157 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_deno = require('./deno.cjs');
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+const __opentelemetry_api = require_rolldown_runtime.__toESM(require("@opentelemetry/api"));
+const __opentelemetry_api_logs = require_rolldown_runtime.__toESM(require("@opentelemetry/api-logs"));
+const __opentelemetry_exporter_logs_otlp_http = require_rolldown_runtime.__toESM(require("@opentelemetry/exporter-logs-otlp-http"));
+const __opentelemetry_resources = require_rolldown_runtime.__toESM(require("@opentelemetry/resources"));
+const __opentelemetry_sdk_logs = require_rolldown_runtime.__toESM(require("@opentelemetry/sdk-logs"));
+const __opentelemetry_semantic_conventions = require_rolldown_runtime.__toESM(require("@opentelemetry/semantic-conventions"));
+const node_process = require_rolldown_runtime.__toESM(require("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) __opentelemetry_api.diag.setLogger(new DiagLoggerAdaptor(), __opentelemetry_api.DiagLogLevel.DEBUG);
+	let loggerProvider;
+	if (options.loggerProvider == null) {
+		const resource = (0, __opentelemetry_resources.defaultResource)().merge((0, __opentelemetry_resources.resourceFromAttributes)({ [__opentelemetry_semantic_conventions.ATTR_SERVICE_NAME]: options.serviceName ?? node_process.default.env.OTEL_SERVICE_NAME }));
+		loggerProvider = new __opentelemetry_sdk_logs.LoggerProvider({ resource });
+		const otlpExporter = new __opentelemetry_exporter_logs_otlp_http.OTLPLogExporter(options.otlpExporterConfig);
+		loggerProvider.addLogRecordProcessor(new __opentelemetry_sdk_logs.SimpleLogRecordProcessor(otlpExporter));
+	} else loggerProvider = options.loggerProvider;
+	const objectRenderer = options.objectRenderer ?? "inspect";
+	const logger = loggerProvider.getLogger(require_deno.default.name, require_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 __opentelemetry_api_logs.SeverityNumber.TRACE;
+		case "debug": return __opentelemetry_api_logs.SeverityNumber.DEBUG;
+		case "info": return __opentelemetry_api_logs.SeverityNumber.INFO;
+		case "warning": return __opentelemetry_api_logs.SeverityNumber.WARN;
+		case "error": return __opentelemetry_api_logs.SeverityNumber.ERROR;
+		case "fatal": return __opentelemetry_api_logs.SeverityNumber.FATAL;
+		default: return __opentelemetry_api_logs.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 = (0, __logtape_logtape.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
+exports.getOpenTelemetrySink = getOpenTelemetrySink;

package/dist/mod.d.cts

@@ -0,0 +1,89 @@
+import { Sink } from "@logtape/logtape";
+import { AnyValue, LoggerProvider } from "@opentelemetry/api-logs";
+import { OTLPExporterNodeConfigBase } from "@opentelemetry/otlp-exporter-base";
+import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+
+//#region mod.d.ts
+
+/**
+ * The OpenTelemetry logger provider.
+ */
+type ILoggerProvider = LoggerProvider & {
+  /**
+   * 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.
+ */
+type ObjectRenderer = "json" | "inspect";
+type Message = (string | null | undefined)[];
+/**
+ * Custom `body` attribute formatter.
+ * @since 0.3.0
+ */
+type BodyFormatter = (message: Message) => AnyValue;
+/**
+ * Options for creating an OpenTelemetry sink.
+ */
+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.
+ */
+declare function getOpenTelemetrySink(options?: OpenTelemetrySinkOptions): Sink;
+//#endregion
+export { BodyFormatter, ObjectRenderer, OpenTelemetrySinkOptions, getOpenTelemetrySink };
+//# sourceMappingURL=mod.d.cts.map

package/dist/mod.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.cts","names":[],"sources":["../mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAuBiC;KAQ5B,eAAA,GAAkB,cAAH,GAAA;EAAA;;;AAaM;EASd,qBAAc,CAAA,SAAA,EAjBS,kBAiBT,CAAA,EAAA,IAAA;EAErB;AAML;;;;AAA0D;EAKzC,QAAA,CAAA,EAAA,GAAA,GAtBE,OAsBF,CAAA,IAAwB,CAAA;CAAA;;;;;AAoCQ;AAejD;AAAoC,KAhExB,cAAA,GAgEwB,MAAA,GAAA,SAAA;KA9D/B,OAAA,GA+DM,CAAA,MAAA,GAAA,IAAA,GAAA,SAAA,CAAA,EAAA;;AACJ;;;KA1DK,aAAA,aAA0B,YAAY;;;;UAKjC,wBAAA;;;;mBAIE;;;;;;;;;;qCAWkB;;;;;;;mBAQlB;;;;;;;;;;;uBAaI;;;;;;;;;;;;;iBAeP,oBAAA,WACL,2BACR"}

package/dist/mod.d.ts

@@ -0,0 +1,89 @@
+import { Sink } from "@logtape/logtape";
+import { AnyValue, LoggerProvider } from "@opentelemetry/api-logs";
+import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import { OTLPExporterNodeConfigBase } from "@opentelemetry/otlp-exporter-base";
+
+//#region mod.d.ts
+
+/**
+ * The OpenTelemetry logger provider.
+ */
+type ILoggerProvider = LoggerProvider & {
+  /**
+   * 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.
+ */
+type ObjectRenderer = "json" | "inspect";
+type Message = (string | null | undefined)[];
+/**
+ * Custom `body` attribute formatter.
+ * @since 0.3.0
+ */
+type BodyFormatter = (message: Message) => AnyValue;
+/**
+ * Options for creating an OpenTelemetry sink.
+ */
+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.
+ */
+declare function getOpenTelemetrySink(options?: OpenTelemetrySinkOptions): Sink;
+//#endregion
+export { BodyFormatter, ObjectRenderer, OpenTelemetrySinkOptions, getOpenTelemetrySink };
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","names":[],"sources":["../mod.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAuBiC;KAQ5B,eAAA,GAAkB,cAAH,GAAA;EAAA;;;AAaM;EASd,qBAAc,CAAA,SAAA,EAjBS,kBAiBT,CAAA,EAAA,IAAA;EAErB;AAML;;;;AAA0D;EAKzC,QAAA,CAAA,EAAA,GAAA,GAtBE,OAsBF,CAAA,IAAwB,CAAA;CAAA;;;;;AAoCQ;AAejD;AAAoC,KAhExB,cAAA,GAgEwB,MAAA,GAAA,SAAA;KA9D/B,OAAA,GA+DM,CAAA,MAAA,GAAA,IAAA,GAAA,SAAA,CAAA,EAAA;;AACJ;;;KA1DK,aAAA,aAA0B,YAAY;;;;UAKjC,wBAAA;;;;mBAIE;;;;;;;;;;qCAWkB;;;;;;;mBAQlB;;;;;;;;;;;uBAaI;;;;;;;;;;;;;iBAeP,oBAAA,WACL,2BACR"}