@pingops/core 0.1.2 → 0.2.0

package/dist/index.d.cts

@@ -29,9 +29,10 @@ interface SpanPayload {
   };
 }
 /**
- * Attributes to propagate to HTTP spans
+ * Attributes to propagate to spans (e.g. when starting a trace with startTrace).
  */
-interface WrapHttpAttributes {
+interface PingopsTraceAttributes {
+  traceId?: string;
   userId?: string;
   sessionId?: string;
   tags?: string[];
@@ -160,17 +161,16 @@ declare function filterHeaders(headers: Record<string, string | string[] | undef
 /**
  * Extracts and normalizes headers from OpenTelemetry span attributes
  *
- * Handles flat array format headers (e.g., 'http.request.header.0', 'http.request.header.1')
- * and converts them to proper key-value objects.
- *
- * Some OpenTelemetry instrumentations store headers as flat arrays:
- * - 'http.request.header.0': 'Content-Type'
- * - 'http.request.header.1': 'application/json'
- * - 'http.request.header.2': 'Authorization'
- * - 'http.request.header.3': 'Bearer token'
+ * Handles two formats:
+ * 1. Flat array format (e.g., 'http.request.header.0', 'http.request.header.1')
+ *    - 'http.request.header.0': 'Content-Type'
+ *    - 'http.request.header.1': 'application/json'
+ * 2. Direct key-value format (e.g., 'http.request.header.date', 'http.request.header.content-type')
+ *    - 'http.request.header.date': 'Mon, 12 Jan 2026 20:22:38 GMT'
+ *    - 'http.request.header.content-type': 'application/json'
  *
  * This function converts them to:
- * - { 'Content-Type': 'application/json', 'Authorization': 'Bearer token' }
+ * - { 'Content-Type': 'application/json', 'date': 'Mon, 12 Jan 2026 20:22:38 GMT' }
  */
 declare function extractHeadersFromAttributes(attributes: Record<string, unknown>, headerPrefix: "http.request.header" | "http.response.header"): Record<string, string | string[] | undefined> | null;
 /**
@@ -178,6 +178,26 @@ declare function extractHeadersFromAttributes(attributes: Record<string, unknown
  */
 declare function normalizeHeaders(headers: unknown): Record<string, string | string[] | undefined>;
 //#endregion
+//#region src/filtering/body-decoder.d.ts
+/**
+ * Minimal body handling: buffer to string for span attributes.
+ * No decompression or truncation; for compressed responses the instrumentation
+ * sends base64 + content-encoding so the backend can decompress.
+ */
+/** Span attribute for response content-encoding when body is sent as base64. */
+declare const HTTP_RESPONSE_CONTENT_ENCODING = "http.response.content_encoding";
+/**
+ * Returns true if the content-encoding header indicates a compressed body
+ * (gzip, br, deflate, x-gzip, x-deflate). Used to decide whether to send
+ * body as base64 + content-encoding for backend decompression.
+ */
+declare function isCompressedContentEncoding(headerValue: unknown): boolean;
+/**
+ * Converts a buffer to a UTF-8 string for use as request/response body on spans.
+ * Returns null for null, undefined, or empty buffer.
+ */
+declare function bufferToBodyString(buffer: Buffer | null | undefined): string | null;
+//#endregion
 //#region src/utils/span-extractor.d.ts
 /**
  * Extracts structured payload from a span
@@ -221,11 +241,10 @@ declare function createLogger(prefix: string): Logger;
  * OpenTelemetry context keys for PingOps
  */
 /**
- * Context key for enabling HTTP instrumentation.
- * When set to true, HTTP requests will be automatically instrumented.
- * This allows wrapHttp to control which HTTP calls are captured.
+ * Context key for trace ID attribute.
+ * Used to propagate trace identifier to all spans in the context.
  */
-declare const PINGOPS_HTTP_ENABLED: symbol;
+declare const PINGOPS_TRACE_ID: symbol;
 /**
  * Context key for user ID attribute.
  * Used to propagate user identifier to all spans in the context.
@@ -249,58 +268,28 @@ declare const PINGOPS_METADATA: symbol;
 /**
  * Context key for capturing request body.
  * When set, controls whether request bodies should be captured for HTTP spans.
- * This allows wrapHttp to control body capture per-request.
  */
 declare const PINGOPS_CAPTURE_REQUEST_BODY: symbol;
 /**
  * Context key for capturing response body.
  * When set, controls whether response bodies should be captured for HTTP spans.
- * This allows wrapHttp to control body capture per-request.
  */
 declare const PINGOPS_CAPTURE_RESPONSE_BODY: symbol;
 //#endregion
-//#region src/wrap-http.d.ts
+//#region src/trace-id.d.ts
 /**
- * Options for wrapHttp function
+ * Deterministic and random trace ID generation for PingOps
  */
-interface WrapHttpOptions {
-  attributes?: WrapHttpAttributes;
-  /**
-   * Callback to check if SDK is initialized.
-   * Required to determine if global instrumentation is enabled.
-   */
-  checkInitialized: () => boolean;
-  /**
-   * Callback to check if global instrumentation is enabled.
-   * Required to determine instrumentation behavior.
-   */
-  isGlobalInstrumentationEnabled: () => boolean;
-  /**
-   * Optional callback to ensure SDK is initialized (auto-initialization).
-   * If not provided, wrapHttp will try to auto-initialize from environment variables.
-   */
-  ensureInitialized?: () => Promise<void>;
-}
 /**
- * Wraps a function to set attributes on HTTP spans created within the wrapped block.
- *
- * This function sets attributes (userId, sessionId, tags, metadata) in the OpenTelemetry
- * context, which are automatically propagated to all spans created within the wrapped function.
- *
- * Instrumentation behavior:
- * - If `initializePingops` was called: All HTTP requests are instrumented by default.
- *   `wrapHttp` only adds attributes to spans created within the wrapped block.
- * - If `initializePingops` was NOT called: Only HTTP requests within `wrapHttp` blocks
- *   are instrumented. Requests outside `wrapHttp` are not instrumented.
- *
- * Note: This is the low-level API. For a simpler API with automatic setup,
- * use `wrapHttp` from `@pingops/sdk` instead.
- *
- * @param options - Options including attributes and required callbacks
- * @param fn - Function to execute within the attribute context
- * @returns The result of the function
+ * Converts a Uint8Array to a lowercase hex string.
+ */
+declare function uint8ArrayToHex(bytes: Uint8Array): string;
+/**
+ * Creates a trace ID (32 hex chars).
+ * - If `seed` is provided: deterministic via SHA-256 of the seed (first 32 hex chars).
+ * - Otherwise: random 16 bytes as 32 hex chars.
  */
-declare function wrapHttp<T>(options: WrapHttpOptions, fn: () => T | Promise<T>): T | Promise<T>;
+declare function createTraceId(seed?: string): Promise<string>;
 //#endregion
-export { DEFAULT_REDACTION_CONFIG, DEFAULT_SENSITIVE_HEADER_PATTERNS, DomainRule, HeaderRedactionConfig, HeaderRedactionStrategy, LogLevel, Logger, PINGOPS_CAPTURE_REQUEST_BODY, PINGOPS_CAPTURE_RESPONSE_BODY, PINGOPS_HTTP_ENABLED, PINGOPS_METADATA, PINGOPS_SESSION_ID, PINGOPS_TAGS, PINGOPS_USER_ID, SpanPayload, WrapHttpAttributes, WrapHttpOptions, createLogger, extractHeadersFromAttributes, extractSpanPayload, filterHeaders, getPropagatedAttributesFromContext, isSensitiveHeader, isSpanEligible, normalizeHeaders, redactHeaderValue, shouldCaptureSpan, wrapHttp };
+export { DEFAULT_REDACTION_CONFIG, DEFAULT_SENSITIVE_HEADER_PATTERNS, DomainRule, HTTP_RESPONSE_CONTENT_ENCODING, HeaderRedactionConfig, HeaderRedactionStrategy, LogLevel, Logger, PINGOPS_CAPTURE_REQUEST_BODY, PINGOPS_CAPTURE_RESPONSE_BODY, PINGOPS_METADATA, PINGOPS_SESSION_ID, PINGOPS_TAGS, PINGOPS_TRACE_ID, PINGOPS_USER_ID, PingopsTraceAttributes, SpanPayload, bufferToBodyString, createLogger, createTraceId, extractHeadersFromAttributes, extractSpanPayload, filterHeaders, getPropagatedAttributesFromContext, isCompressedContentEncoding, isSensitiveHeader, isSpanEligible, normalizeHeaders, redactHeaderValue, shouldCaptureSpan, uint8ArrayToHex };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/filtering/span-filter.ts","../src/filtering/domain-filter.ts","../src/filtering/sensitive-headers.ts","../src/filtering/header-filter.ts","../src/utils/span-extractor.ts","../src/utils/context-extractor.ts","../src/logger.ts","../src/context-keys.ts","../src/wrap-http.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/filtering/span-filter.ts","../src/filtering/domain-filter.ts","../src/filtering/sensitive-headers.ts","../src/filtering/header-filter.ts","../src/filtering/body-decoder.ts","../src/utils/span-extractor.ts","../src/utils/context-extractor.ts","../src/logger.ts","../src/context-keys.ts","../src/trace-id.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -29,9 +29,10 @@ interface SpanPayload {
   };
 }
 /**
- * Attributes to propagate to HTTP spans
+ * Attributes to propagate to spans (e.g. when starting a trace with startTrace).
  */
-interface WrapHttpAttributes {
+interface PingopsTraceAttributes {
+  traceId?: string;
   userId?: string;
   sessionId?: string;
   tags?: string[];
@@ -160,17 +161,16 @@ declare function filterHeaders(headers: Record<string, string | string[] | undef
 /**
  * Extracts and normalizes headers from OpenTelemetry span attributes
  *
- * Handles flat array format headers (e.g., 'http.request.header.0', 'http.request.header.1')
- * and converts them to proper key-value objects.
- *
- * Some OpenTelemetry instrumentations store headers as flat arrays:
- * - 'http.request.header.0': 'Content-Type'
- * - 'http.request.header.1': 'application/json'
- * - 'http.request.header.2': 'Authorization'
- * - 'http.request.header.3': 'Bearer token'
+ * Handles two formats:
+ * 1. Flat array format (e.g., 'http.request.header.0', 'http.request.header.1')
+ *    - 'http.request.header.0': 'Content-Type'
+ *    - 'http.request.header.1': 'application/json'
+ * 2. Direct key-value format (e.g., 'http.request.header.date', 'http.request.header.content-type')
+ *    - 'http.request.header.date': 'Mon, 12 Jan 2026 20:22:38 GMT'
+ *    - 'http.request.header.content-type': 'application/json'
  *
  * This function converts them to:
- * - { 'Content-Type': 'application/json', 'Authorization': 'Bearer token' }
+ * - { 'Content-Type': 'application/json', 'date': 'Mon, 12 Jan 2026 20:22:38 GMT' }
  */
 declare function extractHeadersFromAttributes(attributes: Record<string, unknown>, headerPrefix: "http.request.header" | "http.response.header"): Record<string, string | string[] | undefined> | null;
 /**
@@ -178,6 +178,26 @@ declare function extractHeadersFromAttributes(attributes: Record<string, unknown
  */
 declare function normalizeHeaders(headers: unknown): Record<string, string | string[] | undefined>;
 //#endregion
+//#region src/filtering/body-decoder.d.ts
+/**
+ * Minimal body handling: buffer to string for span attributes.
+ * No decompression or truncation; for compressed responses the instrumentation
+ * sends base64 + content-encoding so the backend can decompress.
+ */
+/** Span attribute for response content-encoding when body is sent as base64. */
+declare const HTTP_RESPONSE_CONTENT_ENCODING = "http.response.content_encoding";
+/**
+ * Returns true if the content-encoding header indicates a compressed body
+ * (gzip, br, deflate, x-gzip, x-deflate). Used to decide whether to send
+ * body as base64 + content-encoding for backend decompression.
+ */
+declare function isCompressedContentEncoding(headerValue: unknown): boolean;
+/**
+ * Converts a buffer to a UTF-8 string for use as request/response body on spans.
+ * Returns null for null, undefined, or empty buffer.
+ */
+declare function bufferToBodyString(buffer: Buffer | null | undefined): string | null;
+//#endregion
 //#region src/utils/span-extractor.d.ts
 /**
  * Extracts structured payload from a span
@@ -221,11 +241,10 @@ declare function createLogger(prefix: string): Logger;
  * OpenTelemetry context keys for PingOps
  */
 /**
- * Context key for enabling HTTP instrumentation.
- * When set to true, HTTP requests will be automatically instrumented.
- * This allows wrapHttp to control which HTTP calls are captured.
+ * Context key for trace ID attribute.
+ * Used to propagate trace identifier to all spans in the context.
  */
-declare const PINGOPS_HTTP_ENABLED: symbol;
+declare const PINGOPS_TRACE_ID: symbol;
 /**
  * Context key for user ID attribute.
  * Used to propagate user identifier to all spans in the context.
@@ -249,58 +268,28 @@ declare const PINGOPS_METADATA: symbol;
 /**
  * Context key for capturing request body.
  * When set, controls whether request bodies should be captured for HTTP spans.
- * This allows wrapHttp to control body capture per-request.
  */
 declare const PINGOPS_CAPTURE_REQUEST_BODY: symbol;
 /**
  * Context key for capturing response body.
  * When set, controls whether response bodies should be captured for HTTP spans.
- * This allows wrapHttp to control body capture per-request.
  */
 declare const PINGOPS_CAPTURE_RESPONSE_BODY: symbol;
 //#endregion
-//#region src/wrap-http.d.ts
+//#region src/trace-id.d.ts
 /**
- * Options for wrapHttp function
+ * Deterministic and random trace ID generation for PingOps
  */
-interface WrapHttpOptions {
-  attributes?: WrapHttpAttributes;
-  /**
-   * Callback to check if SDK is initialized.
-   * Required to determine if global instrumentation is enabled.
-   */
-  checkInitialized: () => boolean;
-  /**
-   * Callback to check if global instrumentation is enabled.
-   * Required to determine instrumentation behavior.
-   */
-  isGlobalInstrumentationEnabled: () => boolean;
-  /**
-   * Optional callback to ensure SDK is initialized (auto-initialization).
-   * If not provided, wrapHttp will try to auto-initialize from environment variables.
-   */
-  ensureInitialized?: () => Promise<void>;
-}
 /**
- * Wraps a function to set attributes on HTTP spans created within the wrapped block.
- *
- * This function sets attributes (userId, sessionId, tags, metadata) in the OpenTelemetry
- * context, which are automatically propagated to all spans created within the wrapped function.
- *
- * Instrumentation behavior:
- * - If `initializePingops` was called: All HTTP requests are instrumented by default.
- *   `wrapHttp` only adds attributes to spans created within the wrapped block.
- * - If `initializePingops` was NOT called: Only HTTP requests within `wrapHttp` blocks
- *   are instrumented. Requests outside `wrapHttp` are not instrumented.
- *
- * Note: This is the low-level API. For a simpler API with automatic setup,
- * use `wrapHttp` from `@pingops/sdk` instead.
- *
- * @param options - Options including attributes and required callbacks
- * @param fn - Function to execute within the attribute context
- * @returns The result of the function
+ * Converts a Uint8Array to a lowercase hex string.
+ */
+declare function uint8ArrayToHex(bytes: Uint8Array): string;
+/**
+ * Creates a trace ID (32 hex chars).
+ * - If `seed` is provided: deterministic via SHA-256 of the seed (first 32 hex chars).
+ * - Otherwise: random 16 bytes as 32 hex chars.
  */
-declare function wrapHttp<T>(options: WrapHttpOptions, fn: () => T | Promise<T>): T | Promise<T>;
+declare function createTraceId(seed?: string): Promise<string>;
 //#endregion
-export { DEFAULT_REDACTION_CONFIG, DEFAULT_SENSITIVE_HEADER_PATTERNS, DomainRule, HeaderRedactionConfig, HeaderRedactionStrategy, LogLevel, Logger, PINGOPS_CAPTURE_REQUEST_BODY, PINGOPS_CAPTURE_RESPONSE_BODY, PINGOPS_HTTP_ENABLED, PINGOPS_METADATA, PINGOPS_SESSION_ID, PINGOPS_TAGS, PINGOPS_USER_ID, SpanPayload, WrapHttpAttributes, WrapHttpOptions, createLogger, extractHeadersFromAttributes, extractSpanPayload, filterHeaders, getPropagatedAttributesFromContext, isSensitiveHeader, isSpanEligible, normalizeHeaders, redactHeaderValue, shouldCaptureSpan, wrapHttp };
+export { DEFAULT_REDACTION_CONFIG, DEFAULT_SENSITIVE_HEADER_PATTERNS, DomainRule, HTTP_RESPONSE_CONTENT_ENCODING, HeaderRedactionConfig, HeaderRedactionStrategy, LogLevel, Logger, PINGOPS_CAPTURE_REQUEST_BODY, PINGOPS_CAPTURE_RESPONSE_BODY, PINGOPS_METADATA, PINGOPS_SESSION_ID, PINGOPS_TAGS, PINGOPS_TRACE_ID, PINGOPS_USER_ID, PingopsTraceAttributes, SpanPayload, bufferToBodyString, createLogger, createTraceId, extractHeadersFromAttributes, extractSpanPayload, filterHeaders, getPropagatedAttributesFromContext, isCompressedContentEncoding, isSensitiveHeader, isSpanEligible, normalizeHeaders, redactHeaderValue, shouldCaptureSpan, uint8ArrayToHex };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/filtering/span-filter.ts","../src/filtering/domain-filter.ts","../src/filtering/sensitive-headers.ts","../src/filtering/header-filter.ts","../src/utils/span-extractor.ts","../src/utils/context-extractor.ts","../src/logger.ts","../src/context-keys.ts","../src/wrap-http.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/filtering/span-filter.ts","../src/filtering/domain-filter.ts","../src/filtering/sensitive-headers.ts","../src/filtering/header-filter.ts","../src/filtering/body-decoder.ts","../src/utils/span-extractor.ts","../src/utils/context-extractor.ts","../src/logger.ts","../src/context-keys.ts","../src/trace-id.ts"],"sourcesContent":[],"mappings":"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"}