@newrelic/preflight 0.0.1-pre.1 → 1.0.1

package/dist/shared/transport/http-client.js

@@ -0,0 +1,381 @@
+import { gzip } from 'node:zlib';
+import { promisify } from 'node:util';
+import { randomUUID } from 'node:crypto';
+import { createLogger } from '../logger.js';
+import { VERSION } from '../version.js';
+import { DEFAULT_CLIENT_NAME } from './otlp-shared.js';
+/**
+ * Builds the `User-Agent` header value for outbound NR ingest requests
+ *. NR's collector logs the UA, so identifying the
+ * consuming client by name and version makes operator-side investigation
+ * tractable (e.g. "which client version is producing the malformed payload?").
+ */
+function buildUserAgent(clientName) {
+    return `${clientName || DEFAULT_CLIENT_NAME}/${VERSION}`;
+}
+const gzipAsync = promisify(gzip);
+const logger = createLogger('transport');
+/**
+ * Generate a short correlation ID for an outbound batch
+ * (14 / §10.5). Eight hex chars derived from a v4 UUID is
+ * enough entropy to disambiguate concurrent retries in stderr without
+ * adding meaningful payload weight or scanning friction.
+ */
+function newRequestId() {
+    return randomUUID().slice(0, 8);
+}
+// Exact license-key prefixes we recognize, plus the region they map to.
+// Prefixes are matched case-insensitively.
+const LICENSE_KEY_REGION_PREFIXES = {
+    us01: 'us',
+    eu01: 'eu',
+    gov01: 'gov',
+};
+// Pattern for *any* string that looks like a region prefix (2-4 letters then
+// 2 digits at the start of the key). If a key matches this pattern but the
+// specific prefix is not in LICENSE_KEY_REGION_PREFIXES, we throw — silently
+// defaulting to US would misroute data to the wrong data center.
+const REGION_PREFIX_SHAPE_RE = /^[a-z]{2,4}\d{2}/;
+export function resolveRegion(licenseKey, collectorHost) {
+    // collectorHost overrides take priority — they are an explicit user choice.
+    // Only recognise the keyword form (bare word, no dots or colons).
+    // Substring matching against FQDNs produced false positives: a host like
+    // 'bureau-collector.local' matches 'eu', 'eucalyptus.test' likewise (§HC2).
+    if (collectorHost) {
+        const host = collectorHost.toLowerCase().trim();
+        if (!host.includes('.') && !host.includes(':')) {
+            if (host === 'gov')
+                return 'gov';
+            if (host === 'eu')
+                return 'eu';
+            if (host === 'us')
+                return 'us';
+        }
+        // FQDN form: licence-key prefix detection below handles region routing.
+    }
+    const lowerKey = licenseKey.toLowerCase();
+    // Exact prefix match — the only path that reliably resolves to a known region.
+    for (const [prefix, region] of Object.entries(LICENSE_KEY_REGION_PREFIXES)) {
+        if (lowerKey.startsWith(prefix))
+            return region;
+    }
+    // Key has the *shape* of a region prefix but not one we recognize. This
+    // most likely means New Relic launched a new region we don't yet support,
+    // OR the key is corrupted. Either way, defaulting to US silently misroutes
+    // data — fail loudly instead.
+    if (REGION_PREFIX_SHAPE_RE.test(lowerKey)) {
+        const observedPrefix = lowerKey.match(REGION_PREFIX_SHAPE_RE)[0];
+        const supported = Object.keys(LICENSE_KEY_REGION_PREFIXES).join(', ');
+        throw new Error(`Unrecognized New Relic license-key region prefix "${observedPrefix}". ` +
+            `Supported prefixes: ${supported}. ` +
+            `Set 'collectorHost' explicitly to override region detection.`);
+    }
+    // No region prefix shape — assume legacy US key (40-char hex, no prefix).
+    return 'us';
+}
+/**
+ * §5.9: When `collectorHost` is provided AND looks like a real hostname (has a
+ * dot or colon — i.e. an FQDN or host:port), treat it as a literal override and
+ * use it as the URL host for ALL three APIs (events, metric, logs). The path
+ * remains per-API since the user's proxy must route by path.
+ *
+ * Without a dot or colon, `collectorHost` is treated as an exact region keyword
+ * (one of 'us', 'eu', 'gov') — `resolveRegion` maps it to the
+ * appropriate NR hostnames for all three APIs (§HC2 — no substring matching).
+ *
+ */
+function isLiteralHostname(collectorHost) {
+    if (!collectorHost)
+        return false;
+    return collectorHost.includes('.') || collectorHost.includes(':');
+}
+/**
+ * Per-region NR ingest hostnames (23 / §5.24).
+ *
+ * Single source of truth — the three URL builders below all read from this
+ * table instead of inlining the same nested-ternary three times. To add a
+ * new region, widen `Region` plus `LICENSE_KEY_REGION_PREFIXES` and add
+ * one row here; nothing else needs to change.
+ *
+ * The table is intentionally NOT exported. Hostnames are NR-operated
+ * implementation detail — exposing them as a public constant invites
+ * consumers to depend on specific values, which would break if NR ever
+ * renames a host (§5.23). Consumers that need to override an endpoint
+ * should use the `collectorHost` option instead, which already routes
+ * through `isLiteralHostname()` above.
+ */
+const NR_INGEST_HOSTS = Object.freeze({
+    us: {
+        events: 'insights-collector.newrelic.com',
+        metric: 'metric-api.newrelic.com',
+        log: 'log-api.newrelic.com',
+    },
+    eu: {
+        events: 'insights-collector.eu01.nr-data.net',
+        metric: 'metric-api.eu.newrelic.com',
+        log: 'log-api.eu.newrelic.com',
+    },
+    gov: {
+        events: 'gov-insights-collector.newrelic.com',
+        metric: 'gov-metric-api.newrelic.com',
+        log: 'gov-log-api.newrelic.com',
+    },
+});
+export function getEventsApiUrl(accountId, region, collectorHost) {
+    // F3: defensive guard against an empty/null/undefined accountId
+    // that bypassed `loadConfig`'s fail-fast (e.g. a JS caller, an explicit
+    // `accountId: config.accountId!` non-null assertion, or a custom config
+    // path that didn't go through loadConfig). Without this, the URL becomes
+    // `.../accounts/null/events` and NR responds 404 to every harvest — the
+    // scheduler silently retry-loops until the retry buffer overflows.
+    if (!accountId || accountId === 'null' || accountId === 'undefined') {
+        throw new Error(`getEventsApiUrl: accountId is required (got: ${JSON.stringify(accountId)}). ` +
+            `Set the NEW_RELIC_ACCOUNT_ID environment variable or pass accountId in options.`);
+    }
+    if (isLiteralHostname(collectorHost)) {
+        return `https://${collectorHost}/v1/accounts/${accountId}/events`;
+    }
+    return `https://${NR_INGEST_HOSTS[region].events}/v1/accounts/${accountId}/events`;
+}
+export function getMetricApiUrl(region, collectorHost) {
+    if (isLiteralHostname(collectorHost)) {
+        return `https://${collectorHost}/metric/v1`;
+    }
+    return `https://${NR_INGEST_HOSTS[region].metric}/metric/v1`;
+}
+export function getLogsApiUrl(region, collectorHost) {
+    if (isLiteralHostname(collectorHost)) {
+        return `https://${collectorHost}/log/v1`;
+    }
+    return `https://${NR_INGEST_HOSTS[region].log}/log/v1`;
+}
+/**
+ * gzip-compress a JSON-serializable payload.
+ *
+ * Node 18+'s `zlib.gzip` accepts a string directly and performs UTF-8
+ * encoding internally, so we hand it `JSON.stringify(data)` and skip the
+ * extra `Buffer.from(json)` allocation that the previous implementation
+ * incurred (one less buffer per harvest).
+ *
+ * The returned Buffer is immutable after the call (`zlib.gzip` is a
+ * one-shot, not a stateful stream), so it is safe for `sendWithRetry` to
+ * reuse the same `compressed` Buffer across retry attempts (§5.16). If a
+ * future refactor moves to a stateful gzip stream, that reuse becomes
+ * unsafe — pin the call site outside the retry loop accordingly.
+ */
+export async function compressPayload(data) {
+    return gzipAsync(JSON.stringify(data));
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * AWS-recommended decorrelated-jitter exponential backoff.
+ *
+ *   sleep = min(maxDelayMs, random_between(baseDelayMs, prevSleepMs * 3))
+ *
+ * Compared to "equal jitter" (`backoff * (0.5 + Math.random() * 0.5)`),
+ * decorrelated jitter:
+ *   - smears retries more uniformly across time, reducing the thundering-herd
+ *     effect when many clients are retrying the same 429,
+ *   - lets a slow-start grow naturally toward `maxDelayMs` rather than locking
+ *     the schedule to powers of two of `baseDelayMs`.
+ *
+ * `prevSleepMs` should start at `baseDelayMs` for the first retry, then carry
+ * the chosen wait forward so each subsequent retry samples from a wider band.
+ */
+export function decorrelatedJitter(baseDelayMs, maxDelayMs, prevSleepMs) {
+    // Clamp upper to at least baseDelayMs so the jitter band [base, upper] is
+    // never negative when maxDelayMs < baseDelayMs (a misconfiguration, but
+    // unguarded — without the clamp the sample can be zero or negative, §TR3).
+    const upper = Math.max(baseDelayMs, Math.min(maxDelayMs, prevSleepMs * 3));
+    // Math.random() returns [0, 1); spread baseDelayMs..upper.
+    const sample = baseDelayMs + (upper - baseDelayMs) * Math.random();
+    return Math.min(maxDelayMs, Math.max(baseDelayMs, sample));
+}
+function isRetryable(status) {
+    return status === 408 || status === 429 || (status >= 500 && status <= 599);
+}
+/**
+ * Parse a Retry-After header per RFC 7231:
+ *   - delta-seconds: a non-negative integer, e.g. "120"
+ *   - HTTP-date: an absolute date, e.g. "Wed, 21 Oct 2026 07:28:00 GMT"
+ * Returns the wait time in milliseconds, or null if absent or malformed.
+ */
+function parseRetryAfterMs(response) {
+    const raw = response.headers.get('retry-after');
+    if (!raw)
+        return null;
+    const trimmed = raw.trim();
+    // Try delta-seconds first
+    if (/^\d+$/.test(trimmed)) {
+        return parseInt(trimmed, 10) * 1000;
+    }
+    // Try HTTP-date
+    const ts = Date.parse(trimmed);
+    if (!Number.isNaN(ts)) {
+        return Math.max(0, ts - Date.now());
+    }
+    return null;
+}
+export async function sendWithRetry(options) {
+    const { url, body, licenseKey, maxRetries, baseDelayMs, maxDelayMs, requestTimeoutMs } = options;
+    // Per-request correlation ID (14 / §10.5). Stamped on every
+    // log line emitted from this call so concurrent retries to different
+    // batches can be disambiguated in stderr.
+    const requestId = newRequestId();
+    let compressed;
+    try {
+        compressed = await compressPayload(body);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error('Failed to compress payload', { requestId, error: message });
+        return { success: false, statusCode: null, retryCount: 0, error: `gzip failed: ${message}` };
+    }
+    // Decorrelated jitter tracks the previous sleep across
+    // attempts so each subsequent retry samples from a wider [base, prev*3] band.
+    // Initialize to baseDelayMs so the first retry samples [base, base*3].
+    let prevSleepMs = baseDelayMs;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            // Node 18+ fetch accepts Buffer bodies, but under TS6 Buffer<ArrayBufferLike>
+            // no longer satisfies BodyInit (tightened Uint8Array generics). Double-cast
+            // through unknown is the standard escape hatch; runtime behaviour is unchanged.
+            const fetchBody = compressed;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Api-Key': licenseKey,
+                    'Content-Type': 'application/json',
+                    'Content-Encoding': 'gzip',
+                    'User-Agent': buildUserAgent(options.clientName),
+                },
+                body: fetchBody,
+                signal: AbortSignal.timeout(requestTimeoutMs),
+                // §5.20 — `keepalive: true` is a no-op in Node fetch (undici), but
+                // safe to set. It exists for the case where this library is consumed
+                // in a runtime that *does* honor it (Cloudflare Workers, Deno, browser
+                // bundlers): the final shutdown send issued from `HarvestScheduler.stop()`
+                // can survive page-unload / process-teardown there. No effect on Node.
+                keepalive: true,
+            });
+            const status = response.status;
+            if (status >= 200 && status < 300) {
+                // Drain the body so undici returns the socket to the keep-alive pool
+                // rather than tearing down the connection (§HC1).
+                await response.body?.cancel().catch(() => { });
+                return { success: true, statusCode: status, retryCount: attempt };
+            }
+            // Read the body for all failure paths: gives useful diagnostics for 5xx
+            // errors and releases the socket to the keep-alive pool (§HC1).
+            const responseBody = (await response.text().catch(() => '')).slice(0, 1024);
+            if (status === 400) {
+                logger.error('Bad request — dropping batch', {
+                    requestId,
+                    statusCode: status,
+                    response: responseBody,
+                });
+                return {
+                    success: false,
+                    statusCode: status,
+                    retryCount: attempt,
+                    // Surface the server's body in the result so the harvest scheduler's
+                    // log line carries diagnostic detail (e.g. "Reserved attribute name
+                    // 'accountId'", "Body too large", "Invalid timestamp"). Truncated.
+                    error: responseBody ? `bad request: ${responseBody}` : 'bad request',
+                };
+            }
+            if (status === 403) {
+                logger.error('Forbidden — possible invalid license key or account permission', {
+                    requestId,
+                    statusCode: status,
+                    response: responseBody,
+                });
+                return {
+                    success: false,
+                    statusCode: status,
+                    retryCount: attempt,
+                    error: responseBody ? `forbidden: ${responseBody}` : 'forbidden',
+                };
+            }
+            if (isRetryable(status)) {
+                logger.warn('Retryable status received', {
+                    requestId,
+                    statusCode: status,
+                    attempt,
+                    response: responseBody.slice(0, 256),
+                });
+                if (attempt < maxRetries) {
+                    // Respect server-supplied Retry-After when present; cap at maxDelayMs
+                    // to avoid pathological values. Otherwise use decorrelated-jitter
+                    // exponential backoff.
+                    const retryAfter = parseRetryAfterMs(response);
+                    let waitMs;
+                    if (retryAfter !== null) {
+                        waitMs = Math.min(retryAfter, maxDelayMs);
+                    }
+                    else {
+                        waitMs = decorrelatedJitter(baseDelayMs, maxDelayMs, prevSleepMs);
+                    }
+                    // Always carry the chosen wait forward so the next jitter window
+                    // widens appropriately — omitting this on the Retry-After path caused
+                    // the window to stall at [base, base*3] after every server-driven
+                    // wait (§TR4).
+                    prevSleepMs = waitMs;
+                    await delay(waitMs);
+                    continue;
+                }
+                logger.warn('Max retries exhausted — dropping batch', {
+                    requestId,
+                    statusCode: status,
+                    attempts: attempt + 1,
+                });
+                return {
+                    success: false,
+                    statusCode: status,
+                    retryCount: attempt,
+                    error: `max retries exhausted (last status: ${status})`,
+                };
+            }
+            // Non-retryable, non-standard status
+            logger.warn('Unexpected status code — dropping batch', {
+                requestId,
+                statusCode: status,
+                response: responseBody.slice(0, 256),
+            });
+            return {
+                success: false,
+                statusCode: status,
+                retryCount: attempt,
+                error: `unexpected status: ${status}`,
+            };
+        }
+        catch (err) {
+            // Network error — retryable
+            const message = err instanceof Error ? err.message : String(err);
+            logger.warn('Network error during send', { requestId, error: message, attempt });
+            if (attempt < maxRetries) {
+                const waitMs = decorrelatedJitter(baseDelayMs, maxDelayMs, prevSleepMs);
+                prevSleepMs = waitMs;
+                await delay(waitMs);
+                continue;
+            }
+            logger.warn('Max retries exhausted after network errors — dropping batch', {
+                requestId,
+                attempts: attempt + 1,
+            });
+            return {
+                success: false,
+                statusCode: null,
+                retryCount: attempt,
+                error: `network error: ${message}`,
+            };
+        }
+    }
+    // Should not reach here — every loop iteration returns or continues.
+    // A throw (not a silent failure return) makes a future loop-logic regression
+    // immediately visible rather than producing a confusing success:false result (§TR6).
+    throw new Error('sendWithRetry: unreachable code — bug in retry loop logic');
+}
+//# sourceMappingURL=http-client.js.map

