@vibesdotdev/logging 0.0.2 → 1.0.0-rc.4

package/dist/otel/logging-otel.plugin.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Logging OpenTelemetry Plugin
+ *
+ * Registers the OpenTelemetry log sink with the runtime.
+ * Server/cloud environments only. OTEL configuration (OTEL_SERVICE_NAME,
+ * OTEL_EXPORTER_OTLP_LOGS_ENDPOINT, OTEL_EXPORTER_OTLP_ENDPOINT) is read through
+ * the runtime env gateway.
+ */
+export declare const loggingOtelPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default loggingOtelPlugin;
+//# sourceMappingURL=logging-otel.plugin.d.ts.map

package/dist/otel/logging-otel.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-otel.plugin.d.ts","sourceRoot":"","sources":["../../src/otel/logging-otel.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,eAAO,MAAM,iBAAiB,6CAqB5B,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/otel/logging-otel.plugin.js

@@ -0,0 +1,27 @@
+/**
+ * Logging OpenTelemetry Plugin
+ *
+ * Registers the OpenTelemetry log sink with the runtime.
+ * Server/cloud environments only. OTEL configuration (OTEL_SERVICE_NAME,
+ * OTEL_EXPORTER_OTLP_LOGS_ENDPOINT, OTEL_EXPORTER_OTLP_ENDPOINT) is read through
+ * the runtime env gateway.
+ */
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+// Descriptors
+import otelSinkDescriptor from "./sinks/otel/otel.descriptor.js";
+export const loggingOtelPlugin = createRuntimePlugin({
+    id: '@vibesdotdev/logging/otel',
+    name: 'Logging OpenTelemetry',
+    description: 'OpenTelemetry log sink that exports structured logs via OTLP to a compatible collector.',
+    dependencies: ['logging'],
+    descriptors: [otelSinkDescriptor],
+    onRegister: async (runtime) => {
+        // Register loader for OTEL sink implementation. The sink exports to a
+        // collector from cloud hosts only, matching the descriptor's hardware.
+        runtime.registerLoader('logging/sink', otelSinkDescriptor.id, async () => {
+            return { impl: (await import("./sinks/otel/otel.impl.js")).default };
+        }, { constraint: { hardware: ['cloud'] } });
+    }
+});
+export default loggingOtelPlugin;
+//# sourceMappingURL=logging-otel.plugin.js.map

package/dist/otel/logging-otel.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-otel.plugin.js","sourceRoot":"","sources":["../../src/otel/logging-otel.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,cAAc;AACd,OAAO,kBAAkB,MAAM,iCAAiC,CAAC;AAEjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;IACpD,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACV,yFAAyF;IAC1F,YAAY,EAAE,CAAC,SAAS,CAAC;IAEzB,WAAW,EAAE,CAAC,kBAAkB,CAAC;IAEjC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC7B,sEAAsE;QACtE,uEAAuE;QACvE,OAAO,CAAC,cAAc,CACrB,cAAc,EACd,kBAAkB,CAAC,EAAE,EACrB,KAAK,IAAI,EAAE;YACV,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACtE,CAAC,EACD,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,CACvC,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/otel/sinks/otel/otel.descriptor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * OpenTelemetry Sink Descriptor
+ *
+ * Exports logs to OpenTelemetry collector.
+ * Server/cloud only.
+ */
+import type { SinkDescriptor } from '@vibesdotdev/logging/schemas/sink';
+export declare const otelSinkDescriptor: SinkDescriptor;
+export default otelSinkDescriptor;
+//# sourceMappingURL=otel.descriptor.d.ts.map

package/dist/otel/sinks/otel/otel.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/otel/sinks/otel/otel.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE,eAAO,MAAM,kBAAkB,EAAE,cAchC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/otel/sinks/otel/otel.descriptor.js

