@scenarist/core 0.2.1 → 0.3.1

package/dist/adapters/console-logger.d.ts

@@ -0,0 +1,40 @@
+import type { Logger, LogLevel, LogCategory, LogContext } from "../ports/driven/logger.js";
+/**
+ * Output format for ConsoleLogger.
+ */
+export type LogFormat = "pretty" | "json";
+/**
+ * Configuration options for ConsoleLogger.
+ */
+export type ConsoleLoggerConfig = {
+    readonly level: Exclude<LogLevel, "silent">;
+    readonly categories?: ReadonlyArray<LogCategory>;
+    readonly format?: LogFormat;
+};
+/**
+ * Console logger implementation for development.
+ */
+export declare class ConsoleLogger implements Logger {
+    private readonly configuredLevel;
+    private readonly configuredCategories;
+    private readonly format;
+    private readonly testIdColors;
+    constructor(config: ConsoleLoggerConfig);
+    private getTestIdColor;
+    private shouldLog;
+    private formatTimestamp;
+    private formatData;
+    private formatPretty;
+    private formatOutput;
+    error(category: LogCategory, message: string, context: LogContext, data?: Record<string, unknown>): void;
+    warn(category: LogCategory, message: string, context: LogContext, data?: Record<string, unknown>): void;
+    info(category: LogCategory, message: string, context: LogContext, data?: Record<string, unknown>): void;
+    debug(category: LogCategory, message: string, context: LogContext, data?: Record<string, unknown>): void;
+    trace(category: LogCategory, message: string, context: LogContext, data?: Record<string, unknown>): void;
+    isEnabled(level: Exclude<LogLevel, "silent">): boolean;
+}
+/**
+ * Factory function for ConsoleLogger.
+ */
+export declare const createConsoleLogger: (config: ConsoleLoggerConfig) => Logger;
+//# sourceMappingURL=console-logger.d.ts.map

package/dist/adapters/console-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.d.ts","sourceRoot":"","sources":["../../src/adapters/console-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,WAAW,EACX,UAAU,EACX,MAAM,2BAA2B,CAAC;AA0FnC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAkC;IACvE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;gBAEnD,MAAM,EAAE,mBAAmB;IAQvC,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,YAAY;IAoBpB,KAAK,CACH,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IAQP,IAAI,CACF,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IAMP,IAAI,CACF,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IAMP,KAAK,CACH,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IAQP,KAAK,CACH,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IAQP,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,OAAO;CAGvD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,mBAAmB,KAAG,MACvC,CAAC"}

package/dist/adapters/console-logger.js

