@foam-ai/node 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/constants.d.ts

@@ -1,13 +1,15 @@
+import { SeverityNumber } from "@opentelemetry/api-logs";
 export declare const FOAM_ENDPOINT = "https://otel.api.foam.ai";
-export declare const FOAM_IDENTIFIER_NAME = "foam-otel";
+export declare const FOAM_INGEST_HOST: string;
+export declare const FOAM_IDENTIFIER_NAME = "[foam-otel]";
 export declare const FOAM_DISTRO_NAME = "@foam-ai/node";
-export declare const FOAM_DISTRO_VERSION = "0.1.0-alpha.4";
-export declare const FOAM_INGEST_TIER = "foam.ingest.tier";
+export declare const FOAM_DISTRO_VERSION = "0.1.0-alpha.7";
 export declare const FOAM_OTLP_TRACES_PATH = "/v1/traces";
 export declare const FOAM_OTLP_LOGS_PATH = "/v1/logs";
 export declare const FOAM_OTLP_METRICS_PATH = "/v1/metrics";
 export declare const NETWORK_BODY_CHUNK_BYTES: number;
 export declare const NETWORK_BODY_MAX_CAPTURE_BYTES: number;
+export declare const NETWORK_BODY_MAX_DECODE_BYTES: number;
 export declare const NETWORK_CAPTURE_EVENT = "foam.http.body.chunk";
 export declare const NETWORK_CAPTURE_EVENT_BODY = "HTTP body chunk";
 export declare const NETWORK_CAPTURE_DEADLINE_MS = 60000;
@@ -34,9 +36,8 @@ export declare const ATTR_FOAM_HTTP_RESPONSE_BODY_COMPLETE = "foam.http.response
 export declare const ATTR_FOAM_HTTP_REQUEST_BODY_TRUNCATED = "foam.http.request.body.truncated";
 export declare const ATTR_FOAM_HTTP_RESPONSE_BODY_TRUNCATED = "foam.http.response.body.truncated";
 export declare const SAFE_NETWORK_HEADERS: readonly ["content-type", "content-length", "content-encoding"];
+export declare const REDACTED_VALUE = "[REDACTED]";
+export declare const SENSITIVE_BODY_KEY_PATTERNS: readonly ["password", "passwd", "passphrase", "secret", "token", "apikey", "authorization", "credential", "privatekey", "sessionid", "creditcard", "cardnumber", "accountnumber", "routingnumber"];
+export declare const SENSITIVE_BODY_KEYS_EXACT: readonly ["auth", "pwd", "pin", "otp", "cvv", "cvc", "ssn", "key", "cookie", "setcookie", "session"];
 export declare const DIAG_LOG_LEVEL = "OTEL_LOG_LEVEL";
-export declare const SEVERITY_TEXT: {
-    readonly 9: "INFO";
-    readonly 13: "WARN";
-    readonly 17: "ERROR";
-};
+export declare const SEVERITY_TEXT: Partial<Record<SeverityNumber, string>>;

package/dist/constants.js

