@testrelic/core 1.0.0 → 1.2.0

package/dist/index.cjs

@@ -133,6 +133,7 @@ function isValidConfig(input) {
   }
   if (obj.openReport !== void 0 && typeof obj.openReport !== "boolean") return false;
   if (obj.htmlReportPath !== void 0 && (typeof obj.htmlReportPath !== "string" || obj.htmlReportPath === "")) return false;
+  if (obj.includeArtifacts !== void 0 && typeof obj.includeArtifacts !== "boolean") return false;
   return true;
 }
 function isValidTestRunReport(value) {
@@ -151,6 +152,7 @@ function isValidTestRunReport(value) {
   if (typeof summary.failed !== "number") return false;
   if (typeof summary.flaky !== "number") return false;
   if (typeof summary.skipped !== "number") return false;
+  if (summary.timedout !== void 0 && typeof summary.timedout !== "number") return false;
   return true;
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.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  FailureDiagnostic,\n  NetworkStats,\n  ResourceBreakdown,\n  ReporterConfig,\n  NavigationAnnotation,\n  MergeOptions,\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 — 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\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\n  return true;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.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  ReporterConfig,\n  TestArtifacts,\n  NavigationAnnotation,\n  MergeOptions,\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 — 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  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

@@ -25,6 +25,7 @@ interface Summary {
     readonly failed: number;
     readonly flaky: number;
     readonly skipped: number;
+    readonly timedout: number;
 }
 interface CIMetadata {
     readonly provider: CIProvider;
@@ -53,8 +54,42 @@ interface TestResult {
     readonly retryCount: number;
     readonly tags: string[];
     readonly failure: FailureDiagnostic | null;
+    readonly testId: string;
+    readonly filePath: string;
+    readonly suiteName: string;
+    readonly testType: TestType;
+    readonly isFlaky: boolean;
+    readonly retryStatus: string | null;
+    readonly expectedStatus: TestStatus;
+    readonly actualStatus: TestStatus;
+    readonly artifacts: TestArtifacts | null;
+    readonly networkRequests: CapturedNetworkRequest[] | null;
 }
-type TestStatus = 'passed' | 'failed' | 'flaky';
+type ResourceType = 'xhr' | 'document' | 'script' | 'stylesheet' | 'image' | 'font' | 'other';
+interface CapturedNetworkRequest {
+    readonly url: string;
+    readonly method: string;
+    readonly resourceType: ResourceType;
+    readonly statusCode: number;
+    readonly responseTimeMs: number;
+    readonly startedAt: string;
+    readonly requestHeaders: Record<string, string> | null;
+    readonly requestBody: string | null;
+    readonly responseBody: string | null;
+    readonly responseHeaders: Record<string, string> | null;
+    readonly contentType: string | null;
+    readonly responseSize: number;
+    readonly requestBodyTruncated: boolean;
+    readonly responseBodyTruncated: boolean;
+    readonly isBinary: boolean;
+    readonly error: string | null;
+}
+interface TestArtifacts {
+    readonly screenshot?: string;
+    readonly video?: string;
+}
+type TestStatus = 'passed' | 'failed' | 'skipped' | 'flaky' | 'timedout';
+type TestType = 'e2e' | 'api' | 'unit' | 'unknown';
 interface FailureDiagnostic {
     readonly message: string;
     readonly line: number | null;
@@ -64,6 +99,7 @@ interface FailureDiagnostic {
 interface NetworkStats {
     readonly totalRequests: number;
     readonly failedRequests: number;
+    readonly failedRequestUrls: string[];
     readonly totalBytes: number;
     readonly byType: ResourceBreakdown;
 }
@@ -88,6 +124,7 @@ interface ReporterConfig {
     readonly metadata?: Record<string, unknown> | null;
     readonly openReport?: boolean;
     readonly htmlReportPath?: string;
+    readonly includeArtifacts?: boolean;
 }
 interface NavigationAnnotation {
     readonly url: string;
@@ -151,4 +188,4 @@ declare function isValidNavigationType(value: unknown): value is NavigationType;
 declare function isValidConfig(input: unknown): input is ReporterConfig;
 declare function isValidTestRunReport(value: unknown): value is TestRunReport;
 
-export { type CIMetadata, type CIProvider, ErrorCode, type FailureDiagnostic, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationType, type NetworkStats, type ReporterConfig, type ResourceBreakdown, type Summary, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TimelineEntry, createError, createLogger, isValidConfig, isValidNavigationType, isValidTestRunReport };
+export { type CIMetadata, type CIProvider, type CapturedNetworkRequest, ErrorCode, type FailureDiagnostic, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationType, type NetworkStats, type ReporterConfig, type ResourceBreakdown, type ResourceType, type Summary, type TestArtifacts, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TestType, type TimelineEntry, createError, createLogger, isValidConfig, isValidNavigationType, isValidTestRunReport };

package/dist/index.d.ts

@@ -25,6 +25,7 @@ interface Summary {
     readonly failed: number;
     readonly flaky: number;
     readonly skipped: number;
+    readonly timedout: number;
 }
 interface CIMetadata {
     readonly provider: CIProvider;
@@ -53,8 +54,42 @@ interface TestResult {
     readonly retryCount: number;
     readonly tags: string[];
     readonly failure: FailureDiagnostic | null;
+    readonly testId: string;
+    readonly filePath: string;
+    readonly suiteName: string;
+    readonly testType: TestType;
+    readonly isFlaky: boolean;
+    readonly retryStatus: string | null;
+    readonly expectedStatus: TestStatus;
+    readonly actualStatus: TestStatus;
+    readonly artifacts: TestArtifacts | null;
+    readonly networkRequests: CapturedNetworkRequest[] | null;
 }
-type TestStatus = 'passed' | 'failed' | 'flaky';
+type ResourceType = 'xhr' | 'document' | 'script' | 'stylesheet' | 'image' | 'font' | 'other';
+interface CapturedNetworkRequest {
+    readonly url: string;
+    readonly method: string;
+    readonly resourceType: ResourceType;
+    readonly statusCode: number;
+    readonly responseTimeMs: number;
+    readonly startedAt: string;
+    readonly requestHeaders: Record<string, string> | null;
+    readonly requestBody: string | null;
+    readonly responseBody: string | null;
+    readonly responseHeaders: Record<string, string> | null;
+    readonly contentType: string | null;
+    readonly responseSize: number;
+    readonly requestBodyTruncated: boolean;
+    readonly responseBodyTruncated: boolean;
+    readonly isBinary: boolean;
+    readonly error: string | null;
+}
+interface TestArtifacts {
+    readonly screenshot?: string;
+    readonly video?: string;
+}
+type TestStatus = 'passed' | 'failed' | 'skipped' | 'flaky' | 'timedout';
+type TestType = 'e2e' | 'api' | 'unit' | 'unknown';
 interface FailureDiagnostic {
     readonly message: string;
     readonly line: number | null;
@@ -64,6 +99,7 @@ interface FailureDiagnostic {
 interface NetworkStats {
     readonly totalRequests: number;
     readonly failedRequests: number;
+    readonly failedRequestUrls: string[];
     readonly totalBytes: number;
     readonly byType: ResourceBreakdown;
 }
@@ -88,6 +124,7 @@ interface ReporterConfig {
     readonly metadata?: Record<string, unknown> | null;
     readonly openReport?: boolean;
     readonly htmlReportPath?: string;
+    readonly includeArtifacts?: boolean;
 }
 interface NavigationAnnotation {
     readonly url: string;
@@ -151,4 +188,4 @@ declare function isValidNavigationType(value: unknown): value is NavigationType;
 declare function isValidConfig(input: unknown): input is ReporterConfig;
 declare function isValidTestRunReport(value: unknown): value is TestRunReport;
 
-export { type CIMetadata, type CIProvider, ErrorCode, type FailureDiagnostic, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationType, type NetworkStats, type ReporterConfig, type ResourceBreakdown, type Summary, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TimelineEntry, createError, createLogger, isValidConfig, isValidNavigationType, isValidTestRunReport };
+export { type CIMetadata, type CIProvider, type CapturedNetworkRequest, ErrorCode, type FailureDiagnostic, type LogLevel, type Logger, type LoggerOptions, type MergeOptions, type NavigationAnnotation, type NavigationType, type NetworkStats, type ReporterConfig, type ResourceBreakdown, type ResourceType, type Summary, type TestArtifacts, TestRelicError, type TestResult, type TestRunReport, type TestStatus, type TestType, type TimelineEntry, createError, createLogger, isValidConfig, isValidNavigationType, isValidTestRunReport };

package/dist/index.js

@@ -101,6 +101,7 @@ function isValidConfig(input) {
   }
   if (obj.openReport !== void 0 && typeof obj.openReport !== "boolean") return false;
   if (obj.htmlReportPath !== void 0 && (typeof obj.htmlReportPath !== "string" || obj.htmlReportPath === "")) return false;
+  if (obj.includeArtifacts !== void 0 && typeof obj.includeArtifacts !== "boolean") return false;
   return true;
 }
 function isValidTestRunReport(value) {
@@ -119,6 +120,7 @@ function isValidTestRunReport(value) {
   if (typeof summary.failed !== "number") return false;
   if (typeof summary.flaky !== "number") return false;
   if (typeof summary.skipped !== "number") return false;
+  if (summary.timedout !== void 0 && typeof summary.timedout !== "number") return false;
   return true;
 }
 export {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/logger.ts","../src/errors.ts","../src/validation.ts"],"sourcesContent":["/**\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\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\n  return true;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/logger.ts","../src/errors.ts","../src/validation.ts"],"sourcesContent":["/**\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  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": "1.0.0",
+  "version": "1.2.0",
   "description": "Shared types, logger, errors, and validation for TestRelic packages",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -32,9 +32,10 @@
     "node": ">=18"
   },
   "license": "MIT",
+  "homepage": "https://testrelic.co",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/testrelic-ai/testrelic-sdk.git",
+    "url": "https://testrelic.co",
     "directory": "packages/core"
   },
   "scripts": {