@@ -0,0 +1,193 @@
+/**
+ * Level priority for filtering (lower = less verbose).
+ */
+const LEVEL_PRIORITY = {
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+    trace: 5,
+};
+/**
+ * Category icons for pretty format.
+ */
+const CATEGORY_ICONS = {
+    lifecycle: "🔄",
+    scenario: "🎬",
+    matching: "🎯",
+    sequence: "📊",
+    state: "💾",
+    template: "📝",
+    request: "🌐",
+};
+/**
+ * Level labels for pretty format.
+ */
+const LEVEL_LABELS = {
+    error: "ERR",
+    warn: "WRN",
+    info: "INF",
+    debug: "DBG",
+    trace: "TRC",
+};
+/**
+ * ANSI color codes.
+ */
+const COLORS = {
+    reset: "\x1b[0m",
+    dim: "\x1b[2m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    gray: "\x1b[90m",
+};
+/**
+ * Test ID color palette for persistent coloring.
+ */
+const TEST_ID_COLORS = [
+    "\x1b[36m", // Cyan
+    "\x1b[33m", // Yellow
+    "\x1b[35m", // Magenta
+    "\x1b[32m", // Green
+    "\x1b[34m", // Blue
+    "\x1b[91m", // Bright Red
+    "\x1b[92m", // Bright Green
+    "\x1b[93m", // Bright Yellow
+    "\x1b[94m", // Bright Blue
+    "\x1b[95m", // Bright Magenta
+    "\x1b[96m", // Bright Cyan
+];
+/**
+ * Simple hash function for consistent color assignment.
+ */
+const hashString = (str) => {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash;
+    }
+    return Math.abs(hash);
+};
+/**
+ * Level colors for pretty format.
+ */
+const LEVEL_COLORS = {
+    error: COLORS.red,
+    warn: COLORS.yellow,
+    info: COLORS.cyan,
+    debug: COLORS.gray,
+    trace: COLORS.dim,
+};
+/**
+ * Console logger implementation for development.
+ */
+export class ConsoleLogger {
+    configuredLevel;
+    configuredCategories;
+    format;
+    testIdColors = new Map();
+    constructor(config) {
+        this.configuredLevel = config.level;
+        this.configuredCategories = config.categories
+            ? new Set(config.categories)
+            : null;
+        this.format = config.format ?? "pretty";
+    }
+    getTestIdColor(testId) {
+        const existingColor = this.testIdColors.get(testId);
+        if (existingColor) {
+            return existingColor;
+        }
+        const hash = hashString(testId);
+        // colorIndex is always 0 to TEST_ID_COLORS.length-1, so index is always valid
+        const colorIndex = hash % TEST_ID_COLORS.length;
+        const newColor = TEST_ID_COLORS[colorIndex];
+        this.testIdColors.set(testId, newColor);
+        return newColor;
+    }
+    shouldLog(level, category) {
+        const levelAllowed = LEVEL_PRIORITY[level] <= LEVEL_PRIORITY[this.configuredLevel];
+        const categoryAllowed = this.configuredCategories === null ||
+            this.configuredCategories.has(category);
+        return levelAllowed && categoryAllowed;
+    }
+    formatTimestamp() {
+        const now = new Date();
+        const hours = now.getHours().toString().padStart(2, "0");
+        const minutes = now.getMinutes().toString().padStart(2, "0");
+        const seconds = now.getSeconds().toString().padStart(2, "0");
+        const ms = now.getMilliseconds().toString().padStart(3, "0");
+        return `${hours}:${minutes}:${seconds}.${ms}`;
+    }
+    formatData(data) {
+        return Object.entries(data)
+            .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
+            .join(" ");
+    }
+    formatPretty(level, category, message, context, data) {
+        const timestamp = this.formatTimestamp();
+        const levelColor = LEVEL_COLORS[level];
+        const levelLabel = LEVEL_LABELS[level];
+        const icon = CATEGORY_ICONS[category];
+        const testId = context.testId ?? "unknown";
+        const testIdColor = this.getTestIdColor(testId);
+        const parts = [
+            `${COLORS.dim}${timestamp}${COLORS.reset}`,
+            `${levelColor}${levelLabel}${COLORS.reset}`,
+            `${testIdColor}[${testId}]${COLORS.reset}`,
+            `${icon}`,
+            category.padEnd(10),
+            message,
+        ];
+        if (data && Object.keys(data).length > 0) {
+            parts.push(`${COLORS.dim}${this.formatData(data)}${COLORS.reset}`);
+        }
+        return parts.join(" ");
+    }
+    formatOutput(level, category, message, context, data) {
+        if (this.format === "json") {
+            return JSON.stringify({
+                timestamp: Date.now(),
+                level,
+                category,
+                message,
+                ...context,
+                ...(data ? { data } : {}),
+            });
+        }
+        return this.formatPretty(level, category, message, context, data);
+    }
+    error(category, message, context, data) {
+        if (this.shouldLog("error", category)) {
+            console.error(this.formatOutput("error", category, message, context, data));
+        }
+    }
+    warn(category, message, context, data) {
+        if (this.shouldLog("warn", category)) {
+            console.warn(this.formatOutput("warn", category, message, context, data));
+        }
+    }
+    info(category, message, context, data) {
+        if (this.shouldLog("info", category)) {
+            console.info(this.formatOutput("info", category, message, context, data));
+        }
+    }
+    debug(category, message, context, data) {
+        if (this.shouldLog("debug", category)) {
+            console.debug(this.formatOutput("debug", category, message, context, data));
+        }
+    }
+    trace(category, message, context, data) {
+        if (this.shouldLog("trace", category)) {
+            console.debug(this.formatOutput("trace", category, message, context, data));
+        }
+    }
+    isEnabled(level) {
+        return LEVEL_PRIORITY[level] <= LEVEL_PRIORITY[this.configuredLevel];
+    }
+}
+/**
+ * Factory function for ConsoleLogger.
+ */
+export const createConsoleLogger = (config) => new ConsoleLogger(config);