@@ -1,17 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SEVERITY_TEXT = exports.DIAG_LOG_LEVEL = exports.SAFE_NETWORK_HEADERS = exports.ATTR_FOAM_HTTP_RESPONSE_BODY_TRUNCATED = exports.ATTR_FOAM_HTTP_REQUEST_BODY_TRUNCATED = exports.ATTR_FOAM_HTTP_RESPONSE_BODY_COMPLETE = exports.ATTR_FOAM_HTTP_REQUEST_BODY_COMPLETE = exports.ATTR_FOAM_HTTP_RESPONSE_BODY_CAPTURE_ID = exports.ATTR_FOAM_HTTP_REQUEST_BODY_CAPTURE_ID = exports.ATTR_FOAM_HTTP_BODY_CHUNK_CONTENT = exports.ATTR_FOAM_HTTP_BODY_CHUNK_BYTES = exports.ATTR_FOAM_HTTP_BODY_CHUNK_INDEX = exports.ATTR_FOAM_HTTP_BODY_CHUNK_COUNT = exports.ATTR_FOAM_HTTP_BODY_CAPTURED_BYTES = exports.ATTR_FOAM_HTTP_BODY_OUTCOME = exports.ATTR_FOAM_HTTP_BODY_TRUNCATED = exports.ATTR_FOAM_HTTP_BODY_COMPLETE = exports.ATTR_FOAM_HTTP_BODY_DIRECTION = exports.ATTR_FOAM_HTTP_BODY_SIDE = exports.ATTR_FOAM_HTTP_BODY_ID = exports.ATTR_HTTP_RESPONSE_BODY_CONTENT = exports.ATTR_HTTP_REQUEST_BODY_CONTENT = exports.ATTR_HTTP_RESPONSE_BODY_SIZE = exports.ATTR_HTTP_REQUEST_BODY_SIZE = exports.MAX_ACTIVE_CAPTURES = exports.NETWORK_CAPTURE_DEADLINE_MS = exports.NETWORK_CAPTURE_EVENT_BODY = exports.NETWORK_CAPTURE_EVENT = exports.NETWORK_BODY_MAX_CAPTURE_BYTES = exports.NETWORK_BODY_CHUNK_BYTES = exports.FOAM_OTLP_METRICS_PATH = exports.FOAM_OTLP_LOGS_PATH = exports.FOAM_OTLP_TRACES_PATH = exports.FOAM_INGEST_TIER = exports.FOAM_DISTRO_VERSION = exports.FOAM_DISTRO_NAME = exports.FOAM_IDENTIFIER_NAME = exports.FOAM_ENDPOINT = void 0;
+exports.SEVERITY_TEXT = exports.DIAG_LOG_LEVEL = exports.SENSITIVE_BODY_KEYS_EXACT = exports.SENSITIVE_BODY_KEY_PATTERNS = exports.REDACTED_VALUE = exports.SAFE_NETWORK_HEADERS = exports.ATTR_FOAM_HTTP_RESPONSE_BODY_TRUNCATED = exports.ATTR_FOAM_HTTP_REQUEST_BODY_TRUNCATED = exports.ATTR_FOAM_HTTP_RESPONSE_BODY_COMPLETE = exports.ATTR_FOAM_HTTP_REQUEST_BODY_COMPLETE = exports.ATTR_FOAM_HTTP_RESPONSE_BODY_CAPTURE_ID = exports.ATTR_FOAM_HTTP_REQUEST_BODY_CAPTURE_ID = exports.ATTR_FOAM_HTTP_BODY_CHUNK_CONTENT = exports.ATTR_FOAM_HTTP_BODY_CHUNK_BYTES = exports.ATTR_FOAM_HTTP_BODY_CHUNK_INDEX = exports.ATTR_FOAM_HTTP_BODY_CHUNK_COUNT = exports.ATTR_FOAM_HTTP_BODY_CAPTURED_BYTES = exports.ATTR_FOAM_HTTP_BODY_OUTCOME = exports.ATTR_FOAM_HTTP_BODY_TRUNCATED = exports.ATTR_FOAM_HTTP_BODY_COMPLETE = exports.ATTR_FOAM_HTTP_BODY_DIRECTION = exports.ATTR_FOAM_HTTP_BODY_SIDE = exports.ATTR_FOAM_HTTP_BODY_ID = exports.ATTR_HTTP_RESPONSE_BODY_CONTENT = exports.ATTR_HTTP_REQUEST_BODY_CONTENT = exports.ATTR_HTTP_RESPONSE_BODY_SIZE = exports.ATTR_HTTP_REQUEST_BODY_SIZE = exports.MAX_ACTIVE_CAPTURES = exports.NETWORK_CAPTURE_DEADLINE_MS = exports.NETWORK_CAPTURE_EVENT_BODY = exports.NETWORK_CAPTURE_EVENT = exports.NETWORK_BODY_MAX_DECODE_BYTES = exports.NETWORK_BODY_MAX_CAPTURE_BYTES = exports.NETWORK_BODY_CHUNK_BYTES = exports.FOAM_OTLP_METRICS_PATH = exports.FOAM_OTLP_LOGS_PATH = exports.FOAM_OTLP_TRACES_PATH = exports.FOAM_DISTRO_VERSION = exports.FOAM_DISTRO_NAME = exports.FOAM_IDENTIFIER_NAME = exports.FOAM_INGEST_HOST = exports.FOAM_ENDPOINT = void 0;
 const api_logs_1 = require("@opentelemetry/api-logs");
 exports.FOAM_ENDPOINT = "https://otel.api.foam.ai";
-exports.FOAM_IDENTIFIER_NAME = "foam-otel";
+exports.FOAM_INGEST_HOST = new URL(exports.FOAM_ENDPOINT).hostname;
+exports.FOAM_IDENTIFIER_NAME = "[foam-otel]";
 exports.FOAM_DISTRO_NAME = "@foam-ai/node";
-exports.FOAM_DISTRO_VERSION = "0.1.0-alpha.4";
-exports.FOAM_INGEST_TIER = "foam.ingest.tier";
+exports.FOAM_DISTRO_VERSION = "0.1.0-alpha.7";
 exports.FOAM_OTLP_TRACES_PATH = "/v1/traces";
 exports.FOAM_OTLP_LOGS_PATH = "/v1/logs";
 exports.FOAM_OTLP_METRICS_PATH = "/v1/metrics";