package/dist/shared/transport/http-client.js.map

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

package/dist/shared/transport/index.d.ts

@@ -0,0 +1,10 @@
+export { sendEvents } from './events-api.js';
+export { sendMetrics } from './metric-api.js';
+export { sendLogs } from './logs-api.js';
+export { OtlpTransport } from './otlp-transport.js';
+export { OtlpEventBridge } from './otlp-event-bridge.js';
+export type { NrLogEntry } from './logs-api.js';
+export type { NrMetric, TransportMode, TransportOptions, TransportResult } from './types.js';
+export type { OtlpTransportOptions } from './otlp-transport.js';
+export type { OtlpEventBridgeOptions } from './otlp-event-bridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7F,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/transport/index.js

@@ -0,0 +1,6 @@
+export { sendEvents } from './events-api.js';
+export { sendMetrics } from './metric-api.js';
+export { sendLogs } from './logs-api.js';
+export { OtlpTransport } from './otlp-transport.js';
+export { OtlpEventBridge } from './otlp-event-bridge.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/transport/logs-api.d.ts

@@ -0,0 +1,29 @@
+import type { TransportOptions, TransportResult } from './types.js';
+export interface NrLogEntry {
+    timestamp: number;
+    message: string;
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Send a batch of log entries to the New Relic Logs API.
+ *
+ * Body shape: `[{ logs: [...] }]` — the "Detailed JSON"
+ * format documented at
+ * https://docs.newrelic.com/docs/logs/log-api/introduction-log-api/.
+ * NR also accepts a top-level `common` block sibling to `logs` for shared
+ * attributes (e.g. `[{ common: { attributes: {…} }, logs: [...] }]`); we
+ * don't use it because each log entry already carries its own `attributes`
+ * map, but the option is open if a future caller wants to deduplicate
+ * across-batch attributes.
+ *
+ * **⚠️ Standalone transport helper — no harvest-scheduler integration (§11.9).**
+ * Unlike `sendEvents` and `sendMetrics`, this function is NOT wired into
+ * `HarvestScheduler`. It has no in-memory buffer, no overflow protection, no
+ * retry-buffer cap, and no self-monitoring drop metrics. Call it directly only
+ * when you own the batching and retry logic yourself. For managed delivery
+ * analogous to event/metric harvest, a `NrLogEntry[]` buffer inside
+ * `HarvestScheduler` would be the right surface — that work is tracked under
+ *.
+ */
+export declare function sendLogs(logs: NrLogEntry[], licenseKey: string, options: TransportOptions): Promise<TransportResult>;
+//# sourceMappingURL=logs-api.d.ts.map

package/dist/shared/transport/logs-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs-api.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/logs-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpE,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,UAAU,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAkB1B"}

package/dist/shared/transport/logs-api.js

@@ -0,0 +1,40 @@
+import { sendWithRetry, resolveRegion, getLogsApiUrl } from './http-client.js';
+/**
+ * Send a batch of log entries to the New Relic Logs API.
+ *
+ * Body shape: `[{ logs: [...] }]` — the "Detailed JSON"
+ * format documented at
+ * https://docs.newrelic.com/docs/logs/log-api/introduction-log-api/.
+ * NR also accepts a top-level `common` block sibling to `logs` for shared
+ * attributes (e.g. `[{ common: { attributes: {…} }, logs: [...] }]`); we
+ * don't use it because each log entry already carries its own `attributes`
+ * map, but the option is open if a future caller wants to deduplicate
+ * across-batch attributes.
+ *
+ * **⚠️ Standalone transport helper — no harvest-scheduler integration (§11.9).**
+ * Unlike `sendEvents` and `sendMetrics`, this function is NOT wired into
+ * `HarvestScheduler`. It has no in-memory buffer, no overflow protection, no
+ * retry-buffer cap, and no self-monitoring drop metrics. Call it directly only
+ * when you own the batching and retry logic yourself. For managed delivery
+ * analogous to event/metric harvest, a `NrLogEntry[]` buffer inside
+ * `HarvestScheduler` would be the right surface — that work is tracked under
+ *.
+ */
+export async function sendLogs(logs, licenseKey, options) {
+    if (logs.length === 0) {
+        return { success: true, statusCode: null, retryCount: 0 };
+    }
+    const region = resolveRegion(licenseKey, options.collectorHost ?? null);
+    const url = getLogsApiUrl(region, options.collectorHost ?? null);
+    return sendWithRetry({
+        url,
+        body: [{ logs }],
+        licenseKey,
+        maxRetries: options.maxRetries ?? 3,
+        baseDelayMs: options.baseDelayMs ?? 1000,
+        maxDelayMs: options.maxDelayMs ?? 30_000,
+        requestTimeoutMs: options.requestTimeoutMs ?? 30_000,
+        clientName: options.clientName,
+    });
+}
+//# sourceMappingURL=logs-api.js.map

package/dist/shared/transport/logs-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs-api.js","sourceRoot":"","sources":["../../../src/shared/transport/logs-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQ/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAkB,EAClB,UAAkB,EAClB,OAAyB;IAEzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IAEjE,OAAO,aAAa,CAAC;QACnB,GAAG;QACH,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;QAChB,UAAU;QACV,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;QACnC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;QACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,MAAM;QACpD,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/transport/metric-api.d.ts

@@ -0,0 +1,9 @@
+import type { NrMetric, TransportOptions, TransportResult } from './types.js';
+/**
+ * Send a batch of `NrMetric` records to NR's Metric API. Encodes the
+ * discriminated union (`gauge`, `count`, `summary`) per NR's wire format,
+ * compresses with gzip, and uses the same retry / timeout machinery as
+ * `sendEvents`.
+ */
+export declare function sendMetrics(metrics: NrMetric[], licenseKey: string, options: TransportOptions): Promise<TransportResult>;
+//# sourceMappingURL=metric-api.d.ts.map

package/dist/shared/transport/metric-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-api.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/metric-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAsB9E;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,QAAQ,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAuB1B"}

package/dist/shared/transport/metric-api.js

@@ -0,0 +1,39 @@
+import { sendWithRetry, resolveRegion, getMetricApiUrl } from './http-client.js';
+function toWireMetric(m) {
+    if (m.intervalMs === undefined) {
+        // Gauge with no intervalMs — emit unchanged, drop the field name entirely.
+        const { intervalMs: _omit, ...rest } = m;
+        void _omit;
+        return rest;
+    }
+    const { intervalMs, ...rest } = m;
+    return { ...rest, 'interval.ms': intervalMs };
+}
+/**
+ * Send a batch of `NrMetric` records to NR's Metric API. Encodes the
+ * discriminated union (`gauge`, `count`, `summary`) per NR's wire format,
+ * compresses with gzip, and uses the same retry / timeout machinery as
+ * `sendEvents`.
+ */
+export async function sendMetrics(metrics, licenseKey, options) {
+    if (metrics.length === 0) {
+        return { success: true, statusCode: null, retryCount: 0 };
+    }
+    const region = resolveRegion(licenseKey, options.collectorHost ?? null);
+    const url = getMetricApiUrl(region, options.collectorHost ?? null);
+    // NR Metric API expects: [{ metrics: [...] }]. Rewrite each metric so the
+    // camelCase `intervalMs` becomes the literal wire key `interval.ms` per NR
+    // Metric API contract.
+    const payload = [{ metrics: metrics.map(toWireMetric) }];
+    return sendWithRetry({
+        url,
+        body: payload,
+        licenseKey,
+        maxRetries: options.maxRetries ?? 3,
+        baseDelayMs: options.baseDelayMs ?? 1000,
+        maxDelayMs: options.maxDelayMs ?? 30_000,
+        requestTimeoutMs: options.requestTimeoutMs ?? 30_000,
+        clientName: options.clientName,
+    });
+}
+//# sourceMappingURL=metric-api.js.map

package/dist/shared/transport/metric-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-api.js","sourceRoot":"","sources":["../../../src/shared/transport/metric-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAUjF,SAAS,YAAY,CAAC,CAAW;IAC/B,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC/B,2EAA2E;QAC3E,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,CAAuC,CAAC;QAC/E,KAAK,KAAK,CAAC;QACX,OAAO,IAAkB,CAAC;IAC5B,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,CAAsC,CAAC;IACvE,OAAO,EAAE,GAAI,IAAqC,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AAClF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmB,EACnB,UAAkB,EAClB,OAAyB;IAEzB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IAEnE,0EAA0E;IAC1E,2EAA2E;IAC3E,uBAAuB;IACvB,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAEzD,OAAO,aAAa,CAAC;QACnB,GAAG;QACH,IAAI,EAAE,OAAO;QACb,UAAU;QACV,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;QACnC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;QACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,MAAM;QACpD,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/transport/otlp-event-bridge.d.ts

@@ -0,0 +1,22 @@
+import type { NrEventData } from '../events/types.js';
+export interface OtlpEventBridgeOptions {
+    endpoint: string;
+    headers?: Record<string, string>;
+    appName: string;
+    /**
+     * OTel logger name used to identify the source of log records emitted by
+     * this bridge. Defaults to `'ai-telemetry'` when not provided. Pass
+     * `'preflight'`, `'my-agent'`, etc. so telemetry from different
+     * consumers is distinguishable in the NR Logs UI.
+     */
+    clientName?: string;
+}
+export declare class OtlpEventBridge {
+    private readonly loggerProvider;
+    private readonly otelLogger;
+    constructor(options: OtlpEventBridgeOptions);
+    sendEvents(events: NrEventData[]): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=otlp-event-bridge.d.ts.map

package/dist/shared/transport/otlp-event-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-event-bridge.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/otlp-event-bridge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMtD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;gBAEzD,OAAO,EAAE,sBAAsB;IAwB3C,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAmBjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/shared/transport/otlp-event-bridge.js

@@ -0,0 +1,50 @@
+import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
+import { LoggerProvider, BatchLogRecordProcessor } from '@opentelemetry/sdk-logs';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { createLogger } from '../logger.js';
+import { validateOtlpEndpoint, hasOtlpAuthHeader, DEFAULT_CLIENT_NAME } from './otlp-shared.js';
+const logger = createLogger('otlp-event-bridge');
+export class OtlpEventBridge {
+    loggerProvider;
+    otelLogger;
+    constructor(options) {
+        validateOtlpEndpoint(options.endpoint, 'OtlpEventBridge');
+        // Warn once at construction time when no auth header is present (§TR4),
+        // matching the behaviour of OtlpTransport.exportMetrics().
+        if (!hasOtlpAuthHeader(options.headers ?? {})) {
+            logger.warn('OtlpEventBridge constructed with no auth header — collector may reject events', {
+                endpoint: options.endpoint,
+            });
+        }
+        const exporter = new OTLPLogExporter({
+            url: `${options.endpoint}/v1/logs`,
+            headers: options.headers ?? {},
+        });
+        this.loggerProvider = new LoggerProvider({
+            resource: resourceFromAttributes({ 'service.name': options.appName }),
+            processors: [new BatchLogRecordProcessor(exporter)],
+        });
+        this.otelLogger = this.loggerProvider.getLogger(options.clientName || DEFAULT_CLIENT_NAME);
+    }
+    sendEvents(events) {
+        for (const event of events) {
+            this.otelLogger.emit({
+                severityText: 'INFO',
+                body: String(event['eventType'] ?? 'AiEvent'),
+                // Filter to scalar values only — the OTel SDK's AnyValue type also
+                // accepts arrays/objects/null, and a non-scalar value would produce a
+                // malformed log record. NrEventData is typed as all-scalar but callers
+                // may pass unexpected shapes (§TR2).
+                attributes: Object.fromEntries(Object.entries(event).filter(([, v]) => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')),
+                timestamp: typeof event.timestamp === 'number' ? event.timestamp : Date.now(),
+            });
+        }
+    }
+    async flush() {
+        await this.loggerProvider.forceFlush();
+    }
+    async shutdown() {
+        await this.loggerProvider.shutdown();
+    }
+}
+//# sourceMappingURL=otlp-event-bridge.js.map

package/dist/shared/transport/otlp-event-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otlp-event-bridge.js","sourceRoot":"","sources":["../../../src/shared/transport/otlp-event-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEhG,MAAM,MAAM,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAejD,MAAM,OAAO,eAAe;IACT,cAAc,CAAiB;IAC/B,UAAU,CAA0C;IAErE,YAAY,OAA+B;QACzC,oBAAoB,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAE1D,wEAAwE;QACxE,2DAA2D;QAC3D,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,+EAA+E,EAAE;gBAC3F,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;YACnC,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,UAAU;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC;YACvC,QAAQ,EAAE,sBAAsB,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YACrE,UAAU,EAAE,CAAC,IAAI,uBAAuB,CAAC,QAAQ,CAAC,CAAC;SACpD,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;IAC7F,CAAC;IAED,UAAU,CAAC,MAAqB;QAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;gBACnB,YAAY,EAAE,MAAM;gBACpB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;gBAC7C,mEAAmE;gBACnE,sEAAsE;gBACtE,uEAAuE;gBACvE,qCAAqC;gBACrC,UAAU,EAAE,MAAM,CAAC,WAAW,CAC5B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS,CACpF,CACF;gBACD,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;aAC9E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;IACvC,CAAC;CACF"}