package/dist/adapters/in-memory-state-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-state-manager.d.ts","sourceRoot":"","sources":["../../src/adapters/in-memory-state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAMrE;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAEtE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAyBtD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI/C,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgB7D,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,cAAc;IAwCtB,OAAO,CAAC,cAAc;CA4BvB;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAO,YAE7C,CAAC"}
+{"version":3,"file":"in-memory-state-manager.d.ts","sourceRoot":"","sources":["../../src/adapters/in-memory-state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAMrE;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAEtE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAUzC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAyBtD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI/C,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgB7D,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,cAAc;CA6BvB;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAO,YAE7C,CAAC"}

package/dist/adapters/in-memory-state-manager.js

@@ -80,6 +80,7 @@ export class InMemoryStateManager {
             });
             return;
         }
+        // eslint-disable-next-line security/detect-object-injection -- Guarded by isDangerousKey and Object.hasOwn
         const existingValue = Object.hasOwn(obj, key) ? obj[key] : undefined;
         if (typeof existingValue !== "object" ||
             existingValue === null ||
@@ -91,6 +92,7 @@ export class InMemoryStateManager {
                 configurable: true,
             });
         }
+        // eslint-disable-next-line security/detect-object-injection -- Guarded by isDangerousKey, Object.hasOwn, and Object.defineProperty
         const nested = obj[key];
         this.setNestedValue(nested, path.slice(1), value);
     }
