@newrelic/preflight 0.0.1-pre.1 → 1.0.1

package/dist/shared/tokens.js

@@ -0,0 +1,492 @@
+import { createLogger } from './logger.js';
+const tokenLogger = createLogger('tokens');
+/**
+ * Coerce a value to a non-negative integer. Returns 0 if the value is not a
+ * finite non-negative number. Useful for tolerating provider responses with
+ * missing, null, undefined, NaN, Infinity, negative, or float token counts.
+ *
+ * Floors fractional values (e.g. `safeInt(10.7) === 10`). When truncation
+ * actually drops a fractional part, emits a debug-level log so operators can
+ * diagnose buggy provider stubs that return non-integer token counts
+ *. The log is debug, not warn — token counts are
+ * provider-controlled and a single fractional value is not a library bug.
+ */
+export function safeInt(value) {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
+        const floored = Math.floor(value);
+        if (floored !== value) {
+            tokenLogger.debug('safeInt truncated fractional value', { value, floored });
+        }
+        return floored;
+    }
+    return 0;
+}
+/**
+ * Frozen zero-valued `TokenUsage` template. Use `{ ...EMPTY_USAGE }` (a
+ * spread copy) when constructing a fresh mutable accumulator — the spread
+ * is intentional: `TokenAccumulator` mutates `latestUsage` in place across
+ * stream chunks. The frozen master is shared across
+ * call sites so a misuse like `(EMPTY_USAGE as TokenUsage).inputTokens = 5`
+ * throws in strict mode rather than silently corrupting future returns.
+ */
+const EMPTY_USAGE = Object.freeze({
+    inputTokens: 0,
+    outputTokens: 0,
+    thinkingTokens: 0,
+    cacheReadTokens: 0,
+    cacheCreationTokens: 0,
+    totalTokens: 0,
+});
+export function extractAnthropicTokens(response) {
+    if (!response.usage)
+        return { ...EMPTY_USAGE };
+    const usage = response.usage;
+    const inputTokens = safeInt(usage.input_tokens);
+    const outputTokens = safeInt(usage.output_tokens);
+    const cacheReadTokens = safeInt(usage.cache_read_input_tokens);
+    const cacheCreationTokens = safeInt(usage.cache_creation_input_tokens);
+    // Anthropic currently folds thinking into output_tokens. If a future SDK
+    // exposes a dedicated thinking_tokens field, pick it up automatically.
+    // safeInt(undefined) === 0 preserves current behavior when absent.
+    const thinkingTokens = safeInt(usage.thinking_tokens);
+    return {
+        inputTokens,
+        outputTokens,
+        thinkingTokens,
+        cacheReadTokens,
+        cacheCreationTokens,
+        totalTokens: inputTokens + outputTokens + thinkingTokens + cacheReadTokens + cacheCreationTokens,
+    };
+}
+export function extractGeminiTokens(response) {
+    if (!response.usageMetadata)
+        return { ...EMPTY_USAGE };
+    const meta = response.usageMetadata;
+    const inputTokens = safeInt(meta.promptTokenCount);
+    const outputTokens = safeInt(meta.candidatesTokenCount);
+    const thinkingTokens = safeInt(meta.thoughtsTokenCount);
+    const cacheReadTokens = safeInt(meta.cachedContentTokenCount);
+    let totalTokens;
+    if (meta.totalTokenCount !== undefined) {
+        const apiTotal = safeInt(meta.totalTokenCount);
+        // Gemini's totalTokenCount is authoritative per
+        // the API spec and may legitimately diverge from the component sum
+        // (e.g. billable-vs-counted distinctions, deduplication). Use the API
+        // value, but emit a debug log on divergence so operators can spot drift
+        // if the API ever stops reporting totals consistently.
+        const componentSum = inputTokens + outputTokens + thinkingTokens + cacheReadTokens;
+        if (apiTotal !== componentSum) {
+            tokenLogger.debug('Gemini totalTokenCount differs from component sum', {
+                apiTotal,
+                componentSum,
+                inputTokens,
+                outputTokens,
+                thinkingTokens,
+                cacheReadTokens,
+            });
+        }
+        totalTokens = apiTotal;
+    }
+    else {
+        totalTokens = inputTokens + outputTokens + thinkingTokens + cacheReadTokens;
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        thinkingTokens,
+        cacheReadTokens,
+        cacheCreationTokens: 0, // Gemini does not expose cache creation tokens
+        totalTokens,
+    };
+}
+/**
+ * Extract `TokenUsage` from an OpenAI Chat Completions response (or the final
+ * stream chunk when `stream_options: { include_usage: true }` is set — the
+ * shape is identical).
+ *
+ * Mapping:
+ *   - `prompt_tokens` → `inputTokens`
+ *   - `completion_tokens` → `outputTokens`
+ *   - `prompt_tokens_details.cached_tokens` → `cacheReadTokens`
+ *   - `completion_tokens_details.reasoning_tokens` → `thinkingTokens`
+ *
+ * `total_tokens` (if present) is authoritative and used as `totalTokens`,
+ * matching the Gemini extractor's behavior. OpenAI does not expose
+ * cache-creation tokens — they're set to 0.
+ */
+export function extractOpenAITokens(response) {
+    if (!response.usage)
+        return { ...EMPTY_USAGE };
+    const usage = response.usage;
+    const inputTokens = safeInt(usage.prompt_tokens);
+    const outputTokens = safeInt(usage.completion_tokens);
+    const cacheReadTokens = safeInt(usage.prompt_tokens_details?.cached_tokens);
+    const thinkingTokens = safeInt(usage.completion_tokens_details?.reasoning_tokens);
+    let totalTokens;
+    if (usage.total_tokens !== undefined) {
+        totalTokens = safeInt(usage.total_tokens);
+    }
+    else {
+        // §11.3: for OpenAI, cacheReadTokens (prompt_tokens_details.cached_tokens)
+        // is a SUBSET of inputTokens (prompt_tokens), not an additive field.
+        // thinkingTokens (reasoning_tokens) is a SUBSET of outputTokens (completion_tokens).
+        // Including either again would double-count when total_tokens is absent.
+        totalTokens = inputTokens + outputTokens;
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        thinkingTokens,
+        cacheReadTokens,
+        cacheCreationTokens: 0,
+        totalTokens,
+    };
+}
+export function extractCohereTokens(response) {
+    const usage = response.usage ?? response.meta;
+    if (!usage)
+        return { ...EMPTY_USAGE };
+    // Prefer the `tokens` block (actual counts). Fall back to `billed_units`
+    // when `tokens` is missing — Cohere has historically populated both, but
+    // older / less-common endpoints may surface only one.
+    const counts = usage.tokens ?? usage.billed_units ?? {};
+    const inputTokens = safeInt(counts.input_tokens);
+    const outputTokens = safeInt(counts.output_tokens);
+    return {
+        inputTokens,
+        outputTokens,
+        thinkingTokens: 0, // Cohere does not expose reasoning tokens
+        cacheReadTokens: 0,
+        cacheCreationTokens: 0,
+        totalTokens: inputTokens + outputTokens,
+    };
+}
+export function extractMistralTokens(response) {
+    if (!response.usage)
+        return { ...EMPTY_USAGE };
+    const usage = response.usage;
+    const inputTokens = safeInt(usage.prompt_tokens);
+    const outputTokens = safeInt(usage.completion_tokens);
+    let totalTokens;
+    if (usage.total_tokens !== undefined) {
+        totalTokens = safeInt(usage.total_tokens);
+    }
+    else {
+        totalTokens = inputTokens + outputTokens;
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        thinkingTokens: 0, // Mistral Chat Completions does not expose reasoning tokens
+        cacheReadTokens: 0, // Mistral does not expose prompt-cache fields today
+        cacheCreationTokens: 0,
+        totalTokens,
+    };
+}
+export function extractBedrockTokens(response) {
+    if (!response.usage)
+        return { ...EMPTY_USAGE };
+    const usage = response.usage;
+    const inputTokens = safeInt(usage.inputTokens);
+    const outputTokens = safeInt(usage.outputTokens);
+    const cacheReadTokens = safeInt(usage.cacheReadInputTokens);
+    const cacheCreationTokens = safeInt(usage.cacheWriteInputTokens);
+    let totalTokens;
+    if (usage.totalTokens !== undefined) {
+        totalTokens = safeInt(usage.totalTokens);
+    }
+    else {
+        totalTokens = inputTokens + outputTokens + cacheReadTokens + cacheCreationTokens;
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        thinkingTokens: 0, // Bedrock Converse does not surface reasoning tokens distinctly
+        cacheReadTokens,
+        cacheCreationTokens,
+        totalTokens,
+    };
+}
+// ---------------------------------------------------------------------------
+// Unified stream extraction
+// ---------------------------------------------------------------------------
+/**
+ * Track providers we've already warned about for unsupported streaming token
+ * extraction One-shot per process — a noisy provider
+ * shouldn't flood stderr, but the first call is loud enough to be discovered.
+ */
+const unsupportedProvidersWarned = new Set();
+function warnUnsupportedProviderOnce(provider, source) {
+    if (unsupportedProvidersWarned.has(provider))
+        return;
+    unsupportedProvidersWarned.add(provider);
+    tokenLogger.warn(`${source}: token extraction not implemented for provider "${provider}" — returning zero usage. ` +
+        `Cost reports for this provider will be $0 until an extractor is added. ` +
+        `Pass usage data manually via createAiResponse if you have it.`, { provider });
+}
+/**
+ * Test-only — reset the warn-once set so per-test assertions can re-trigger.
+ */
+export function __resetUnsupportedProvidersWarned() {
+    unsupportedProvidersWarned.clear();
+}
+export function extractStreamTokens(
+// Accepts both non-streaming response shapes and streaming final-chunk
+// shapes (which may nest usage differently). Duck-typed internally.
+finalChunk, provider) {
+    // Guard against null/non-object for all providers — each extractor begins with
+    // `if (!response.usage) return EMPTY_USAGE` but that dereferences response
+    // first, throwing TypeError if it is null (§TK2).
+    if (finalChunk == null || typeof finalChunk !== 'object') {
+        return { ...EMPTY_USAGE };
+    }
+    if (provider === 'anthropic') {
+        return extractAnthropicTokens(finalChunk);
+    }
+    if (provider === 'google') {
+        return extractGeminiTokens(finalChunk);
+    }
+    if (provider === 'openai') {
+        return extractOpenAITokens(finalChunk);
+    }
+    if (provider === 'bedrock') {
+        // Bedrock stream final chunks nest usage under metadata.usage; non-streaming
+        // responses have it at the top level. Unwrap before delegating (§T1).
+        // null/non-object already guarded above (§TK2).
+        const bedrockChunk = finalChunk;
+        if ('metadata' in bedrockChunk) {
+            // This is a streaming-shaped chunk (has a metadata key). Keep shape
+            // detection separate from usage-presence so a future metadata event type
+            // that carries no usage does not fall through to the non-streaming extractor
+            // where the top-level usage field is also absent (§TK1).
+            const streamUsage = bedrockChunk.metadata?.usage;
+            if (streamUsage) {
+                return extractBedrockTokens({ usage: streamUsage });
+            }
+            tokenLogger.debug('Bedrock streaming chunk has metadata but no usage — returning empty', {
+                keys: Object.keys(bedrockChunk),
+            });
+            return { ...EMPTY_USAGE };
+        }
+        return extractBedrockTokens(bedrockChunk);
+    }
+    if (provider === 'mistral') {
+        return extractMistralTokens(finalChunk);
+    }
+    if (provider === 'cohere') {
+        // Cohere stream final chunks (message-end) nest usage under delta.usage;
+        // non-streaming responses have it at the top level (§T1).
+        // null/non-object already guarded above (§TK2).
+        const cohereChunk = finalChunk;
+        const streamUsage = cohereChunk.delta?.usage;
+        if ('delta' in cohereChunk && streamUsage) {
+            return extractCohereTokens({ usage: streamUsage });
+        }
+        return extractCohereTokens(cohereChunk);
+    }
+    // Defensive guard for hypothetical future providers added to AiProvider
+    // without a matching extractor branch above.
+    warnUnsupportedProviderOnce(provider, 'extractStreamTokens');
+    return { ...EMPTY_USAGE };
+}
+export class TokenAccumulator {
+    provider;
+    latestUsage = { ...EMPTY_USAGE };
+    finalized = false;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    addChunk(chunk) {
+        if (this.finalized)
+            return;
+        if (this.provider === 'anthropic') {
+            this.addAnthropicChunk(chunk);
+            return;
+        }
+        if (this.provider === 'google') {
+            this.addGeminiChunk(chunk);
+            return;
+        }
+        if (this.provider === 'openai') {
+            this.addOpenAIChunk(chunk);
+            return;
+        }
+        if (this.provider === 'bedrock') {
+            this.addBedrockChunk(chunk);
+            return;
+        }
+        if (this.provider === 'mistral') {
+            this.addMistralChunk(chunk);
+            return;
+        }
+        if (this.provider === 'cohere') {
+            this.addCohereChunk(chunk);
+            return;
+        }
+        // Defensive guard for hypothetical future providers added to AiProvider
+        // without a matching extractor branch above.
+        warnUnsupportedProviderOnce(this.provider, 'TokenAccumulator');
+    }
+    finalize() {
+        this.finalized = true;
+        return { ...this.latestUsage };
+    }
+    /**
+     * Reset the accumulator so it can be reused for a new stream
+     *. Zeroes the latest usage snapshot and clears the
+     * `finalized` flag. The provider binding is preserved — to track a
+     * different provider, construct a new `TokenAccumulator`.
+     *
+     * Useful when a streaming operation retries mid-stream (provider-side
+     * disconnect, client-side reconnect): instead of allocating a fresh
+     * instance for each attempt, the caller can `reset()` the existing one.
+     * Without this method `addChunk()` is a no-op after `finalize()` and
+     * subsequent `finalize()` calls return the stale snapshot.
+     */
+    reset() {
+        this.latestUsage = { ...EMPTY_USAGE };
+        this.finalized = false;
+    }
+    addAnthropicChunk(event) {
+        // message_start carries the initial usage with input token counts (§TK3).
+        if (event.type === 'message_start' && event.message?.usage) {
+            const usage = event.message.usage;
+            this.latestUsage.inputTokens = safeInt(usage.input_tokens);
+            this.latestUsage.cacheReadTokens = safeInt(usage.cache_read_input_tokens);
+            this.latestUsage.cacheCreationTokens = safeInt(usage.cache_creation_input_tokens);
+            this.latestUsage.totalTokens =
+                this.latestUsage.inputTokens +
+                    this.latestUsage.outputTokens +
+                    this.latestUsage.thinkingTokens +
+                    this.latestUsage.cacheReadTokens +
+                    this.latestUsage.cacheCreationTokens;
+        }
+        // message_delta carries the FINAL counts. Per the Anthropic streaming
+        // spec it includes input_tokens, output_tokens, cache_read_input_tokens,
+        // and cache_creation_input_tokens — all of which may differ from
+        // message_start. Only overwrite a field when the delta carries it,
+        // so single-event-mocks (older tests, simpler stubs) continue to work.
+        if (event.type === 'message_delta' && event.usage) {
+            const u = event.usage;
+            if (u.output_tokens !== undefined) {
+                this.latestUsage.outputTokens = safeInt(u.output_tokens);
+            }
+            if (u.input_tokens !== undefined) {
+                this.latestUsage.inputTokens = safeInt(u.input_tokens);
+            }
+            if (u.cache_read_input_tokens !== undefined) {
+                this.latestUsage.cacheReadTokens = safeInt(u.cache_read_input_tokens);
+            }
+            if (u.cache_creation_input_tokens !== undefined) {
+                this.latestUsage.cacheCreationTokens = safeInt(u.cache_creation_input_tokens);
+            }
+            // Pick up thinking_tokens when Anthropic starts emitting it on streaming
+            // events. Matches the non-streaming path in extractAnthropicTokens (§TK1).
+            if (u.thinking_tokens !== undefined) {
+                this.latestUsage.thinkingTokens = safeInt(u.thinking_tokens);
+            }
+            // Recalculate totalTokens only when a usage update was received (§TK3).
+            // Moving this inside the branch avoids re-computing on every non-usage
+            // event (content_block_delta etc.) and is consistent with the Gemini/
+            // OpenAI/Bedrock/Cohere accumulators which all update inside their guards.
+            this.latestUsage.totalTokens =
+                this.latestUsage.inputTokens +
+                    this.latestUsage.outputTokens +
+                    this.latestUsage.thinkingTokens +
+                    this.latestUsage.cacheReadTokens +
+                    this.latestUsage.cacheCreationTokens;
+        }
+    }
+    addGeminiChunk(chunk) {
+        // Each Gemini chunk may carry usageMetadata; the last one is authoritative
+        if (chunk.usageMetadata) {
+            const meta = chunk.usageMetadata;
+            this.latestUsage.inputTokens = safeInt(meta.promptTokenCount);
+            this.latestUsage.outputTokens = safeInt(meta.candidatesTokenCount);
+            this.latestUsage.thinkingTokens = safeInt(meta.thoughtsTokenCount);
+            this.latestUsage.cacheReadTokens = safeInt(meta.cachedContentTokenCount);
+            this.latestUsage.totalTokens =
+                meta.totalTokenCount !== undefined
+                    ? safeInt(meta.totalTokenCount)
+                    : this.latestUsage.inputTokens +
+                        this.latestUsage.outputTokens +
+                        this.latestUsage.thinkingTokens +
+                        this.latestUsage.cacheReadTokens +
+                        this.latestUsage.cacheCreationTokens;
+        }
+    }
+    addOpenAIChunk(chunk) {
+        // Only the final chunk (when stream_options.include_usage is set) carries
+        // `usage`. Earlier chunks are no-ops here. The values are absolute, not
+        // deltas, so overwrite rather than accumulate.
+        if (chunk.usage) {
+            const u = chunk.usage;
+            this.latestUsage.inputTokens = safeInt(u.prompt_tokens);
+            this.latestUsage.outputTokens = safeInt(u.completion_tokens);
+            this.latestUsage.cacheReadTokens = safeInt(u.prompt_tokens_details?.cached_tokens);
+            this.latestUsage.thinkingTokens = safeInt(u.completion_tokens_details?.reasoning_tokens);
+            this.latestUsage.totalTokens =
+                u.total_tokens !== undefined
+                    ? safeInt(u.total_tokens)
+                    : // §11.3: same subset semantics as extractOpenAITokens — neither
+                        // cacheReadTokens nor thinkingTokens is additive for OpenAI.
+                        this.latestUsage.inputTokens + this.latestUsage.outputTokens;
+        }
+    }
+    addCohereChunk(chunk) {
+        // Only the `message-end` event carries usage; earlier event types are
+        // no-ops here. The values are absolute, not deltas, so overwrite rather
+        // than accumulate.
+        const usage = chunk.delta?.usage;
+        if (usage) {
+            const counts = usage.tokens ?? usage.billed_units ?? {};
+            this.latestUsage.inputTokens = safeInt(counts.input_tokens);
+            this.latestUsage.outputTokens = safeInt(counts.output_tokens);
+            this.latestUsage.totalTokens =
+                this.latestUsage.inputTokens +
+                    this.latestUsage.outputTokens +
+                    this.latestUsage.thinkingTokens +
+                    this.latestUsage.cacheReadTokens +
+                    this.latestUsage.cacheCreationTokens;
+        }
+    }
+    addMistralChunk(chunk) {
+        // Final chunk carries usage. The values are absolute, not deltas, so
+        // overwrite rather than accumulate.
+        if (chunk.usage) {
+            const u = chunk.usage;
+            this.latestUsage.inputTokens = safeInt(u.prompt_tokens);
+            this.latestUsage.outputTokens = safeInt(u.completion_tokens);
+            this.latestUsage.totalTokens =
+                u.total_tokens !== undefined
+                    ? safeInt(u.total_tokens)
+                    : this.latestUsage.inputTokens +
+                        this.latestUsage.outputTokens +
+                        this.latestUsage.thinkingTokens +
+                        this.latestUsage.cacheReadTokens +
+                        this.latestUsage.cacheCreationTokens;
+        }
+    }
+    addBedrockChunk(chunk) {
+        // Bedrock ConverseStream emits the `metadata` event near the end of
+        // the stream; earlier events (messageStart, contentBlockDelta,
+        // messageStop) carry no usage. The values are absolute, not deltas,
+        // so overwrite rather than accumulate.
+        const usage = chunk.metadata?.usage;
+        if (usage) {
+            this.latestUsage.inputTokens = safeInt(usage.inputTokens);
+            this.latestUsage.outputTokens = safeInt(usage.outputTokens);
+            this.latestUsage.cacheReadTokens = safeInt(usage.cacheReadInputTokens);
+            this.latestUsage.cacheCreationTokens = safeInt(usage.cacheWriteInputTokens);
+            this.latestUsage.totalTokens =
+                usage.totalTokens !== undefined
+                    ? safeInt(usage.totalTokens)
+                    : this.latestUsage.inputTokens +
+                        this.latestUsage.outputTokens +
+                        this.latestUsage.thinkingTokens +
+                        this.latestUsage.cacheReadTokens +
+                        this.latestUsage.cacheCreationTokens;
+        }
+    }
+}
+//# sourceMappingURL=tokens.js.map