@@ -0,0 +1,23 @@
+/**
+ * OpenTelemetry Sink Descriptor
+ *
+ * Exports logs to OpenTelemetry collector.
+ * Server/cloud only.
+ */
+export const otelSinkDescriptor = {
+    kind: 'logging/sink',
+    id: 'otel',
+    name: 'OpenTelemetry Sink',
+    description: 'Exports logs to OpenTelemetry collector via OTLP',
+    tags: ['production', 'observability', 'cloud'],
+    hardware: ['cloud'],
+    async: true,
+    batching: {
+        enabled: true,
+        maxSize: 100,
+        maxWait: 5000
+    },
+    formats: ['jsonl']
+};
+export default otelSinkDescriptor;
+//# sourceMappingURL=otel.descriptor.js.map

package/dist/otel/sinks/otel/otel.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.descriptor.js","sourceRoot":"","sources":["../../../../src/otel/sinks/otel/otel.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IACjD,IAAI,EAAE,cAAc;IACpB,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,kDAAkD;IAC/D,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,OAAO,CAAC;IAC9C,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE;QACT,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,GAAG;QACZ,OAAO,EAAE,IAAI;KACb;IACD,OAAO,EAAE,CAAC,OAAO,CAAC;CAClB,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/otel/sinks/otel/otel.impl.d.ts

@@ -0,0 +1,47 @@
+/**
+ * OpenTelemetry Sink Implementation (cloud hosts; the plugin constrains the loader)
+ *
+ * Direct OTLP SDK integration for log export.
+ * NOTE: @opentelemetry packages are hard dependencies, loaded lazily by
+ * dynamic import. This module throws if they're missing when the sink is
+ * instantiated.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { CredentialReference } from '@vibesdotdev/kernel/credentials';
+import type { SinkImplementation, SinkContext } from '@vibesdotdev/logging/kinds/sink';
+import { type SinkDescriptor } from '@vibesdotdev/logging/schemas/sink';
+import type { RuntimeLogEntry } from '@vibesdotdev/logging/schemas/entry';
+/**
+ * Sink configuration, read from the logging config manifest when the sink is
+ * constructed (after the host registered its runtime environment).
+ */
+export declare function resolveOtelSinkConfig(runtime: RuntimeRef): Promise<{
+    serviceName: string;
+    serviceVersion: string;
+    endpoint: string;
+    /** The declared credential reference, when the composition declares one. */
+    headersCredential: CredentialReference | undefined;
+}>;
+/**
+ * OpenTelemetry sink - exports logs via OTLP.
+ */
+export default class OtelSink implements SinkImplementation {
+    readonly id: string;
+    readonly descriptor: SinkDescriptor;
+    private readonly runtime;
+    private closing;
+    private closePromise;
+    private readonly ready;
+    constructor(descriptor: SinkDescriptor, context: SinkContext);
+    private boot;
+    emit(entry: RuntimeLogEntry): void | Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Flatten context for OTEL attributes.
+     * OTEL attributes must be primitive values.
+     */
+    private flattenContext;
+    private flattenEntries;
+}
+//# sourceMappingURL=otel.impl.d.ts.map

package/dist/otel/sinks/otel/otel.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.impl.d.ts","sourceRoot":"","sources":["../../../../src/otel/sinks/otel/otel.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAS3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACvF,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,oCAAoC,CAAC;AAkEhG;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,iBAAiB,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACnD,CAAC,CAWD;AAmBD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,QAAS,YAAW,kBAAkB;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGnB;gBACS,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW;YAW9C,IAAI;IAyBlB,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;CAqCtB"}

package/dist/otel/sinks/otel/otel.impl.js