@@ -104,6 +106,7 @@ export class InMemoryStateManager {
         if (!Object.hasOwn(obj, key)) {
             return undefined;
         }
+        // eslint-disable-next-line security/detect-object-injection -- Guarded by isDangerousKey and Object.hasOwn
         const value = obj[key];
         if (path.length === 1) {
             return value;

package/dist/adapters/index.d.ts

@@ -2,4 +2,6 @@ export { InMemoryScenarioRegistry } from "./in-memory-registry.js";
 export { InMemoryScenarioStore } from "./in-memory-store.js";
 export { InMemorySequenceTracker, createInMemorySequenceTracker, } from "./in-memory-sequence-tracker.js";
 export { InMemoryStateManager, createInMemoryStateManager, } from "./in-memory-state-manager.js";
+export { NoOpLogger, noOpLogger, createNoOpLogger } from "./noop-logger.js";
+export { ConsoleLogger, createConsoleLogger, type ConsoleLoggerConfig, type LogFormat, } from "./console-logger.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC"}

package/dist/adapters/index.js

@@ -2,3 +2,5 @@ export { InMemoryScenarioRegistry } from "./in-memory-registry.js";
 export { InMemoryScenarioStore } from "./in-memory-store.js";
 export { InMemorySequenceTracker, createInMemorySequenceTracker, } from "./in-memory-sequence-tracker.js";
 export { InMemoryStateManager, createInMemoryStateManager, } from "./in-memory-state-manager.js";
+export { NoOpLogger, noOpLogger, createNoOpLogger } from "./noop-logger.js";
+export { ConsoleLogger, createConsoleLogger, } from "./console-logger.js";

package/dist/adapters/noop-logger.d.ts

@@ -0,0 +1,26 @@
+import type { Logger } from "../ports/driven/logger.js";
+/**
+ * No-operation logger that discards all log calls.
+ *
+ * Used when logging is disabled for zero overhead.
+ * All methods are empty - V8 will inline and eliminate them.
+ */
+export declare class NoOpLogger implements Logger {
+    error(): void;
+    warn(): void;
+    info(): void;
+    debug(): void;
+    trace(): void;
+    isEnabled(): boolean;
+}
+/**
+ * Singleton NoOpLogger instance.
+ * Prevents unnecessary allocations.
+ */
+export declare const noOpLogger: Logger;
+/**
+ * Factory function for NoOpLogger.
+ * Returns the singleton instance.
+ */
+export declare const createNoOpLogger: () => Logger;
+//# sourceMappingURL=noop-logger.d.ts.map

package/dist/adapters/noop-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-logger.d.ts","sourceRoot":"","sources":["../../src/adapters/noop-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,KAAK,IAAI,IAAI;IACb,KAAK,IAAI,IAAI;IACb,SAAS,IAAI,OAAO;CAGrB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAyB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAO,MAAoB,CAAC"}

package/dist/adapters/noop-logger.js

@@ -0,0 +1,26 @@
+/**
+ * No-operation logger that discards all log calls.
+ *
+ * Used when logging is disabled for zero overhead.
+ * All methods are empty - V8 will inline and eliminate them.
+ */
+export class NoOpLogger {
+    error() { }
+    warn() { }
+    info() { }
+    debug() { }
+    trace() { }
+    isEnabled() {
+        return false;
+    }
+}
+/**
+ * Singleton NoOpLogger instance.
+ * Prevents unnecessary allocations.
+ */
+export const noOpLogger = new NoOpLogger();
+/**
+ * Factory function for NoOpLogger.
+ * Returns the singleton instance.
+ */
+export const createNoOpLogger = () => noOpLogger;

package/dist/contracts/framework-adapter.d.ts

@@ -3,6 +3,7 @@ import type { ScenarioRegistry } from "../ports/driven/scenario-registry.js";
 import type { ScenarioStore } from "../ports/driven/scenario-store.js";
 import type { StateManager } from "../ports/driven/state-manager.js";
 import type { SequenceTracker } from "../ports/driven/sequence-tracker.js";
+import type { Logger } from "../ports/driven/logger.js";
 /**
  * Base configuration options that all framework adapters must support.
  *
@@ -49,6 +50,23 @@ export type BaseAdapterOptions<T extends ScenaristScenarios = ScenaristScenarios
      * If not provided, an in-memory sequence tracker will be used.
      */
     readonly sequenceTracker?: SequenceTracker;
+    /**
+     * Logger implementation for debugging and observability.
+     *
+     * If not provided, NoOpLogger will be used (silent).
+     *
+     * @example
+     * ```typescript
+     * import { createConsoleLogger } from '@scenarist/express-adapter';
+     *
+     * const scenarist = createScenarist({
+     *   enabled: true,
+     *   scenarios,
+     *   logger: createConsoleLogger({ level: 'debug' }),
+     * });
+     * ```
+     */
+    readonly logger?: Logger;
 };
 /**
  * The contract that all Scenarist adapters must satisfy.

package/dist/contracts/framework-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-adapter.d.ts","sourceRoot":"","sources":["../../src/contracts/framework-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,kBAAkB,CAC5B,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,IAC/C,oBAAoB,CAAC,CAAC,CAAC,GAAG;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC5C,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,CAC1B,WAAW,GAAG,OAAO,EACrB,UAAU,SAAS,kBAAkB,GAAG,kBAAkB,IACxD;IACF;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAEjC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,CACvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,KAChC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAE3E;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,CACxB,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,KAChC,iBAAiB,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC"}
+{"version":3,"file":"framework-adapter.d.ts","sourceRoot":"","sources":["../../src/contracts/framework-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,kBAAkB,CAC5B,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,IAC/C,oBAAoB,CAAC,CAAC,CAAC,GAAG;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAE3C;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,gBAAgB,CAC1B,WAAW,GAAG,OAAO,EACrB,UAAU,SAAS,kBAAkB,GAAG,kBAAkB,IACxD;IACF;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAEjC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAEjC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,CACvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,KAChC,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAE3E;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,CACxB,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,KAChC,iBAAiB,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC"}

package/dist/domain/config-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-builder.d.ts","sourceRoot":"","sources":["../../src/domain/config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAG3B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,kBAAkB,EACtD,OAAO,oBAAoB,CAAC,CAAC,CAAC,KAC7B,eAaF,CAAC"}
+{"version":3,"file":"config-builder.d.ts","sourceRoot":"","sources":["../../src/domain/config-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAa3B;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,kBAAkB,EACtD,OAAO,oBAAoB,CAAC,CAAC,CAAC,KAC7B,eAiBF,CAAC"}

package/dist/domain/config-builder.js

@@ -1,4 +1,13 @@
 import { ScenariosObjectSchema } from "../schemas/index.js";
+/**
+ * Default error behaviors - strict by default.
+ * All errors throw to ensure tests fail clearly when something goes wrong.
+ */
+const DEFAULT_ERROR_BEHAVIORS = {
+    onNoMockFound: "throw",
+    onSequenceExhausted: "throw",
+    onMissingTestId: "throw",
+};
 /**
  * Build a complete config from partial user input.
  * Applies sensible defaults for missing values.
@@ -16,5 +25,9 @@ export const buildConfig = (input) => {
             getScenario: input.endpoints?.getScenario ?? "/__scenario__",
         },
         defaultTestId: input.defaultTestId ?? "default-test",
+        errorBehaviors: {
+            ...DEFAULT_ERROR_BEHAVIORS,
+            ...input.errorBehaviors,
+        },
     };
 };

package/dist/domain/deep-equals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deep-equals.d.ts","sourceRoot":"","sources":["../../src/domain/deep-equals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAkEnD,CAAC"}
+{"version":3,"file":"deep-equals.d.ts","sourceRoot":"","sources":["../../src/domain/deep-equals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,EAAE,GAAG,OAAO,KAAG,OAoEnD,CAAC"}

package/dist/domain/deep-equals.js

@@ -31,6 +31,7 @@ export const deepEquals = (a, b) => {
             return false;
         }
         for (let i = 0; i < a.length; i++) {
+            // eslint-disable-next-line security/detect-object-injection -- Index bounded by array length check
             if (!deepEquals(a[i], b[i])) {
                 return false;
             }
@@ -52,6 +53,7 @@ export const deepEquals = (a, b) => {
             if (!(key in b)) {
                 return false;
             }
+            // eslint-disable-next-line security/detect-object-injection -- Keys from Object.keys (own properties only)
             if (!deepEquals(a[key], b[key])) {
                 return false;
             }

package/dist/domain/index.d.ts

@@ -5,4 +5,5 @@ export { matchesRegex } from "./regex-matching.js";
 export { createStateConditionEvaluator, type StateConditionEvaluator, } from "./state-condition-evaluator.js";
 export { createStateResponseResolver, type StateResponseResolver, } from "./state-response-resolver.js";
 export { deepEquals } from "./deep-equals.js";
+export { LogCategories, LogEvents, type LogEvent } from "./log-events.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/domain/index.js

@@ -5,3 +5,4 @@ export { matchesRegex } from "./regex-matching.js";
 export { createStateConditionEvaluator, } from "./state-condition-evaluator.js";
 export { createStateResponseResolver, } from "./state-response-resolver.js";
 export { deepEquals } from "./deep-equals.js";
+export { LogCategories, LogEvents } from "./log-events.js";

package/dist/domain/log-events.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Log event constants for consistent and discoverable logging.
+ *
+ * Using constants ensures:
+ * - TypeScript type safety for event names
+ * - Discoverability via IDE autocomplete
+ * - Consistent naming across the codebase
+ * - Easy refactoring of event names
+ */
+/**
+ * Log categories group related events.
+ *
+ * The values here match the LogCategory type from ports/driven/logger.ts.
+ * Using these constants instead of string literals provides:
+ * - IDE autocomplete
+ * - Refactoring safety
+ * - Single source of truth for category names
+ */
+export declare const LogCategories: {
+    /** Scenario lifecycle events (registration, switching, clearing) */
+    readonly SCENARIO: "scenario";
+    /** Mock matching and selection events */
+    readonly MATCHING: "matching";
+    /** State capture and injection events */
+    readonly STATE: "state";
+    /** Sequence progression events */
+    readonly SEQUENCE: "sequence";
+    /** Request handling events */
+    readonly REQUEST: "request";
+};
+/**
+ * Log event names for structured logging.
+ */
+export declare const LogEvents: {
+    /** Scenario successfully registered */
+    readonly SCENARIO_REGISTERED: "scenario_registered";
+    /** Attempted to switch to non-existent scenario */
+    readonly SCENARIO_NOT_FOUND: "scenario_not_found";
+    /** Scenario switched for a test */
+    readonly SCENARIO_SWITCHED: "scenario_switched";
+    /** Scenario cleared for a test */
+    readonly SCENARIO_CLEARED: "scenario_cleared";
+    /** Candidate mocks found for evaluation */
+    readonly MOCK_CANDIDATES_FOUND: "mock_candidates_found";
+    /** Mock evaluated against match criteria */
+    readonly MOCK_MATCH_EVALUATED: "mock_match_evaluated";
+    /** Mock selected to handle request */
+    readonly MOCK_SELECTED: "mock_selected";
+    /** No mock matched the request */
+    readonly MOCK_NO_MATCH: "mock_no_match";
+    /** State captured from response */
+    readonly STATE_CAPTURED: "state_captured";
+    /** State injected into response */
+    readonly STATE_INJECTED: "state_injected";
+    /** State set via afterResponse.setState */
+    readonly STATE_SET: "state_set";
+    /** State response resolved (condition matched or default) */
+    readonly STATE_RESPONSE_RESOLVED: "state_response_resolved";
+    /** Sequence advanced to next response */
+    readonly SEQUENCE_ADVANCED: "sequence_advanced";
+    /** Sequence exhausted all responses */
+    readonly SEQUENCE_EXHAUSTED: "sequence_exhausted";
+    /** Unhandled error in request handler */
+    readonly HANDLER_ERROR: "handler_error";
+    /** Validation error in scenario definition */
+    readonly VALIDATION_ERROR: "validation_error";
+    /** Request missing test ID header */
+    readonly MISSING_TEST_ID: "missing_test_id";
+};
+export type LogEvent = (typeof LogEvents)[keyof typeof LogEvents];
+//# sourceMappingURL=log-events.d.ts.map