package/dist/shared/tokens.js.map

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

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

@@ -0,0 +1,14 @@
+import type { NrEventData } from '../events/types.js';
+import type { TransportOptions, TransportResult } from './types.js';
+/**
+ * Send a batch of events to NR's Events API. Compresses with gzip, retries
+ * with exponential backoff (capped, jittered, Retry-After-aware), and
+ * surfaces 4xx response bodies in the result so callers can distinguish
+ * license-key from payload-shape failures (7 / §5.8).
+ *
+ * Returns a {@link TransportResult} the harvest scheduler uses to decide
+ * whether to requeue the batch. Per-request timeout is honored via
+ * `AbortSignal.timeout`.
+ */
+export declare function sendEvents(events: NrEventData[], licenseKey: string, options: TransportOptions): Promise<TransportResult>;
+//# sourceMappingURL=events-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events-api.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/events-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpE;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EAAE,EACrB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAkB1B"}

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

@@ -0,0 +1,29 @@
+import { sendWithRetry, resolveRegion, getEventsApiUrl } from './http-client.js';
+/**
+ * Send a batch of events to NR's Events API. Compresses with gzip, retries
+ * with exponential backoff (capped, jittered, Retry-After-aware), and
+ * surfaces 4xx response bodies in the result so callers can distinguish
+ * license-key from payload-shape failures (7 / §5.8).
+ *
+ * Returns a {@link TransportResult} the harvest scheduler uses to decide
+ * whether to requeue the batch. Per-request timeout is honored via
+ * `AbortSignal.timeout`.
+ */
+export async function sendEvents(events, licenseKey, options) {
+    if (events.length === 0) {
+        return { success: true, statusCode: null, retryCount: 0 };
+    }
+    const region = resolveRegion(licenseKey, options.collectorHost ?? null);
+    const url = getEventsApiUrl(options.accountId, region, options.collectorHost ?? null);
+    return sendWithRetry({
+        url,
+        body: events,
+        licenseKey,
+        maxRetries: options.maxRetries ?? 3,
+        baseDelayMs: options.baseDelayMs ?? 1000,
+        maxDelayMs: options.maxDelayMs ?? 30_000,
+        requestTimeoutMs: options.requestTimeoutMs ?? 30_000,
+        clientName: options.clientName,
+    });
+}
+//# sourceMappingURL=events-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events-api.js","sourceRoot":"","sources":["../../../src/shared/transport/events-api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEjF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,UAAkB,EAClB,OAAyB;IAEzB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,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,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC;IAEtF,OAAO,aAAa,CAAC;QACnB,GAAG;QACH,IAAI,EAAE,MAAM;QACZ,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/http-client.d.ts