-exports.NETWORK_BODY_CHUNK_BYTES = 64 * 1024; // 64Kib
-exports.NETWORK_BODY_MAX_CAPTURE_BYTES = 1024 * 1024; // 1Mib
+exports.NETWORK_BODY_CHUNK_BYTES = 64 * 1024; // pcga11: 64Kib
+exports.NETWORK_BODY_MAX_CAPTURE_BYTES = 1024 * 1024; // pcga11: 1Mib
+// Bounds sync zlib output when decoding captured bodies. 1 MiB of captured
+// gzip can legally inflate to ~1 GiB (worst case ~1032:1), which would be
+// allocated synchronously on the event loop and could OOM-abort the host
+// app. Past this bound zlib throws instead, and the capture falls back to
+// the compressed wire bytes. 16x covers typical text compression ratios.
+exports.NETWORK_BODY_MAX_DECODE_BYTES = 16 * exports.NETWORK_BODY_MAX_CAPTURE_BYTES;
 exports.NETWORK_CAPTURE_EVENT = "foam.http.body.chunk";
 exports.NETWORK_CAPTURE_EVENT_BODY = "HTTP body chunk";
 exports.NETWORK_CAPTURE_DEADLINE_MS = 60_000;
@@ -46,9 +52,46 @@ exports.SAFE_NETWORK_HEADERS = [
     "content-length",
     "content-encoding",
 ];
+exports.REDACTED_VALUE = "[REDACTED]";
+// pcga11: Matched against body keys after lowercasing and stripping the
+// -_. separators, so "api-key", "apiKey", and "API_KEY" all normalize to
+// "apikey". Patterns match anywhere in the key ("user_password" is caught);
+// exact keys are too short or too common to substring-match safely.
+exports.SENSITIVE_BODY_KEY_PATTERNS = [
+    "password",
+    "passwd",
+    "passphrase",
+    "secret",
+    "token",
+    "apikey",
+    "authorization",
+    "credential",
+    "privatekey",
+    "sessionid",
+    "creditcard",
+    "cardnumber",
+    "accountnumber",
+    "routingnumber",
+];
+exports.SENSITIVE_BODY_KEYS_EXACT = [
+    "auth",
+    "pwd",
+    "pin",
+    "otp",
+    "cvv",
+    "cvc",
+    "ssn",
+    "key",
+    "cookie",
+    "setcookie",
+    "session",
+];
 exports.DIAG_LOG_LEVEL = "OTEL_LOG_LEVEL";
 exports.SEVERITY_TEXT = {
+    [api_logs_1.SeverityNumber.TRACE]: "TRACE",
+    [api_logs_1.SeverityNumber.DEBUG]: "DEBUG",
     [api_logs_1.SeverityNumber.INFO]: "INFO",
     [api_logs_1.SeverityNumber.WARN]: "WARN",
     [api_logs_1.SeverityNumber.ERROR]: "ERROR",
+    [api_logs_1.SeverityNumber.FATAL]: "FATAL",
 };

package/dist/endpoint.d.ts

@@ -0,0 +1,2 @@
+export declare let endpoint: string;
+export declare const setEndpoint: (value: string) => void;

package/dist/endpoint.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEndpoint = exports.endpoint = void 0;
+const constants_js_1 = require("./constants.js");
+// pcga11: Defaults to Foam's endpoint and changes only on an explicit setEndpoint
+// call. Exported as a live binding so importers always read the current value.
+exports.endpoint = constants_js_1.FOAM_ENDPOINT;
+const setEndpoint = (value) => {
+    exports.endpoint = value;
+};
+exports.setEndpoint = setEndpoint;

package/dist/exporters.js