package/dist/domain/log-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-events.d.ts","sourceRoot":"","sources":["../../src/domain/log-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;IACxB,oEAAoE;;IAEpE,yCAAyC;;IAEzC,yCAAyC;;IAEzC,kCAAkC;;IAElC,8BAA8B;;CAEtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;IAEpB,uCAAuC;;IAEvC,mDAAmD;;IAEnD,mCAAmC;;IAEnC,kCAAkC;;IAIlC,2CAA2C;;IAE3C,4CAA4C;;IAE5C,sCAAsC;;IAEtC,kCAAkC;;IAIlC,mCAAmC;;IAEnC,mCAAmC;;IAEnC,2CAA2C;;IAE3C,6DAA6D;;IAI7D,yCAAyC;;IAEzC,uCAAuC;;IAIvC,yCAAyC;;IAEzC,8CAA8C;;IAE9C,qCAAqC;;CAE7B,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC"}

package/dist/domain/log-events.js

@@ -0,0 +1,74 @@
+/**
+ * Log event constants for consistent and discoverable logging.
+ *
+ * Using constants ensures:
+ * - TypeScript type safety for event names
+ * - Discoverability via IDE autocomplete
+ * - Consistent naming across the codebase
+ * - Easy refactoring of event names
+ */
+/**
+ * Log categories group related events.
+ *
+ * The values here match the LogCategory type from ports/driven/logger.ts.
+ * Using these constants instead of string literals provides:
+ * - IDE autocomplete
+ * - Refactoring safety
+ * - Single source of truth for category names
+ */
+export const LogCategories = {
+    /** Scenario lifecycle events (registration, switching, clearing) */
+    SCENARIO: "scenario",
+    /** Mock matching and selection events */
+    MATCHING: "matching",
+    /** State capture and injection events */
+    STATE: "state",
+    /** Sequence progression events */
+    SEQUENCE: "sequence",
+    /** Request handling events */
+    REQUEST: "request",
+};
+/**
+ * Log event names for structured logging.
+ */
+export const LogEvents = {
+    // Scenario lifecycle
+    /** Scenario successfully registered */
+    SCENARIO_REGISTERED: "scenario_registered",
+    /** Attempted to switch to non-existent scenario */
+    SCENARIO_NOT_FOUND: "scenario_not_found",
+    /** Scenario switched for a test */
+    SCENARIO_SWITCHED: "scenario_switched",
+    /** Scenario cleared for a test */
+    SCENARIO_CLEARED: "scenario_cleared",
+    // Mock matching
+    /** Candidate mocks found for evaluation */
+    MOCK_CANDIDATES_FOUND: "mock_candidates_found",
+    /** Mock evaluated against match criteria */
+    MOCK_MATCH_EVALUATED: "mock_match_evaluated",
+    /** Mock selected to handle request */
+    MOCK_SELECTED: "mock_selected",
+    /** No mock matched the request */
+    MOCK_NO_MATCH: "mock_no_match",
+    // State management
+    /** State captured from response */
+    STATE_CAPTURED: "state_captured",
+    /** State injected into response */
+    STATE_INJECTED: "state_injected",
+    /** State set via afterResponse.setState */
+    STATE_SET: "state_set",
+    /** State response resolved (condition matched or default) */
+    STATE_RESPONSE_RESOLVED: "state_response_resolved",
+    // Sequence progression
+    /** Sequence advanced to next response */
+    SEQUENCE_ADVANCED: "sequence_advanced",
+    /** Sequence exhausted all responses */
+    SEQUENCE_EXHAUSTED: "sequence_exhausted",
+    // Error events
+    /** Unhandled error in request handler */
+    HANDLER_ERROR: "handler_error",
+    /** Validation error in scenario definition */
+    VALIDATION_ERROR: "validation_error",
+    /** Request missing test ID header */
+    MISSING_TEST_ID: "missing_test_id",
+};