@@ -0,0 +1,49 @@
+import type { HttpSendOptions, TransportResult } from './types.js';
+/**
+ * Supported New Relic regions for data ingest.
+ *
+ * - `us` — default/global region (insights-collector.newrelic.com)
+ * - `eu` — EU data center (insights-collector.eu01.nr-data.net)
+ * - `gov` — FedRAMP / US gov cloud (gov-* hostnames)
+ *
+ * License-key prefix mapping: `us01` → us, `eu01` → eu, `gov01` → gov.
+ * Legacy keys (no recognizable region prefix) default to `us`.
+ */
+export type Region = 'us' | 'eu' | 'gov';
+export declare function resolveRegion(licenseKey: string, collectorHost: string | null): Region;
+export declare function getEventsApiUrl(accountId: string, region: Region, collectorHost?: string | null): string;
+export declare function getMetricApiUrl(region: Region, collectorHost?: string | null): string;
+export declare function getLogsApiUrl(region: Region, collectorHost?: string | null): string;
+/**
+ * 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 declare function compressPayload(data: unknown): Promise<Buffer>;
+/**
+ * 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 declare function decorrelatedJitter(baseDelayMs: number, maxDelayMs: number, prevSleepMs: number): number;
+export declare function sendWithRetry(options: HttpSendOptions): Promise<TransportResult>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/shared/transport/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/shared/transport/http-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA0BnE;;;;;;;;;GASG;AACH,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AAgBzC,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAsCtF;AA4DD,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,MAAM,CAiBR;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKrF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKnF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpE;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR;AA4BD,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAwKtF"}