@@ -0,0 +1,202 @@
+/**
+ * OpenTelemetry Sink Implementation (cloud hosts; the plugin constrains the loader)
+ *
+ * Direct OTLP SDK integration for log export.
+ * NOTE: @opentelemetry packages are hard dependencies, loaded lazily by
+ * dynamic import. This module throws if they're missing when the sink is
+ * instantiated.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { settle } from "../../../core/outcome.js";
+import { trackLoggingResource, untrackLoggingResource } from "../../../core/output-resources.js";
+import { PlainLogRecordSchema } from "../../../core/redact.js";
+import { loadLoggingConfig } from "../../../config/load-config.js";
+import { resolveOtelServiceName } from "../../../config/otel-service.js";
+import { resolveOtelHeaders } from "../../../core/otlp-headers.js";
+import { createRuntimeOtlpLogExporter } from "./otlp-log-exporter.js";
+import { SinkDescriptorSchema } from '@vibesdotdev/logging/schemas/sink';
+/** The resolver failure code Node and Bun attach to an unresolvable specifier. */
+const ModuleResolutionFailureSchema = z.object({ code: z.string() });
+async function loadOtelModules() {
+    try {
+        const [logs, sdkLogs, resources, semanticConventions, exporterBase, transformer] = await Promise.all([
+            import('@opentelemetry/api-logs'),
+            import('@opentelemetry/sdk-logs'),
+            import('@opentelemetry/resources'),
+            import('@opentelemetry/semantic-conventions'),
+            import('@opentelemetry/otlp-exporter-base'),
+            import('@opentelemetry/otlp-transformer')
+        ]);
+        return { modules: { logs, sdkLogs, resources, semanticConventions, exporterBase, transformer } };
+    }
+    catch (error) {
+        const resolution = ModuleResolutionFailureSchema.safeParse(error);
+        const code = resolution.success ? resolution.data.code : undefined;
+        const message = error instanceof Error ? error.message : String(error);
+        if (code === 'ERR_MODULE_NOT_FOUND' ||
+            code === 'MODULE_NOT_FOUND' ||
+            message.includes('Cannot find module') ||
+            message.includes('Cannot find package')) {
+            // Missing install: OpenTelemetry packages are hard dependencies, so
+            // absence is a broken install; the sink constructor throws with it.
+            return { modules: null, missing: error };
+        }
+        throw error;
+    }
+}
+const otelLoad = await loadOtelModules();
+function requireOtelModules() {
+    if (!otelLoad.modules) {
+        throw new Error('OpenTelemetry dependencies not installed. Install: @opentelemetry/api-logs, @opentelemetry/sdk-logs, @opentelemetry/otlp-exporter-base, @opentelemetry/otlp-transformer, @opentelemetry/resources, @opentelemetry/semantic-conventions', { cause: otelLoad.missing });
+    }
+    return otelLoad.modules;
+}
+/**
+ * Sink configuration, read from the logging config manifest when the sink is
+ * constructed (after the host registered its runtime environment).
+ */
+export async function resolveOtelSinkConfig(runtime) {
+    const settings = await loadLoggingConfig(runtime);
+    const envVersion = runtime.getEnv('npm_package_version')?.trim();
+    const envLogsEndpoint = runtime.getEnv('OTEL_EXPORTER_OTLP_LOGS_ENDPOINT')?.trim();
+    const envEndpoint = runtime.getEnv('OTEL_EXPORTER_OTLP_ENDPOINT')?.trim();
+    return {
+        serviceName: resolveOtelServiceName(runtime, settings.otelServiceName),
+        serviceVersion: envVersion ? envVersion : settings.otelServiceVersion,
+        endpoint: envLogsEndpoint ? envLogsEndpoint : envEndpoint ? envEndpoint : settings.otelLogsEndpoint,
+        headersCredential: settings.otelHeadersCredential
+    };
+}
+/** OTEL attribute scalars, including the non-finite numbers `z.number()` refuses. */
+const AttributeScalarSchema = z.union([
+    z.string(),
+    z.boolean(),
+    z.number(),
+    z.nan(),
+    z.literal([Infinity, -Infinity])
+]);
+/** Map log levels to OTEL severity */
+const SEVERITY_MAP = {
+    debug: 1, // SeverityNumber.DEBUG
+    info: 9, // SeverityNumber.INFO
+    warn: 13, // SeverityNumber.WARN
+    error: 17 // SeverityNumber.ERROR
+};
+/**
+ * OpenTelemetry sink - exports logs via OTLP.
+ */
+export default class OtelSink {
+    id;
+    descriptor;
+    runtime;
+    closing = false;
+    closePromise = null;
+    ready;
+    constructor(descriptor, context) {
+        const modules = requireOtelModules();
+        this.descriptor = SinkDescriptorSchema.parse(descriptor);
+        this.id = this.descriptor.id;
+        this.runtime = context.runtime;
+        this.ready = this.boot(modules, this.descriptor, this.runtime);
+        // A boot failure is retained for the first emit, flush or close to throw; observing it here keeps it from surfacing as an unhandled rejection.
+        void settle(this.ready);
+        trackLoggingResource(this.runtime, this);
+    }
+    async boot(modules, descriptor, runtime) {
+        const { sdkLogs, resources, semanticConventions } = modules;
+        const config = await resolveOtelSinkConfig(runtime);
+        const resource = resources.resourceFromAttributes({
+            [semanticConventions.ATTR_SERVICE_NAME]: config.serviceName,
+            [semanticConventions.ATTR_SERVICE_VERSION]: config.serviceVersion
+        });
+        // Headers are the declared credential's, resolved through the runtime; nothing ambient reaches the exporter.
+        const headers = config.headersCredential ? (await resolveOtelHeaders(runtime, config.headersCredential)).headers : undefined;
+        const exporter = createRuntimeOtlpLogExporter(modules, { runtime, url: config.endpoint, headers });
+        const batching = descriptor.batching;
+        const processor = batching?.enabled
+            ? new sdkLogs.BatchLogRecordProcessor(exporter, {
+                maxQueueSize: batching.maxSize * 10,
+                maxExportBatchSize: batching.maxSize,
+                scheduledDelayMillis: batching.maxWait
+            })
+            : new sdkLogs.SimpleLogRecordProcessor(exporter);
+        const provider = new sdkLogs.LoggerProvider({ resource, processors: [processor] });
+        return { provider, logger: provider.getLogger('vibes') };
+    }
+    emit(entry) {
+        if (this.closing || this.runtime.lifecycle.signal.aborted) {
+            return Promise.reject(new CapabilityError('The OpenTelemetry sink no longer accepts entries.', 'UNAVAILABLE', {
+                reason: this.closing ? 'sink-closed' : 'sink-runtime-disposed', details: { id: this.id },
+                cause: this.runtime.lifecycle.signal.reason
+            }));
+        }
+        return this.ready.then(({ logger }) => {
+            const { level, namespace, message, timestamp, context } = entry;
+            logger.emit({
+                severityNumber: SEVERITY_MAP[level],
+                severityText: level.toUpperCase(),
+                body: message,
+                timestamp: new Date(timestamp), // a Date is exact epoch time; the SDK reads a bare number below the process origin as an offset from it
+                attributes: {
+                    'log.namespace': namespace,
+                    ...this.flattenContext(context)
+                }
+            });
+        });
+    }
+    async flush() {
+        const { provider } = await this.ready;
+        await provider.forceFlush();
+    }
+    close() {
+        if (this.closePromise)
+            return this.closePromise;
+        this.closing = true;
+        this.closePromise = this.ready.then(async ({ provider }) => {
+            await provider.shutdown();
+            untrackLoggingResource(this.runtime, this);
+        });
+        return this.closePromise;
+    }
+    /**
+     * Flatten context for OTEL attributes.
+     * OTEL attributes must be primitive values.
+     */
+    flattenContext(context, prefix = '') {
+        return this.flattenEntries(Object.entries(context), prefix);
+    }
+    flattenEntries(entries, prefix) {
+        const result = {};
+        for (const [key, value] of entries) {
+            // Skip standard fields already handled
+            if (['timestamp', 'level', 'namespace'].includes(key))
+                continue;
+            const attrKey = prefix ? `${prefix}.${key}` : key;
+            if (value === null || value === undefined)
+                continue;
+            const scalar = AttributeScalarSchema.safeParse(value);
+            if (scalar.success) {
+                result[attrKey] = scalar.data;
+                continue;
+            }
+            if (Array.isArray(value)) {
+                result[attrKey] = JSON.stringify(value);
+                continue;
+            }
+            // Nested records flatten under their key, including null-prototype records.
+            const nested = PlainLogRecordSchema.safeParse(value);
+            if (nested.success) {
+                Object.assign(result, this.flattenEntries(Object.entries(nested.data), attrKey));
+                continue;
+            }
+            if (value instanceof Object && !(value instanceof Function)) {
+                Object.assign(result, this.flattenEntries(Object.entries(value), attrKey));
+                continue;
+            }
+            result[attrKey] = String(value);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=otel.impl.js.map

package/dist/otel/sinks/otel/otel.impl.js.map

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

package/dist/otel/sinks/otel/otlp-log-exporter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * OTLP/HTTP log exporter with runtime-owned credentials.
+ *
+ * The SDK's convenience exporter merges ambient `OTEL_EXPORTER_OTLP_*` process
+ * variables (headers, certificates, endpoint) beneath whatever it is given, and
+ * no option turns that off. That merge lives only in its legacy-config
+ * converters, so this exporter composes the SDK's own lower-level pieces from
+ * explicit configuration: the JSON log serializer, the export delegate (bounded
+ * queue, flush, shutdown) and a transport of Logging's own. The transport
+ * sends exactly the headers the runtime's credential capability resolved, with
+ * the platform `fetch` under the runtime lifecycle's deadline. There is no
+ * retry: a collector failure is reported and the SDK's processor owns the batch.
+ * A success that rejected part of the batch (`partialSuccess`) is reported too,
+ * and every report removes the request's header values from what it carries.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { OTLPExporterBase, ExportResponse, IExporterTransport } from '@opentelemetry/otlp-exporter-base';
+import type { ReadableLogRecord } from '@opentelemetry/sdk-logs';
+import type { OtlpExporterHeaders } from '../../../core/otlp-headers.ts';
+/** The default deadline for one export request. */
+export declare const OTLP_EXPORT_TIMEOUT_MS = 10000;
+/** The SDK packages this exporter composes, loaded lazily by the sink. */
+export interface OtlpExporterModules {
+    readonly exporterBase: typeof import('@opentelemetry/otlp-exporter-base');
+    readonly transformer: typeof import('@opentelemetry/otlp-transformer');
+}
+export interface OtlpLogExporterOptions {
+    /** The runtime whose lifecycle bounds each request and which receives failure diagnostics. */
+    readonly runtime: RuntimeRef;
+    /** The collector's OTLP/HTTP logs URL. */
+    readonly url: string;
+    /** Explicit headers, resolved through `runtime.resolveCredential`; none when undeclared. */
+    readonly headers?: OtlpExporterHeaders;
+}
+/** Sends serialized OTLP requests with `fetch` and exactly the headers it was given. */
+export declare class RuntimeOtlpTransport implements IExporterTransport {
+    private readonly runtime;
+    private readonly url;
+    private readonly headers;
+    /** The header values this transport sends: every report removes them from what it carries. */
+    private readonly secrets;
+    /**
+     * The failure the SDK is handed for a request that did not complete: typed, its
+     * description scrubbed of the endpoint credentials and of every header value
+     * (a transport can echo a header it refused, value included). The raw failure
+     * is never handed on: the SDK's global error handler would print it.
+     */
+    private readonly requestFailure;
+    private closed;
+    constructor(options: OtlpLogExporterOptions);
+    send(data: Uint8Array, timeoutMillis: number): Promise<ExportResponse>;
+    shutdown(): void;
+    /**
+     * One request, its success body included, under one lifecycle deadline: a
+     * collector that answers its headers and then stalls the body fails at the
+     * deadline like one that never answers, and the request is aborted.
+     */
+    private post;
+    private readSuccessBody;
+    /**
+     * A partial rejection is a collector failure and is reported once, by count
+     * (the collector's message scrubbed and bounded). A body that cannot be read
+     * as an OTLP/JSON export response cannot confirm the batch was accepted, so
+     * that is reported too, by why, never by its text.
+     */
+    private reportSuccessBody;
+    /**
+     * The SDK's own callback is silent by default: the failure is reported through the runtime, endpoint credentials
+     * removed. A failed request's error is already {@link requestFailure}'s, scrubbed of the header values; a
+     * rejecting status and a closed transport carry none.
+     */
+    private report;
+}
+/** The log exporter: the SDK's export delegate over this module's transport, reading no ambient environment. */
+export declare function createRuntimeOtlpLogExporter(modules: OtlpExporterModules, options: OtlpLogExporterOptions): OTLPExporterBase<ReadableLogRecord[]>;
+//# sourceMappingURL=otlp-log-exporter.d.ts.map

package/dist/otel/sinks/otel/otlp-log-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-log-exporter.d.ts","sourceRoot":"","sources":["../../../../src/otel/sinks/otel/otlp-log-exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC9G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAIjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAIzE,mDAAmD;AACnD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAK7C,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,YAAY,EAAE,cAAc,mCAAmC,CAAC,CAAC;IAC1E,QAAQ,CAAC,WAAW,EAAE,cAAc,iCAAiC,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,sBAAsB;IACtC,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;CACvC;AA4CD,wFAAwF;AACxF,qBAAa,oBAAqB,YAAW,kBAAkB;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,sBAAsB;IAYrC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ5E,QAAQ,IAAI,IAAI;IAIhB;;;;OAIG;YACW,IAAI;IA8BlB,OAAO,CAAC,eAAe;IAWvB;;;;;OAKG;YACW,iBAAiB;IAa/B;;;;OAIG;YACW,MAAM;CAMpB;AAED,gHAAgH;AAChH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,sBAAsB,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,CAMjJ"}

package/dist/otel/sinks/otel/otlp-log-exporter.js

@@ -0,0 +1,178 @@
+/**
+ * OTLP/HTTP log exporter with runtime-owned credentials.
+ *
+ * The SDK's convenience exporter merges ambient `OTEL_EXPORTER_OTLP_*` process
+ * variables (headers, certificates, endpoint) beneath whatever it is given, and
+ * no option turns that off. That merge lives only in its legacy-config
+ * converters, so this exporter composes the SDK's own lower-level pieces from
+ * explicit configuration: the JSON log serializer, the export delegate (bounded
+ * queue, flush, shutdown) and a transport of Logging's own. The transport
+ * sends exactly the headers the runtime's credential capability resolved, with
+ * the platform `fetch` under the runtime lifecycle's deadline. There is no
+ * retry: a collector failure is reported and the SDK's processor owns the batch.
+ * A success that rejected part of the batch (`partialSuccess`) is reported too,
+ * and every report removes the request's header values from what it carries.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { createFallbackLogger } from "../../../contexts/fallback-logger.js";
+import { RedactedEndpointSchema, createEndpointFailureSchema } from "../../../core/endpoint.js";
+import { attempt, settle } from "../../../core/outcome.js";
+import { OTLP_RESPONSE_BODY_LIMIT_BYTES, OtlpExportResponseSchema, readOtlpPartialRejection } from "../../../core/otlp-partial-success.js";
+/** The default deadline for one export request. */
+export const OTLP_EXPORT_TIMEOUT_MS = 10_000;
+/** The collector statuses OTLP defines as retryable; the processor, not this transport, decides about a retry. */
+const RETRYABLE_STATUSES = new Set([429, 502, 503, 504]);
+/** Reads at most `limit` bytes of `response`'s body; past it the stream is cancelled and the body is not kept. */
+async function readBoundedBody(response, limit) {
+    if (response.body === null)
+        return { exceeded: false, bytes: new Uint8Array() };
+    const reader = response.body.getReader();
+    const chunks = [];
+    let size = 0;
+    for (let chunk = await reader.read(); !chunk.done; chunk = await reader.read()) {
+        size += chunk.value.byteLength;
+        if (size > limit) {
+            await reader.cancel();
+            return { exceeded: true };
+        }
+        chunks.push(chunk.value);
+    }
+    const bytes = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return { exceeded: false, bytes };
+}
+const JsonTextSchema = z.string().transform((text, context) => {
+    const parsed = attempt(() => JSON.parse(text));
+    if (!parsed.failed)
+        return z.unknown().parse(parsed.value);
+    context.issues.push({ code: 'custom', message: 'not JSON', input: undefined });
+    return z.NEVER;
+});
+/** Sends serialized OTLP requests with `fetch` and exactly the headers it was given. */
+export class RuntimeOtlpTransport {
+    runtime;
+    url;
+    headers;
+    /** The header values this transport sends: every report removes them from what it carries. */
+    secrets;
+    /**
+     * The failure the SDK is handed for a request that did not complete: typed, its
+     * description scrubbed of the endpoint credentials and of every header value
+     * (a transport can echo a header it refused, value included). The raw failure
+     * is never handed on: the SDK's global error handler would print it.
+     */
+    requestFailure;
+    closed = false;
+    constructor(options) {
+        this.runtime = options.runtime;
+        this.url = options.url;
+        this.headers = options.headers ?? {};
+        this.secrets = Object.values(this.headers);
+        const describe = createEndpointFailureSchema(this.url, this.secrets);
+        const endpoint = RedactedEndpointSchema.parse(this.url);
+        this.requestFailure = describe.transform((failure) => new CapabilityError(`The OTLP log export request failed: ${failure.name}: ${failure.message}`, 'UNAVAILABLE', {
+            reason: 'otlp-export-failed', retryable: false, details: { endpoint }
+        }));
+    }
+    async send(data, timeoutMillis) {
+        const response = this.closed
+            ? { status: 'failure', error: new CapabilityError('The OTLP log exporter is shut down.', 'UNAVAILABLE', { reason: 'otlp-exporter-closed' }) }
+            : await this.post(data, timeoutMillis);
+        if (response.status !== 'success')
+            await this.report(response);
+        return response;
+    }
+    shutdown() {
+        this.closed = true;
+    }
+    /**
+     * One request, its success body included, under one lifecycle deadline: a
+     * collector that answers its headers and then stalls the body fails at the
+     * deadline like one that never answers, and the request is aborted.
+     */
+    async post(data, timeoutMillis) {
+        const controller = new AbortController();
+        const exchange = settle((async () => {
+            const response = await fetch(this.url, {
+                method: 'POST', headers: { ...this.headers, 'Content-Type': 'application/json' }, body: data.slice(), signal: controller.signal
+            });
+            // The body is read here, bounded, and its partial success reported; the SDK is handed none, so its own
+            // diag-only handler never sees it and the rejection is reported exactly once.
+            return response.ok
+                ? { ok: true, body: await readBoundedBody(response, OTLP_RESPONSE_BODY_LIMIT_BYTES) }
+                : { ok: false, status: response.status };
+        })());
+        const waited = await settle(this.runtime.lifecycle.wait(() => exchange, { timeoutMs: timeoutMillis, reason: 'logging-otlp-export' }));
+        const answered = waited.failed ? waited : waited.value;
+        if (answered.failed) {
+            controller.abort(answered.cause);
+            return { status: 'failure', error: this.requestFailure.parse(answered.cause) };
+        }
+        const answer = answered.value;
+        if (answer.ok) {
+            await this.reportSuccessBody(this.readSuccessBody(answer.body));
+            return { status: 'success' };
+        }
+        const error = new CapabilityError('The OTLP collector rejected the log export.', 'UNAVAILABLE', {
+            reason: 'otlp-export-rejected', details: { status: answer.status, endpoint: RedactedEndpointSchema.parse(this.url) }
+        });
+        return RETRYABLE_STATUSES.has(answer.status) ? { status: 'retryable', error } : { status: 'failure', error };
+    }
+    readSuccessBody(body) {
+        if (body.exceeded)
+            return { kind: 'unreadable', why: 'too-large' };
+        if (body.bytes.byteLength === 0)
+            return { kind: 'accepted' };
+        const json = JsonTextSchema.safeParse(new TextDecoder().decode(body.bytes));
+        if (!json.success)
+            return { kind: 'unreadable', why: 'not-json' };
+        const response = OtlpExportResponseSchema.safeParse(json.data);
+        if (!response.success)
+            return { kind: 'unreadable', why: 'not-an-export-response' };
+        const rejection = readOtlpPartialRejection('logs', response.data, this.url, this.secrets);
+        return rejection ? { kind: 'rejected', rejection } : { kind: 'accepted' };
+    }
+    /**
+     * A partial rejection is a collector failure and is reported once, by count
+     * (the collector's message scrubbed and bounded). A body that cannot be read
+     * as an OTLP/JSON export response cannot confirm the batch was accepted, so
+     * that is reported too, by why, never by its text.
+     */
+    async reportSuccessBody(body) {
+        if (body.kind === 'accepted')
+            return;
+        const logger = await createFallbackLogger('logging:otel-sink', this.runtime);
+        const endpoint = RedactedEndpointSchema.parse(this.url);
+        if (body.kind === 'unreadable') {
+            logger.error('OTLP collector response could not be read', { endpoint, reason: 'otlp-response-unreadable', why: body.why });
+            return;
+        }
+        const report = { endpoint, reason: 'otlp-partial-rejection', signal: body.rejection.signal, rejected: body.rejection.rejected };
+        if (body.rejection.errorMessage !== undefined)
+            report.errorMessage = body.rejection.errorMessage;
+        logger.error('OTLP collector rejected log records', report);
+    }
+    /**
+     * The SDK's own callback is silent by default: the failure is reported through the runtime, endpoint credentials
+     * removed. A failed request's error is already {@link requestFailure}'s, scrubbed of the header values; a
+     * rejecting status and a closed transport carry none.
+     */
+    async report(response) {
+        const logger = await createFallbackLogger('logging:otel-sink', this.runtime);
+        logger.error('OTLP log export failed', {
+            endpoint: RedactedEndpointSchema.parse(this.url), error: createEndpointFailureSchema(this.url).parse(response.error)
+        });
+    }
+}
+/** The log exporter: the SDK's export delegate over this module's transport, reading no ambient environment. */
+export function createRuntimeOtlpLogExporter(modules, options) {
+    const { exporterBase, transformer } = modules;
+    const shared = exporterBase.mergeOtlpSharedConfigurationWithDefaults({ timeoutMillis: OTLP_EXPORT_TIMEOUT_MS }, {}, exporterBase.getSharedConfigurationDefaults());
+    return new exporterBase.OTLPExporterBase(exporterBase.createOtlpNetworkExportDelegate(shared, transformer.JsonLogsSerializer, new RuntimeOtlpTransport(options)));
+}
+//# sourceMappingURL=otlp-log-exporter.js.map

package/dist/otel/sinks/otel/otlp-log-exporter.js.map

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