package/dist/domain/path-extraction.js

@@ -69,6 +69,7 @@ const traversePath = (obj, path) => {
         return undefined;
     }
     const record = obj;
+    // eslint-disable-next-line security/detect-object-injection -- Key validated by Object.hasOwn and isDangerousKey guard
     const value = record[key];
     // Recursively traverse remaining path
     return traversePath(value, path.slice(1));

package/dist/domain/regex-matching.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regex-matching.d.ts","sourceRoot":"","sources":["../../src/domain/regex-matching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,SAAS,eAAe,KACvB,OAQF,CAAC"}
+{"version":3,"file":"regex-matching.d.ts","sourceRoot":"","sources":["../../src/domain/regex-matching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,SAAS,eAAe,KACvB,OASF,CAAC"}

package/dist/domain/regex-matching.js

@@ -17,6 +17,7 @@
  */
 export const matchesRegex = (value, pattern) => {
     try {
+        // eslint-disable-next-line security/detect-non-literal-regexp -- Pattern validated at trust boundary (schema uses redos-detector)
         const regex = new RegExp(pattern.source, pattern.flags);
         return regex.test(value);
     }

package/dist/domain/response-selector.d.ts

@@ -1,10 +1,11 @@
-import type { ResponseSelector, SequenceTracker, StateManager } from "../ports/index.js";
+import type { ResponseSelector, SequenceTracker, StateManager, Logger } from "../ports/index.js";
 /**
  * Options for creating a response selector.
  */
 type CreateResponseSelectorOptions = {
     sequenceTracker?: SequenceTracker;
     stateManager?: StateManager;
+    logger?: Logger;
 };
 /**
  * Creates a response selector domain service.

package/dist/domain/response-selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response-selector.d.ts","sourceRoot":"","sources":["../../src/domain/response-selector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACb,MAAM,mBAAmB,CAAC;AAe3B;;GAEG;AACH,KAAK,6BAA6B,GAAG;IACnC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAS,6BAAkC,KAC1C,gBAyIF,CAAC"}
+{"version":3,"file":"response-selector.d.ts","sourceRoot":"","sources":["../../src/domain/response-selector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,MAAM,EACP,MAAM,mBAAmB,CAAC;AAiB3B;;GAEG;AACH,KAAK,6BAA6B,GAAG;IACnC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAS,6BAAkC,KAC1C,gBAuQF,CAAC"}