@testrelic/core 2.2.2 → 2.2.3

package/dist/index.cjs

@@ -28,9 +28,14 @@ __export(index_exports, {
   createError: () => createError,
   createLogger: () => createLogger,
   isTestRelicDataPayload: () => isTestRelicDataPayload,
+  isValidApiKeyFormat: () => isValidApiKeyFormat,
+  isValidCloudConfig: () => isValidCloudConfig,
   isValidConfig: () => isValidConfig,
+  isValidEndpointUrl: () => isValidEndpointUrl,
   isValidNavigationType: () => isValidNavigationType,
-  isValidTestRunReport: () => isValidTestRunReport
+  isValidQueueEntry: () => isValidQueueEntry,
+  isValidTestRunReport: () => isValidTestRunReport,
+  isValidUploadStrategy: () => isValidUploadStrategy
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -73,7 +78,11 @@ var ErrorCode = {
   MERGE_READ_FAILED: "TESTRELIC_MERGE_READ_FAILED",
   NAVIGATION_FLUSH_FAILED: "TESTRELIC_NAVIGATION_FLUSH_FAILED",
   CODE_EXTRACT_FAILED: "TESTRELIC_CODE_EXTRACT_FAILED",
-  HTML_REPORT_FAILED: "TESTRELIC_HTML_REPORT_FAILED"
+  HTML_REPORT_FAILED: "TESTRELIC_HTML_REPORT_FAILED",
+  CLOUD_AUTH_FAILED: "TESTRELIC_CLOUD_AUTH_FAILED",
+  CLOUD_UPLOAD_FAILED: "TESTRELIC_CLOUD_UPLOAD_FAILED",
+  CLOUD_CONFIG_INVALID: "TESTRELIC_CLOUD_CONFIG_INVALID",
+  CLOUD_QUEUE_FAILED: "TESTRELIC_CLOUD_QUEUE_FAILED"
 };
 var TestRelicError = class extends Error {
   constructor(code, message, cause) {
@@ -180,6 +189,67 @@ function isValidConfig(input) {
   }
   return true;
 }
+var API_KEY_PATTERN = /^tr[a-z]*_[a-z]+_[a-zA-Z0-9]+$/;
+var UPLOAD_STRATEGIES = /* @__PURE__ */ new Set(["batch", "realtime", "both"]);
+var LOCALHOST_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "0.0.0.0"]);
+function isValidApiKeyFormat(value) {
+  return typeof value === "string" && API_KEY_PATTERN.test(value);
+}
+function isValidUploadStrategy(value) {
+  return typeof value === "string" && UPLOAD_STRATEGIES.has(value);
+}
+function isValidEndpointUrl(value) {
+  if (typeof value !== "string") return false;
+  try {
+    const url = new URL(value);
+    if (url.protocol === "https:") return true;
+    if (url.protocol === "http:" && LOCALHOST_HOSTS.has(url.hostname)) return true;
+    return false;
+  } catch {
+    return false;
+  }
+}
+function isValidCloudConfig(input) {
+  if (typeof input !== "object" || input === null) return false;
+  if (!hasNoPrototypePollution(input)) return false;
+  const obj = input;
+  if (obj.apiKey !== void 0 && obj.apiKey !== null) {
+    if (typeof obj.apiKey !== "string") return false;
+    if (obj.apiKey.length > 0 && !isValidApiKeyFormat(obj.apiKey)) return false;
+  }
+  if (obj.endpoint !== void 0) {
+    if (!isValidEndpointUrl(obj.endpoint)) return false;
+  }
+  if (obj.uploadStrategy !== void 0) {
+    if (!isValidUploadStrategy(obj.uploadStrategy)) return false;
+  }
+  if (obj.timeout !== void 0) {
+    if (typeof obj.timeout !== "number" || obj.timeout < 1e3 || obj.timeout > 12e4) return false;
+  }
+  if (obj.projectName !== void 0 && obj.projectName !== null && typeof obj.projectName !== "string") return false;
+  if (obj.queueMaxAge !== void 0) {
+    if (typeof obj.queueMaxAge !== "number" || obj.queueMaxAge < 36e5 || obj.queueMaxAge > 2592e6) return false;
+  }
+  if (obj.queueDirectory !== void 0) {
+    if (typeof obj.queueDirectory !== "string") return false;
+    if (obj.queueDirectory.startsWith("/") || obj.queueDirectory.includes("..")) return false;
+  }
+  return true;
+}
+function isValidQueueEntry(input) {
+  if (typeof input !== "object" || input === null) return false;
+  if (!hasNoPrototypePollution(input)) return false;
+  const obj = input;
+  if (typeof obj.version !== "string") return false;
+  if (typeof obj.queuedAt !== "string") return false;
+  if (typeof obj.reason !== "string") return false;
+  if (typeof obj.retryCount !== "number") return false;
+  if (typeof obj.targetEndpoint !== "string") return false;
+  if (typeof obj.method !== "string") return false;
+  if (typeof obj.payload !== "object" || obj.payload === null) return false;
+  if (typeof obj.headers !== "object" || obj.headers === null) return false;
+  return true;
+}
 function isValidTestRunReport(value) {
   if (typeof value !== "object" || value === null) return false;
   const obj = value;
@@ -209,8 +279,13 @@ function isValidTestRunReport(value) {
   createError,
   createLogger,
   isTestRelicDataPayload,
+  isValidApiKeyFormat,
+  isValidCloudConfig,
   isValidConfig,
+  isValidEndpointUrl,
   isValidNavigationType,
-  isValidTestRunReport
+  isValidQueueEntry,
+  isValidTestRunReport,
+  isValidUploadStrategy
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/logger.ts","../src/errors.ts","../src/validation.ts"],"sourcesContent":["// @testrelic/core — barrel export\n// Re-exports only, no implementation (Constitution II)\n\nexport type {\n  NavigationType,\n  TestRunReport,\n  Summary,\n  CIMetadata,\n  CIProvider,\n  TimelineEntry,\n  TestResult,\n  TestStatus,\n  TestType,\n  FailureDiagnostic,\n  NetworkStats,\n  ResourceBreakdown,\n  ResourceType,\n  CapturedNetworkRequest,\n  ApiCallRecord,\n  ApiAssertion,\n  AssertionType,\n  AssertionLocation,\n  ReporterConfig,\n  TestArtifacts,\n  NavigationAnnotation,\n  MergeOptions,\n  StepTestIdentity,\n  ApiCallStepRequest,\n  ApiCallStepResponse,\n  StepAssertion,\n  NavigationStep,\n  ApiCallStep,\n  TimelineStep,\n  ActionStep,\n  ActionCategory,\n  TestRelicDataPayload,\n} from './types.js';\n\nexport {\n  PAYLOAD_VERSION,\n  ATTACHMENT_NAME,\n  ATTACHMENT_CONTENT_TYPE,\n  isTestRelicDataPayload,\n} from './types.js';\n\nexport type { Logger, LoggerOptions, LogLevel } from './logger.js';\nexport { createLogger } from './logger.js';\n\nexport { ErrorCode, TestRelicError, createError } from './errors.js';\n\nexport {\n  isValidConfig,\n  isValidNavigationType,\n  isValidTestRunReport,\n} from './validation.js';\n","/**\n * @testrelic/core — Shared type definitions\n *\n * All interfaces for the JSON output schema, reporter configuration,\n * and internal fixture-to-reporter communication.\n *\n * Schema Version: 1.0.0\n */\n\n// ---------------------------------------------------------------------------\n// Navigation Types\n// ---------------------------------------------------------------------------\n\nexport type NavigationType =\n  | 'goto'\n  | 'navigation'\n  | 'back'\n  | 'forward'\n  | 'refresh'\n  | 'spa_route'\n  | 'spa_replace'\n  | 'hash_change'\n  | 'link_click'\n  | 'form_submit'\n  | 'redirect'\n  | 'popstate'\n  | 'page_load'\n  | 'manual_record'\n  | 'fallback'\n  | 'dummy';\n\n// ---------------------------------------------------------------------------\n// Output Schema Types (JSON report structure)\n// ---------------------------------------------------------------------------\n\nexport interface TestRunReport {\n  readonly schemaVersion: string;\n  readonly testRunId: string;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly totalDuration: number;\n  readonly summary: Summary;\n  readonly ci: CIMetadata | null;\n  readonly metadata: Record<string, unknown> | null;\n  readonly timeline: readonly (TimelineEntry | TimelineStep)[];\n  readonly shardRunIds: string[] | null;\n}\n\n/** Breakdown of API calls by HTTP response status range. */\nexport interface ApiCallsByStatusRange {\n  readonly '2xx': number;\n  readonly '3xx': number;\n  readonly '4xx': number;\n  readonly '5xx': number;\n  readonly error: number;\n}\n\n/** Statistical distribution of API call response times in milliseconds. */\nexport interface ApiResponseTimeStats {\n  readonly avg: number;\n  readonly min: number;\n  readonly max: number;\n  readonly p50: number;\n  readonly p95: number;\n  readonly p99: number;\n}\n\nexport interface Summary {\n  readonly total: number;\n  readonly passed: number;\n  readonly failed: number;\n  readonly flaky: number;\n  readonly skipped: number;\n  readonly timedout: number;\n  readonly totalApiCalls: number;\n  readonly uniqueApiUrls: number;\n  readonly apiCallsByMethod: Record<string, number>;\n  readonly apiCallsByStatusRange: ApiCallsByStatusRange;\n  readonly apiResponseTime: ApiResponseTimeStats | null;\n  readonly totalAssertions: number;\n  readonly passedAssertions: number;\n  readonly failedAssertions: number;\n  readonly totalNavigations: number;\n  readonly uniqueNavigationUrls: number;\n  readonly totalTimelineSteps: number;\n  readonly totalActionSteps: number;\n  readonly actionStepsByCategory: Record<string, number>;\n}\n\nexport interface CIMetadata {\n  readonly provider: CIProvider;\n  readonly buildId: string | null;\n  readonly commitSha: string | null;\n  readonly branch: string | null;\n}\n\nexport type CIProvider =\n  | 'github-actions'\n  | 'gitlab-ci'\n  | 'jenkins'\n  | 'circleci'\n  | 'unknown';\n\nexport interface TimelineEntry {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly visitedAt: string;\n  readonly duration: number;\n  readonly specFile: string;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly tests: TestResult[];\n}\n\nexport interface TestResult {\n  readonly title: string;\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly retryCount: number;\n  readonly tags: string[];\n  readonly failure: FailureDiagnostic | null;\n  readonly testId: string;\n  readonly filePath: string;\n  readonly suiteName: string;\n  readonly testType: TestType;\n  readonly isFlaky: boolean;\n  readonly retryStatus: string | null;\n  readonly expectedStatus: TestStatus;\n  readonly actualStatus: TestStatus;\n  readonly artifacts: TestArtifacts | null;\n  readonly networkRequests: CapturedNetworkRequest[] | null;\n  readonly apiCalls: readonly ApiCallRecord[] | null;\n  readonly apiAssertions: readonly ApiAssertion[] | null;\n  readonly actions: readonly ActionStep[] | null;\n}\n\nexport type ResourceType = 'xhr' | 'document' | 'script' | 'stylesheet' | 'image' | 'font' | 'other';\n\nexport interface CapturedNetworkRequest {\n  readonly url: string;\n  readonly method: string;\n  readonly resourceType: ResourceType;\n  readonly statusCode: number;\n  readonly responseTimeMs: number;\n  readonly startedAt: string;\n  readonly requestHeaders: Record<string, string> | null;\n  readonly requestBody: string | null;\n  readonly responseBody: string | null;\n  readonly responseHeaders: Record<string, string> | null;\n  readonly contentType: string | null;\n  readonly responseSize: number;\n  readonly requestBodyTruncated: boolean;\n  readonly responseBodyTruncated: boolean;\n  readonly isBinary: boolean;\n  readonly error: string | null;\n}\n\nexport interface TestArtifacts {\n  readonly screenshot?: string;\n  readonly video?: string;\n}\n\nexport type TestStatus = 'passed' | 'failed' | 'skipped' | 'flaky' | 'timedout';\n\nexport type TestType = 'e2e' | 'api' | 'unit' | 'unknown';\n\nexport interface FailureDiagnostic {\n  readonly message: string;\n  readonly line: number | null;\n  readonly code: string | null;\n  readonly stack: string | null;\n}\n\nexport interface NetworkStats {\n  readonly totalRequests: number;\n  readonly failedRequests: number;\n  readonly failedRequestUrls: string[];\n  readonly totalBytes: number;\n  readonly byType: ResourceBreakdown;\n}\n\nexport interface ResourceBreakdown {\n  readonly xhr: number;\n  readonly document: number;\n  readonly script: number;\n  readonly stylesheet: number;\n  readonly image: number;\n  readonly font: number;\n  readonly other: number;\n}\n\n// ---------------------------------------------------------------------------\n// API Call Record (captured from Playwright APIRequestContext proxy)\n// ---------------------------------------------------------------------------\n\nexport interface ApiCallRecord {\n  /** Unique call identifier within the test (e.g., \"api-call-0\") */\n  readonly id: string;\n  /** ISO 8601 timestamp when the call was initiated */\n  readonly timestamp: string;\n  /** HTTP method: GET, POST, PUT, PATCH, DELETE, HEAD, or custom via fetch() */\n  readonly method: string;\n  /** Full resolved URL (after baseURL resolution by Playwright) */\n  readonly url: string;\n  /** All request headers sent, or null if unavailable */\n  readonly requestHeaders: Record<string, string> | null;\n  /** Request payload as string (JSON-serialized for objects). Null for bodiless methods */\n  readonly requestBody: string | null;\n  /** HTTP response status code, or null if request errored before response */\n  readonly responseStatusCode: number | null;\n  /** HTTP response status text, or null if request errored before response */\n  readonly responseStatusText: string | null;\n  /** All response headers received, or null if request errored before response */\n  readonly responseHeaders: Record<string, string> | null;\n  /** Response body: string for text/JSON, base64 for binary. Null on error */\n  readonly responseBody: string | null;\n  /** Duration in milliseconds from request initiation to response received */\n  readonly responseTimeMs: number;\n  /** Whether the response body is stored as a base64-encoded binary string */\n  readonly isBinary: boolean;\n  /** Error message if the call failed (network error, timeout), null on success */\n  readonly error: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// API Assertion Types (captured from assertion tracking)\n// ---------------------------------------------------------------------------\n\n/** Categorization of the assertion being made. */\nexport type AssertionType =\n  | 'status'\n  | 'statusOk'\n  | 'header'\n  | 'bodyField'\n  | 'bodyMatch'\n  | 'bodyContains'\n  | 'custom';\n\n/** Source location where an assertion was made in the test file. */\nexport interface AssertionLocation {\n  /** Absolute or relative file path to the test file */\n  readonly file: string;\n  /** Line number (1-based) */\n  readonly line: number;\n  /** Column number (1-based), if available */\n  readonly column?: number;\n}\n\n/** A single captured assertion on API response data. */\nexport interface ApiAssertion {\n  /** Links to ApiCallRecord.id from the API proxy */\n  readonly callId: string;\n  /** Category of assertion */\n  readonly type: AssertionType;\n  /** What the test expected */\n  readonly expected: unknown;\n  /** What was actually received */\n  readonly actual: unknown;\n  /** Whether the assertion passed or failed */\n  readonly status: 'passed' | 'failed';\n  /** Source location of the assertion in the test file */\n  readonly location: AssertionLocation;\n  /** String representation of the assertion expression (best-effort) */\n  readonly expression?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Unified Timeline Types (navigation + API call steps)\n// ---------------------------------------------------------------------------\n\n/** Test identity block attached to every timeline step. */\nexport interface StepTestIdentity {\n  readonly title: string;\n  readonly fullTitle: readonly string[];\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly retries: number;\n  readonly retry: number;\n  readonly tags: readonly string[];\n  readonly failure: FailureDiagnostic | null;\n}\n\n/** Request details within an API call step. */\nexport interface ApiCallStepRequest {\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** Response details within an API call step. */\nexport interface ApiCallStepResponse {\n  readonly statusCode: number;\n  readonly statusText: string;\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** An assertion linked to an API call step (callId omitted — implicit from parent). */\nexport interface StepAssertion {\n  readonly type: AssertionType;\n  readonly expected: unknown;\n  readonly actual: unknown;\n  readonly status: 'passed' | 'failed';\n  readonly location: AssertionLocation;\n  readonly expression?: string;\n}\n\n/** A browser navigation event in the unified timeline. */\nexport interface NavigationStep {\n  readonly index: number;\n  readonly type: 'navigation';\n  readonly url: string;\n  readonly timestamp: string;\n  readonly durationOnUrl: number;\n  readonly navigationType: NavigationType;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** An API request event in the unified timeline. */\nexport interface ApiCallStep {\n  readonly index: number;\n  readonly type: 'api_call';\n  readonly callId: string;\n  readonly method: string;\n  readonly url: string;\n  readonly timestamp: string;\n  readonly responseTime: number | null;\n  readonly request: ApiCallStepRequest;\n  readonly response: ApiCallStepResponse | null;\n  readonly error?: string | null;\n  readonly assertions: readonly StepAssertion[];\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** Discriminated union of all timeline step types. */\nexport type TimelineStep = NavigationStep | ApiCallStep;\n\n// ---------------------------------------------------------------------------\n// Action Step Types (Playwright test step capture)\n// ---------------------------------------------------------------------------\n\n/** Categorized type of a captured test action. */\nexport type ActionCategory = 'ui_action' | 'assertion' | 'custom_step';\n\n/** A single captured test action step. */\nexport interface ActionStep {\n  readonly title: string;\n  readonly category: ActionCategory;\n  readonly timestamp: string;\n  readonly duration: number;\n  readonly videoOffset: number | null;\n  readonly status: 'passed' | 'failed';\n  readonly error: string | null;\n  readonly children: readonly ActionStep[];\n}\n\n// ---------------------------------------------------------------------------\n// Configuration Types (reporter tuple options)\n// ---------------------------------------------------------------------------\n\nexport interface ReporterConfig {\n  readonly outputPath?: string;\n  readonly includeStackTrace?: boolean;\n  readonly includeCodeSnippets?: boolean;\n  readonly codeContextLines?: number;\n  readonly includeNetworkStats?: boolean;\n  readonly navigationTypes?: NavigationType[] | null;\n  readonly redactPatterns?: (string | RegExp)[];\n  readonly testRunId?: string | null;\n  readonly metadata?: Record<string, unknown> | null;\n  readonly openReport?: boolean;\n  readonly htmlReportPath?: string;\n  readonly includeArtifacts?: boolean;\n  /** When false, disables API call interception in the unified fixture. Default: true */\n  readonly trackApiCalls?: boolean;\n  /** When true, suppresses console summary output. Default: false */\n  readonly quiet?: boolean;\n  /** When true, captures Playwright test steps (actions). Default: true */\n  readonly includeActionSteps?: boolean;\n  /** Capture request headers for API calls. Default: true */\n  readonly captureRequestHeaders?: boolean;\n  /** Capture response headers for API calls. Default: true */\n  readonly captureResponseHeaders?: boolean;\n  /** Capture request body for API calls. Default: true */\n  readonly captureRequestBody?: boolean;\n  /** Capture response body for API calls. Default: true */\n  readonly captureResponseBody?: boolean;\n  /** Capture API assertions (both pass and fail). Default: true */\n  readonly captureAssertions?: boolean;\n  /**\n   * Header names whose values are replaced with \"[REDACTED]\".\n   * Case-insensitive matching. Default: ['authorization', 'cookie', 'set-cookie', 'x-api-key']\n   */\n  readonly redactHeaders?: string[];\n  /**\n   * Body field names whose values are replaced with \"[REDACTED]\" at any depth.\n   * Default: ['password', 'secret', 'token', 'apiKey', 'api_key']\n   */\n  readonly redactBodyFields?: string[];\n  /**\n   * Only track API calls matching these URL patterns.\n   * Default: undefined (track all)\n   */\n  readonly apiIncludeUrls?: (string | RegExp)[];\n  /**\n   * Exclude API calls matching these URL patterns. Takes precedence over include.\n   * Default: undefined (exclude none)\n   */\n  readonly apiExcludeUrls?: (string | RegExp)[];\n}\n\n// ---------------------------------------------------------------------------\n// Internal Types (fixture → reporter communication)\n// ---------------------------------------------------------------------------\n\nexport interface NavigationAnnotation {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly timestamp: string;\n  readonly domContentLoadedAt?: string;\n  readonly networkIdleAt?: string;\n  readonly networkStats?: NetworkStats;\n}\n\n// ---------------------------------------------------------------------------\n// Worker-Safe Data Payload (worker → reporter communication)\n// ---------------------------------------------------------------------------\n\n/** Consolidated data payload sent from a worker fixture to the reporter. */\nexport interface TestRelicDataPayload {\n  /** Marker to identify TestRelic attachments. Always `true`. */\n  readonly testRelicData: true;\n  /** Payload format version (semver). */\n  readonly version: string;\n  /** Navigation events collected during the test. */\n  readonly navigations: readonly NavigationAnnotation[];\n  /** Captured network requests during the test. */\n  readonly networkRequests: readonly CapturedNetworkRequest[];\n  /** API calls made via APIRequestContext proxy. */\n  readonly apiCalls: readonly ApiCallRecord[];\n  /** Assertions captured on API responses. */\n  readonly apiAssertions: readonly ApiAssertion[];\n}\n\n/** Current payload format version. */\nexport const PAYLOAD_VERSION = '1.0.0';\n\n/** Attachment name used for the consolidated payload. */\nexport const ATTACHMENT_NAME = 'testrelic-data';\n\n/** Attachment content type. */\nexport const ATTACHMENT_CONTENT_TYPE = 'application/json';\n\n/** Type guard: validates that a parsed object is a TestRelicDataPayload. */\nexport function isTestRelicDataPayload(obj: unknown): obj is TestRelicDataPayload {\n  if (typeof obj !== 'object' || obj === null) return false;\n  const record = obj as Record<string, unknown>;\n  return (\n    record.testRelicData === true &&\n    typeof record.version === 'string' &&\n    record.version.length > 0 &&\n    Array.isArray(record.navigations) &&\n    Array.isArray(record.networkRequests) &&\n    Array.isArray(record.apiCalls) &&\n    Array.isArray(record.apiAssertions)\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Merge CLI Types\n// ---------------------------------------------------------------------------\n\nexport interface MergeOptions {\n  readonly output: string;\n  readonly testRunId?: string;\n}\n","/**\n * @testrelic/core — Configurable logger\n *\n * Provides a Logger interface with a no-op default.\n * Never uses console.* directly (Constitution SDK Constraint).\n */\n\nexport interface Logger {\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n  debug(message: string, ...args: unknown[]): void;\n}\n\nexport interface LoggerOptions {\n  readonly handler?: (level: LogLevel, message: string, args: unknown[]) => void;\n}\n\nexport type LogLevel = 'info' | 'warn' | 'error' | 'debug';\n\ntype LogHandler = (level: LogLevel, message: string, args: unknown[]) => void;\n\nconst noopHandler: LogHandler = () => {};\n\nexport function createLogger(options?: LoggerOptions): Logger {\n  const handler = options?.handler ?? noopHandler;\n\n  return {\n    info(message: string, ...args: unknown[]) {\n      handler('info', message, args);\n    },\n    warn(message: string, ...args: unknown[]) {\n      handler('warn', message, args);\n    },\n    error(message: string, ...args: unknown[]) {\n      handler('error', message, args);\n    },\n    debug(message: string, ...args: unknown[]) {\n      handler('debug', message, args);\n    },\n  };\n}\n","/**\n * @testrelic/core — Structured error factory\n *\n * Machine-readable error codes for programmatic handling.\n */\n\nexport const ErrorCode = {\n  CONFIG_INVALID: 'TESTRELIC_CONFIG_INVALID',\n  OUTPUT_WRITE_FAILED: 'TESTRELIC_OUTPUT_WRITE_FAILED',\n  MERGE_INVALID_SCHEMA: 'TESTRELIC_MERGE_INVALID_SCHEMA',\n  MERGE_READ_FAILED: 'TESTRELIC_MERGE_READ_FAILED',\n  NAVIGATION_FLUSH_FAILED: 'TESTRELIC_NAVIGATION_FLUSH_FAILED',\n  CODE_EXTRACT_FAILED: 'TESTRELIC_CODE_EXTRACT_FAILED',\n  HTML_REPORT_FAILED: 'TESTRELIC_HTML_REPORT_FAILED',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\nexport class TestRelicError extends Error {\n  readonly code: ErrorCode;\n\n  constructor(code: ErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = 'TestRelicError';\n    this.code = code;\n    if (cause !== undefined) {\n      Object.defineProperty(this, 'cause', { value: cause, writable: false, enumerable: false });\n    }\n  }\n}\n\nexport function createError(\n  code: ErrorCode,\n  message: string,\n  cause?: unknown,\n): TestRelicError {\n  return new TestRelicError(code, message, cause);\n}\n","/**\n * @testrelic/core — Lightweight runtime type guards\n *\n * Hand-written guards, no runtime schema libraries (Constitution SDK Constraint).\n */\n\nimport type {\n  ReporterConfig,\n  NavigationType,\n  TestRunReport,\n} from './types.js';\n\nconst NAVIGATION_TYPES = new Set<string>([\n  'goto', 'navigation', 'back', 'forward', 'refresh',\n  'spa_route', 'spa_replace', 'hash_change', 'link_click',\n  'form_submit', 'redirect', 'popstate', 'page_load',\n  'manual_record', 'fallback', 'dummy',\n]);\n\nconst DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport function isValidNavigationType(value: unknown): value is NavigationType {\n  return typeof value === 'string' && NAVIGATION_TYPES.has(value);\n}\n\nfunction hasNoPrototypePollution(obj: unknown): boolean {\n  if (typeof obj !== 'object' || obj === null) return true;\n  for (const key of Object.keys(obj)) {\n    if (DANGEROUS_KEYS.has(key)) return false;\n  }\n  return true;\n}\n\nexport function isValidConfig(input: unknown): input is ReporterConfig {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (obj.outputPath !== undefined && typeof obj.outputPath !== 'string') return false;\n  if (obj.includeStackTrace !== undefined && typeof obj.includeStackTrace !== 'boolean') return false;\n  if (obj.includeCodeSnippets !== undefined && typeof obj.includeCodeSnippets !== 'boolean') return false;\n  if (obj.codeContextLines !== undefined && typeof obj.codeContextLines !== 'number') return false;\n  if (obj.includeNetworkStats !== undefined && typeof obj.includeNetworkStats !== 'boolean') return false;\n\n  if (obj.navigationTypes !== undefined && obj.navigationTypes !== null) {\n    if (!Array.isArray(obj.navigationTypes)) return false;\n    for (const t of obj.navigationTypes) {\n      if (!isValidNavigationType(t)) return false;\n    }\n  }\n\n  if (obj.redactPatterns !== undefined) {\n    if (!Array.isArray(obj.redactPatterns)) return false;\n    for (const p of obj.redactPatterns) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.testRunId !== undefined && obj.testRunId !== null && typeof obj.testRunId !== 'string') return false;\n\n  if (obj.metadata !== undefined && obj.metadata !== null) {\n    if (typeof obj.metadata !== 'object') return false;\n    if (!hasNoPrototypePollution(obj.metadata)) return false;\n  }\n\n  if (obj.openReport !== undefined && typeof obj.openReport !== 'boolean') return false;\n  if (obj.htmlReportPath !== undefined && (typeof obj.htmlReportPath !== 'string' || obj.htmlReportPath === '')) return false;\n  if (obj.includeArtifacts !== undefined && typeof obj.includeArtifacts !== 'boolean') return false;\n\n  // API tracking configuration\n  if (obj.trackApiCalls !== undefined && typeof obj.trackApiCalls !== 'boolean') return false;\n  if (obj.captureRequestHeaders !== undefined && typeof obj.captureRequestHeaders !== 'boolean') return false;\n  if (obj.captureResponseHeaders !== undefined && typeof obj.captureResponseHeaders !== 'boolean') return false;\n  if (obj.captureRequestBody !== undefined && typeof obj.captureRequestBody !== 'boolean') return false;\n  if (obj.captureResponseBody !== undefined && typeof obj.captureResponseBody !== 'boolean') return false;\n  if (obj.captureAssertions !== undefined && typeof obj.captureAssertions !== 'boolean') return false;\n\n  if (obj.redactHeaders !== undefined) {\n    if (!Array.isArray(obj.redactHeaders)) return false;\n    for (const h of obj.redactHeaders) {\n      if (typeof h !== 'string') return false;\n    }\n  }\n\n  if (obj.redactBodyFields !== undefined) {\n    if (!Array.isArray(obj.redactBodyFields)) return false;\n    for (const f of obj.redactBodyFields) {\n      if (typeof f !== 'string') return false;\n    }\n  }\n\n  if (obj.apiIncludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiIncludeUrls)) return false;\n    for (const p of obj.apiIncludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.apiExcludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiExcludeUrls)) return false;\n    for (const p of obj.apiExcludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  return true;\n}\n\nexport function isValidTestRunReport(value: unknown): value is TestRunReport {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.schemaVersion !== 'string') return false;\n  if (typeof obj.testRunId !== 'string') return false;\n  if (typeof obj.startedAt !== 'string') return false;\n  if (typeof obj.completedAt !== 'string') return false;\n  if (typeof obj.totalDuration !== 'number') return false;\n  if (typeof obj.summary !== 'object' || obj.summary === null) return false;\n  if (!Array.isArray(obj.timeline)) return false;\n\n  const summary = obj.summary as Record<string, unknown>;\n  if (typeof summary.total !== 'number') return false;\n  if (typeof summary.passed !== 'number') return false;\n  if (typeof summary.failed !== 'number') return false;\n  if (typeof summary.flaky !== 'number') return false;\n  if (typeof summary.skipped !== 'number') return false;\n  // timedout is optional for backward compat with schema 1.0.0\n  if (summary.timedout !== undefined && typeof summary.timedout !== 'number') return false;\n\n  return true;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/logger.ts","../src/errors.ts","../src/validation.ts"],"sourcesContent":["// @testrelic/core — barrel export\n// Re-exports only, no implementation (Constitution II)\n\nexport type {\n  NavigationType,\n  TestRunReport,\n  Summary,\n  CIMetadata,\n  CIProvider,\n  TimelineEntry,\n  TestResult,\n  TestStatus,\n  TestType,\n  FailureDiagnostic,\n  NetworkStats,\n  ResourceBreakdown,\n  ResourceType,\n  CapturedNetworkRequest,\n  ApiCallRecord,\n  ApiAssertion,\n  AssertionType,\n  AssertionLocation,\n  ReporterConfig,\n  TestArtifacts,\n  NavigationAnnotation,\n  MergeOptions,\n  StepTestIdentity,\n  ApiCallStepRequest,\n  ApiCallStepResponse,\n  StepAssertion,\n  NavigationStep,\n  ApiCallStep,\n  TimelineStep,\n  ActionStep,\n  ActionCategory,\n  TestRelicDataPayload,\n  CloudConfig,\n  AuthState,\n  AuthMode,\n  GitMetadata,\n  ProjectResolution,\n  QueueEntry,\n  UploadStrategy,\n  CloudReporterOptions,\n} from './types.js';\n\nexport {\n  PAYLOAD_VERSION,\n  ATTACHMENT_NAME,\n  ATTACHMENT_CONTENT_TYPE,\n  isTestRelicDataPayload,\n} from './types.js';\n\nexport type { Logger, LoggerOptions, LogLevel } from './logger.js';\nexport { createLogger } from './logger.js';\n\nexport { ErrorCode, TestRelicError, createError } from './errors.js';\n\nexport {\n  isValidConfig,\n  isValidNavigationType,\n  isValidTestRunReport,\n  isValidCloudConfig,\n  isValidApiKeyFormat,\n  isValidEndpointUrl,\n  isValidUploadStrategy,\n  isValidQueueEntry,\n} from './validation.js';\n","/**\n * @testrelic/core — Shared type definitions\n *\n * All interfaces for the JSON output schema, reporter configuration,\n * and internal fixture-to-reporter communication.\n *\n * Schema Version: 1.0.0\n */\n\n// ---------------------------------------------------------------------------\n// Navigation Types\n// ---------------------------------------------------------------------------\n\nexport type NavigationType =\n  | 'goto'\n  | 'navigation'\n  | 'back'\n  | 'forward'\n  | 'refresh'\n  | 'spa_route'\n  | 'spa_replace'\n  | 'hash_change'\n  | 'link_click'\n  | 'form_submit'\n  | 'redirect'\n  | 'popstate'\n  | 'page_load'\n  | 'manual_record'\n  | 'fallback'\n  | 'dummy';\n\n// ---------------------------------------------------------------------------\n// Output Schema Types (JSON report structure)\n// ---------------------------------------------------------------------------\n\nexport interface TestRunReport {\n  readonly schemaVersion: string;\n  readonly testRunId: string;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly totalDuration: number;\n  readonly summary: Summary;\n  readonly ci: CIMetadata | null;\n  readonly metadata: Record<string, unknown> | null;\n  readonly timeline: readonly (TimelineEntry | TimelineStep)[];\n  readonly shardRunIds: string[] | null;\n}\n\n/** Breakdown of API calls by HTTP response status range. */\nexport interface ApiCallsByStatusRange {\n  readonly '2xx': number;\n  readonly '3xx': number;\n  readonly '4xx': number;\n  readonly '5xx': number;\n  readonly error: number;\n}\n\n/** Statistical distribution of API call response times in milliseconds. */\nexport interface ApiResponseTimeStats {\n  readonly avg: number;\n  readonly min: number;\n  readonly max: number;\n  readonly p50: number;\n  readonly p95: number;\n  readonly p99: number;\n}\n\nexport interface Summary {\n  readonly total: number;\n  readonly passed: number;\n  readonly failed: number;\n  readonly flaky: number;\n  readonly skipped: number;\n  readonly timedout: number;\n  readonly totalApiCalls: number;\n  readonly uniqueApiUrls: number;\n  readonly apiCallsByMethod: Record<string, number>;\n  readonly apiCallsByStatusRange: ApiCallsByStatusRange;\n  readonly apiResponseTime: ApiResponseTimeStats | null;\n  readonly totalAssertions: number;\n  readonly passedAssertions: number;\n  readonly failedAssertions: number;\n  readonly totalNavigations: number;\n  readonly uniqueNavigationUrls: number;\n  readonly totalTimelineSteps: number;\n  readonly totalActionSteps: number;\n  readonly actionStepsByCategory: Record<string, number>;\n}\n\nexport interface CIMetadata {\n  readonly provider: CIProvider;\n  readonly buildId: string | null;\n  readonly commitSha: string | null;\n  readonly branch: string | null;\n  readonly runUrl: string | null;\n}\n\nexport type CIProvider =\n  | 'github-actions'\n  | 'gitlab-ci'\n  | 'jenkins'\n  | 'circleci'\n  | 'bitbucket-pipelines'\n  | 'unknown';\n\nexport interface TimelineEntry {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly visitedAt: string;\n  readonly duration: number;\n  readonly specFile: string;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly tests: TestResult[];\n}\n\nexport interface TestResult {\n  readonly title: string;\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly retryCount: number;\n  readonly tags: string[];\n  readonly failure: FailureDiagnostic | null;\n  readonly testId: string;\n  readonly filePath: string;\n  readonly suiteName: string;\n  readonly testType: TestType;\n  readonly isFlaky: boolean;\n  readonly retryStatus: string | null;\n  readonly expectedStatus: TestStatus;\n  readonly actualStatus: TestStatus;\n  readonly artifacts: TestArtifacts | null;\n  readonly networkRequests: CapturedNetworkRequest[] | null;\n  readonly apiCalls: readonly ApiCallRecord[] | null;\n  readonly apiAssertions: readonly ApiAssertion[] | null;\n  readonly actions: readonly ActionStep[] | null;\n}\n\nexport type ResourceType = 'xhr' | 'document' | 'script' | 'stylesheet' | 'image' | 'font' | 'other';\n\nexport interface CapturedNetworkRequest {\n  readonly url: string;\n  readonly method: string;\n  readonly resourceType: ResourceType;\n  readonly statusCode: number;\n  readonly responseTimeMs: number;\n  readonly startedAt: string;\n  readonly requestHeaders: Record<string, string> | null;\n  readonly requestBody: string | null;\n  readonly responseBody: string | null;\n  readonly responseHeaders: Record<string, string> | null;\n  readonly contentType: string | null;\n  readonly responseSize: number;\n  readonly requestBodyTruncated: boolean;\n  readonly responseBodyTruncated: boolean;\n  readonly isBinary: boolean;\n  readonly error: string | null;\n}\n\nexport interface TestArtifacts {\n  readonly screenshot?: string;\n  readonly video?: string;\n}\n\nexport type TestStatus = 'passed' | 'failed' | 'skipped' | 'flaky' | 'timedout';\n\nexport type TestType = 'e2e' | 'api' | 'unit' | 'unknown';\n\nexport interface FailureDiagnostic {\n  readonly message: string;\n  readonly line: number | null;\n  readonly code: string | null;\n  readonly stack: string | null;\n}\n\nexport interface NetworkStats {\n  readonly totalRequests: number;\n  readonly failedRequests: number;\n  readonly failedRequestUrls: string[];\n  readonly totalBytes: number;\n  readonly byType: ResourceBreakdown;\n}\n\nexport interface ResourceBreakdown {\n  readonly xhr: number;\n  readonly document: number;\n  readonly script: number;\n  readonly stylesheet: number;\n  readonly image: number;\n  readonly font: number;\n  readonly other: number;\n}\n\n// ---------------------------------------------------------------------------\n// API Call Record (captured from Playwright APIRequestContext proxy)\n// ---------------------------------------------------------------------------\n\nexport interface ApiCallRecord {\n  /** Unique call identifier within the test (e.g., \"api-call-0\") */\n  readonly id: string;\n  /** ISO 8601 timestamp when the call was initiated */\n  readonly timestamp: string;\n  /** HTTP method: GET, POST, PUT, PATCH, DELETE, HEAD, or custom via fetch() */\n  readonly method: string;\n  /** Full resolved URL (after baseURL resolution by Playwright) */\n  readonly url: string;\n  /** All request headers sent, or null if unavailable */\n  readonly requestHeaders: Record<string, string> | null;\n  /** Request payload as string (JSON-serialized for objects). Null for bodiless methods */\n  readonly requestBody: string | null;\n  /** HTTP response status code, or null if request errored before response */\n  readonly responseStatusCode: number | null;\n  /** HTTP response status text, or null if request errored before response */\n  readonly responseStatusText: string | null;\n  /** All response headers received, or null if request errored before response */\n  readonly responseHeaders: Record<string, string> | null;\n  /** Response body: string for text/JSON, base64 for binary. Null on error */\n  readonly responseBody: string | null;\n  /** Duration in milliseconds from request initiation to response received */\n  readonly responseTimeMs: number;\n  /** Whether the response body is stored as a base64-encoded binary string */\n  readonly isBinary: boolean;\n  /** Error message if the call failed (network error, timeout), null on success */\n  readonly error: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// API Assertion Types (captured from assertion tracking)\n// ---------------------------------------------------------------------------\n\n/** Categorization of the assertion being made. */\nexport type AssertionType =\n  | 'status'\n  | 'statusOk'\n  | 'header'\n  | 'bodyField'\n  | 'bodyMatch'\n  | 'bodyContains'\n  | 'custom';\n\n/** Source location where an assertion was made in the test file. */\nexport interface AssertionLocation {\n  /** Absolute or relative file path to the test file */\n  readonly file: string;\n  /** Line number (1-based) */\n  readonly line: number;\n  /** Column number (1-based), if available */\n  readonly column?: number;\n}\n\n/** A single captured assertion on API response data. */\nexport interface ApiAssertion {\n  /** Links to ApiCallRecord.id from the API proxy */\n  readonly callId: string;\n  /** Category of assertion */\n  readonly type: AssertionType;\n  /** What the test expected */\n  readonly expected: unknown;\n  /** What was actually received */\n  readonly actual: unknown;\n  /** Whether the assertion passed or failed */\n  readonly status: 'passed' | 'failed';\n  /** Source location of the assertion in the test file */\n  readonly location: AssertionLocation;\n  /** String representation of the assertion expression (best-effort) */\n  readonly expression?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Unified Timeline Types (navigation + API call steps)\n// ---------------------------------------------------------------------------\n\n/** Test identity block attached to every timeline step. */\nexport interface StepTestIdentity {\n  readonly title: string;\n  readonly fullTitle: readonly string[];\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly retries: number;\n  readonly retry: number;\n  readonly tags: readonly string[];\n  readonly failure: FailureDiagnostic | null;\n}\n\n/** Request details within an API call step. */\nexport interface ApiCallStepRequest {\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** Response details within an API call step. */\nexport interface ApiCallStepResponse {\n  readonly statusCode: number;\n  readonly statusText: string;\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** An assertion linked to an API call step (callId omitted — implicit from parent). */\nexport interface StepAssertion {\n  readonly type: AssertionType;\n  readonly expected: unknown;\n  readonly actual: unknown;\n  readonly status: 'passed' | 'failed';\n  readonly location: AssertionLocation;\n  readonly expression?: string;\n}\n\n/** A browser navigation event in the unified timeline. */\nexport interface NavigationStep {\n  readonly index: number;\n  readonly type: 'navigation';\n  readonly url: string;\n  readonly timestamp: string;\n  readonly durationOnUrl: number;\n  readonly navigationType: NavigationType;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** An API request event in the unified timeline. */\nexport interface ApiCallStep {\n  readonly index: number;\n  readonly type: 'api_call';\n  readonly callId: string;\n  readonly method: string;\n  readonly url: string;\n  readonly timestamp: string;\n  readonly responseTime: number | null;\n  readonly request: ApiCallStepRequest;\n  readonly response: ApiCallStepResponse | null;\n  readonly error?: string | null;\n  readonly assertions: readonly StepAssertion[];\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** Discriminated union of all timeline step types. */\nexport type TimelineStep = NavigationStep | ApiCallStep;\n\n// ---------------------------------------------------------------------------\n// Action Step Types (Playwright test step capture)\n// ---------------------------------------------------------------------------\n\n/** Categorized type of a captured test action. */\nexport type ActionCategory = 'ui_action' | 'assertion' | 'custom_step';\n\n/** A single captured test action step. */\nexport interface ActionStep {\n  readonly title: string;\n  readonly category: ActionCategory;\n  readonly timestamp: string;\n  readonly duration: number;\n  readonly videoOffset: number | null;\n  readonly status: 'passed' | 'failed';\n  readonly error: string | null;\n  readonly children: readonly ActionStep[];\n}\n\n// ---------------------------------------------------------------------------\n// Configuration Types (reporter tuple options)\n// ---------------------------------------------------------------------------\n\nexport interface ReporterConfig {\n  readonly outputPath?: string;\n  readonly includeStackTrace?: boolean;\n  readonly includeCodeSnippets?: boolean;\n  readonly codeContextLines?: number;\n  readonly includeNetworkStats?: boolean;\n  readonly navigationTypes?: NavigationType[] | null;\n  readonly redactPatterns?: (string | RegExp)[];\n  readonly testRunId?: string | null;\n  readonly metadata?: Record<string, unknown> | null;\n  readonly openReport?: boolean;\n  readonly htmlReportPath?: string;\n  readonly includeArtifacts?: boolean;\n  /** When false, disables API call interception in the unified fixture. Default: true */\n  readonly trackApiCalls?: boolean;\n  /** When true, suppresses console summary output. Default: false */\n  readonly quiet?: boolean;\n  /** When true, captures Playwright test steps (actions). Default: true */\n  readonly includeActionSteps?: boolean;\n  /** Capture request headers for API calls. Default: true */\n  readonly captureRequestHeaders?: boolean;\n  /** Capture response headers for API calls. Default: true */\n  readonly captureResponseHeaders?: boolean;\n  /** Capture request body for API calls. Default: true */\n  readonly captureRequestBody?: boolean;\n  /** Capture response body for API calls. Default: true */\n  readonly captureResponseBody?: boolean;\n  /** Capture API assertions (both pass and fail). Default: true */\n  readonly captureAssertions?: boolean;\n  /**\n   * Header names whose values are replaced with \"[REDACTED]\".\n   * Case-insensitive matching. Default: ['authorization', 'cookie', 'set-cookie', 'x-api-key']\n   */\n  readonly redactHeaders?: string[];\n  /**\n   * Body field names whose values are replaced with \"[REDACTED]\" at any depth.\n   * Default: ['password', 'secret', 'token', 'apiKey', 'api_key']\n   */\n  readonly redactBodyFields?: string[];\n  /**\n   * Only track API calls matching these URL patterns.\n   * Default: undefined (track all)\n   */\n  readonly apiIncludeUrls?: (string | RegExp)[];\n  /**\n   * Exclude API calls matching these URL patterns. Takes precedence over include.\n   * Default: undefined (exclude none)\n   */\n  readonly apiExcludeUrls?: (string | RegExp)[];\n  /** Cloud integration configuration. Default: undefined (local mode) */\n  readonly cloud?: CloudReporterOptions;\n}\n\n// ---------------------------------------------------------------------------\n// Internal Types (fixture → reporter communication)\n// ---------------------------------------------------------------------------\n\nexport interface NavigationAnnotation {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly timestamp: string;\n  readonly domContentLoadedAt?: string;\n  readonly networkIdleAt?: string;\n  readonly networkStats?: NetworkStats;\n}\n\n// ---------------------------------------------------------------------------\n// Worker-Safe Data Payload (worker → reporter communication)\n// ---------------------------------------------------------------------------\n\n/** Consolidated data payload sent from a worker fixture to the reporter. */\nexport interface TestRelicDataPayload {\n  /** Marker to identify TestRelic attachments. Always `true`. */\n  readonly testRelicData: true;\n  /** Payload format version (semver). */\n  readonly version: string;\n  /** Navigation events collected during the test. */\n  readonly navigations: readonly NavigationAnnotation[];\n  /** Captured network requests during the test. */\n  readonly networkRequests: readonly CapturedNetworkRequest[];\n  /** API calls made via APIRequestContext proxy. */\n  readonly apiCalls: readonly ApiCallRecord[];\n  /** Assertions captured on API responses. */\n  readonly apiAssertions: readonly ApiAssertion[];\n}\n\n/** Current payload format version. */\nexport const PAYLOAD_VERSION = '1.0.0';\n\n/** Attachment name used for the consolidated payload. */\nexport const ATTACHMENT_NAME = 'testrelic-data';\n\n/** Attachment content type. */\nexport const ATTACHMENT_CONTENT_TYPE = 'application/json';\n\n/** Type guard: validates that a parsed object is a TestRelicDataPayload. */\nexport function isTestRelicDataPayload(obj: unknown): obj is TestRelicDataPayload {\n  if (typeof obj !== 'object' || obj === null) return false;\n  const record = obj as Record<string, unknown>;\n  return (\n    record.testRelicData === true &&\n    typeof record.version === 'string' &&\n    record.version.length > 0 &&\n    Array.isArray(record.navigations) &&\n    Array.isArray(record.networkRequests) &&\n    Array.isArray(record.apiCalls) &&\n    Array.isArray(record.apiAssertions)\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Cloud Integration Types\n// ---------------------------------------------------------------------------\n\n/** Upload strategy for cloud timeline data. */\nexport type UploadStrategy = 'batch' | 'realtime' | 'both';\n\n/** Current cloud/local operating mode. */\nexport type AuthMode = 'cloud' | 'local' | 'pending';\n\n/** Resolved cloud configuration, immutable after initialization. */\nexport interface CloudConfig {\n  readonly apiKey: string | null;\n  readonly endpoint: string;\n  readonly uploadStrategy: UploadStrategy;\n  readonly timeout: number;\n  readonly projectName: string | null;\n  readonly queueMaxAge: number;\n  readonly queueDirectory: string;\n}\n\n/** Mutable auth state tracked by the cloud client. */\nexport interface AuthState {\n  mode: AuthMode;\n  accessToken: string | null;\n  refreshToken: string | null;\n  expiresAt: number | null;\n  orgId: string | null;\n  orgName: string | null;\n  userId: string | null;\n  userName: string | null;\n}\n\n/** Auto-collected git information. All fields nullable. */\nexport interface GitMetadata {\n  readonly branch: string | null;\n  readonly commitSha: string | null;\n  readonly commitMessage: string | null;\n  readonly remoteUrl: string | null;\n}\n\n/** Cached project identity. */\nexport interface ProjectResolution {\n  readonly projectId: string;\n  readonly gitId: string;\n  readonly displayName: string;\n  readonly resolvedAt: number;\n  readonly apiKeyHash: string;\n}\n\n/** A single queued upload payload. */\nexport interface QueueEntry {\n  readonly version: string;\n  readonly queuedAt: string;\n  readonly reason: string;\n  readonly retryCount: number;\n  readonly targetEndpoint: string;\n  readonly method: string;\n  readonly payload: Record<string, unknown>;\n  readonly headers: Record<string, string>;\n}\n\n/** Inline cloud configuration accepted via reporter options. */\nexport interface CloudReporterOptions {\n  readonly apiKey?: string;\n  readonly endpoint?: string;\n  readonly upload?: UploadStrategy;\n  readonly timeout?: number;\n  readonly projectName?: string;\n  readonly queueMaxAge?: string;\n  readonly queueDirectory?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Merge CLI Types\n// ---------------------------------------------------------------------------\n\nexport interface MergeOptions {\n  readonly output: string;\n  readonly testRunId?: string;\n}\n","/**\n * @testrelic/core — Configurable logger\n *\n * Provides a Logger interface with a no-op default.\n * Never uses console.* directly (Constitution SDK Constraint).\n */\n\nexport interface Logger {\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n  debug(message: string, ...args: unknown[]): void;\n}\n\nexport interface LoggerOptions {\n  readonly handler?: (level: LogLevel, message: string, args: unknown[]) => void;\n}\n\nexport type LogLevel = 'info' | 'warn' | 'error' | 'debug';\n\ntype LogHandler = (level: LogLevel, message: string, args: unknown[]) => void;\n\nconst noopHandler: LogHandler = () => {};\n\nexport function createLogger(options?: LoggerOptions): Logger {\n  const handler = options?.handler ?? noopHandler;\n\n  return {\n    info(message: string, ...args: unknown[]) {\n      handler('info', message, args);\n    },\n    warn(message: string, ...args: unknown[]) {\n      handler('warn', message, args);\n    },\n    error(message: string, ...args: unknown[]) {\n      handler('error', message, args);\n    },\n    debug(message: string, ...args: unknown[]) {\n      handler('debug', message, args);\n    },\n  };\n}\n","/**\n * @testrelic/core — Structured error factory\n *\n * Machine-readable error codes for programmatic handling.\n */\n\nexport const ErrorCode = {\n  CONFIG_INVALID: 'TESTRELIC_CONFIG_INVALID',\n  OUTPUT_WRITE_FAILED: 'TESTRELIC_OUTPUT_WRITE_FAILED',\n  MERGE_INVALID_SCHEMA: 'TESTRELIC_MERGE_INVALID_SCHEMA',\n  MERGE_READ_FAILED: 'TESTRELIC_MERGE_READ_FAILED',\n  NAVIGATION_FLUSH_FAILED: 'TESTRELIC_NAVIGATION_FLUSH_FAILED',\n  CODE_EXTRACT_FAILED: 'TESTRELIC_CODE_EXTRACT_FAILED',\n  HTML_REPORT_FAILED: 'TESTRELIC_HTML_REPORT_FAILED',\n  CLOUD_AUTH_FAILED: 'TESTRELIC_CLOUD_AUTH_FAILED',\n  CLOUD_UPLOAD_FAILED: 'TESTRELIC_CLOUD_UPLOAD_FAILED',\n  CLOUD_CONFIG_INVALID: 'TESTRELIC_CLOUD_CONFIG_INVALID',\n  CLOUD_QUEUE_FAILED: 'TESTRELIC_CLOUD_QUEUE_FAILED',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\nexport class TestRelicError extends Error {\n  readonly code: ErrorCode;\n\n  constructor(code: ErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = 'TestRelicError';\n    this.code = code;\n    if (cause !== undefined) {\n      Object.defineProperty(this, 'cause', { value: cause, writable: false, enumerable: false });\n    }\n  }\n}\n\nexport function createError(\n  code: ErrorCode,\n  message: string,\n  cause?: unknown,\n): TestRelicError {\n  return new TestRelicError(code, message, cause);\n}\n","/**\n * @testrelic/core — Lightweight runtime type guards\n *\n * Hand-written guards, no runtime schema libraries (Constitution SDK Constraint).\n */\n\nimport type {\n  ReporterConfig,\n  NavigationType,\n  TestRunReport,\n  CloudConfig,\n  QueueEntry,\n  UploadStrategy,\n} from './types.js';\n\nconst NAVIGATION_TYPES = new Set<string>([\n  'goto', 'navigation', 'back', 'forward', 'refresh',\n  'spa_route', 'spa_replace', 'hash_change', 'link_click',\n  'form_submit', 'redirect', 'popstate', 'page_load',\n  'manual_record', 'fallback', 'dummy',\n]);\n\nconst DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport function isValidNavigationType(value: unknown): value is NavigationType {\n  return typeof value === 'string' && NAVIGATION_TYPES.has(value);\n}\n\nfunction hasNoPrototypePollution(obj: unknown): boolean {\n  if (typeof obj !== 'object' || obj === null) return true;\n  for (const key of Object.keys(obj)) {\n    if (DANGEROUS_KEYS.has(key)) return false;\n  }\n  return true;\n}\n\nexport function isValidConfig(input: unknown): input is ReporterConfig {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (obj.outputPath !== undefined && typeof obj.outputPath !== 'string') return false;\n  if (obj.includeStackTrace !== undefined && typeof obj.includeStackTrace !== 'boolean') return false;\n  if (obj.includeCodeSnippets !== undefined && typeof obj.includeCodeSnippets !== 'boolean') return false;\n  if (obj.codeContextLines !== undefined && typeof obj.codeContextLines !== 'number') return false;\n  if (obj.includeNetworkStats !== undefined && typeof obj.includeNetworkStats !== 'boolean') return false;\n\n  if (obj.navigationTypes !== undefined && obj.navigationTypes !== null) {\n    if (!Array.isArray(obj.navigationTypes)) return false;\n    for (const t of obj.navigationTypes) {\n      if (!isValidNavigationType(t)) return false;\n    }\n  }\n\n  if (obj.redactPatterns !== undefined) {\n    if (!Array.isArray(obj.redactPatterns)) return false;\n    for (const p of obj.redactPatterns) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.testRunId !== undefined && obj.testRunId !== null && typeof obj.testRunId !== 'string') return false;\n\n  if (obj.metadata !== undefined && obj.metadata !== null) {\n    if (typeof obj.metadata !== 'object') return false;\n    if (!hasNoPrototypePollution(obj.metadata)) return false;\n  }\n\n  if (obj.openReport !== undefined && typeof obj.openReport !== 'boolean') return false;\n  if (obj.htmlReportPath !== undefined && (typeof obj.htmlReportPath !== 'string' || obj.htmlReportPath === '')) return false;\n  if (obj.includeArtifacts !== undefined && typeof obj.includeArtifacts !== 'boolean') return false;\n\n  // API tracking configuration\n  if (obj.trackApiCalls !== undefined && typeof obj.trackApiCalls !== 'boolean') return false;\n  if (obj.captureRequestHeaders !== undefined && typeof obj.captureRequestHeaders !== 'boolean') return false;\n  if (obj.captureResponseHeaders !== undefined && typeof obj.captureResponseHeaders !== 'boolean') return false;\n  if (obj.captureRequestBody !== undefined && typeof obj.captureRequestBody !== 'boolean') return false;\n  if (obj.captureResponseBody !== undefined && typeof obj.captureResponseBody !== 'boolean') return false;\n  if (obj.captureAssertions !== undefined && typeof obj.captureAssertions !== 'boolean') return false;\n\n  if (obj.redactHeaders !== undefined) {\n    if (!Array.isArray(obj.redactHeaders)) return false;\n    for (const h of obj.redactHeaders) {\n      if (typeof h !== 'string') return false;\n    }\n  }\n\n  if (obj.redactBodyFields !== undefined) {\n    if (!Array.isArray(obj.redactBodyFields)) return false;\n    for (const f of obj.redactBodyFields) {\n      if (typeof f !== 'string') return false;\n    }\n  }\n\n  if (obj.apiIncludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiIncludeUrls)) return false;\n    for (const p of obj.apiIncludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.apiExcludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiExcludeUrls)) return false;\n    for (const p of obj.apiExcludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  return true;\n}\n\n// ---------------------------------------------------------------------------\n// Cloud Config Validation\n// ---------------------------------------------------------------------------\n\nconst API_KEY_PATTERN = /^tr[a-z]*_[a-z]+_[a-zA-Z0-9]+$/;\n\nconst UPLOAD_STRATEGIES = new Set<string>(['batch', 'realtime', 'both']);\n\nconst LOCALHOST_HOSTS = new Set(['localhost', '127.0.0.1', '0.0.0.0']);\n\nexport function isValidApiKeyFormat(value: unknown): value is string {\n  return typeof value === 'string' && API_KEY_PATTERN.test(value);\n}\n\nexport function isValidUploadStrategy(value: unknown): value is UploadStrategy {\n  return typeof value === 'string' && UPLOAD_STRATEGIES.has(value);\n}\n\nexport function isValidEndpointUrl(value: unknown): boolean {\n  if (typeof value !== 'string') return false;\n  try {\n    const url = new URL(value);\n    if (url.protocol === 'https:') return true;\n    if (url.protocol === 'http:' && LOCALHOST_HOSTS.has(url.hostname)) return true;\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function isValidCloudConfig(input: unknown): input is CloudConfig {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (obj.apiKey !== undefined && obj.apiKey !== null) {\n    if (typeof obj.apiKey !== 'string') return false;\n    if (obj.apiKey.length > 0 && !isValidApiKeyFormat(obj.apiKey)) return false;\n  }\n\n  if (obj.endpoint !== undefined) {\n    if (!isValidEndpointUrl(obj.endpoint)) return false;\n  }\n\n  if (obj.uploadStrategy !== undefined) {\n    if (!isValidUploadStrategy(obj.uploadStrategy)) return false;\n  }\n\n  if (obj.timeout !== undefined) {\n    if (typeof obj.timeout !== 'number' || obj.timeout < 1000 || obj.timeout > 120000) return false;\n  }\n\n  if (obj.projectName !== undefined && obj.projectName !== null && typeof obj.projectName !== 'string') return false;\n\n  if (obj.queueMaxAge !== undefined) {\n    if (typeof obj.queueMaxAge !== 'number' || obj.queueMaxAge < 3600000 || obj.queueMaxAge > 2592000000) return false;\n  }\n\n  if (obj.queueDirectory !== undefined) {\n    if (typeof obj.queueDirectory !== 'string') return false;\n    if (obj.queueDirectory.startsWith('/') || obj.queueDirectory.includes('..')) return false;\n  }\n\n  return true;\n}\n\nexport function isValidQueueEntry(input: unknown): input is QueueEntry {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (typeof obj.version !== 'string') return false;\n  if (typeof obj.queuedAt !== 'string') return false;\n  if (typeof obj.reason !== 'string') return false;\n  if (typeof obj.retryCount !== 'number') return false;\n  if (typeof obj.targetEndpoint !== 'string') return false;\n  if (typeof obj.method !== 'string') return false;\n  if (typeof obj.payload !== 'object' || obj.payload === null) return false;\n  if (typeof obj.headers !== 'object' || obj.headers === null) return false;\n\n  return true;\n}\n\nexport function isValidTestRunReport(value: unknown): value is TestRunReport {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.schemaVersion !== 'string') return false;\n  if (typeof obj.testRunId !== 'string') return false;\n  if (typeof obj.startedAt !== 'string') return false;\n  if (typeof obj.completedAt !== 'string') return false;\n  if (typeof obj.totalDuration !== 'number') return false;\n  if (typeof obj.summary !== 'object' || obj.summary === null) return false;\n  if (!Array.isArray(obj.timeline)) return false;\n\n  const summary = obj.summary as Record<string, unknown>;\n  if (typeof summary.total !== 'number') return false;\n  if (typeof summary.passed !== 'number') return false;\n  if (typeof summary.failed !== 'number') return false;\n  if (typeof summary.flaky !== 'number') return false;\n  if (typeof summary.skipped !== 'number') return false;\n  // timedout is optional for backward compat with schema 1.0.0\n  if (summary.timedout !== undefined && typeof summary.timedout !== 'number') return false;\n\n  return true;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -62,8 +62,9 @@ interface CIMetadata {
     readonly buildId: string | null;
     readonly commitSha: string | null;
     readonly branch: string | null;
+    readonly runUrl: string | null;
 }
-type CIProvider = 'github-actions' | 'gitlab-ci' | 'jenkins' | 'circleci' | 'unknown';
+type CIProvider = 'github-actions' | 'gitlab-ci' | 'jenkins' | 'circleci' | 'bitbucket-pipelines' | 'unknown';
 interface TimelineEntry {
     readonly url: string;
     readonly navigationType: NavigationType;
@@ -327,6 +328,8 @@ interface ReporterConfig {
      * Default: undefined (exclude none)
      */
     readonly apiExcludeUrls?: (string | RegExp)[];
+    /** Cloud integration configuration. Default: undefined (local mode) */
+    readonly cloud?: CloudReporterOptions;
 }
 interface NavigationAnnotation {
     readonly url: string;
@@ -359,6 +362,67 @@ declare const ATTACHMENT_NAME = "testrelic-data";
 declare const ATTACHMENT_CONTENT_TYPE = "application/json";
 /** Type guard: validates that a parsed object is a TestRelicDataPayload. */
 declare function isTestRelicDataPayload(obj: unknown): obj is TestRelicDataPayload;
+/** Upload strategy for cloud timeline data. */
+type UploadStrategy = 'batch' | 'realtime' | 'both';
+/** Current cloud/local operating mode. */
+type AuthMode = 'cloud' | 'local' | 'pending';
+/** Resolved cloud configuration, immutable after initialization. */
+interface CloudConfig {
+    readonly apiKey: string | null;
+    readonly endpoint: string;
+    readonly uploadStrategy: UploadStrategy;
+    readonly timeout: number;
+    readonly projectName: string | null;
+    readonly queueMaxAge: number;
+    readonly queueDirectory: string;
+}
+/** Mutable auth state tracked by the cloud client. */
+interface AuthState {
+    mode: AuthMode;
+    accessToken: string | null;
+    refreshToken: string | null;
+    expiresAt: number | null;
+    orgId: string | null;
+    orgName: string | null;
+    userId: string | null;
+    userName: string | null;
+}
+/** Auto-collected git information. All fields nullable. */
+interface GitMetadata {
+    readonly branch: string | null;
+    readonly commitSha: string | null;
+    readonly commitMessage: string | null;
+    readonly remoteUrl: string | null;
+}
+/** Cached project identity. */
+interface ProjectResolution {
+    readonly projectId: string;
+    readonly gitId: string;
+    readonly displayName: string;
+    readonly resolvedAt: number;
+    readonly apiKeyHash: string;
+}
+/** A single queued upload payload. */
+interface QueueEntry {
+    readonly version: string;
+    readonly queuedAt: string;
+    readonly reason: string;
+    readonly retryCount: number;
+    readonly targetEndpoint: string;
+    readonly method: string;
+    readonly payload: Record<string, unknown>;
+    readonly headers: Record<string, string>;
+}
+/** Inline cloud configuration accepted via reporter options. */
+interface CloudReporterOptions {
+    readonly apiKey?: string;
+    readonly endpoint?: string;
+    readonly upload?: UploadStrategy;
+    readonly timeout?: number;
+    readonly projectName?: string;
+    readonly queueMaxAge?: string;
+    readonly queueDirectory?: string;
+}
 interface MergeOptions {
     readonly output: string;
     readonly testRunId?: string;
@@ -395,6 +459,10 @@ declare const ErrorCode: {
     readonly NAVIGATION_FLUSH_FAILED: "TESTRELIC_NAVIGATION_FLUSH_FAILED";
     readonly CODE_EXTRACT_FAILED: "TESTRELIC_CODE_EXTRACT_FAILED";
     readonly HTML_REPORT_FAILED: "TESTRELIC_HTML_REPORT_FAILED";
+    readonly CLOUD_AUTH_FAILED: "TESTRELIC_CLOUD_AUTH_FAILED";
+    readonly CLOUD_UPLOAD_FAILED: "TESTRELIC_CLOUD_UPLOAD_FAILED";
+    readonly CLOUD_CONFIG_INVALID: "TESTRELIC_CLOUD_CONFIG_INVALID";
+    readonly CLOUD_QUEUE_FAILED: "TESTRELIC_CLOUD_QUEUE_FAILED";
 };
 type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
 declare class TestRelicError extends Error {
@@ -411,6 +479,11 @@ declare function createError(code: ErrorCode, message: string, cause?: unknown):
 
 declare function isValidNavigationType(value: unknown): value is NavigationType;
 declare function isValidConfig(input: unknown): input is ReporterConfig;
+declare function isValidApiKeyFormat(value: unknown): value is string;
+declare function isValidUploadStrategy(value: unknown): value is UploadStrategy;
+declare function isValidEndpointUrl(value: unknown): boolean;
+declare function isValidCloudConfig(input: unknown): input is CloudConfig;
+declare function isValidQueueEntry(input: unknown): input is QueueEntry;
 declare function isValidTestRunReport(value: unknown): value is TestRunReport;
 
-export { ATTACHMENT_CONTENT_TYPE, ATTACHMENT_NAME, type ActionCategory, type ActionStep, type ApiAssertion, type ApiCallRecord, type ApiCallStep, type ApiCallStepRequest, type ApiCallStepResponse, type AssertionLocation, type AssertionType, type CIMetadata, type CIProvider, type CapturedNetworkRequest, ErrorCode, type FailureDiagnostic, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationStep, type NavigationType, type NetworkStats, PAYLOAD_VERSION, type ReporterConfig, type ResourceBreakdown, type ResourceType, type StepAssertion, type StepTestIdentity, type Summary, type TestArtifacts, type TestRelicDataPayload, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TestType, type TimelineEntry, type TimelineStep, createError, createLogger, isTestRelicDataPayload, isValidConfig, isValidNavigationType, isValidTestRunReport };
+export { ATTACHMENT_CONTENT_TYPE, ATTACHMENT_NAME, type ActionCategory, type ActionStep, type ApiAssertion, type ApiCallRecord, type ApiCallStep, type ApiCallStepRequest, type ApiCallStepResponse, type AssertionLocation, type AssertionType, type AuthMode, type AuthState, type CIMetadata, type CIProvider, type CapturedNetworkRequest, type CloudConfig, type CloudReporterOptions, ErrorCode, type FailureDiagnostic, type GitMetadata, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationStep, type NavigationType, type NetworkStats, PAYLOAD_VERSION, type ProjectResolution, type QueueEntry, type ReporterConfig, type ResourceBreakdown, type ResourceType, type StepAssertion, type StepTestIdentity, type Summary, type TestArtifacts, type TestRelicDataPayload, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TestType, type TimelineEntry, type TimelineStep, type UploadStrategy, createError, createLogger, isTestRelicDataPayload, isValidApiKeyFormat, isValidCloudConfig, isValidConfig, isValidEndpointUrl, isValidNavigationType, isValidQueueEntry, isValidTestRunReport, isValidUploadStrategy };

package/dist/index.d.ts

@@ -62,8 +62,9 @@ interface CIMetadata {
     readonly buildId: string | null;
     readonly commitSha: string | null;
     readonly branch: string | null;
+    readonly runUrl: string | null;
 }
-type CIProvider = 'github-actions' | 'gitlab-ci' | 'jenkins' | 'circleci' | 'unknown';
+type CIProvider = 'github-actions' | 'gitlab-ci' | 'jenkins' | 'circleci' | 'bitbucket-pipelines' | 'unknown';
 interface TimelineEntry {
     readonly url: string;
     readonly navigationType: NavigationType;
@@ -327,6 +328,8 @@ interface ReporterConfig {
      * Default: undefined (exclude none)
      */
     readonly apiExcludeUrls?: (string | RegExp)[];
+    /** Cloud integration configuration. Default: undefined (local mode) */
+    readonly cloud?: CloudReporterOptions;
 }
 interface NavigationAnnotation {
     readonly url: string;
@@ -359,6 +362,67 @@ declare const ATTACHMENT_NAME = "testrelic-data";
 declare const ATTACHMENT_CONTENT_TYPE = "application/json";
 /** Type guard: validates that a parsed object is a TestRelicDataPayload. */
 declare function isTestRelicDataPayload(obj: unknown): obj is TestRelicDataPayload;
+/** Upload strategy for cloud timeline data. */
+type UploadStrategy = 'batch' | 'realtime' | 'both';
+/** Current cloud/local operating mode. */
+type AuthMode = 'cloud' | 'local' | 'pending';
+/** Resolved cloud configuration, immutable after initialization. */
+interface CloudConfig {
+    readonly apiKey: string | null;
+    readonly endpoint: string;
+    readonly uploadStrategy: UploadStrategy;
+    readonly timeout: number;
+    readonly projectName: string | null;
+    readonly queueMaxAge: number;
+    readonly queueDirectory: string;
+}
+/** Mutable auth state tracked by the cloud client. */
+interface AuthState {
+    mode: AuthMode;
+    accessToken: string | null;
+    refreshToken: string | null;
+    expiresAt: number | null;
+    orgId: string | null;
+    orgName: string | null;
+    userId: string | null;
+    userName: string | null;
+}
+/** Auto-collected git information. All fields nullable. */
+interface GitMetadata {
+    readonly branch: string | null;
+    readonly commitSha: string | null;
+    readonly commitMessage: string | null;
+    readonly remoteUrl: string | null;
+}
+/** Cached project identity. */
+interface ProjectResolution {
+    readonly projectId: string;
+    readonly gitId: string;
+    readonly displayName: string;
+    readonly resolvedAt: number;
+    readonly apiKeyHash: string;
+}
+/** A single queued upload payload. */
+interface QueueEntry {
+    readonly version: string;
+    readonly queuedAt: string;
+    readonly reason: string;
+    readonly retryCount: number;
+    readonly targetEndpoint: string;
+    readonly method: string;
+    readonly payload: Record<string, unknown>;
+    readonly headers: Record<string, string>;
+}
+/** Inline cloud configuration accepted via reporter options. */
+interface CloudReporterOptions {
+    readonly apiKey?: string;
+    readonly endpoint?: string;
+    readonly upload?: UploadStrategy;
+    readonly timeout?: number;
+    readonly projectName?: string;
+    readonly queueMaxAge?: string;
+    readonly queueDirectory?: string;
+}
 interface MergeOptions {
     readonly output: string;
     readonly testRunId?: string;
@@ -395,6 +459,10 @@ declare const ErrorCode: {
     readonly NAVIGATION_FLUSH_FAILED: "TESTRELIC_NAVIGATION_FLUSH_FAILED";
     readonly CODE_EXTRACT_FAILED: "TESTRELIC_CODE_EXTRACT_FAILED";
     readonly HTML_REPORT_FAILED: "TESTRELIC_HTML_REPORT_FAILED";
+    readonly CLOUD_AUTH_FAILED: "TESTRELIC_CLOUD_AUTH_FAILED";
+    readonly CLOUD_UPLOAD_FAILED: "TESTRELIC_CLOUD_UPLOAD_FAILED";
+    readonly CLOUD_CONFIG_INVALID: "TESTRELIC_CLOUD_CONFIG_INVALID";
+    readonly CLOUD_QUEUE_FAILED: "TESTRELIC_CLOUD_QUEUE_FAILED";
 };
 type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
 declare class TestRelicError extends Error {
@@ -411,6 +479,11 @@ declare function createError(code: ErrorCode, message: string, cause?: unknown):
 
 declare function isValidNavigationType(value: unknown): value is NavigationType;
 declare function isValidConfig(input: unknown): input is ReporterConfig;
+declare function isValidApiKeyFormat(value: unknown): value is string;
+declare function isValidUploadStrategy(value: unknown): value is UploadStrategy;
+declare function isValidEndpointUrl(value: unknown): boolean;
+declare function isValidCloudConfig(input: unknown): input is CloudConfig;
+declare function isValidQueueEntry(input: unknown): input is QueueEntry;
 declare function isValidTestRunReport(value: unknown): value is TestRunReport;
 
-export { ATTACHMENT_CONTENT_TYPE, ATTACHMENT_NAME, type ActionCategory, type ActionStep, type ApiAssertion, type ApiCallRecord, type ApiCallStep, type ApiCallStepRequest, type ApiCallStepResponse, type AssertionLocation, type AssertionType, type CIMetadata, type CIProvider, type CapturedNetworkRequest, ErrorCode, type FailureDiagnostic, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationStep, type NavigationType, type NetworkStats, PAYLOAD_VERSION, type ReporterConfig, type ResourceBreakdown, type ResourceType, type StepAssertion, type StepTestIdentity, type Summary, type TestArtifacts, type TestRelicDataPayload, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TestType, type TimelineEntry, type TimelineStep, createError, createLogger, isTestRelicDataPayload, isValidConfig, isValidNavigationType, isValidTestRunReport };
+export { ATTACHMENT_CONTENT_TYPE, ATTACHMENT_NAME, type ActionCategory, type ActionStep, type ApiAssertion, type ApiCallRecord, type ApiCallStep, type ApiCallStepRequest, type ApiCallStepResponse, type AssertionLocation, type AssertionType, type AuthMode, type AuthState, type CIMetadata, type CIProvider, type CapturedNetworkRequest, type CloudConfig, type CloudReporterOptions, ErrorCode, type FailureDiagnostic, type GitMetadata, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationStep, type NavigationType, type NetworkStats, PAYLOAD_VERSION, type ProjectResolution, type QueueEntry, type ReporterConfig, type ResourceBreakdown, type ResourceType, type StepAssertion, type StepTestIdentity, type Summary, type TestArtifacts, type TestRelicDataPayload, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TestType, type TimelineEntry, type TimelineStep, type UploadStrategy, createError, createLogger, isTestRelicDataPayload, isValidApiKeyFormat, isValidCloudConfig, isValidConfig, isValidEndpointUrl, isValidNavigationType, isValidQueueEntry, isValidTestRunReport, isValidUploadStrategy };

package/dist/index.js

@@ -37,7 +37,11 @@ var ErrorCode = {
   MERGE_READ_FAILED: "TESTRELIC_MERGE_READ_FAILED",
   NAVIGATION_FLUSH_FAILED: "TESTRELIC_NAVIGATION_FLUSH_FAILED",
   CODE_EXTRACT_FAILED: "TESTRELIC_CODE_EXTRACT_FAILED",
-  HTML_REPORT_FAILED: "TESTRELIC_HTML_REPORT_FAILED"
+  HTML_REPORT_FAILED: "TESTRELIC_HTML_REPORT_FAILED",
+  CLOUD_AUTH_FAILED: "TESTRELIC_CLOUD_AUTH_FAILED",
+  CLOUD_UPLOAD_FAILED: "TESTRELIC_CLOUD_UPLOAD_FAILED",
+  CLOUD_CONFIG_INVALID: "TESTRELIC_CLOUD_CONFIG_INVALID",
+  CLOUD_QUEUE_FAILED: "TESTRELIC_CLOUD_QUEUE_FAILED"
 };
 var TestRelicError = class extends Error {
   constructor(code, message, cause) {
@@ -144,6 +148,67 @@ function isValidConfig(input) {
   }
   return true;
 }
+var API_KEY_PATTERN = /^tr[a-z]*_[a-z]+_[a-zA-Z0-9]+$/;
+var UPLOAD_STRATEGIES = /* @__PURE__ */ new Set(["batch", "realtime", "both"]);
+var LOCALHOST_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "0.0.0.0"]);
+function isValidApiKeyFormat(value) {
+  return typeof value === "string" && API_KEY_PATTERN.test(value);
+}
+function isValidUploadStrategy(value) {
+  return typeof value === "string" && UPLOAD_STRATEGIES.has(value);
+}
+function isValidEndpointUrl(value) {
+  if (typeof value !== "string") return false;
+  try {
+    const url = new URL(value);
+    if (url.protocol === "https:") return true;
+    if (url.protocol === "http:" && LOCALHOST_HOSTS.has(url.hostname)) return true;
+    return false;
+  } catch {
+    return false;
+  }
+}
+function isValidCloudConfig(input) {
+  if (typeof input !== "object" || input === null) return false;
+  if (!hasNoPrototypePollution(input)) return false;
+  const obj = input;
+  if (obj.apiKey !== void 0 && obj.apiKey !== null) {
+    if (typeof obj.apiKey !== "string") return false;
+    if (obj.apiKey.length > 0 && !isValidApiKeyFormat(obj.apiKey)) return false;
+  }
+  if (obj.endpoint !== void 0) {
+    if (!isValidEndpointUrl(obj.endpoint)) return false;
+  }
+  if (obj.uploadStrategy !== void 0) {
+    if (!isValidUploadStrategy(obj.uploadStrategy)) return false;
+  }
+  if (obj.timeout !== void 0) {
+    if (typeof obj.timeout !== "number" || obj.timeout < 1e3 || obj.timeout > 12e4) return false;
+  }
+  if (obj.projectName !== void 0 && obj.projectName !== null && typeof obj.projectName !== "string") return false;
+  if (obj.queueMaxAge !== void 0) {
+    if (typeof obj.queueMaxAge !== "number" || obj.queueMaxAge < 36e5 || obj.queueMaxAge > 2592e6) return false;
+  }
+  if (obj.queueDirectory !== void 0) {
+    if (typeof obj.queueDirectory !== "string") return false;
+    if (obj.queueDirectory.startsWith("/") || obj.queueDirectory.includes("..")) return false;
+  }
+  return true;
+}
+function isValidQueueEntry(input) {
+  if (typeof input !== "object" || input === null) return false;
+  if (!hasNoPrototypePollution(input)) return false;
+  const obj = input;
+  if (typeof obj.version !== "string") return false;
+  if (typeof obj.queuedAt !== "string") return false;
+  if (typeof obj.reason !== "string") return false;
+  if (typeof obj.retryCount !== "number") return false;
+  if (typeof obj.targetEndpoint !== "string") return false;
+  if (typeof obj.method !== "string") return false;
+  if (typeof obj.payload !== "object" || obj.payload === null) return false;
+  if (typeof obj.headers !== "object" || obj.headers === null) return false;
+  return true;
+}
 function isValidTestRunReport(value) {
   if (typeof value !== "object" || value === null) return false;
   const obj = value;
@@ -172,8 +237,13 @@ export {
   createError,
   createLogger,
   isTestRelicDataPayload,
+  isValidApiKeyFormat,
+  isValidCloudConfig,
   isValidConfig,
+  isValidEndpointUrl,
   isValidNavigationType,
-  isValidTestRunReport
+  isValidQueueEntry,
+  isValidTestRunReport,
+  isValidUploadStrategy
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts","../src/logger.ts","../src/errors.ts","../src/validation.ts"],"sourcesContent":["/**\n * @testrelic/core — Shared type definitions\n *\n * All interfaces for the JSON output schema, reporter configuration,\n * and internal fixture-to-reporter communication.\n *\n * Schema Version: 1.0.0\n */\n\n// ---------------------------------------------------------------------------\n// Navigation Types\n// ---------------------------------------------------------------------------\n\nexport type NavigationType =\n  | 'goto'\n  | 'navigation'\n  | 'back'\n  | 'forward'\n  | 'refresh'\n  | 'spa_route'\n  | 'spa_replace'\n  | 'hash_change'\n  | 'link_click'\n  | 'form_submit'\n  | 'redirect'\n  | 'popstate'\n  | 'page_load'\n  | 'manual_record'\n  | 'fallback'\n  | 'dummy';\n\n// ---------------------------------------------------------------------------\n// Output Schema Types (JSON report structure)\n// ---------------------------------------------------------------------------\n\nexport interface TestRunReport {\n  readonly schemaVersion: string;\n  readonly testRunId: string;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly totalDuration: number;\n  readonly summary: Summary;\n  readonly ci: CIMetadata | null;\n  readonly metadata: Record<string, unknown> | null;\n  readonly timeline: readonly (TimelineEntry | TimelineStep)[];\n  readonly shardRunIds: string[] | null;\n}\n\n/** Breakdown of API calls by HTTP response status range. */\nexport interface ApiCallsByStatusRange {\n  readonly '2xx': number;\n  readonly '3xx': number;\n  readonly '4xx': number;\n  readonly '5xx': number;\n  readonly error: number;\n}\n\n/** Statistical distribution of API call response times in milliseconds. */\nexport interface ApiResponseTimeStats {\n  readonly avg: number;\n  readonly min: number;\n  readonly max: number;\n  readonly p50: number;\n  readonly p95: number;\n  readonly p99: number;\n}\n\nexport interface Summary {\n  readonly total: number;\n  readonly passed: number;\n  readonly failed: number;\n  readonly flaky: number;\n  readonly skipped: number;\n  readonly timedout: number;\n  readonly totalApiCalls: number;\n  readonly uniqueApiUrls: number;\n  readonly apiCallsByMethod: Record<string, number>;\n  readonly apiCallsByStatusRange: ApiCallsByStatusRange;\n  readonly apiResponseTime: ApiResponseTimeStats | null;\n  readonly totalAssertions: number;\n  readonly passedAssertions: number;\n  readonly failedAssertions: number;\n  readonly totalNavigations: number;\n  readonly uniqueNavigationUrls: number;\n  readonly totalTimelineSteps: number;\n  readonly totalActionSteps: number;\n  readonly actionStepsByCategory: Record<string, number>;\n}\n\nexport interface CIMetadata {\n  readonly provider: CIProvider;\n  readonly buildId: string | null;\n  readonly commitSha: string | null;\n  readonly branch: string | null;\n}\n\nexport type CIProvider =\n  | 'github-actions'\n  | 'gitlab-ci'\n  | 'jenkins'\n  | 'circleci'\n  | 'unknown';\n\nexport interface TimelineEntry {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly visitedAt: string;\n  readonly duration: number;\n  readonly specFile: string;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly tests: TestResult[];\n}\n\nexport interface TestResult {\n  readonly title: string;\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly retryCount: number;\n  readonly tags: string[];\n  readonly failure: FailureDiagnostic | null;\n  readonly testId: string;\n  readonly filePath: string;\n  readonly suiteName: string;\n  readonly testType: TestType;\n  readonly isFlaky: boolean;\n  readonly retryStatus: string | null;\n  readonly expectedStatus: TestStatus;\n  readonly actualStatus: TestStatus;\n  readonly artifacts: TestArtifacts | null;\n  readonly networkRequests: CapturedNetworkRequest[] | null;\n  readonly apiCalls: readonly ApiCallRecord[] | null;\n  readonly apiAssertions: readonly ApiAssertion[] | null;\n  readonly actions: readonly ActionStep[] | null;\n}\n\nexport type ResourceType = 'xhr' | 'document' | 'script' | 'stylesheet' | 'image' | 'font' | 'other';\n\nexport interface CapturedNetworkRequest {\n  readonly url: string;\n  readonly method: string;\n  readonly resourceType: ResourceType;\n  readonly statusCode: number;\n  readonly responseTimeMs: number;\n  readonly startedAt: string;\n  readonly requestHeaders: Record<string, string> | null;\n  readonly requestBody: string | null;\n  readonly responseBody: string | null;\n  readonly responseHeaders: Record<string, string> | null;\n  readonly contentType: string | null;\n  readonly responseSize: number;\n  readonly requestBodyTruncated: boolean;\n  readonly responseBodyTruncated: boolean;\n  readonly isBinary: boolean;\n  readonly error: string | null;\n}\n\nexport interface TestArtifacts {\n  readonly screenshot?: string;\n  readonly video?: string;\n}\n\nexport type TestStatus = 'passed' | 'failed' | 'skipped' | 'flaky' | 'timedout';\n\nexport type TestType = 'e2e' | 'api' | 'unit' | 'unknown';\n\nexport interface FailureDiagnostic {\n  readonly message: string;\n  readonly line: number | null;\n  readonly code: string | null;\n  readonly stack: string | null;\n}\n\nexport interface NetworkStats {\n  readonly totalRequests: number;\n  readonly failedRequests: number;\n  readonly failedRequestUrls: string[];\n  readonly totalBytes: number;\n  readonly byType: ResourceBreakdown;\n}\n\nexport interface ResourceBreakdown {\n  readonly xhr: number;\n  readonly document: number;\n  readonly script: number;\n  readonly stylesheet: number;\n  readonly image: number;\n  readonly font: number;\n  readonly other: number;\n}\n\n// ---------------------------------------------------------------------------\n// API Call Record (captured from Playwright APIRequestContext proxy)\n// ---------------------------------------------------------------------------\n\nexport interface ApiCallRecord {\n  /** Unique call identifier within the test (e.g., \"api-call-0\") */\n  readonly id: string;\n  /** ISO 8601 timestamp when the call was initiated */\n  readonly timestamp: string;\n  /** HTTP method: GET, POST, PUT, PATCH, DELETE, HEAD, or custom via fetch() */\n  readonly method: string;\n  /** Full resolved URL (after baseURL resolution by Playwright) */\n  readonly url: string;\n  /** All request headers sent, or null if unavailable */\n  readonly requestHeaders: Record<string, string> | null;\n  /** Request payload as string (JSON-serialized for objects). Null for bodiless methods */\n  readonly requestBody: string | null;\n  /** HTTP response status code, or null if request errored before response */\n  readonly responseStatusCode: number | null;\n  /** HTTP response status text, or null if request errored before response */\n  readonly responseStatusText: string | null;\n  /** All response headers received, or null if request errored before response */\n  readonly responseHeaders: Record<string, string> | null;\n  /** Response body: string for text/JSON, base64 for binary. Null on error */\n  readonly responseBody: string | null;\n  /** Duration in milliseconds from request initiation to response received */\n  readonly responseTimeMs: number;\n  /** Whether the response body is stored as a base64-encoded binary string */\n  readonly isBinary: boolean;\n  /** Error message if the call failed (network error, timeout), null on success */\n  readonly error: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// API Assertion Types (captured from assertion tracking)\n// ---------------------------------------------------------------------------\n\n/** Categorization of the assertion being made. */\nexport type AssertionType =\n  | 'status'\n  | 'statusOk'\n  | 'header'\n  | 'bodyField'\n  | 'bodyMatch'\n  | 'bodyContains'\n  | 'custom';\n\n/** Source location where an assertion was made in the test file. */\nexport interface AssertionLocation {\n  /** Absolute or relative file path to the test file */\n  readonly file: string;\n  /** Line number (1-based) */\n  readonly line: number;\n  /** Column number (1-based), if available */\n  readonly column?: number;\n}\n\n/** A single captured assertion on API response data. */\nexport interface ApiAssertion {\n  /** Links to ApiCallRecord.id from the API proxy */\n  readonly callId: string;\n  /** Category of assertion */\n  readonly type: AssertionType;\n  /** What the test expected */\n  readonly expected: unknown;\n  /** What was actually received */\n  readonly actual: unknown;\n  /** Whether the assertion passed or failed */\n  readonly status: 'passed' | 'failed';\n  /** Source location of the assertion in the test file */\n  readonly location: AssertionLocation;\n  /** String representation of the assertion expression (best-effort) */\n  readonly expression?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Unified Timeline Types (navigation + API call steps)\n// ---------------------------------------------------------------------------\n\n/** Test identity block attached to every timeline step. */\nexport interface StepTestIdentity {\n  readonly title: string;\n  readonly fullTitle: readonly string[];\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly retries: number;\n  readonly retry: number;\n  readonly tags: readonly string[];\n  readonly failure: FailureDiagnostic | null;\n}\n\n/** Request details within an API call step. */\nexport interface ApiCallStepRequest {\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** Response details within an API call step. */\nexport interface ApiCallStepResponse {\n  readonly statusCode: number;\n  readonly statusText: string;\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** An assertion linked to an API call step (callId omitted — implicit from parent). */\nexport interface StepAssertion {\n  readonly type: AssertionType;\n  readonly expected: unknown;\n  readonly actual: unknown;\n  readonly status: 'passed' | 'failed';\n  readonly location: AssertionLocation;\n  readonly expression?: string;\n}\n\n/** A browser navigation event in the unified timeline. */\nexport interface NavigationStep {\n  readonly index: number;\n  readonly type: 'navigation';\n  readonly url: string;\n  readonly timestamp: string;\n  readonly durationOnUrl: number;\n  readonly navigationType: NavigationType;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** An API request event in the unified timeline. */\nexport interface ApiCallStep {\n  readonly index: number;\n  readonly type: 'api_call';\n  readonly callId: string;\n  readonly method: string;\n  readonly url: string;\n  readonly timestamp: string;\n  readonly responseTime: number | null;\n  readonly request: ApiCallStepRequest;\n  readonly response: ApiCallStepResponse | null;\n  readonly error?: string | null;\n  readonly assertions: readonly StepAssertion[];\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** Discriminated union of all timeline step types. */\nexport type TimelineStep = NavigationStep | ApiCallStep;\n\n// ---------------------------------------------------------------------------\n// Action Step Types (Playwright test step capture)\n// ---------------------------------------------------------------------------\n\n/** Categorized type of a captured test action. */\nexport type ActionCategory = 'ui_action' | 'assertion' | 'custom_step';\n\n/** A single captured test action step. */\nexport interface ActionStep {\n  readonly title: string;\n  readonly category: ActionCategory;\n  readonly timestamp: string;\n  readonly duration: number;\n  readonly videoOffset: number | null;\n  readonly status: 'passed' | 'failed';\n  readonly error: string | null;\n  readonly children: readonly ActionStep[];\n}\n\n// ---------------------------------------------------------------------------\n// Configuration Types (reporter tuple options)\n// ---------------------------------------------------------------------------\n\nexport interface ReporterConfig {\n  readonly outputPath?: string;\n  readonly includeStackTrace?: boolean;\n  readonly includeCodeSnippets?: boolean;\n  readonly codeContextLines?: number;\n  readonly includeNetworkStats?: boolean;\n  readonly navigationTypes?: NavigationType[] | null;\n  readonly redactPatterns?: (string | RegExp)[];\n  readonly testRunId?: string | null;\n  readonly metadata?: Record<string, unknown> | null;\n  readonly openReport?: boolean;\n  readonly htmlReportPath?: string;\n  readonly includeArtifacts?: boolean;\n  /** When false, disables API call interception in the unified fixture. Default: true */\n  readonly trackApiCalls?: boolean;\n  /** When true, suppresses console summary output. Default: false */\n  readonly quiet?: boolean;\n  /** When true, captures Playwright test steps (actions). Default: true */\n  readonly includeActionSteps?: boolean;\n  /** Capture request headers for API calls. Default: true */\n  readonly captureRequestHeaders?: boolean;\n  /** Capture response headers for API calls. Default: true */\n  readonly captureResponseHeaders?: boolean;\n  /** Capture request body for API calls. Default: true */\n  readonly captureRequestBody?: boolean;\n  /** Capture response body for API calls. Default: true */\n  readonly captureResponseBody?: boolean;\n  /** Capture API assertions (both pass and fail). Default: true */\n  readonly captureAssertions?: boolean;\n  /**\n   * Header names whose values are replaced with \"[REDACTED]\".\n   * Case-insensitive matching. Default: ['authorization', 'cookie', 'set-cookie', 'x-api-key']\n   */\n  readonly redactHeaders?: string[];\n  /**\n   * Body field names whose values are replaced with \"[REDACTED]\" at any depth.\n   * Default: ['password', 'secret', 'token', 'apiKey', 'api_key']\n   */\n  readonly redactBodyFields?: string[];\n  /**\n   * Only track API calls matching these URL patterns.\n   * Default: undefined (track all)\n   */\n  readonly apiIncludeUrls?: (string | RegExp)[];\n  /**\n   * Exclude API calls matching these URL patterns. Takes precedence over include.\n   * Default: undefined (exclude none)\n   */\n  readonly apiExcludeUrls?: (string | RegExp)[];\n}\n\n// ---------------------------------------------------------------------------\n// Internal Types (fixture → reporter communication)\n// ---------------------------------------------------------------------------\n\nexport interface NavigationAnnotation {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly timestamp: string;\n  readonly domContentLoadedAt?: string;\n  readonly networkIdleAt?: string;\n  readonly networkStats?: NetworkStats;\n}\n\n// ---------------------------------------------------------------------------\n// Worker-Safe Data Payload (worker → reporter communication)\n// ---------------------------------------------------------------------------\n\n/** Consolidated data payload sent from a worker fixture to the reporter. */\nexport interface TestRelicDataPayload {\n  /** Marker to identify TestRelic attachments. Always `true`. */\n  readonly testRelicData: true;\n  /** Payload format version (semver). */\n  readonly version: string;\n  /** Navigation events collected during the test. */\n  readonly navigations: readonly NavigationAnnotation[];\n  /** Captured network requests during the test. */\n  readonly networkRequests: readonly CapturedNetworkRequest[];\n  /** API calls made via APIRequestContext proxy. */\n  readonly apiCalls: readonly ApiCallRecord[];\n  /** Assertions captured on API responses. */\n  readonly apiAssertions: readonly ApiAssertion[];\n}\n\n/** Current payload format version. */\nexport const PAYLOAD_VERSION = '1.0.0';\n\n/** Attachment name used for the consolidated payload. */\nexport const ATTACHMENT_NAME = 'testrelic-data';\n\n/** Attachment content type. */\nexport const ATTACHMENT_CONTENT_TYPE = 'application/json';\n\n/** Type guard: validates that a parsed object is a TestRelicDataPayload. */\nexport function isTestRelicDataPayload(obj: unknown): obj is TestRelicDataPayload {\n  if (typeof obj !== 'object' || obj === null) return false;\n  const record = obj as Record<string, unknown>;\n  return (\n    record.testRelicData === true &&\n    typeof record.version === 'string' &&\n    record.version.length > 0 &&\n    Array.isArray(record.navigations) &&\n    Array.isArray(record.networkRequests) &&\n    Array.isArray(record.apiCalls) &&\n    Array.isArray(record.apiAssertions)\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Merge CLI Types\n// ---------------------------------------------------------------------------\n\nexport interface MergeOptions {\n  readonly output: string;\n  readonly testRunId?: string;\n}\n","/**\n * @testrelic/core — Configurable logger\n *\n * Provides a Logger interface with a no-op default.\n * Never uses console.* directly (Constitution SDK Constraint).\n */\n\nexport interface Logger {\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n  debug(message: string, ...args: unknown[]): void;\n}\n\nexport interface LoggerOptions {\n  readonly handler?: (level: LogLevel, message: string, args: unknown[]) => void;\n}\n\nexport type LogLevel = 'info' | 'warn' | 'error' | 'debug';\n\ntype LogHandler = (level: LogLevel, message: string, args: unknown[]) => void;\n\nconst noopHandler: LogHandler = () => {};\n\nexport function createLogger(options?: LoggerOptions): Logger {\n  const handler = options?.handler ?? noopHandler;\n\n  return {\n    info(message: string, ...args: unknown[]) {\n      handler('info', message, args);\n    },\n    warn(message: string, ...args: unknown[]) {\n      handler('warn', message, args);\n    },\n    error(message: string, ...args: unknown[]) {\n      handler('error', message, args);\n    },\n    debug(message: string, ...args: unknown[]) {\n      handler('debug', message, args);\n    },\n  };\n}\n","/**\n * @testrelic/core — Structured error factory\n *\n * Machine-readable error codes for programmatic handling.\n */\n\nexport const ErrorCode = {\n  CONFIG_INVALID: 'TESTRELIC_CONFIG_INVALID',\n  OUTPUT_WRITE_FAILED: 'TESTRELIC_OUTPUT_WRITE_FAILED',\n  MERGE_INVALID_SCHEMA: 'TESTRELIC_MERGE_INVALID_SCHEMA',\n  MERGE_READ_FAILED: 'TESTRELIC_MERGE_READ_FAILED',\n  NAVIGATION_FLUSH_FAILED: 'TESTRELIC_NAVIGATION_FLUSH_FAILED',\n  CODE_EXTRACT_FAILED: 'TESTRELIC_CODE_EXTRACT_FAILED',\n  HTML_REPORT_FAILED: 'TESTRELIC_HTML_REPORT_FAILED',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\nexport class TestRelicError extends Error {\n  readonly code: ErrorCode;\n\n  constructor(code: ErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = 'TestRelicError';\n    this.code = code;\n    if (cause !== undefined) {\n      Object.defineProperty(this, 'cause', { value: cause, writable: false, enumerable: false });\n    }\n  }\n}\n\nexport function createError(\n  code: ErrorCode,\n  message: string,\n  cause?: unknown,\n): TestRelicError {\n  return new TestRelicError(code, message, cause);\n}\n","/**\n * @testrelic/core — Lightweight runtime type guards\n *\n * Hand-written guards, no runtime schema libraries (Constitution SDK Constraint).\n */\n\nimport type {\n  ReporterConfig,\n  NavigationType,\n  TestRunReport,\n} from './types.js';\n\nconst NAVIGATION_TYPES = new Set<string>([\n  'goto', 'navigation', 'back', 'forward', 'refresh',\n  'spa_route', 'spa_replace', 'hash_change', 'link_click',\n  'form_submit', 'redirect', 'popstate', 'page_load',\n  'manual_record', 'fallback', 'dummy',\n]);\n\nconst DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport function isValidNavigationType(value: unknown): value is NavigationType {\n  return typeof value === 'string' && NAVIGATION_TYPES.has(value);\n}\n\nfunction hasNoPrototypePollution(obj: unknown): boolean {\n  if (typeof obj !== 'object' || obj === null) return true;\n  for (const key of Object.keys(obj)) {\n    if (DANGEROUS_KEYS.has(key)) return false;\n  }\n  return true;\n}\n\nexport function isValidConfig(input: unknown): input is ReporterConfig {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (obj.outputPath !== undefined && typeof obj.outputPath !== 'string') return false;\n  if (obj.includeStackTrace !== undefined && typeof obj.includeStackTrace !== 'boolean') return false;\n  if (obj.includeCodeSnippets !== undefined && typeof obj.includeCodeSnippets !== 'boolean') return false;\n  if (obj.codeContextLines !== undefined && typeof obj.codeContextLines !== 'number') return false;\n  if (obj.includeNetworkStats !== undefined && typeof obj.includeNetworkStats !== 'boolean') return false;\n\n  if (obj.navigationTypes !== undefined && obj.navigationTypes !== null) {\n    if (!Array.isArray(obj.navigationTypes)) return false;\n    for (const t of obj.navigationTypes) {\n      if (!isValidNavigationType(t)) return false;\n    }\n  }\n\n  if (obj.redactPatterns !== undefined) {\n    if (!Array.isArray(obj.redactPatterns)) return false;\n    for (const p of obj.redactPatterns) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.testRunId !== undefined && obj.testRunId !== null && typeof obj.testRunId !== 'string') return false;\n\n  if (obj.metadata !== undefined && obj.metadata !== null) {\n    if (typeof obj.metadata !== 'object') return false;\n    if (!hasNoPrototypePollution(obj.metadata)) return false;\n  }\n\n  if (obj.openReport !== undefined && typeof obj.openReport !== 'boolean') return false;\n  if (obj.htmlReportPath !== undefined && (typeof obj.htmlReportPath !== 'string' || obj.htmlReportPath === '')) return false;\n  if (obj.includeArtifacts !== undefined && typeof obj.includeArtifacts !== 'boolean') return false;\n\n  // API tracking configuration\n  if (obj.trackApiCalls !== undefined && typeof obj.trackApiCalls !== 'boolean') return false;\n  if (obj.captureRequestHeaders !== undefined && typeof obj.captureRequestHeaders !== 'boolean') return false;\n  if (obj.captureResponseHeaders !== undefined && typeof obj.captureResponseHeaders !== 'boolean') return false;\n  if (obj.captureRequestBody !== undefined && typeof obj.captureRequestBody !== 'boolean') return false;\n  if (obj.captureResponseBody !== undefined && typeof obj.captureResponseBody !== 'boolean') return false;\n  if (obj.captureAssertions !== undefined && typeof obj.captureAssertions !== 'boolean') return false;\n\n  if (obj.redactHeaders !== undefined) {\n    if (!Array.isArray(obj.redactHeaders)) return false;\n    for (const h of obj.redactHeaders) {\n      if (typeof h !== 'string') return false;\n    }\n  }\n\n  if (obj.redactBodyFields !== undefined) {\n    if (!Array.isArray(obj.redactBodyFields)) return false;\n    for (const f of obj.redactBodyFields) {\n      if (typeof f !== 'string') return false;\n    }\n  }\n\n  if (obj.apiIncludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiIncludeUrls)) return false;\n    for (const p of obj.apiIncludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.apiExcludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiExcludeUrls)) return false;\n    for (const p of obj.apiExcludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  return true;\n}\n\nexport function isValidTestRunReport(value: unknown): value is TestRunReport {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.schemaVersion !== 'string') return false;\n  if (typeof obj.testRunId !== 'string') return false;\n  if (typeof obj.startedAt !== 'string') return false;\n  if (typeof obj.completedAt !== 'string') return false;\n  if (typeof obj.totalDuration !== 'number') return false;\n  if (typeof obj.summary !== 'object' || obj.summary === null) return false;\n  if (!Array.isArray(obj.timeline)) return false;\n\n  const summary = obj.summary as Record<string, unknown>;\n  if (typeof summary.total !== 'number') return false;\n  if (typeof summary.passed !== 'number') return false;\n  if (typeof summary.failed !== 'number') return false;\n  if (typeof summary.flaky !== 'number') return false;\n  if (typeof summary.skipped !== 'number') return false;\n  // timedout is optional for backward compat with schema 1.0.0\n  if (summary.timedout !== undefined && typeof summary.timedout !== 'number') return false;\n\n  return true;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/types.ts","../src/logger.ts","../src/errors.ts","../src/validation.ts"],"sourcesContent":["/**\n * @testrelic/core — Shared type definitions\n *\n * All interfaces for the JSON output schema, reporter configuration,\n * and internal fixture-to-reporter communication.\n *\n * Schema Version: 1.0.0\n */\n\n// ---------------------------------------------------------------------------\n// Navigation Types\n// ---------------------------------------------------------------------------\n\nexport type NavigationType =\n  | 'goto'\n  | 'navigation'\n  | 'back'\n  | 'forward'\n  | 'refresh'\n  | 'spa_route'\n  | 'spa_replace'\n  | 'hash_change'\n  | 'link_click'\n  | 'form_submit'\n  | 'redirect'\n  | 'popstate'\n  | 'page_load'\n  | 'manual_record'\n  | 'fallback'\n  | 'dummy';\n\n// ---------------------------------------------------------------------------\n// Output Schema Types (JSON report structure)\n// ---------------------------------------------------------------------------\n\nexport interface TestRunReport {\n  readonly schemaVersion: string;\n  readonly testRunId: string;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly totalDuration: number;\n  readonly summary: Summary;\n  readonly ci: CIMetadata | null;\n  readonly metadata: Record<string, unknown> | null;\n  readonly timeline: readonly (TimelineEntry | TimelineStep)[];\n  readonly shardRunIds: string[] | null;\n}\n\n/** Breakdown of API calls by HTTP response status range. */\nexport interface ApiCallsByStatusRange {\n  readonly '2xx': number;\n  readonly '3xx': number;\n  readonly '4xx': number;\n  readonly '5xx': number;\n  readonly error: number;\n}\n\n/** Statistical distribution of API call response times in milliseconds. */\nexport interface ApiResponseTimeStats {\n  readonly avg: number;\n  readonly min: number;\n  readonly max: number;\n  readonly p50: number;\n  readonly p95: number;\n  readonly p99: number;\n}\n\nexport interface Summary {\n  readonly total: number;\n  readonly passed: number;\n  readonly failed: number;\n  readonly flaky: number;\n  readonly skipped: number;\n  readonly timedout: number;\n  readonly totalApiCalls: number;\n  readonly uniqueApiUrls: number;\n  readonly apiCallsByMethod: Record<string, number>;\n  readonly apiCallsByStatusRange: ApiCallsByStatusRange;\n  readonly apiResponseTime: ApiResponseTimeStats | null;\n  readonly totalAssertions: number;\n  readonly passedAssertions: number;\n  readonly failedAssertions: number;\n  readonly totalNavigations: number;\n  readonly uniqueNavigationUrls: number;\n  readonly totalTimelineSteps: number;\n  readonly totalActionSteps: number;\n  readonly actionStepsByCategory: Record<string, number>;\n}\n\nexport interface CIMetadata {\n  readonly provider: CIProvider;\n  readonly buildId: string | null;\n  readonly commitSha: string | null;\n  readonly branch: string | null;\n  readonly runUrl: string | null;\n}\n\nexport type CIProvider =\n  | 'github-actions'\n  | 'gitlab-ci'\n  | 'jenkins'\n  | 'circleci'\n  | 'bitbucket-pipelines'\n  | 'unknown';\n\nexport interface TimelineEntry {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly visitedAt: string;\n  readonly duration: number;\n  readonly specFile: string;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly tests: TestResult[];\n}\n\nexport interface TestResult {\n  readonly title: string;\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly startedAt: string;\n  readonly completedAt: string;\n  readonly retryCount: number;\n  readonly tags: string[];\n  readonly failure: FailureDiagnostic | null;\n  readonly testId: string;\n  readonly filePath: string;\n  readonly suiteName: string;\n  readonly testType: TestType;\n  readonly isFlaky: boolean;\n  readonly retryStatus: string | null;\n  readonly expectedStatus: TestStatus;\n  readonly actualStatus: TestStatus;\n  readonly artifacts: TestArtifacts | null;\n  readonly networkRequests: CapturedNetworkRequest[] | null;\n  readonly apiCalls: readonly ApiCallRecord[] | null;\n  readonly apiAssertions: readonly ApiAssertion[] | null;\n  readonly actions: readonly ActionStep[] | null;\n}\n\nexport type ResourceType = 'xhr' | 'document' | 'script' | 'stylesheet' | 'image' | 'font' | 'other';\n\nexport interface CapturedNetworkRequest {\n  readonly url: string;\n  readonly method: string;\n  readonly resourceType: ResourceType;\n  readonly statusCode: number;\n  readonly responseTimeMs: number;\n  readonly startedAt: string;\n  readonly requestHeaders: Record<string, string> | null;\n  readonly requestBody: string | null;\n  readonly responseBody: string | null;\n  readonly responseHeaders: Record<string, string> | null;\n  readonly contentType: string | null;\n  readonly responseSize: number;\n  readonly requestBodyTruncated: boolean;\n  readonly responseBodyTruncated: boolean;\n  readonly isBinary: boolean;\n  readonly error: string | null;\n}\n\nexport interface TestArtifacts {\n  readonly screenshot?: string;\n  readonly video?: string;\n}\n\nexport type TestStatus = 'passed' | 'failed' | 'skipped' | 'flaky' | 'timedout';\n\nexport type TestType = 'e2e' | 'api' | 'unit' | 'unknown';\n\nexport interface FailureDiagnostic {\n  readonly message: string;\n  readonly line: number | null;\n  readonly code: string | null;\n  readonly stack: string | null;\n}\n\nexport interface NetworkStats {\n  readonly totalRequests: number;\n  readonly failedRequests: number;\n  readonly failedRequestUrls: string[];\n  readonly totalBytes: number;\n  readonly byType: ResourceBreakdown;\n}\n\nexport interface ResourceBreakdown {\n  readonly xhr: number;\n  readonly document: number;\n  readonly script: number;\n  readonly stylesheet: number;\n  readonly image: number;\n  readonly font: number;\n  readonly other: number;\n}\n\n// ---------------------------------------------------------------------------\n// API Call Record (captured from Playwright APIRequestContext proxy)\n// ---------------------------------------------------------------------------\n\nexport interface ApiCallRecord {\n  /** Unique call identifier within the test (e.g., \"api-call-0\") */\n  readonly id: string;\n  /** ISO 8601 timestamp when the call was initiated */\n  readonly timestamp: string;\n  /** HTTP method: GET, POST, PUT, PATCH, DELETE, HEAD, or custom via fetch() */\n  readonly method: string;\n  /** Full resolved URL (after baseURL resolution by Playwright) */\n  readonly url: string;\n  /** All request headers sent, or null if unavailable */\n  readonly requestHeaders: Record<string, string> | null;\n  /** Request payload as string (JSON-serialized for objects). Null for bodiless methods */\n  readonly requestBody: string | null;\n  /** HTTP response status code, or null if request errored before response */\n  readonly responseStatusCode: number | null;\n  /** HTTP response status text, or null if request errored before response */\n  readonly responseStatusText: string | null;\n  /** All response headers received, or null if request errored before response */\n  readonly responseHeaders: Record<string, string> | null;\n  /** Response body: string for text/JSON, base64 for binary. Null on error */\n  readonly responseBody: string | null;\n  /** Duration in milliseconds from request initiation to response received */\n  readonly responseTimeMs: number;\n  /** Whether the response body is stored as a base64-encoded binary string */\n  readonly isBinary: boolean;\n  /** Error message if the call failed (network error, timeout), null on success */\n  readonly error: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// API Assertion Types (captured from assertion tracking)\n// ---------------------------------------------------------------------------\n\n/** Categorization of the assertion being made. */\nexport type AssertionType =\n  | 'status'\n  | 'statusOk'\n  | 'header'\n  | 'bodyField'\n  | 'bodyMatch'\n  | 'bodyContains'\n  | 'custom';\n\n/** Source location where an assertion was made in the test file. */\nexport interface AssertionLocation {\n  /** Absolute or relative file path to the test file */\n  readonly file: string;\n  /** Line number (1-based) */\n  readonly line: number;\n  /** Column number (1-based), if available */\n  readonly column?: number;\n}\n\n/** A single captured assertion on API response data. */\nexport interface ApiAssertion {\n  /** Links to ApiCallRecord.id from the API proxy */\n  readonly callId: string;\n  /** Category of assertion */\n  readonly type: AssertionType;\n  /** What the test expected */\n  readonly expected: unknown;\n  /** What was actually received */\n  readonly actual: unknown;\n  /** Whether the assertion passed or failed */\n  readonly status: 'passed' | 'failed';\n  /** Source location of the assertion in the test file */\n  readonly location: AssertionLocation;\n  /** String representation of the assertion expression (best-effort) */\n  readonly expression?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Unified Timeline Types (navigation + API call steps)\n// ---------------------------------------------------------------------------\n\n/** Test identity block attached to every timeline step. */\nexport interface StepTestIdentity {\n  readonly title: string;\n  readonly fullTitle: readonly string[];\n  readonly status: TestStatus;\n  readonly duration: number;\n  readonly retries: number;\n  readonly retry: number;\n  readonly tags: readonly string[];\n  readonly failure: FailureDiagnostic | null;\n}\n\n/** Request details within an API call step. */\nexport interface ApiCallStepRequest {\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** Response details within an API call step. */\nexport interface ApiCallStepResponse {\n  readonly statusCode: number;\n  readonly statusText: string;\n  readonly headers: Record<string, string> | null;\n  readonly body: unknown;\n}\n\n/** An assertion linked to an API call step (callId omitted — implicit from parent). */\nexport interface StepAssertion {\n  readonly type: AssertionType;\n  readonly expected: unknown;\n  readonly actual: unknown;\n  readonly status: 'passed' | 'failed';\n  readonly location: AssertionLocation;\n  readonly expression?: string;\n}\n\n/** A browser navigation event in the unified timeline. */\nexport interface NavigationStep {\n  readonly index: number;\n  readonly type: 'navigation';\n  readonly url: string;\n  readonly timestamp: string;\n  readonly durationOnUrl: number;\n  readonly navigationType: NavigationType;\n  readonly domContentLoadedAt: string | null;\n  readonly networkIdleAt: string | null;\n  readonly networkStats: NetworkStats | null;\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** An API request event in the unified timeline. */\nexport interface ApiCallStep {\n  readonly index: number;\n  readonly type: 'api_call';\n  readonly callId: string;\n  readonly method: string;\n  readonly url: string;\n  readonly timestamp: string;\n  readonly responseTime: number | null;\n  readonly request: ApiCallStepRequest;\n  readonly response: ApiCallStepResponse | null;\n  readonly error?: string | null;\n  readonly assertions: readonly StepAssertion[];\n  readonly specFile: string;\n  readonly test: StepTestIdentity;\n}\n\n/** Discriminated union of all timeline step types. */\nexport type TimelineStep = NavigationStep | ApiCallStep;\n\n// ---------------------------------------------------------------------------\n// Action Step Types (Playwright test step capture)\n// ---------------------------------------------------------------------------\n\n/** Categorized type of a captured test action. */\nexport type ActionCategory = 'ui_action' | 'assertion' | 'custom_step';\n\n/** A single captured test action step. */\nexport interface ActionStep {\n  readonly title: string;\n  readonly category: ActionCategory;\n  readonly timestamp: string;\n  readonly duration: number;\n  readonly videoOffset: number | null;\n  readonly status: 'passed' | 'failed';\n  readonly error: string | null;\n  readonly children: readonly ActionStep[];\n}\n\n// ---------------------------------------------------------------------------\n// Configuration Types (reporter tuple options)\n// ---------------------------------------------------------------------------\n\nexport interface ReporterConfig {\n  readonly outputPath?: string;\n  readonly includeStackTrace?: boolean;\n  readonly includeCodeSnippets?: boolean;\n  readonly codeContextLines?: number;\n  readonly includeNetworkStats?: boolean;\n  readonly navigationTypes?: NavigationType[] | null;\n  readonly redactPatterns?: (string | RegExp)[];\n  readonly testRunId?: string | null;\n  readonly metadata?: Record<string, unknown> | null;\n  readonly openReport?: boolean;\n  readonly htmlReportPath?: string;\n  readonly includeArtifacts?: boolean;\n  /** When false, disables API call interception in the unified fixture. Default: true */\n  readonly trackApiCalls?: boolean;\n  /** When true, suppresses console summary output. Default: false */\n  readonly quiet?: boolean;\n  /** When true, captures Playwright test steps (actions). Default: true */\n  readonly includeActionSteps?: boolean;\n  /** Capture request headers for API calls. Default: true */\n  readonly captureRequestHeaders?: boolean;\n  /** Capture response headers for API calls. Default: true */\n  readonly captureResponseHeaders?: boolean;\n  /** Capture request body for API calls. Default: true */\n  readonly captureRequestBody?: boolean;\n  /** Capture response body for API calls. Default: true */\n  readonly captureResponseBody?: boolean;\n  /** Capture API assertions (both pass and fail). Default: true */\n  readonly captureAssertions?: boolean;\n  /**\n   * Header names whose values are replaced with \"[REDACTED]\".\n   * Case-insensitive matching. Default: ['authorization', 'cookie', 'set-cookie', 'x-api-key']\n   */\n  readonly redactHeaders?: string[];\n  /**\n   * Body field names whose values are replaced with \"[REDACTED]\" at any depth.\n   * Default: ['password', 'secret', 'token', 'apiKey', 'api_key']\n   */\n  readonly redactBodyFields?: string[];\n  /**\n   * Only track API calls matching these URL patterns.\n   * Default: undefined (track all)\n   */\n  readonly apiIncludeUrls?: (string | RegExp)[];\n  /**\n   * Exclude API calls matching these URL patterns. Takes precedence over include.\n   * Default: undefined (exclude none)\n   */\n  readonly apiExcludeUrls?: (string | RegExp)[];\n  /** Cloud integration configuration. Default: undefined (local mode) */\n  readonly cloud?: CloudReporterOptions;\n}\n\n// ---------------------------------------------------------------------------\n// Internal Types (fixture → reporter communication)\n// ---------------------------------------------------------------------------\n\nexport interface NavigationAnnotation {\n  readonly url: string;\n  readonly navigationType: NavigationType;\n  readonly timestamp: string;\n  readonly domContentLoadedAt?: string;\n  readonly networkIdleAt?: string;\n  readonly networkStats?: NetworkStats;\n}\n\n// ---------------------------------------------------------------------------\n// Worker-Safe Data Payload (worker → reporter communication)\n// ---------------------------------------------------------------------------\n\n/** Consolidated data payload sent from a worker fixture to the reporter. */\nexport interface TestRelicDataPayload {\n  /** Marker to identify TestRelic attachments. Always `true`. */\n  readonly testRelicData: true;\n  /** Payload format version (semver). */\n  readonly version: string;\n  /** Navigation events collected during the test. */\n  readonly navigations: readonly NavigationAnnotation[];\n  /** Captured network requests during the test. */\n  readonly networkRequests: readonly CapturedNetworkRequest[];\n  /** API calls made via APIRequestContext proxy. */\n  readonly apiCalls: readonly ApiCallRecord[];\n  /** Assertions captured on API responses. */\n  readonly apiAssertions: readonly ApiAssertion[];\n}\n\n/** Current payload format version. */\nexport const PAYLOAD_VERSION = '1.0.0';\n\n/** Attachment name used for the consolidated payload. */\nexport const ATTACHMENT_NAME = 'testrelic-data';\n\n/** Attachment content type. */\nexport const ATTACHMENT_CONTENT_TYPE = 'application/json';\n\n/** Type guard: validates that a parsed object is a TestRelicDataPayload. */\nexport function isTestRelicDataPayload(obj: unknown): obj is TestRelicDataPayload {\n  if (typeof obj !== 'object' || obj === null) return false;\n  const record = obj as Record<string, unknown>;\n  return (\n    record.testRelicData === true &&\n    typeof record.version === 'string' &&\n    record.version.length > 0 &&\n    Array.isArray(record.navigations) &&\n    Array.isArray(record.networkRequests) &&\n    Array.isArray(record.apiCalls) &&\n    Array.isArray(record.apiAssertions)\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Cloud Integration Types\n// ---------------------------------------------------------------------------\n\n/** Upload strategy for cloud timeline data. */\nexport type UploadStrategy = 'batch' | 'realtime' | 'both';\n\n/** Current cloud/local operating mode. */\nexport type AuthMode = 'cloud' | 'local' | 'pending';\n\n/** Resolved cloud configuration, immutable after initialization. */\nexport interface CloudConfig {\n  readonly apiKey: string | null;\n  readonly endpoint: string;\n  readonly uploadStrategy: UploadStrategy;\n  readonly timeout: number;\n  readonly projectName: string | null;\n  readonly queueMaxAge: number;\n  readonly queueDirectory: string;\n}\n\n/** Mutable auth state tracked by the cloud client. */\nexport interface AuthState {\n  mode: AuthMode;\n  accessToken: string | null;\n  refreshToken: string | null;\n  expiresAt: number | null;\n  orgId: string | null;\n  orgName: string | null;\n  userId: string | null;\n  userName: string | null;\n}\n\n/** Auto-collected git information. All fields nullable. */\nexport interface GitMetadata {\n  readonly branch: string | null;\n  readonly commitSha: string | null;\n  readonly commitMessage: string | null;\n  readonly remoteUrl: string | null;\n}\n\n/** Cached project identity. */\nexport interface ProjectResolution {\n  readonly projectId: string;\n  readonly gitId: string;\n  readonly displayName: string;\n  readonly resolvedAt: number;\n  readonly apiKeyHash: string;\n}\n\n/** A single queued upload payload. */\nexport interface QueueEntry {\n  readonly version: string;\n  readonly queuedAt: string;\n  readonly reason: string;\n  readonly retryCount: number;\n  readonly targetEndpoint: string;\n  readonly method: string;\n  readonly payload: Record<string, unknown>;\n  readonly headers: Record<string, string>;\n}\n\n/** Inline cloud configuration accepted via reporter options. */\nexport interface CloudReporterOptions {\n  readonly apiKey?: string;\n  readonly endpoint?: string;\n  readonly upload?: UploadStrategy;\n  readonly timeout?: number;\n  readonly projectName?: string;\n  readonly queueMaxAge?: string;\n  readonly queueDirectory?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Merge CLI Types\n// ---------------------------------------------------------------------------\n\nexport interface MergeOptions {\n  readonly output: string;\n  readonly testRunId?: string;\n}\n","/**\n * @testrelic/core — Configurable logger\n *\n * Provides a Logger interface with a no-op default.\n * Never uses console.* directly (Constitution SDK Constraint).\n */\n\nexport interface Logger {\n  info(message: string, ...args: unknown[]): void;\n  warn(message: string, ...args: unknown[]): void;\n  error(message: string, ...args: unknown[]): void;\n  debug(message: string, ...args: unknown[]): void;\n}\n\nexport interface LoggerOptions {\n  readonly handler?: (level: LogLevel, message: string, args: unknown[]) => void;\n}\n\nexport type LogLevel = 'info' | 'warn' | 'error' | 'debug';\n\ntype LogHandler = (level: LogLevel, message: string, args: unknown[]) => void;\n\nconst noopHandler: LogHandler = () => {};\n\nexport function createLogger(options?: LoggerOptions): Logger {\n  const handler = options?.handler ?? noopHandler;\n\n  return {\n    info(message: string, ...args: unknown[]) {\n      handler('info', message, args);\n    },\n    warn(message: string, ...args: unknown[]) {\n      handler('warn', message, args);\n    },\n    error(message: string, ...args: unknown[]) {\n      handler('error', message, args);\n    },\n    debug(message: string, ...args: unknown[]) {\n      handler('debug', message, args);\n    },\n  };\n}\n","/**\n * @testrelic/core — Structured error factory\n *\n * Machine-readable error codes for programmatic handling.\n */\n\nexport const ErrorCode = {\n  CONFIG_INVALID: 'TESTRELIC_CONFIG_INVALID',\n  OUTPUT_WRITE_FAILED: 'TESTRELIC_OUTPUT_WRITE_FAILED',\n  MERGE_INVALID_SCHEMA: 'TESTRELIC_MERGE_INVALID_SCHEMA',\n  MERGE_READ_FAILED: 'TESTRELIC_MERGE_READ_FAILED',\n  NAVIGATION_FLUSH_FAILED: 'TESTRELIC_NAVIGATION_FLUSH_FAILED',\n  CODE_EXTRACT_FAILED: 'TESTRELIC_CODE_EXTRACT_FAILED',\n  HTML_REPORT_FAILED: 'TESTRELIC_HTML_REPORT_FAILED',\n  CLOUD_AUTH_FAILED: 'TESTRELIC_CLOUD_AUTH_FAILED',\n  CLOUD_UPLOAD_FAILED: 'TESTRELIC_CLOUD_UPLOAD_FAILED',\n  CLOUD_CONFIG_INVALID: 'TESTRELIC_CLOUD_CONFIG_INVALID',\n  CLOUD_QUEUE_FAILED: 'TESTRELIC_CLOUD_QUEUE_FAILED',\n} as const;\n\nexport type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];\n\nexport class TestRelicError extends Error {\n  readonly code: ErrorCode;\n\n  constructor(code: ErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = 'TestRelicError';\n    this.code = code;\n    if (cause !== undefined) {\n      Object.defineProperty(this, 'cause', { value: cause, writable: false, enumerable: false });\n    }\n  }\n}\n\nexport function createError(\n  code: ErrorCode,\n  message: string,\n  cause?: unknown,\n): TestRelicError {\n  return new TestRelicError(code, message, cause);\n}\n","/**\n * @testrelic/core — Lightweight runtime type guards\n *\n * Hand-written guards, no runtime schema libraries (Constitution SDK Constraint).\n */\n\nimport type {\n  ReporterConfig,\n  NavigationType,\n  TestRunReport,\n  CloudConfig,\n  QueueEntry,\n  UploadStrategy,\n} from './types.js';\n\nconst NAVIGATION_TYPES = new Set<string>([\n  'goto', 'navigation', 'back', 'forward', 'refresh',\n  'spa_route', 'spa_replace', 'hash_change', 'link_click',\n  'form_submit', 'redirect', 'popstate', 'page_load',\n  'manual_record', 'fallback', 'dummy',\n]);\n\nconst DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);\n\nexport function isValidNavigationType(value: unknown): value is NavigationType {\n  return typeof value === 'string' && NAVIGATION_TYPES.has(value);\n}\n\nfunction hasNoPrototypePollution(obj: unknown): boolean {\n  if (typeof obj !== 'object' || obj === null) return true;\n  for (const key of Object.keys(obj)) {\n    if (DANGEROUS_KEYS.has(key)) return false;\n  }\n  return true;\n}\n\nexport function isValidConfig(input: unknown): input is ReporterConfig {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (obj.outputPath !== undefined && typeof obj.outputPath !== 'string') return false;\n  if (obj.includeStackTrace !== undefined && typeof obj.includeStackTrace !== 'boolean') return false;\n  if (obj.includeCodeSnippets !== undefined && typeof obj.includeCodeSnippets !== 'boolean') return false;\n  if (obj.codeContextLines !== undefined && typeof obj.codeContextLines !== 'number') return false;\n  if (obj.includeNetworkStats !== undefined && typeof obj.includeNetworkStats !== 'boolean') return false;\n\n  if (obj.navigationTypes !== undefined && obj.navigationTypes !== null) {\n    if (!Array.isArray(obj.navigationTypes)) return false;\n    for (const t of obj.navigationTypes) {\n      if (!isValidNavigationType(t)) return false;\n    }\n  }\n\n  if (obj.redactPatterns !== undefined) {\n    if (!Array.isArray(obj.redactPatterns)) return false;\n    for (const p of obj.redactPatterns) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.testRunId !== undefined && obj.testRunId !== null && typeof obj.testRunId !== 'string') return false;\n\n  if (obj.metadata !== undefined && obj.metadata !== null) {\n    if (typeof obj.metadata !== 'object') return false;\n    if (!hasNoPrototypePollution(obj.metadata)) return false;\n  }\n\n  if (obj.openReport !== undefined && typeof obj.openReport !== 'boolean') return false;\n  if (obj.htmlReportPath !== undefined && (typeof obj.htmlReportPath !== 'string' || obj.htmlReportPath === '')) return false;\n  if (obj.includeArtifacts !== undefined && typeof obj.includeArtifacts !== 'boolean') return false;\n\n  // API tracking configuration\n  if (obj.trackApiCalls !== undefined && typeof obj.trackApiCalls !== 'boolean') return false;\n  if (obj.captureRequestHeaders !== undefined && typeof obj.captureRequestHeaders !== 'boolean') return false;\n  if (obj.captureResponseHeaders !== undefined && typeof obj.captureResponseHeaders !== 'boolean') return false;\n  if (obj.captureRequestBody !== undefined && typeof obj.captureRequestBody !== 'boolean') return false;\n  if (obj.captureResponseBody !== undefined && typeof obj.captureResponseBody !== 'boolean') return false;\n  if (obj.captureAssertions !== undefined && typeof obj.captureAssertions !== 'boolean') return false;\n\n  if (obj.redactHeaders !== undefined) {\n    if (!Array.isArray(obj.redactHeaders)) return false;\n    for (const h of obj.redactHeaders) {\n      if (typeof h !== 'string') return false;\n    }\n  }\n\n  if (obj.redactBodyFields !== undefined) {\n    if (!Array.isArray(obj.redactBodyFields)) return false;\n    for (const f of obj.redactBodyFields) {\n      if (typeof f !== 'string') return false;\n    }\n  }\n\n  if (obj.apiIncludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiIncludeUrls)) return false;\n    for (const p of obj.apiIncludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  if (obj.apiExcludeUrls !== undefined) {\n    if (!Array.isArray(obj.apiExcludeUrls)) return false;\n    for (const p of obj.apiExcludeUrls) {\n      if (typeof p !== 'string' && !(p instanceof RegExp)) return false;\n    }\n  }\n\n  return true;\n}\n\n// ---------------------------------------------------------------------------\n// Cloud Config Validation\n// ---------------------------------------------------------------------------\n\nconst API_KEY_PATTERN = /^tr[a-z]*_[a-z]+_[a-zA-Z0-9]+$/;\n\nconst UPLOAD_STRATEGIES = new Set<string>(['batch', 'realtime', 'both']);\n\nconst LOCALHOST_HOSTS = new Set(['localhost', '127.0.0.1', '0.0.0.0']);\n\nexport function isValidApiKeyFormat(value: unknown): value is string {\n  return typeof value === 'string' && API_KEY_PATTERN.test(value);\n}\n\nexport function isValidUploadStrategy(value: unknown): value is UploadStrategy {\n  return typeof value === 'string' && UPLOAD_STRATEGIES.has(value);\n}\n\nexport function isValidEndpointUrl(value: unknown): boolean {\n  if (typeof value !== 'string') return false;\n  try {\n    const url = new URL(value);\n    if (url.protocol === 'https:') return true;\n    if (url.protocol === 'http:' && LOCALHOST_HOSTS.has(url.hostname)) return true;\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function isValidCloudConfig(input: unknown): input is CloudConfig {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (obj.apiKey !== undefined && obj.apiKey !== null) {\n    if (typeof obj.apiKey !== 'string') return false;\n    if (obj.apiKey.length > 0 && !isValidApiKeyFormat(obj.apiKey)) return false;\n  }\n\n  if (obj.endpoint !== undefined) {\n    if (!isValidEndpointUrl(obj.endpoint)) return false;\n  }\n\n  if (obj.uploadStrategy !== undefined) {\n    if (!isValidUploadStrategy(obj.uploadStrategy)) return false;\n  }\n\n  if (obj.timeout !== undefined) {\n    if (typeof obj.timeout !== 'number' || obj.timeout < 1000 || obj.timeout > 120000) return false;\n  }\n\n  if (obj.projectName !== undefined && obj.projectName !== null && typeof obj.projectName !== 'string') return false;\n\n  if (obj.queueMaxAge !== undefined) {\n    if (typeof obj.queueMaxAge !== 'number' || obj.queueMaxAge < 3600000 || obj.queueMaxAge > 2592000000) return false;\n  }\n\n  if (obj.queueDirectory !== undefined) {\n    if (typeof obj.queueDirectory !== 'string') return false;\n    if (obj.queueDirectory.startsWith('/') || obj.queueDirectory.includes('..')) return false;\n  }\n\n  return true;\n}\n\nexport function isValidQueueEntry(input: unknown): input is QueueEntry {\n  if (typeof input !== 'object' || input === null) return false;\n  if (!hasNoPrototypePollution(input)) return false;\n\n  const obj = input as Record<string, unknown>;\n\n  if (typeof obj.version !== 'string') return false;\n  if (typeof obj.queuedAt !== 'string') return false;\n  if (typeof obj.reason !== 'string') return false;\n  if (typeof obj.retryCount !== 'number') return false;\n  if (typeof obj.targetEndpoint !== 'string') return false;\n  if (typeof obj.method !== 'string') return false;\n  if (typeof obj.payload !== 'object' || obj.payload === null) return false;\n  if (typeof obj.headers !== 'object' || obj.headers === null) return false;\n\n  return true;\n}\n\nexport function isValidTestRunReport(value: unknown): value is TestRunReport {\n  if (typeof value !== 'object' || value === null) return false;\n\n  const obj = value as Record<string, unknown>;\n\n  if (typeof obj.schemaVersion !== 'string') return false;\n  if (typeof obj.testRunId !== 'string') return false;\n  if (typeof obj.startedAt !== 'string') return false;\n  if (typeof obj.completedAt !== 'string') return false;\n  if (typeof obj.totalDuration !== 'number') return false;\n  if (typeof obj.summary !== 'object' || obj.summary === null) return false;\n  if (!Array.isArray(obj.timeline)) return false;\n\n  const summary = obj.summary as Record<string, unknown>;\n  if (typeof summary.total !== 'number') return false;\n  if (typeof summary.passed !== 'number') return false;\n  if (typeof summary.failed !== 'number') return false;\n  if (typeof summary.flaky !== 'number') return false;\n  if (typeof summary.skipped !== 'number') return false;\n  // timedout is optional for backward compat with schema 1.0.0\n  if (summary.timedout !== undefined && typeof summary.timedout !== 'number') return false;\n\n  return true;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testrelic/core",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "Shared types, logger, errors, and validation for TestRelic packages",
   "keywords": [
     "testrelic",