autotel-aws 0.13.13 → 0.13.14

package/dist/cloudwatch.d.ts

@@ -1,8 +1,9 @@
-import { ExportResult } from '@opentelemetry/core';
-import { SpanExporter, ReadableSpan } from '@opentelemetry/sdk-trace-base';
-import { LogRecordExporter, ReadableLogRecord } from '@opentelemetry/sdk-logs';
-import { PushMetricExporter, AggregationTemporalitySelector, ResourceMetrics, InstrumentType, AggregationTemporality } from '@opentelemetry/sdk-metrics';
+import { ExportResult } from "@opentelemetry/core";
+import { AggregationTemporality, AggregationTemporalitySelector, InstrumentType, PushMetricExporter, ResourceMetrics } from "@opentelemetry/sdk-metrics";
+import { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+import { LogRecordExporter, ReadableLogRecord } from "@opentelemetry/sdk-logs";
 
+//#region src/cloudwatch/endpoints.d.ts
 /**
  * CloudWatch native OTLP HTTP endpoints.
  *
@@ -16,56 +17,56 @@ import { PushMetricExporter, AggregationTemporalitySelector, ResourceMetrics, In
  *   - metrics → CloudWatch Metrics, queryable via PromQL
  */
 interface CloudWatchEndpointInput {
-    readonly region: string;
+  readonly region: string;
 }
 /** Traces — signed against the `xray` service. */
-declare function cloudWatchTracesEndpoint({ region }: CloudWatchEndpointInput): string;
+declare function cloudWatchTracesEndpoint({
+  region
+}: CloudWatchEndpointInput): string;
 /** Logs — signed against the `logs` service. Requires log group/stream headers. */
-declare function cloudWatchLogsEndpoint({ region }: CloudWatchEndpointInput): string;
+declare function cloudWatchLogsEndpoint({
+  region
+}: CloudWatchEndpointInput): string;
 /** Metrics — signed against the `monitoring` service. */
-declare function cloudWatchMetricsEndpoint({ region }: CloudWatchEndpointInput): string;
+declare function cloudWatchMetricsEndpoint({
+  region
+}: CloudWatchEndpointInput): string;
 /**
  * The SigV4 service name used when signing requests for each endpoint.
  * These do NOT always match the host prefix — they're the canonical
  * AWS service identifiers used by the SigV4 signer.
  */
 declare const SIGV4_SERVICE: {
-    readonly traces: "xray";
-    readonly logs: "logs";
-    readonly metrics: "monitoring";
+  readonly traces: "xray";
+  readonly logs: "logs";
+  readonly metrics: "monitoring";
 };
 type CloudWatchSignal = keyof typeof SIGV4_SERVICE;
-
-/**
- * SigV4 signing helper for CloudWatch OTLP HTTP endpoints.
- *
- * Uses `@smithy/signature-v4` + `@aws-crypto/sha256-js` (optional peer deps).
- * Returns the headers required to POST a signed OTLP request.
- */
-
+//#endregion
+//#region src/cloudwatch/sigv4.d.ts
 interface AwsCredentialsLike {
-    readonly accessKeyId: string;
-    readonly secretAccessKey: string;
-    readonly sessionToken?: string;
+  readonly accessKeyId: string;
+  readonly secretAccessKey: string;
+  readonly sessionToken?: string;
 }
 type AwsCredentialsProvider = AwsCredentialsLike | (() => AwsCredentialsLike | Promise<AwsCredentialsLike>);
 interface SignOtlpRequestInput {
-    /** The full endpoint URL (e.g. https://xray.eu-west-1.amazonaws.com/v1/traces). */
-    url: string;
-    /** OTLP payload — already serialized + (optionally) gzipped. */
-    body: Uint8Array;
-    /** AWS region (e.g. "eu-west-1"). Must match the host. */
-    region: string;
-    /** Which CloudWatch endpoint we're hitting (selects the SigV4 service name). */
-    signal: CloudWatchSignal;
-    /** Static credentials or a provider. Falls back to the AWS SDK default chain when omitted. */
-    credentials?: AwsCredentialsProvider;
-    /** Extra headers to include in the canonical request (signed). */
-    additionalHeaders?: Record<string, string>;
-    /** Content-Type — defaults to OTLP/JSON. Use `application/x-protobuf` for proto. */
-    contentType?: 'application/json' | 'application/x-protobuf';
-    /** Content-Encoding (e.g. "gzip"). Omit for identity. */
-    contentEncoding?: 'gzip';
+  /** The full endpoint URL (e.g. https://xray.eu-west-1.amazonaws.com/v1/traces). */
+  url: string;
+  /** OTLP payload — already serialized + (optionally) gzipped. */
+  body: Uint8Array;
+  /** AWS region (e.g. "eu-west-1"). Must match the host. */
+  region: string;
+  /** Which CloudWatch endpoint we're hitting (selects the SigV4 service name). */
+  signal: CloudWatchSignal;
+  /** Static credentials or a provider. Falls back to the AWS SDK default chain when omitted. */
+  credentials?: AwsCredentialsProvider;
+  /** Extra headers to include in the canonical request (signed). */
+  additionalHeaders?: Record<string, string>;
+  /** Content-Type — defaults to OTLP/JSON. Use `application/x-protobuf` for proto. */
+  contentType?: 'application/json' | 'application/x-protobuf';
+  /** Content-Encoding (e.g. "gzip"). Omit for identity. */
+  contentEncoding?: 'gzip';
 }
 /**
  * Compute SigV4-signed headers for an OTLP HTTP POST to a CloudWatch endpoint.
@@ -75,29 +76,19 @@ interface SignOtlpRequestInput {
  * when you want to ship telemetry directly from app code (no collector).
  */
 declare function signCloudWatchOtlpRequest(input: SignOtlpRequestInput): Promise<Record<string, string>>;
-
-/**
- * SpanExporter that ships OTLP/JSON straight to the CloudWatch traces
- * endpoint (https://xray.<region>.amazonaws.com/v1/traces) using SigV4.
- *
- * No collector required. Useful in Lambda when you don't want to attach
- * the ADOT extension layer, or any other env where you'd rather not run
- * a sidecar.
- *
- * Lands in: X-Ray + Application Signals + Transaction Search.
- */
-
+//#endregion
+//#region src/cloudwatch/trace-exporter.d.ts
 interface CloudWatchTraceExporterConfig {
-    /** AWS region — defaults to `process.env.AWS_REGION`. */
-    region?: string;
-    /** Override the endpoint (mainly for tests / VPC endpoints). */
-    endpoint?: string;
-    /** Static credentials or a provider. Defaults to the AWS SDK default chain. */
-    credentials?: AwsCredentialsProvider;
-    /** Per-export timeout in ms. Defaults to 10s (CloudWatch's documented soft cap). */
-    timeoutMs?: number;
-    /** Optional `fetch` override (Node 18+ has it globally; useful in tests). */
-    fetchImpl?: typeof fetch;
+  /** AWS region — defaults to `process.env.AWS_REGION`. */
+  region?: string;
+  /** Override the endpoint (mainly for tests / VPC endpoints). */
+  endpoint?: string;
+  /** Static credentials or a provider. Defaults to the AWS SDK default chain. */
+  credentials?: AwsCredentialsProvider;
+  /** Per-export timeout in ms. Defaults to 10s (CloudWatch's documented soft cap). */
+  timeoutMs?: number;
+  /** Optional `fetch` override (Node 18+ has it globally; useful in tests). */
+  fetchImpl?: typeof fetch;
 }
 /**
  * OTLP/JSON exporter for CloudWatch's traces endpoint.
@@ -109,105 +100,87 @@ interface CloudWatchTraceExporterConfig {
  * needs `forceFlush()` before the handler returns.
  */
 declare class CloudWatchTraceExporter implements SpanExporter {
-    private readonly region;
-    private readonly endpoint;
-    private readonly credentials?;
-    private readonly timeoutMs;
-    private readonly fetchImpl;
-    private shutdownOnce;
-    constructor(config?: CloudWatchTraceExporterConfig);
-    export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
-    shutdown(): Promise<void>;
-    forceFlush(): Promise<void>;
-    private sendBatch;
+  private readonly region;
+  private readonly endpoint;
+  private readonly credentials?;
+  private readonly timeoutMs;
+  private readonly fetchImpl;
+  private shutdownOnce;
+  constructor(config?: CloudWatchTraceExporterConfig);
+  export(spans: ReadableSpan[], resultCallback: (result: ExportResult) => void): void;
+  shutdown(): Promise<void>;
+  forceFlush(): Promise<void>;
+  private sendBatch;
 }
-
-/**
- * LogRecordExporter that ships OTLP/JSON logs to the CloudWatch logs
- * endpoint (https://logs.<region>.amazonaws.com/v1/logs) using SigV4.
- *
- * CloudWatch Logs requires `x-aws-log-group` and `x-aws-log-stream`
- * headers — both must already exist (this exporter does NOT create them).
- *
- * In Lambda, the runtime auto-provisions a log group + stream per function;
- * read them from `AWS_LAMBDA_LOG_GROUP_NAME` / `AWS_LAMBDA_LOG_STREAM_NAME`
- * (set automatically when the function runs).
- */
-
+//#endregion
+//#region src/cloudwatch/log-exporter.d.ts
 interface CloudWatchLogExporterConfig {
-    region?: string;
-    endpoint?: string;
-    credentials?: AwsCredentialsProvider;
-    /**
-     * Existing CloudWatch log group to write into. Defaults to
-     * `AWS_LAMBDA_LOG_GROUP_NAME` (set automatically by the Lambda runtime).
-     */
-    logGroup?: string;
-    /**
-     * Existing CloudWatch log stream. Defaults to
-     * `AWS_LAMBDA_LOG_STREAM_NAME`.
-     */
-    logStream?: string;
-    /**
-     * Optional comma-separated list of field paths CloudWatch may truncate
-     * if the event exceeds 1 MB (sent as `x-aws-truncatable-fields`).
-     */
-    truncatableFields?: string;
-    timeoutMs?: number;
-    fetchImpl?: typeof fetch;
+  region?: string;
+  endpoint?: string;
+  credentials?: AwsCredentialsProvider;
+  /**
+   * Existing CloudWatch log group to write into. Defaults to
+   * `AWS_LAMBDA_LOG_GROUP_NAME` (set automatically by the Lambda runtime).
+   */
+  logGroup?: string;
+  /**
+   * Existing CloudWatch log stream. Defaults to
+   * `AWS_LAMBDA_LOG_STREAM_NAME`.
+   */
+  logStream?: string;
+  /**
+   * Optional comma-separated list of field paths CloudWatch may truncate
+   * if the event exceeds 1 MB (sent as `x-aws-truncatable-fields`).
+   */
+  truncatableFields?: string;
+  timeoutMs?: number;
+  fetchImpl?: typeof fetch;
 }
 declare class CloudWatchLogExporter implements LogRecordExporter {
-    private readonly region;
-    private readonly endpoint;
-    private readonly credentials?;
-    private readonly logGroup;
-    private readonly logStream;
-    private readonly truncatableFields?;
-    private readonly timeoutMs;
-    private readonly fetchImpl;
-    private shutdownOnce;
-    constructor(config?: CloudWatchLogExporterConfig);
-    export(logs: ReadableLogRecord[], resultCallback: (result: ExportResult) => void): void;
-    shutdown(): Promise<void>;
-    forceFlush(): Promise<void>;
-    private sendBatch;
+  private readonly region;
+  private readonly endpoint;
+  private readonly credentials?;
+  private readonly logGroup;
+  private readonly logStream;
+  private readonly truncatableFields?;
+  private readonly timeoutMs;
+  private readonly fetchImpl;
+  private shutdownOnce;
+  constructor(config?: CloudWatchLogExporterConfig);
+  export(logs: ReadableLogRecord[], resultCallback: (result: ExportResult) => void): void;
+  shutdown(): Promise<void>;
+  forceFlush(): Promise<void>;
+  private sendBatch;
 }
-
-/**
- * PushMetricExporter that ships OTLP/JSON metrics to the CloudWatch
- * metrics endpoint (https://monitoring.<region>.amazonaws.com/v1/metrics)
- * using SigV4.
- *
- * Lands in: CloudWatch Metrics — queryable via PromQL alongside the AWS
- * vended namespaces.
- */
-
+//#endregion
+//#region src/cloudwatch/metric-exporter.d.ts
 interface CloudWatchMetricExporterConfig {
-    region?: string;
-    endpoint?: string;
-    credentials?: AwsCredentialsProvider;
-    timeoutMs?: number;
-    fetchImpl?: typeof fetch;
-    /**
-     * Aggregation temporality. CloudWatch's OTLP metrics endpoint accepts
-     * delta and cumulative; delta is generally cheaper for counters.
-     */
-    temporalitySelector?: AggregationTemporalitySelector;
+  region?: string;
+  endpoint?: string;
+  credentials?: AwsCredentialsProvider;
+  timeoutMs?: number;
+  fetchImpl?: typeof fetch;
+  /**
+   * Aggregation temporality. CloudWatch's OTLP metrics endpoint accepts
+   * delta and cumulative; delta is generally cheaper for counters.
+   */
+  temporalitySelector?: AggregationTemporalitySelector;
 }
 declare class CloudWatchMetricExporter implements PushMetricExporter {
-    private readonly region;
-    private readonly endpoint;
-    private readonly credentials?;
-    private readonly timeoutMs;
-    private readonly fetchImpl;
-    private readonly temporalitySelector;
-    private shutdownOnce;
-    constructor(config?: CloudWatchMetricExporterConfig);
-    export(metrics: ResourceMetrics, resultCallback: (result: ExportResult) => void): void;
-    shutdown(): Promise<void>;
-    forceFlush(): Promise<void>;
-    selectAggregationTemporality(instrumentType: InstrumentType): AggregationTemporality;
-    private sendBatch;
+  private readonly region;
+  private readonly endpoint;
+  private readonly credentials?;
+  private readonly timeoutMs;
+  private readonly fetchImpl;
+  private readonly temporalitySelector;
+  private shutdownOnce;
+  constructor(config?: CloudWatchMetricExporterConfig);
+  export(metrics: ResourceMetrics, resultCallback: (result: ExportResult) => void): void;
+  shutdown(): Promise<void>;
+  forceFlush(): Promise<void>;
+  selectAggregationTemporality(instrumentType: InstrumentType): AggregationTemporality;
+  private sendBatch;
 }
-
-export { type AwsCredentialsLike, type AwsCredentialsProvider, type CloudWatchEndpointInput, CloudWatchLogExporter, type CloudWatchLogExporterConfig, CloudWatchMetricExporter, type CloudWatchMetricExporterConfig, type CloudWatchSignal, CloudWatchTraceExporter, type CloudWatchTraceExporterConfig, SIGV4_SERVICE, type SignOtlpRequestInput, cloudWatchLogsEndpoint, cloudWatchMetricsEndpoint, cloudWatchTracesEndpoint, signCloudWatchOtlpRequest };
+//#endregion
+export { AwsCredentialsLike, AwsCredentialsProvider, CloudWatchEndpointInput, CloudWatchLogExporter, CloudWatchLogExporterConfig, CloudWatchMetricExporter, CloudWatchMetricExporterConfig, CloudWatchSignal, CloudWatchTraceExporter, CloudWatchTraceExporterConfig, SIGV4_SERVICE, SignOtlpRequestInput, cloudWatchLogsEndpoint, cloudWatchMetricsEndpoint, cloudWatchTracesEndpoint, signCloudWatchOtlpRequest };
+//# sourceMappingURL=cloudwatch.d.ts.map

package/dist/cloudwatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudwatch.d.ts","names":[],"sources":["../src/cloudwatch/endpoints.ts","../src/cloudwatch/sigv4.ts","../src/cloudwatch/trace-exporter.ts","../src/cloudwatch/log-exporter.ts","../src/cloudwatch/metric-exporter.ts"],"mappings":";;;;;;;;;;;;AAaA;;;;AACiB;AAIjB;UALiB,uBAAA;EAAA,SACN,MAAM;AAAA;;iBAID,wBAAA;EAA2B;AAAA,GAAU,uBAAuB;;iBAK5D,sBAAA;EAAyB;AAAA,GAAU,uBAAuB;AALE;AAAA,iBAU5D,yBAAA;EAA4B;AAAA,GAAU,uBAAuB;;;;;;cAShE,aAAA;EAAA;;;;KAMD,gBAAA,gBAAgC,aAAa;;;UCjCxC,kBAAA;EAAA,SACN,WAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA;AAAA;AAAA,KAGC,sBAAA,GACR,kBAAA,UACO,kBAAA,GAAqB,OAAA,CAAQ,kBAAA;AAAA,UAEvB,oBAAA;EDF2D;ECI1E,GAAA;EDJyC;ECMzC,IAAA,EAAM,UAAA;EDNoE;ECQ1E,MAAA;EDHc;ECKd,MAAA,EAAQ,gBAAA;;EAER,WAAA,GAAc,sBAAA;EDPyB;ECSvC,iBAAA,GAAoB,MAAA;EDT6B;ECWjD,WAAA;EDXwE;ECaxE,eAAA;AAAA;;;;;;;ADR2E;iBCkBvD,yBAAA,CACpB,KAAA,EAAO,oBAAA,GACN,OAAA,CAAQ,MAAA;;;UCvBM,6BAAA;EFP2D;EES1E,MAAA;EFTyC;EEWzC,QAAA;EFX0E;EEa1E,WAAA,GAAc,sBAAA;EFRA;EEUd,SAAA;;EAEA,SAAA,UAAmB,KAAK;AAAA;;;;AFZgD;AAK1E;;;;;cEmBa,uBAAA,YAAmC,YAAA;EAAA,iBAC7B,MAAA;EAAA,iBACA,QAAA;EAAA,iBACA,WAAA;EAAA,iBACA,SAAA;EAAA,iBACA,SAAA;EAAA,QACT,YAAA;cAEI,MAAA,GAAQ,6BAAA;EAmBpB,MAAA,CACE,KAAA,EAAO,YAAA,IACP,cAAA,GAAiB,MAAA,EAAQ,YAAA;EAwBrB,QAAA,IAAY,OAAA;EAIZ,UAAA,IAAc,OAAA;EAAA,QAIN,SAAA;AAAA;;;UClFC,2BAAA;EACf,MAAA;EACA,QAAA;EACA,WAAA,GAAc,sBAAA;EHX4D;AAAA;AAK5E;;EGWE,QAAA;EHXwE;;;;EGgBxE,SAAA;EHhBwE;AAK1E;;;EGgBE,iBAAA;EACA,SAAA;EACA,SAAA,UAAmB,KAAK;AAAA;AAAA,cAGb,qBAAA,YAAiC,iBAAA;EAAA,iBAC3B,MAAA;EAAA,iBACA,QAAA;EAAA,iBACA,WAAA;EAAA,iBACA,QAAA;EAAA,iBACA,SAAA;EAAA,iBACA,iBAAA;EAAA,iBACA,SAAA;EAAA,iBACA,SAAA;EAAA,QACT,YAAA;cAEI,MAAA,GAAQ,2BAAA;EA8BpB,MAAA,CACE,IAAA,EAAM,iBAAA,IACN,cAAA,GAAiB,MAAA,EAAQ,YAAA;EAwBrB,QAAA,IAAY,OAAA;EAIZ,UAAA,IAAc,OAAA;EAAA,QAEN,SAAA;AAAA;;;UChGC,8BAAA;EACf,MAAA;EACA,QAAA;EACA,WAAA,GAAc,sBAAA;EACd,SAAA;EACA,SAAA,UAAmB,KAAA;EJbgC;;AAAuB;AAK5E;EIaE,mBAAA,GAAsB,8BAAA;AAAA;AAAA,cAOX,wBAAA,YAAoC,kBAAA;EAAA,iBAC9B,MAAA;EAAA,iBACA,QAAA;EAAA,iBACA,WAAA;EAAA,iBACA,SAAA;EAAA,iBACA,SAAA;EAAA,iBACA,mBAAA;EAAA,QACT,YAAA;cAEI,MAAA,GAAQ,8BAAA;EAqBpB,MAAA,CACE,OAAA,EAAS,eAAA,EACT,cAAA,GAAiB,MAAA,EAAQ,YAAA;EAoBrB,QAAA,IAAY,OAAA;EAIZ,UAAA,IAAc,OAAA;EAEpB,4BAAA,CACE,cAAA,EAAgB,cAAA,GACf,sBAAA;EAAA,QAIW,SAAA;AAAA"}