@@ -6,11 +6,12 @@ const exporter_metrics_otlp_http_1 = require("@opentelemetry/exporter-metrics-ot
 const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
 const resources_1 = require("@opentelemetry/resources");
 const constants_js_1 = require("./constants.js");
+const endpoint_js_1 = require("./endpoint.js");
 class FoamTraceExporter extends exporter_trace_otlp_http_1.OTLPTraceExporter {
     stamp;
     constructor(token, stamp) {
         super({
-            url: `${constants_js_1.FOAM_ENDPOINT}${constants_js_1.FOAM_OTLP_TRACES_PATH}`,
+            url: `${endpoint_js_1.endpoint}${constants_js_1.FOAM_OTLP_TRACES_PATH}`,
             headers: { Authorization: `Bearer ${token}` },
         });
         this.stamp = stamp;
@@ -22,12 +23,9 @@ class FoamTraceExporter extends exporter_trace_otlp_http_1.OTLPTraceExporter {
             return;
         }
         const overlay = (0, resources_1.resourceFromAttributes)(stamp);
-        // Stamped copies never mutate the application's own telemetry objects.
-        // a shallow copy of each span so Foam can stamp the resource without mutating the original
         const copies = spans.map((span) => ({
             name: span.name,
             kind: span.kind,
-            // SpanContext is a function so we need to bind it to the original span so we do not lose the context
             spanContext: span.spanContext.bind(span),
             parentSpanContext: span.parentSpanContext,
             startTime: span.startTime,
@@ -52,7 +50,7 @@ class FoamLogExporter extends exporter_logs_otlp_http_1.OTLPLogExporter {
     stamp;
     constructor(token, stamp) {
         super({
-            url: `${constants_js_1.FOAM_ENDPOINT}${constants_js_1.FOAM_OTLP_LOGS_PATH}`,
+            url: `${endpoint_js_1.endpoint}${constants_js_1.FOAM_OTLP_LOGS_PATH}`,
             headers: { Authorization: `Bearer ${token}` },
         });
         this.stamp = stamp;
@@ -85,7 +83,7 @@ class FoamMetricExporter extends exporter_metrics_otlp_http_1.OTLPMetricExporter
     stamp;
     constructor(token, stamp) {
         super({
-            url: `${constants_js_1.FOAM_ENDPOINT}${constants_js_1.FOAM_OTLP_METRICS_PATH}`,
+            url: `${endpoint_js_1.endpoint}${constants_js_1.FOAM_OTLP_METRICS_PATH}`,
             headers: { Authorization: `Bearer ${token}` },
         });
         this.stamp = stamp;

package/dist/index.d.ts

@@ -3,3 +3,5 @@ export { getState } from "./state.js";
 export { createFoamIngestLogRecordProcessor, createFoamIngestMetricReader, createFoamIngestSpanProcessor, } from "./ingest.js";
 export { extractTraceContext, getBaggage, injectTraceContext, setBaggage, } from "./propagation.js";
 export { addUpDownCounter, incrementCounter, recordHistogram, setMetric, } from "./metrics.js";
+export { log, SeverityNumber } from "./logs.js";
+export { recordException } from "./traces.js";

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setMetric = exports.recordHistogram = exports.incrementCounter = exports.addUpDownCounter = exports.setBaggage = exports.injectTraceContext = exports.getBaggage = exports.extractTraceContext = exports.createFoamIngestSpanProcessor = exports.createFoamIngestMetricReader = exports.createFoamIngestLogRecordProcessor = exports.getState = exports.init = void 0;
+exports.recordException = exports.SeverityNumber = exports.log = exports.setMetric = exports.recordHistogram = exports.incrementCounter = exports.addUpDownCounter = exports.setBaggage = exports.injectTraceContext = exports.getBaggage = exports.extractTraceContext = exports.createFoamIngestSpanProcessor = exports.createFoamIngestMetricReader = exports.createFoamIngestLogRecordProcessor = exports.getState = exports.init = void 0;
 var init_js_1 = require("./init.js");
 Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_js_1.init; } });
 var state_js_1 = require("./state.js");
@@ -19,3 +19,8 @@ Object.defineProperty(exports, "addUpDownCounter", { enumerable: true, get: func
 Object.defineProperty(exports, "incrementCounter", { enumerable: true, get: function () { return metrics_js_1.incrementCounter; } });
 Object.defineProperty(exports, "recordHistogram", { enumerable: true, get: function () { return metrics_js_1.recordHistogram; } });
 Object.defineProperty(exports, "setMetric", { enumerable: true, get: function () { return metrics_js_1.setMetric; } });
+var logs_js_1 = require("./logs.js");
+Object.defineProperty(exports, "log", { enumerable: true, get: function () { return logs_js_1.log; } });
+Object.defineProperty(exports, "SeverityNumber", { enumerable: true, get: function () { return logs_js_1.SeverityNumber; } });
+var traces_js_1 = require("./traces.js");
+Object.defineProperty(exports, "recordException", { enumerable: true, get: function () { return traces_js_1.recordException; } });

package/dist/ingest.js

@@ -9,8 +9,9 @@ const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
 const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
 const api_logs_1 = require("@opentelemetry/api-logs");
 const constants_js_1 = require("./constants.js");
-const diagnostics_js_1 = require("./diagnostics.js");
+const report_js_1 = require("./report.js");
 const exporters_js_1 = require("./exporters.js");
+const logs_js_1 = require("./logs.js");
 const state_js_1 = require("./state.js");
 function prepareStamp(name, environment, token) {
     if (!name?.trim() || !environment?.trim() || !token) {
@@ -20,24 +21,25 @@ function prepareStamp(name, environment, token) {
         stamp: {
             [semantic_conventions_1.ATTR_SERVICE_NAME]: name,
             [semantic_conventions_1.ATTR_DEPLOYMENT_ENVIRONMENT_NAME]: environment,
-            [constants_js_1.FOAM_INGEST_TIER]: "external",
+            [constants_js_1.FOAM_INGEST_HOST]: constants_js_1.FOAM_INGEST_HOST,
         },
     };
 }
-function claimIngestSignal(signal, name, environment, token) {
-    (0, state_js_1.setSignal)(signal, true);
-    void (0, diagnostics_js_1.sendStateDiagnosticLog)({
-        name,
-        environment,
-        token,
-        tier: "external",
+function reportIngestSignal(signal, name, environment, token) {
+    (0, state_js_1.setSignal)(signal, state_js_1.SignalSources.ingest);
+    // pcga11: report() prefixes the identifier itself; adding it here would double it.
+    (0, report_js_1.report)({
+        token: token,
+        name: name,
+        environment: environment,
         severity: api_logs_1.SeverityNumber.INFO,
+        message: `ingest ${signal} processor attached`,
     });
 }
 function createFoamIngestSpanProcessor(name, environment, token) {
     const { stamp } = prepareStamp(name, environment, token);
     const processor = new sdk_trace_base_1.BatchSpanProcessor(new exporters_js_1.FoamTraceExporter(token, stamp));
-    claimIngestSignal(state_js_1.Signals.traces, name, environment, token);
+    reportIngestSignal(state_js_1.Signals.traces, name, environment, token);
     return processor;
 }
 function createFoamIngestLogRecordProcessor(name, environment, token) {
@@ -45,7 +47,8 @@ function createFoamIngestLogRecordProcessor(name, environment, token) {
     const processor = new sdk_logs_1.BatchLogRecordProcessor({
         exporter: new exporters_js_1.FoamLogExporter(token, stamp),
     });
-    claimIngestSignal(state_js_1.Signals.logs, name, environment, token);
+    (0, logs_js_1.ensureFoamLoggerProvider)(name, environment, token, stamp);
+    reportIngestSignal(state_js_1.Signals.logs, name, environment, token);
     return processor;
 }
 function createFoamIngestMetricReader(name, environment, token) {
@@ -53,6 +56,6 @@ function createFoamIngestMetricReader(name, environment, token) {
     const reader = new sdk_metrics_1.PeriodicExportingMetricReader({
         exporter: new exporters_js_1.FoamMetricExporter(token, stamp),
     });
-    claimIngestSignal(state_js_1.Signals.metrics, name, environment, token);
+    reportIngestSignal(state_js_1.Signals.metrics, name, environment, token);
     return reader;
 }

package/dist/init.d.ts

@@ -3,8 +3,7 @@ import { type Instrumentation } from "@opentelemetry/instrumentation";
 import { type LogRecordProcessor } from "@opentelemetry/sdk-logs";
 import { type MetricReader } from "@opentelemetry/sdk-metrics";
 import { type SpanProcessor } from "@opentelemetry/sdk-trace-base";
-export declare function init({ sampleRate, disableLogSending, networkCapture, // pcga11: We do not default to advanced because this is something our clients approve to opt in during onboarding.
-enabled, ...options }: {
+export interface InitOptions {
     name: string;
     environment: string;
     token?: string;
@@ -19,4 +18,5 @@ enabled, ...options }: {
     additionalMetricReaders?: readonly MetricReader[];
     additionalResourceAttributes?: Attributes;
     ignoredOutboundHosts?: readonly string[];
-}): void;
+}
+export declare function init(options: InitOptions): void;

package/dist/init.js

@@ -10,32 +10,60 @@ const resource_js_1 = require("./resource.js");
 const sdk_logs_1 = require("@opentelemetry/sdk-logs");
 const sdk_metrics_1 = require("@opentelemetry/sdk-metrics");
 const sdk_trace_base_1 = require("@opentelemetry/sdk-trace-base");
-const constants_js_1 = require("./constants.js");
-const diagnostics_js_1 = require("./diagnostics.js");
+const report_js_1 = require("./report.js");
 const exporters_js_1 = require("./exporters.js");
 const instrumentations_js_1 = require("./instrumentations.js");
+const logs_js_1 = require("./logs.js");
 const state_js_1 = require("./state.js");
-// TODO(pcga11): redact and beforeSend as well as conflicts handling not yet implemented.
-function init({ sampleRate = 1, disableLogSending = false, networkCapture = "basic", // pcga11: We do not default to advanced because this is something our clients approve to opt in during onboarding.
-enabled = true, ...options }) {
+// TODO(pcga11): conflicts, redact and beforeSend handling pending.
+function init(options) {
+    const { sampleRate = 1, disableLogSending = false, networkCapture = "basic", enabled = true, } = options;
+    // pcga11: Set params before any early return so every state is reported, including failed or disabled attempts.
+    (0, state_js_1.setParams)({ name: options.name, environment: options.environment });
+    // pcga11: We keep this option because companies often want to turn the integration off in specific envs
     if (!enabled) {
-        (0, diagnostics_js_1.info)("Foam SDK for Node.js is disabled");
+        (0, report_js_1.report)({
+            token: options.token,
+            severity: api_logs_1.SeverityNumber.INFO,
+            message: 'SDK disabled',
+        });
+        return;
+    }
+    if (!options.token) {
+        // pcga11: Nothing can be sent without a token; report() still logs locally so this is not silent.
+        (0, report_js_1.report)({
+            severity: api_logs_1.SeverityNumber.ERROR,
+            message: 'Parameter token not provided',
+        });
         return;
     }
+    // pcga11: Re-initializing could register duplicate providers/instrumentations, so we track the initialization state and bail out on repeat calls
     if ((0, state_js_1.getInitialized)()) {
-        (0, diagnostics_js_1.warn)("Foam SDK for Node.js is already initialized");
+        (0, report_js_1.report)({
+            token: options.token,
+            severity: api_logs_1.SeverityNumber.WARN,
+            message: 'SDK already initialized',
+        });
         return;
     }
-    (0, diagnostics_js_1.configureDiagnostics)();
-    if (!options.name?.trim() || !options.environment?.trim() || !options.token) {
-        (0, diagnostics_js_1.error)(`${constants_js_1.FOAM_IDENTIFIER_NAME}: name, environment, and token are required`);
+    if (!options.name?.trim() || !options.environment?.trim()) {
+        (0, report_js_1.report)({
+            token: options.token,
+            severity: api_logs_1.SeverityNumber.ERROR,
+            message: 'Parameters name and environment not provided',
+        });
         return;
     }
+    // pcga11: Hoisted so the catch block can shut down providers whose batch/periodic
+    // export timers started in their constructors, even when init fails midway.
+    let tracerProvider;
+    let meterProvider;
     try {
         const resource = (0, resource_js_1.createFoamResource)(options.name, options.environment, options.version, options.additionalResourceAttributes);
-        // pcga11: Register our context manager and propagator; if another SDK already
-        // registered one, keep theirs
-        // TODO(pcga11): Implement a way to handle piggy backing the context manager and propagator from another SDK.
+        // pcga11: The context manager is what makes the "current" context (active span, baggage)
+        // follow execution across await/callback boundaries, via Node's AsyncLocalStorage. Without
+        // one registered, spans would not nest and trace/log correlation would break. Registration
+        // is first-wins: if another SDK already installed one, we keep theirs and disable ours.
         const contextManager = new context_async_hooks_1.AsyncLocalStorageContextManager();
         contextManager.enable();
         if (!api_1.context.setGlobalContextManager(contextManager)) {
@@ -46,10 +74,10 @@ enabled = true, ...options }) {
                 new core_1.W3CTraceContextPropagator(),
                 new core_1.W3CBaggagePropagator(),
             ],
-        })));
+        })) ? state_js_1.SignalSources.global : state_js_1.SignalSources.none);
         // pcga11: The @opentelemetry/api setters return false when another SDK already owns a slot (registration is first-wins). So we try to register our own and if it fails or already taken, nothing happens.
         // TODO(pcga11): Implement a way to handle piggy backing the context and propagation from another SDK.
-        const tracerProvider = new sdk_trace_base_1.BasicTracerProvider({
+        tracerProvider = new sdk_trace_base_1.BasicTracerProvider({
             resource,
             sampler: new sdk_trace_base_1.ParentBasedSampler({
                 root: new sdk_trace_base_1.TraceIdRatioBasedSampler(sampleRate),
@@ -59,7 +87,7 @@ enabled = true, ...options }) {
                 ...(options.additionalSpanProcessors ?? []),
             ],
         });
-        const meterProvider = new sdk_metrics_1.MeterProvider({
+        meterProvider = new sdk_metrics_1.MeterProvider({
             resource,
             readers: [
                 new sdk_metrics_1.PeriodicExportingMetricReader({
@@ -77,44 +105,45 @@ enabled = true, ...options }) {
                 ...(options.additionalLogRecordProcessors ?? []),
             ],
         });
-        // pcga11: trace/metrics/propagation setters return false when the slot is taken by another SDK. The logs setter returns whichever provider ended up registered. We use that to mark ownership.
-        (0, state_js_1.setSignal)(state_js_1.Signals.traces, api_1.trace.setGlobalTracerProvider(tracerProvider));
-        (0, state_js_1.setSignal)(state_js_1.Signals.metrics, api_1.metrics.setGlobalMeterProvider(meterProvider));
-        (0, state_js_1.setSignal)(state_js_1.Signals.logs, api_logs_1.logs.setGlobalLoggerProvider(loggerProvider) === loggerProvider);
+        (0, logs_js_1.setFoamLoggerProvider)(loggerProvider);
+        // pcga11: trace/metrics/propagation setters return false when the slot is taken by another SDK. The logs setter returns whichever provider ended up registered. We use that to record the source: "global" when Foam owns the slot, "none" when another SDK does. Logs fall back to "local" because the Foam-only provider behind log() exists either way.
+        (0, state_js_1.setSignal)(state_js_1.Signals.traces, api_1.trace.setGlobalTracerProvider(tracerProvider) ? state_js_1.SignalSources.global : state_js_1.SignalSources.none);
+        (0, state_js_1.setSignal)(state_js_1.Signals.metrics, api_1.metrics.setGlobalMeterProvider(meterProvider) ? state_js_1.SignalSources.global : state_js_1.SignalSources.none);
+        (0, state_js_1.setSignal)(state_js_1.Signals.logs, api_logs_1.logs.setGlobalLoggerProvider(loggerProvider) === loggerProvider ? state_js_1.SignalSources.global : state_js_1.SignalSources.local);
         const instrumentations = (0, instrumentations_js_1.buildInstrumentations)(networkCapture, disableLogSending, options.ignoredOutboundHosts, options.additionalInstrumentations ?? []);
+        // pcga11: registerInstrumentations turns on instrumentation "hooks". OpenTelemetry wraps supported libraries when the app imports them.
         (0, instrumentation_1.registerInstrumentations)({ instrumentations });
         (0, state_js_1.setInstrumentations)(instrumentations.map(instrumentations_js_1.instrumentationName));
-        // pcga11: Signals are flushed, remaining batches are sent, and exporters are stopped before the process exits.
         process.once("beforeExit", () => {
             void Promise.all([
-                (0, state_js_1.getSignal)(state_js_1.Signals.traces) ? tracerProvider.shutdown() : undefined,
-                (0, state_js_1.getSignal)(state_js_1.Signals.metrics) ? meterProvider.shutdown() : undefined,
-                (0, state_js_1.getSignal)(state_js_1.Signals.logs) ? loggerProvider.shutdown() : undefined,
+                (0, state_js_1.getSignal)(state_js_1.Signals.traces) === state_js_1.SignalSources.global ? tracerProvider?.shutdown() : undefined,
+                (0, state_js_1.getSignal)(state_js_1.Signals.metrics) === state_js_1.SignalSources.global ? meterProvider?.shutdown() : undefined,
+                loggerProvider.shutdown(),
             ]).catch(() => undefined);
         });
         (0, state_js_1.setInitialized)(true);
-        (0, diagnostics_js_1.info)("Foam SDK for Node.js initialized");
-        void (0, diagnostics_js_1.sendStateDiagnosticLog)({
-            name: options.name,
-            environment: options.environment,
+        (0, report_js_1.report)({
             token: options.token,
-            tier: "internal",
             severity: api_logs_1.SeverityNumber.INFO,
+            message: 'SDK initialized',
         });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         for (const signal of [state_js_1.Signals.traces, state_js_1.Signals.metrics, state_js_1.Signals.logs, state_js_1.Signals.baggage]) {
-            (0, state_js_1.setSignal)(signal, false);
+            (0, state_js_1.setSignal)(signal, state_js_1.SignalSources.none);
         }
+        void Promise.all([
+            tracerProvider?.shutdown(),
+            meterProvider?.shutdown(),
+            (0, logs_js_1.getFoamLoggerProvider)()?.shutdown(),
+        ]).catch(() => undefined);
+        (0, logs_js_1.clearFoamLoggerProvider)();
         (0, state_js_1.setInitialized)(false);
-        (0, diagnostics_js_1.error)(`Foam SDK for Node.js initialization failed: ${errorMessage}`);
-        void (0, diagnostics_js_1.sendStateDiagnosticLog)({
-            name: options.name,
-            environment: options.environment,
+        (0, report_js_1.report)({
             token: options.token,
-            tier: "internal",
             severity: api_logs_1.SeverityNumber.ERROR,
+            message: `SDK initialization failed: ${errorMessage}`,
             error: errorMessage,
         });
     }

package/dist/instrumentations.js

@@ -5,11 +5,33 @@ exports.buildInstrumentations = buildInstrumentations;
 const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
 const instrumentation_console_1 = require("@opentelemetry/instrumentation-console");
 const index_js_1 = require("./network-capture/index.js");
+const endpoint_js_1 = require("./endpoint.js");
 const state_js_1 = require("./state.js");
 const constants_js_1 = require("./constants.js");
 function buildInstrumentations(networkCapture = "basic", disableLogSending = false, ignoredOutboundHosts, additionalInstrumentations) {
-    const bodyCaptureEnabled = (0, state_js_1.getSignal)(state_js_1.Signals.logs);
+    // pcga11: Captured bodies are emitted through the global logs pipeline. Only enable
+    // capture when that pipeline delivers to Foam ("global"/"ingest").
+    // If another SDK owns the slot (aka we have "local" for logs), capturing would be done for other vendors instead of Foam which might be non-compliant.
+    // If it's "none", capturing does not work at all.
+    const logsSource = (0, state_js_1.getSignal)(state_js_1.Signals.logs);
+    const bodyCaptureEnabled = logsSource === state_js_1.SignalSources.global || logsSource === state_js_1.SignalSources.ingest;
     const capturedHeaders = networkCapture === "off" ? undefined : [...constants_js_1.SAFE_NETWORK_HEADERS];
+    // pcga11: Skip Foam's OTLP export HTTP calls so they do not become client spans
+    // TODO(pcga11): This could get real interesting: could we use these calls to verify coverage? IDK maybe tarpid
+    const ignoredHosts = new Set([
+        new URL(endpoint_js_1.endpoint).hostname,
+        ...(ignoredOutboundHosts ?? []),
+    ]);
+    const ignoreHttpOutgoingRequest = ((request) => typeof request.hostname === "string" &&
+        ignoredHosts.has(request.hostname));
+    const ignoreUndiciRequest = ((request) => {
+        try {
+            return ignoredHosts.has(new URL(request.origin).hostname);
+        }
+        catch {
+            return false;
+        }
+    });
     const bodyHooks = networkCapture === "advanced"
         ? (0, index_js_1.createNetworkCaptureHooks)(bodyCaptureEnabled)
         : undefined;
@@ -36,8 +58,7 @@ function buildInstrumentations(networkCapture = "basic", disableLogSending = fal
                 }
                 : {}),
             ...(bodyHooks ?? {}),
-            ignoreOutgoingRequestHook: ((request) => typeof request.hostname === "string" &&
-                (ignoredOutboundHosts ?? []).includes(request.hostname)),
+            ignoreOutgoingRequestHook: ignoreHttpOutgoingRequest,
         },
         "@opentelemetry/instrumentation-openai": {
             captureMessageContent: networkCapture === "advanced",
@@ -55,6 +76,7 @@ function buildInstrumentations(networkCapture = "basic", disableLogSending = fal
                 }
                 : {}),
             ...(advancedUndiciHooks ?? {}),
+            ignoreRequestHook: ignoreUndiciRequest,
         },
         "@opentelemetry/instrumentation-winston": {
             disableLogSending: disableLogSending === true,

package/dist/logs.d.ts

@@ -0,0 +1,9 @@
+import type { Attributes } from "@opentelemetry/api";
+import { SeverityNumber } from "@opentelemetry/api-logs";
+import { LoggerProvider } from "@opentelemetry/sdk-logs";
+export declare function setFoamLoggerProvider(provider: LoggerProvider): void;
+export declare function getFoamLoggerProvider(): LoggerProvider | undefined;
+export declare function clearFoamLoggerProvider(): void;
+export declare function ensureFoamLoggerProvider(name: string, environment: string, token: string, stamp?: Attributes): LoggerProvider;
+export declare const log: (body: string, severityNumber?: SeverityNumber, attributes?: Attributes) => void;
+export { SeverityNumber };

package/dist/logs.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeverityNumber = exports.log = void 0;
+exports.setFoamLoggerProvider = setFoamLoggerProvider;
+exports.getFoamLoggerProvider = getFoamLoggerProvider;
+exports.clearFoamLoggerProvider = clearFoamLoggerProvider;
+exports.ensureFoamLoggerProvider = ensureFoamLoggerProvider;
+const api_logs_1 = require("@opentelemetry/api-logs");
+Object.defineProperty(exports, "SeverityNumber", { enumerable: true, get: function () { return api_logs_1.SeverityNumber; } });
+const sdk_logs_1 = require("@opentelemetry/sdk-logs");
+const constants_js_1 = require("./constants.js");
+const exporters_js_1 = require("./exporters.js");
+const resource_js_1 = require("./resource.js");
+const utils_js_1 = require("./utils.js");
+let foamLoggerProvider;
+function setFoamLoggerProvider(provider) {
+    if (foamLoggerProvider && foamLoggerProvider !== provider) {
+        void foamLoggerProvider.shutdown().catch(() => undefined);
+    }
+    foamLoggerProvider = provider;
+}
+function getFoamLoggerProvider() {
+    return foamLoggerProvider;
+}
+function clearFoamLoggerProvider() {
+    foamLoggerProvider = undefined;
+}
+function ensureFoamLoggerProvider(name, environment, token, stamp) {
+    const existing = foamLoggerProvider;
+    if (existing) {
+        return existing;
+    }
+    const provider = new sdk_logs_1.LoggerProvider({
+        resource: (0, resource_js_1.createFoamResource)(name, environment),
+        processors: [
+            new sdk_logs_1.BatchLogRecordProcessor({
+                exporter: new exporters_js_1.FoamLogExporter(token, stamp),
+            }),
+        ],
+    });
+    setFoamLoggerProvider(provider);
+    process.once("beforeExit", () => {
+        void provider.shutdown().catch(() => undefined);
+    });
+    return provider;
+}
+const log = (body, severityNumber = api_logs_1.SeverityNumber.INFO, attributes) => {
+    const provider = foamLoggerProvider;
+    if (!provider) {
+        return;
+    }
+    (0, utils_js_1.safely)(() => {
+        provider.getLogger(constants_js_1.FOAM_DISTRO_NAME, constants_js_1.FOAM_DISTRO_VERSION).emit({
+            body,
+            severityNumber,
+            severityText: constants_js_1.SEVERITY_TEXT[severityNumber],
+            attributes,
+        });
+    });
+};
+exports.log = log;