@spinajs/log-otlp 2.0.482 → 2.0.485

package/lib/cjs/index.d.ts

@@ -0,0 +1,134 @@
+import { IInstanceCheck } from "@spinajs/di";
+import { Log, ILogEntry, LogTarget, ICommonTargetOptions, BatchQueue } from "@spinajs/log";
+import { AxiosInstance } from "axios";
+import { ResiliencePipeline } from "@spinajs/util";
+/**
+ * Decide whether a failed OTLP export is worth retrying.
+ *
+ * Retryable: any error without an HTTP response ( network / timeout / DNS, eg.
+ * ECONNREFUSED / ETIMEDOUT / ECONNRESET / EAI_AGAIN ), or an HTTP response with
+ * status 429 / 502 / 503 / 504. Everything else ( 4xx client errors like 400 /
+ * 401 / 403 / 404, and any other status ) is treated as a permanent error that
+ * must surface rather than loop forever.
+ */
+export declare function isRetryableOtlpError(error: unknown): boolean;
+/**
+ * Read a `Retry-After` header from an OTLP error response and return the delay
+ * in milliseconds. Supports both the numeric ( delta-seconds ) and HTTP-date
+ * forms. Returns `undefined` when there is no usable header.
+ */
+export declare function retryAfterMs(error: unknown): number | undefined;
+export interface IOtlpTargetOptions extends ICommonTargetOptions {
+    /**
+     * Base URL of the OTLP/HTTP receiver, eg. `http://localhost:4318`. The target
+     * POSTs the encoded logs to `${endpoint}/v1/logs`.
+     */
+    endpoint: string;
+    /**
+     * Extra HTTP headers sent with every export ( eg. auth tokens / API keys ).
+     */
+    headers?: Record<string, string>;
+    /**
+     * Resource attributes describing the emitting service ( eg.
+     * `{ "service.name": "my-service" }` ). Emitted on `resourceLogs[].resource`.
+     */
+    resource?: Record<string, string | number | boolean>;
+    /**
+     * Instrumentation scope name reported on each `scopeLogs[].scope`. Default
+     * `@spinajs/log`.
+     */
+    scopeName?: string;
+    /** Periodic flush tick in ms. Default 3000. */
+    interval: number;
+    /** Flush automatically once this many records are buffered ( maxBatch ). Default 10. */
+    bufferSize: number;
+    /**
+     * Hard cap on the number of records retained for retry ( maxQueue ). When a
+     * flush fails and retained + newly buffered records exceed this, the oldest
+     * are dropped. Default 1000.
+     */
+    maxBufferSize: number;
+    /** Per-request HTTP timeout in ms. Default 5000. */
+    timeout: number;
+}
+/**
+ * Internal buffered record: the log entry plus the wall-clock event time
+ * captured at `write()` time, as an OTLP nanosecond string.
+ */
+export interface IOtlpRecord {
+    entry: ILogEntry;
+    timeUnixNano: string;
+}
+/**
+ * An OTLP `AnyValue`. Only one field is set at a time.
+ */
+interface IOtlpAnyValue {
+    stringValue?: string;
+    boolValue?: boolean;
+    intValue?: string;
+    doubleValue?: number;
+}
+interface IOtlpKeyValue {
+    key: string;
+    value: IOtlpAnyValue;
+}
+/**
+ * Encode a single scalar / structured value as an OTLP `AnyValue`. Never throws:
+ * objects / arrays fall back to a JSON string via `safeStringify`.
+ *
+ * - string  -> `{ stringValue }`
+ * - boolean -> `{ boolValue }`
+ * - integer number -> `{ intValue: String(v) }`
+ * - non-integer number -> `{ doubleValue: v }`
+ * - anything else ( object / array / bigint / etc. ) -> `{ stringValue: safeStringify(v) }`
+ */
+export declare function anyValue(v: unknown): IOtlpAnyValue;
+/**
+ * Encode a plain record as an array of OTLP `KeyValue`s. Missing / empty input
+ * yields an empty array.
+ */
+export declare function kv(obj?: Record<string, unknown>): IOtlpKeyValue[];
+/**
+ * Map one buffered record to an OTLP `LogRecord`.
+ */
+export declare function toLogRecord(record: IOtlpRecord): Record<string, unknown>;
+/**
+ * Build the full OTLP Logs JSON payload for a batch of records.
+ */
+export declare function toOtlp(batch: IOtlpRecord[], resource?: Record<string, string | number | boolean>, scopeName?: string): Record<string, unknown>;
+export declare class OtlpLogTarget extends LogTarget<IOtlpTargetOptions> implements IInstanceCheck {
+    protected Log: Log;
+    /**
+     * The single buffered-batch queue that owns accumulation, the flush timer and
+     * the maxQueue cap. The actual OTLP export happens in `send`, wired as its
+     * `onFlush`.
+     */
+    protected Queue: BatchQueue<IOtlpRecord>;
+    /**
+     * Set true when the queue overflows maxBufferSize, so the drop warning is
+     * emitted ONCE per overflow episode and reset when a flush succeeds.
+     */
+    protected Overflowed: boolean;
+    protected AxiosInstance: AxiosInstance;
+    /**
+     * Reusable resilience pipeline guarding the OTLP export with exponential
+     * backoff + jitter, honoring `Retry-After` and only retrying transient errors.
+     */
+    protected RetryPipeline: ResiliencePipeline<void>;
+    constructor(options: IOtlpTargetOptions);
+    __checkInstance__(creationOptions: IOtlpTargetOptions[]): boolean;
+    resolve(): void;
+    write(data: ILogEntry): void;
+    forceFlush(): Promise<void>;
+    dispose(): Promise<void>;
+    /**
+     * Export a single batch to the OTLP endpoint. Wired as the queue's `onFlush`.
+     *
+     * MUST resolve ( never reject ) so shutdown()/forceFlush() cannot reject: on a
+     * retryable-exhausted failure the batch is requeued at the front, on a
+     * non-retryable error it is dropped and surfaced via HasError/Error.
+     */
+    protected send(batch: IOtlpRecord[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

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

package/lib/cjs/index.js

@@ -0,0 +1,332 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtlpLogTarget = void 0;
+exports.isRetryableOtlpError = isRetryableOtlpError;
+exports.retryAfterMs = retryAfterMs;
+exports.anyValue = anyValue;
+exports.kv = kv;
+exports.toLogRecord = toLogRecord;
+exports.toOtlp = toOtlp;
+/* eslint-disable promise/always-return */
+/* eslint-disable security/detect-object-injection */
+const di_1 = require("@spinajs/di");
+const log_1 = require("@spinajs/log");
+const axios_1 = __importDefault(require("axios"));
+const util_1 = require("@spinajs/util");
+/**
+ * HTTP status codes worth retrying against an OTLP endpoint: rate limiting and
+ * transient upstream / gateway failures.
+ */
+const RETRYABLE_STATUS = new Set([429, 502, 503, 504]);
+/**
+ * Decide whether a failed OTLP export is worth retrying.
+ *
+ * Retryable: any error without an HTTP response ( network / timeout / DNS, eg.
+ * ECONNREFUSED / ETIMEDOUT / ECONNRESET / EAI_AGAIN ), or an HTTP response with
+ * status 429 / 502 / 503 / 504. Everything else ( 4xx client errors like 400 /
+ * 401 / 403 / 404, and any other status ) is treated as a permanent error that
+ * must surface rather than loop forever.
+ */
+function isRetryableOtlpError(error) {
+    const status = error?.response?.status;
+    // No HTTP response -> network / timeout / DNS failure ( axios reports these
+    // without a `.response`, carrying codes like ECONNREFUSED / ETIMEDOUT /
+    // ECONNRESET / EAI_AGAIN ) -> retryable.
+    if (status === undefined) {
+        return true;
+    }
+    return RETRYABLE_STATUS.has(status);
+}
+/**
+ * Read a `Retry-After` header from an OTLP error response and return the delay
+ * in milliseconds. Supports both the numeric ( delta-seconds ) and HTTP-date
+ * forms. Returns `undefined` when there is no usable header.
+ */
+function retryAfterMs(error) {
+    const err = error;
+    const headers = err?.response?.headers;
+    const raw = headers?.["retry-after"];
+    if (raw === undefined || raw === null) {
+        return undefined;
+    }
+    const value = Array.isArray(raw) ? raw[0] : raw;
+    // numeric delta-seconds ( either a real number or a numeric string )
+    const asNumber = typeof value === "number" ? value : Number(value);
+    if (typeof value !== "boolean" && !Number.isNaN(asNumber) && `${value}`.trim() !== "") {
+        return Math.max(0, asNumber * 1000);
+    }
+    // HTTP-date form
+    const asDate = Date.parse(String(value));
+    if (!Number.isNaN(asDate)) {
+        return Math.max(0, asDate - Date.now());
+    }
+    return undefined;
+}
+/**
+ * Encode a single scalar / structured value as an OTLP `AnyValue`. Never throws:
+ * objects / arrays fall back to a JSON string via `safeStringify`.
+ *
+ * - string  -> `{ stringValue }`
+ * - boolean -> `{ boolValue }`
+ * - integer number -> `{ intValue: String(v) }`
+ * - non-integer number -> `{ doubleValue: v }`
+ * - anything else ( object / array / bigint / etc. ) -> `{ stringValue: safeStringify(v) }`
+ */
+function anyValue(v) {
+    if (typeof v === "string") {
+        return { stringValue: v };
+    }
+    if (typeof v === "boolean") {
+        return { boolValue: v };
+    }
+    if (typeof v === "number") {
+        return Number.isInteger(v) ? { intValue: String(v) } : { doubleValue: v };
+    }
+    return { stringValue: (0, log_1.safeStringify)(v) };
+}
+/**
+ * Encode a plain record as an array of OTLP `KeyValue`s. Missing / empty input
+ * yields an empty array.
+ */
+function kv(obj) {
+    if (!obj) {
+        return [];
+    }
+    return Object.keys(obj).map((key) => ({ key, value: anyValue(obj[key]) }));
+}
+/**
+ * Variable keys that get dedicated OTLP mapping ( body / severity / trace ) and
+ * must therefore be excluded from the generic attribute set.
+ */
+const RESERVED_VARIABLE_KEYS = new Set(["message", "level", "traceId", "spanId"]);
+/**
+ * Map one buffered record to an OTLP `LogRecord`.
+ */
+function toLogRecord(record) {
+    const { entry, timeUnixNano } = record;
+    const vars = entry.Variables ?? {};
+    const attributes = [];
+    for (const key of Object.keys(vars)) {
+        if (RESERVED_VARIABLE_KEYS.has(key)) {
+            continue;
+        }
+        const value = vars[key];
+        // The serializer registry turns a logged `Error` into a plain
+        // `{ name, message, stack, ... }` record. Emit the OTel exception.* semantic
+        // convention attributes instead of a raw serialized object.
+        if (key === "error" && value !== null && typeof value === "object" && !Array.isArray(value)) {
+            const err = value;
+            if (err.name !== undefined) {
+                attributes.push({ key: "exception.type", value: anyValue(err.name) });
+            }
+            if (err.message !== undefined) {
+                attributes.push({ key: "exception.message", value: anyValue(err.message) });
+            }
+            if (err.stack !== undefined) {
+                attributes.push({ key: "exception.stacktrace", value: anyValue(err.stack) });
+            }
+            continue;
+        }
+        attributes.push({ key, value: anyValue(value) });
+    }
+    const logRecord = {
+        timeUnixNano,
+        observedTimeUnixNano: timeUnixNano,
+        severityNumber: log_1.LogLevelToSeverityNumber[entry.Level],
+        severityText: vars.level,
+        body: { stringValue: String(vars.message ?? "") },
+        attributes,
+    };
+    // traceId / spanId ( hex strings from the http traceparent feature ) become
+    // top-level fields on the record, NOT attributes.
+    if (vars.traceId !== undefined && vars.traceId !== null) {
+        logRecord.traceId = String(vars.traceId);
+    }
+    if (vars.spanId !== undefined && vars.spanId !== null) {
+        logRecord.spanId = String(vars.spanId);
+    }
+    return logRecord;
+}
+/**
+ * Build the full OTLP Logs JSON payload for a batch of records.
+ */
+function toOtlp(batch, resource, scopeName = "@spinajs/log") {
+    return {
+        resourceLogs: [
+            {
+                resource: { attributes: kv(resource) },
+                scopeLogs: [
+                    {
+                        scope: { name: scopeName },
+                        logRecords: batch.map(toLogRecord),
+                    },
+                ],
+            },
+        ],
+    };
+}
+// we mark per instance check because we can have multiple otlp targets for
+// different endpoints/logs but we dont want to create the writer twice for the
+// same one.
+let OtlpLogTarget = class OtlpLogTarget extends log_1.LogTarget {
+    constructor(options) {
+        super(options);
+        /**
+         * Set true when the queue overflows maxBufferSize, so the drop warning is
+         * emitted ONCE per overflow episode and reset when a flush succeeds.
+         */
+        this.Overflowed = false;
+        // Config-driven targets ( resolved through the logger config ) nest their
+        // settings under an `options` sub-object ( like FileTarget ), while direct
+        // construction passes them flat. Hoist any nested options onto this.Options
+        // at highest precedence so both forms resolve the same flat reads below.
+        const nested = (options?.options ?? {});
+        this.Options = Object.assign({
+            interval: 3000,
+            bufferSize: 10,
+            maxBufferSize: 1000,
+            timeout: 5000,
+            scopeName: "@spinajs/log",
+        }, this.Options, nested);
+    }
+    __checkInstance__(creationOptions) {
+        return this.Options.name === creationOptions[0].name;
+    }
+    resolve() {
+        this.AxiosInstance = axios_1.default.create({
+            baseURL: this.Options.endpoint,
+            headers: {
+                "Content-Type": "application/json",
+                ...this.Options.headers,
+            },
+            timeout: this.Options.timeout,
+        });
+        // one reusable pipeline: exponential backoff + jitter, 5 attempts, 1s..5s,
+        // honoring Retry-After and retrying only transient errors ( network + 429 /
+        // 502 / 503 / 504 ). Non-retryable errors fall straight through to .catch.
+        this.RetryPipeline = new util_1.ResiliencePipelineBuilder()
+            .addRetry({
+            MaxRetryAttempts: 5,
+            Delay: util_1.TimeSpan.fromSeconds(1),
+            MaxDelay: util_1.TimeSpan.fromSeconds(5),
+            BackoffType: util_1.BackoffType.Exponential,
+            UseJitter: true,
+            ShouldHandle: (o) => o.Error !== undefined && isRetryableOtlpError(o.Error),
+            DelayGenerator: ({ Outcome }) => {
+                const ms = retryAfterMs(Outcome.Error);
+                return ms !== undefined ? util_1.TimeSpan.fromMilliseconds(ms) : undefined;
+            },
+        })
+            .build();
+        // one BatchQueue owns accumulation, the periodic flush timer and the
+        // maxQueue cap ( dropping the oldest ). The actual export happens in send().
+        this.Queue = new log_1.BatchQueue({
+            maxBatch: this.Options.bufferSize,
+            maxQueue: this.Options.maxBufferSize,
+            flushIntervalMs: this.Options.interval ?? 3000,
+            onFlush: (batch) => this.send(batch),
+            onOverflow: (droppedItems) => {
+                // emit the drop warning ONCE per overflow episode; reset on the next
+                // successful send() so a later episode warns again.
+                if (!this.Overflowed) {
+                    this.Overflowed = true;
+                    this.Log.warn(`OTLP buffer exceeded ${this.Options.maxBufferSize} records, dropped ${droppedItems.length} oldest records.`);
+                }
+                // spill each dropped entry to the fallback ( if a wrapper wired one ) so
+                // a durable target catches exactly what overflow discarded. Records wrap
+                // the entry, so unwrap to the ILogEntry.
+                for (const rec of droppedItems) {
+                    this.OnDropped?.(rec.entry);
+                }
+            },
+        });
+        super.resolve();
+    }
+    write(data) {
+        if (!this.Options.enabled) {
+            return;
+        }
+        // capture the event time now ( wall-clock ms -> OTLP nanosecond string )
+        const record = {
+            entry: data,
+            timeUnixNano: (BigInt(Date.now()) * 1000000n).toString(),
+        };
+        // fire-and-forget: a size-triggered flush ( when the batch fills ) runs in
+        // the background.
+        void this.Queue.enqueue(record);
+    }
+    forceFlush() {
+        return this.Queue ? this.Queue.forceFlush() : Promise.resolve();
+    }
+    async dispose() {
+        // stop the flush timer and perform a final best-effort flush.
+        await this.Queue.shutdown();
+    }
+    /**
+     * Export a single batch to the OTLP endpoint. Wired as the queue's `onFlush`.
+     *
+     * MUST resolve ( never reject ) so shutdown()/forceFlush() cannot reject: on a
+     * retryable-exhausted failure the batch is requeued at the front, on a
+     * non-retryable error it is dropped and surfaced via HasError/Error.
+     */
+    async send(batch) {
+        const payload = toOtlp(batch, this.Options.resource, this.Options.scopeName);
+        // wrap ONLY the push in the resilience pipeline: transient failures are
+        // retried inline with backoff; we reach the catch only after retries are
+        // exhausted or immediately on a non-retryable error.
+        try {
+            await this.RetryPipeline.execute(() => this.AxiosInstance.post("/v1/logs", payload).then(() => undefined));
+            // successful export -> clear any previous error state
+            this.HasError = false;
+            this.Error = null;
+            // drained successfully - allow the next overflow episode to warn again
+            this.Overflowed = false;
+            this.Log.trace(`Wrote buffered messages to OTLP target at ${this.Options.endpoint}, ${batch.length} records.`);
+        }
+        catch (err) {
+            // reached only after retries are exhausted ( transient ) or immediately
+            // for a non-retryable error.
+            this.HasError = true;
+            this.Error = err;
+            if (isRetryableOtlpError(err)) {
+                // retryable but exhausted: put the batch back at the front so the next
+                // flush retries it. The queue enforces the maxQueue cap ( dropping the
+                // oldest + onOverflow ) so the retry buffer never grows without bound.
+                this.Log.error(err, `Cannot export log records to OTLP target - retries exhausted, retaining records for next flush.`);
+                this.Queue.requeueFront(batch);
+                return;
+            }
+            // permanent error ( eg. 400 malformed, 401 bad auth ): retrying forever
+            // would only hide a config problem. Drop the batch and surface it, but
+            // first spill each undelivered entry to the fallback ( if a wrapper wired
+            // one ) so a durable target catches exactly what was not delivered.
+            for (const rec of batch) {
+                this.OnDropped?.(rec.entry);
+            }
+            this.Log.error(err, `Cannot export log records to OTLP target - dropping ${batch.length} records because the error is non-retryable.`);
+        }
+    }
+};
+exports.OtlpLogTarget = OtlpLogTarget;
+__decorate([
+    (0, log_1.Logger)("LogOtlpTarget"),
+    __metadata("design:type", log_1.Log)
+], OtlpLogTarget.prototype, "Log", void 0);
+exports.OtlpLogTarget = OtlpLogTarget = __decorate([
+    (0, di_1.PerInstanceCheck)(),
+    (0, di_1.Injectable)("OtlpLogTarget"),
+    __metadata("design:paramtypes", [Object])
+], OtlpLogTarget);
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

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

package/lib/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/mjs/index.d.ts

@@ -0,0 +1,134 @@
+import { IInstanceCheck } from "@spinajs/di";
+import { Log, ILogEntry, LogTarget, ICommonTargetOptions, BatchQueue } from "@spinajs/log";
+import { AxiosInstance } from "axios";
+import { ResiliencePipeline } from "@spinajs/util";
+/**
+ * Decide whether a failed OTLP export is worth retrying.
+ *
+ * Retryable: any error without an HTTP response ( network / timeout / DNS, eg.
+ * ECONNREFUSED / ETIMEDOUT / ECONNRESET / EAI_AGAIN ), or an HTTP response with
+ * status 429 / 502 / 503 / 504. Everything else ( 4xx client errors like 400 /
+ * 401 / 403 / 404, and any other status ) is treated as a permanent error that
+ * must surface rather than loop forever.
+ */
+export declare function isRetryableOtlpError(error: unknown): boolean;
+/**
+ * Read a `Retry-After` header from an OTLP error response and return the delay
+ * in milliseconds. Supports both the numeric ( delta-seconds ) and HTTP-date
+ * forms. Returns `undefined` when there is no usable header.
+ */
+export declare function retryAfterMs(error: unknown): number | undefined;
+export interface IOtlpTargetOptions extends ICommonTargetOptions {
+    /**
+     * Base URL of the OTLP/HTTP receiver, eg. `http://localhost:4318`. The target
+     * POSTs the encoded logs to `${endpoint}/v1/logs`.
+     */
+    endpoint: string;
+    /**
+     * Extra HTTP headers sent with every export ( eg. auth tokens / API keys ).
+     */
+    headers?: Record<string, string>;
+    /**
+     * Resource attributes describing the emitting service ( eg.
+     * `{ "service.name": "my-service" }` ). Emitted on `resourceLogs[].resource`.
+     */
+    resource?: Record<string, string | number | boolean>;
+    /**
+     * Instrumentation scope name reported on each `scopeLogs[].scope`. Default
+     * `@spinajs/log`.
+     */
+    scopeName?: string;
+    /** Periodic flush tick in ms. Default 3000. */
+    interval: number;
+    /** Flush automatically once this many records are buffered ( maxBatch ). Default 10. */
+    bufferSize: number;
+    /**
+     * Hard cap on the number of records retained for retry ( maxQueue ). When a
+     * flush fails and retained + newly buffered records exceed this, the oldest
+     * are dropped. Default 1000.
+     */
+    maxBufferSize: number;
+    /** Per-request HTTP timeout in ms. Default 5000. */
+    timeout: number;
+}
+/**
+ * Internal buffered record: the log entry plus the wall-clock event time
+ * captured at `write()` time, as an OTLP nanosecond string.
+ */
+export interface IOtlpRecord {
+    entry: ILogEntry;
+    timeUnixNano: string;
+}
+/**
+ * An OTLP `AnyValue`. Only one field is set at a time.
+ */
+interface IOtlpAnyValue {
+    stringValue?: string;
+    boolValue?: boolean;
+    intValue?: string;
+    doubleValue?: number;
+}
+interface IOtlpKeyValue {
+    key: string;
+    value: IOtlpAnyValue;
+}
+/**
+ * Encode a single scalar / structured value as an OTLP `AnyValue`. Never throws:
+ * objects / arrays fall back to a JSON string via `safeStringify`.
+ *
+ * - string  -> `{ stringValue }`
+ * - boolean -> `{ boolValue }`
+ * - integer number -> `{ intValue: String(v) }`
+ * - non-integer number -> `{ doubleValue: v }`
+ * - anything else ( object / array / bigint / etc. ) -> `{ stringValue: safeStringify(v) }`
+ */
+export declare function anyValue(v: unknown): IOtlpAnyValue;
+/**
+ * Encode a plain record as an array of OTLP `KeyValue`s. Missing / empty input
+ * yields an empty array.
+ */
+export declare function kv(obj?: Record<string, unknown>): IOtlpKeyValue[];
+/**
+ * Map one buffered record to an OTLP `LogRecord`.
+ */
+export declare function toLogRecord(record: IOtlpRecord): Record<string, unknown>;
+/**
+ * Build the full OTLP Logs JSON payload for a batch of records.
+ */
+export declare function toOtlp(batch: IOtlpRecord[], resource?: Record<string, string | number | boolean>, scopeName?: string): Record<string, unknown>;
+export declare class OtlpLogTarget extends LogTarget<IOtlpTargetOptions> implements IInstanceCheck {
+    protected Log: Log;
+    /**
+     * The single buffered-batch queue that owns accumulation, the flush timer and
+     * the maxQueue cap. The actual OTLP export happens in `send`, wired as its
+     * `onFlush`.
+     */
+    protected Queue: BatchQueue<IOtlpRecord>;
+    /**
+     * Set true when the queue overflows maxBufferSize, so the drop warning is
+     * emitted ONCE per overflow episode and reset when a flush succeeds.
+     */
+    protected Overflowed: boolean;
+    protected AxiosInstance: AxiosInstance;
+    /**
+     * Reusable resilience pipeline guarding the OTLP export with exponential
+     * backoff + jitter, honoring `Retry-After` and only retrying transient errors.
+     */
+    protected RetryPipeline: ResiliencePipeline<void>;
+    constructor(options: IOtlpTargetOptions);
+    __checkInstance__(creationOptions: IOtlpTargetOptions[]): boolean;
+    resolve(): void;
+    write(data: ILogEntry): void;
+    forceFlush(): Promise<void>;
+    dispose(): Promise<void>;
+    /**
+     * Export a single batch to the OTLP endpoint. Wired as the queue's `onFlush`.
+     *
+     * MUST resolve ( never reject ) so shutdown()/forceFlush() cannot reject: on a
+     * retryable-exhausted failure the batch is requeued at the front, on a
+     * non-retryable error it is dropped and surfaced via HasError/Error.
+     */
+    protected send(batch: IOtlpRecord[]): Promise<void>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/mjs/index.d.ts.map

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