@opensip-cli/simulation 0.1.0

package/dist/framework/assertions.js

@@ -0,0 +1,256 @@
+/**
+ * @fileoverview Pre-built assertions for simulation scenarios
+ *
+ * All assertion functions are pure (no side effects).
+ * Default thresholds are production-safe.
+ * Custom assertions allow escape hatch.
+ */
+// =============================================================================
+// ASSERTION BUILDERS
+// =============================================================================
+/**
+ * Pre-built assertions for common metrics.
+ *
+ * @example
+ * ```typescript
+ * export const myScenario = defineLoadScenario({
+ *   // ...
+ *   assertions: [
+ *     ASSERTIONS.lowErrorRate(),
+ *     ASSERTIONS.lowLatency('p95', 500),
+ *     ASSERTIONS.minThroughput(100),
+ *   ],
+ * });
+ * ```
+ */
+export const ASSERTIONS = {
+    // ===========================================================================
+    // ERROR RATE
+    // ===========================================================================
+    /**
+     * Assert that error rate is below threshold.
+     * @param threshold - Maximum error rate (0-1). Default: 0.05 (5%)
+     */
+    lowErrorRate: (threshold = 0.05) => ({
+        metric: 'error_rate',
+        operator: 'lt',
+        value: threshold,
+        message: `Error rate must be < ${(threshold * 100).toFixed(1)}%`,
+    }),
+    /**
+     * Assert zero errors.
+     */
+    zeroErrors: () => ({
+        metric: 'error_rate',
+        operator: 'eq',
+        value: 0,
+        message: 'Error rate must be 0%',
+    }),
+    // ===========================================================================
+    // LATENCY
+    // ===========================================================================
+    /**
+     * Assert that latency percentile is below threshold.
+     * @param percentile - Which percentile to check (p50, p95, p99)
+     * @param thresholdMs - Maximum latency in milliseconds
+     */
+    lowLatency: (percentile = 'p95', thresholdMs = 500) => ({
+        metric: `${percentile}_latency_ms`,
+        operator: 'lt',
+        value: thresholdMs,
+        message: `${percentile.toUpperCase()} latency must be < ${thresholdMs}ms`,
+    }),
+    /**
+     * Assert that average latency is below threshold.
+     * @param thresholdMs - Maximum average latency in milliseconds
+     */
+    avgLatency: (thresholdMs = 200) => ({
+        metric: 'avg_latency_ms',
+        operator: 'lt',
+        value: thresholdMs,
+        message: `Average latency must be < ${thresholdMs}ms`,
+    }),
+    /**
+     * Assert that max latency is below threshold.
+     * @param thresholdMs - Maximum latency in milliseconds
+     */
+    maxLatency: (thresholdMs = 2000) => ({
+        metric: 'max_latency_ms',
+        operator: 'lt',
+        value: thresholdMs,
+        message: `Max latency must be < ${thresholdMs}ms`,
+    }),
+    // ===========================================================================
+    // THROUGHPUT
+    // ===========================================================================
+    /**
+     * Assert minimum throughput.
+     * @param rps - Minimum requests per second
+     */
+    minThroughput: (rps) => ({
+        metric: 'requests_per_second',
+        operator: 'gte',
+        value: rps,
+        message: `Throughput must be >= ${rps} RPS`,
+    }),
+    /**
+     * Assert maximum throughput (useful for rate limiting tests).
+     * @param rps - Maximum requests per second
+     */
+    maxThroughput: (rps) => ({
+        metric: 'requests_per_second',
+        operator: 'lte',
+        value: rps,
+        message: `Throughput must be <= ${rps} RPS`,
+    }),
+    // ===========================================================================
+    // SUCCESS RATE
+    // ===========================================================================
+    /**
+     * Assert high success rate.
+     * @param threshold - Minimum success rate (0-1). Default: 0.95 (95%)
+     */
+    highSuccessRate: (threshold = 0.95) => ({
+        metric: 'success_rate',
+        operator: 'gte',
+        value: threshold,
+        message: `Success rate must be >= ${(threshold * 100).toFixed(1)}%`,
+    }),
+    /**
+     * Assert 100% success rate.
+     */
+    perfectSuccessRate: () => ({
+        metric: 'success_rate',
+        operator: 'eq',
+        value: 1,
+        message: 'Success rate must be 100%',
+    }),
+    // ===========================================================================
+    // RESOURCE USAGE
+    // ===========================================================================
+    /**
+     * Assert memory usage is below threshold.
+     * @param thresholdMb - Maximum memory in megabytes
+     */
+    memoryUsage: (thresholdMb) => ({
+        metric: 'memory_mb',
+        operator: 'lt',
+        value: thresholdMb,
+        message: `Memory usage must be < ${thresholdMb}MB`,
+    }),
+    /**
+     * Assert CPU usage is below threshold.
+     * @param threshold - Maximum CPU percentage (0-100)
+     */
+    cpuUsage: (threshold) => ({
+        metric: 'cpu_percent',
+        operator: 'lt',
+        value: threshold,
+        message: `CPU usage must be < ${threshold}%`,
+    }),
+    // ===========================================================================
+    // CUSTOM
+    // ===========================================================================
+    /**
+     * Create a custom assertion.
+     *
+     * @example
+     * ```typescript
+     * ASSERTIONS.custom('listing_creation_time_ms', 'lt', 1000, 'Listing creation must be < 1s')
+     * ```
+     */
+    custom: (metric, operator, value, message) => ({
+        metric,
+        operator,
+        value,
+        message: message ?? `${metric} ${operator} ${value}`,
+    }),
+};
+// =============================================================================
+// ASSERTION EVALUATION
+// =============================================================================
+/**
+ * Evaluate an operator comparison (low-level).
+ */
+export function evaluateOperator(actual, operator, expected) {
+    switch (operator) {
+        case 'lt': {
+            return actual < expected;
+        }
+        case 'lte': {
+            return actual <= expected;
+        }
+        case 'gt': {
+            return actual > expected;
+        }
+        case 'gte': {
+            return actual >= expected;
+        }
+        case 'eq': {
+            return actual === expected;
+        }
+        case 'neq': {
+            return actual !== expected;
+        }
+        default: {
+            return false;
+        }
+    }
+}
+/**
+ * Evaluate an assertion against an actual value.
+ */
+export function evaluateAssertion(assertion, actual) {
+    switch (assertion.operator) {
+        case 'lt': {
+            return actual < assertion.value;
+        }
+        case 'lte': {
+            return actual <= assertion.value;
+        }
+        case 'gt': {
+            return actual > assertion.value;
+        }
+        case 'gte': {
+            return actual >= assertion.value;
+        }
+        case 'eq': {
+            return actual === assertion.value;
+        }
+        case 'neq': {
+            return actual !== assertion.value;
+        }
+        default: {
+            return false;
+        }
+    }
+}
+/**
+ * Get a human-readable description of an operator.
+ */
+export function getOperatorDescription(operator) {
+    switch (operator) {
+        case 'lt': {
+            return 'less than';
+        }
+        case 'lte': {
+            return 'at most';
+        }
+        case 'gt': {
+            return 'greater than';
+        }
+        case 'gte': {
+            return 'at least';
+        }
+        case 'eq': {
+            return 'equal to';
+        }
+        case 'neq': {
+            return 'not equal to';
+        }
+        default: {
+            return operator;
+        }
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/dist/framework/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../src/framework/assertions.ts"],"names":[],"mappings":"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"}

package/dist/framework/execution/__tests__/execution-engine.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Unit tests for execution-engine utilities.
+ *
+ * The orchestration loop is exercised by scenario-execution.test.ts;
+ * this file targets the helper functions that are exported as the
+ * public API of the engine.
+ */
+export {};
+//# sourceMappingURL=execution-engine.test.d.ts.map

package/dist/framework/execution/__tests__/execution-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-engine.test.d.ts","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/execution-engine.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/framework/execution/__tests__/execution-engine.test.js

@@ -0,0 +1,138 @@
+/**
+ * @fileoverview Unit tests for execution-engine utilities.
+ *
+ * The orchestration loop is exercised by scenario-execution.test.ts;
+ * this file targets the helper functions that are exported as the
+ * public API of the engine.
+ */
+import { describe, expect, it } from 'vitest';
+import { resolveMetric } from '../../resolve-metric.js';
+import { createEmptyMetrics } from '../../result-builder.js';
+import { ScenarioAbortedError, scenarioAborted, sleepWithAbort, updateLatencyMetrics, validateAssertions, } from '../execution-engine.js';
+const baseMetrics = (overrides = {}) => ({
+    ...createEmptyMetrics(),
+    totalRequests: 100,
+    successfulRequests: 99,
+    failedRequests: 1,
+    avgLatencyMs: 50,
+    p50LatencyMs: 40,
+    p95LatencyMs: 80,
+    p99LatencyMs: 120,
+    ...overrides,
+});
+describe('validateAssertions', () => {
+    it('returns passed=true when every assertion holds', () => {
+        const assertions = [
+            { metric: 'error_rate', operator: 'lt', value: 0.5, message: 'low error rate' },
+            { metric: 'success_rate', operator: 'gt', value: 0.5, message: 'high success rate' },
+        ];
+        const out = validateAssertions(baseMetrics(), assertions);
+        expect(out.passed).toBe(true);
+        expect(out.failed).toEqual([]);
+    });
+    it('returns failed entries with the actual value', () => {
+        const assertions = [
+            { metric: 'error_rate', operator: 'lt', value: 0.001, message: 'extreme low error' },
+        ];
+        const out = validateAssertions(baseMetrics(), assertions);
+        expect(out.passed).toBe(false);
+        expect(out.failed).toHaveLength(1);
+        expect(out.failed[0]?.actual).toBeCloseTo(0.01);
+    });
+    it('returns passed=false / failed=[] when assertions is not an array', () => {
+        const out = validateAssertions(baseMetrics(), undefined);
+        expect(out.passed).toBe(false);
+        expect(out.failed).toEqual([]);
+    });
+    it('honors an empty assertion list as passing', () => {
+        expect(validateAssertions(baseMetrics(), []).passed).toBe(true);
+    });
+});
+describe('resolveMetric (via validateAssertions)', () => {
+    it.each([
+        ['error_rate', baseMetrics({ totalRequests: 100, failedRequests: 25 }), 0.25],
+        ['error_rate', baseMetrics({ totalRequests: 0 }), 0],
+        ['success_rate', baseMetrics({ totalRequests: 100, successfulRequests: 90 }), 0.9],
+        // Per resolve-metric.ts: success_rate is 0 when totalRequests === 0 (tightening choice).
+        ['success_rate', baseMetrics({ totalRequests: 0 }), 0],
+        ['recovery_rate', baseMetrics({ errorsGenerated: 10, failedRequests: 2 }), 0.8],
+        ['recovery_rate', baseMetrics({ errorsGenerated: 0 }), 1],
+        ['p50_latency', baseMetrics({ p50LatencyMs: 40 }), 40],
+        ['p50_latency_ms', baseMetrics({ p50LatencyMs: 40 }), 40],
+        ['p95_latency_ms', baseMetrics({ p95LatencyMs: 80 }), 80],
+        ['p99_latency_ms', baseMetrics({ p99LatencyMs: 120 }), 120],
+        ['avg_latency_ms', baseMetrics({ avgLatencyMs: 60 }), 60],
+        ['total_requests', baseMetrics({ totalRequests: 5 }), 5],
+        ['failed_requests', baseMetrics({ failedRequests: 3 }), 3],
+    ])('resolveMetric(%s)', (metric, metrics, expected) => {
+        expect(resolveMetric(metric, metrics)).toBeCloseTo(expected);
+    });
+});
+describe('updateLatencyMetrics', () => {
+    it('seeds all percentile fields on the first sample', () => {
+        const m = createEmptyMetrics();
+        updateLatencyMetrics(m, 100);
+        expect(m.avgLatencyMs).toBe(100);
+        expect(m.p50LatencyMs).toBe(100);
+        expect(m.p95LatencyMs).toBe(100);
+        expect(m.p99LatencyMs).toBe(100);
+    });
+    it('updates the running average on subsequent samples', () => {
+        const m = { ...createEmptyMetrics(), totalRequests: 1, avgLatencyMs: 100 };
+        // After: n=1, avg becomes (100*0 + sample)/1 — but the function expects
+        // `metrics.totalRequests` to be the count BEFORE incrementing.
+        updateLatencyMetrics(m, 200);
+        expect(m.avgLatencyMs).toBe(200);
+    });
+    it('approximates percentiles as multiples of the average for n>=1', () => {
+        const m = { ...createEmptyMetrics(), totalRequests: 2, avgLatencyMs: 100 };
+        updateLatencyMetrics(m, 200);
+        expect(m.p50LatencyMs).toBeCloseTo(m.avgLatencyMs * 0.9);
+        expect(m.p95LatencyMs).toBeCloseTo(m.avgLatencyMs * 1.5);
+        expect(m.p99LatencyMs).toBeCloseTo(m.avgLatencyMs * 2);
+    });
+});
+describe('sleepWithAbort', () => {
+    it('resolves after the specified delay', async () => {
+        const ac = new AbortController();
+        const start = Date.now();
+        await sleepWithAbort(20, ac.signal);
+        expect(Date.now() - start).toBeGreaterThanOrEqual(15);
+    });
+    it('rejects immediately when the signal is already aborted', async () => {
+        const ac = new AbortController();
+        ac.abort();
+        await expect(sleepWithAbort(1000, ac.signal)).rejects.toThrow(ScenarioAbortedError);
+    });
+    it('rejects when the signal is aborted mid-sleep', async () => {
+        const ac = new AbortController();
+        const promise = sleepWithAbort(10_000, ac.signal);
+        setTimeout(() => ac.abort(), 5);
+        await expect(promise).rejects.toThrow(ScenarioAbortedError);
+    });
+});
+describe('scenarioAborted', () => {
+    it('returns silently when signal is undefined', () => {
+        expect(() => scenarioAborted(undefined)).not.toThrow();
+    });
+    it('returns silently when signal is not aborted', () => {
+        const ac = new AbortController();
+        expect(() => scenarioAborted(ac.signal)).not.toThrow();
+    });
+    it('throws ScenarioAbortedError when signal is aborted', () => {
+        const ac = new AbortController();
+        ac.abort();
+        expect(() => scenarioAborted(ac.signal, 'sid')).toThrow(ScenarioAbortedError);
+    });
+});
+describe('ScenarioAbortedError', () => {
+    it('carries the scenario id when one is supplied', () => {
+        const err = new ScenarioAbortedError('s1');
+        expect(err.message).toContain('s1');
+    });
+    it('uses an unknown placeholder when no id is supplied', () => {
+        const err = new ScenarioAbortedError();
+        expect(err.message.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=execution-engine.test.js.map

package/dist/framework/execution/__tests__/execution-engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-engine.test.js","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/execution-engine.test.ts"],"names":[],"mappings":"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"}

package/dist/framework/execution/__tests__/fault-builders.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Tests for the fault.* builders.
+ */
+export {};
+//# sourceMappingURL=fault-builders.test.d.ts.map

package/dist/framework/execution/__tests__/fault-builders.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-builders.test.d.ts","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/fault-builders.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/framework/execution/__tests__/fault-builders.test.js

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Tests for the fault.* builders.
+ */
+import { describe, expect, it } from 'vitest';
+import { fault } from '../fault-builders.js';
+describe('fault builders', () => {
+    it('latency', () => {
+        expect(fault.latency({ ms: 5 })).toEqual({ kind: 'latency', ms: 5 });
+    });
+    it('abort', () => {
+        expect(fault.abort()).toEqual({ kind: 'abort' });
+    });
+    it('drop', () => {
+        expect(fault.drop()).toEqual({ kind: 'drop' });
+    });
+    it('of assembles a probability-gated spec', () => {
+        expect(fault.of([fault.drop(), fault.abort()], { probability: 0.3 })).toEqual({
+            faults: [{ kind: 'drop' }, { kind: 'abort' }],
+            probability: 0.3,
+        });
+    });
+});
+//# sourceMappingURL=fault-builders.test.js.map

package/dist/framework/execution/__tests__/fault-builders.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-builders.test.js","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/fault-builders.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACjB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACf,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACd,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5E,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC7C,WAAW,EAAE,GAAG;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/framework/execution/__tests__/fault-model.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Behaviour tests for the client-side fault model. Determinism
+ * comes from an injected RNG sequence so perturbed counts are exact.
+ */
+export {};
+//# sourceMappingURL=fault-model.test.d.ts.map

package/dist/framework/execution/__tests__/fault-model.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-model.test.d.ts","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/fault-model.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/framework/execution/__tests__/fault-model.test.js

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Behaviour tests for the client-side fault model. Determinism
+ * comes from an injected RNG sequence so perturbed counts are exact.
+ */
+import { describe, expect, it } from 'vitest';
+import { countingTarget, noopTarget } from '../../../__tests__/test-utils/targets.js';
+import { fault } from '../fault-builders.js';
+import { createFaultModel } from '../fault-model.js';
+const ctx = { signal: new AbortController().signal, correlationId: 'c' };
+/** RNG that walks a fixed sequence (wraps). */
+const seq = (vals) => {
+    let i = 0;
+    return () => vals[i++ % vals.length] ?? 0;
+};
+describe('createFaultModel', () => {
+    it('perturbs exactly the requests whose draw < probability', async () => {
+        const ct = countingTarget();
+        const fm = createFaultModel(fault.of([fault.drop()], { probability: 0.5 }), {
+            rng: seq([0.4, 0.6, 0.4, 0.6]),
+        });
+        const wrapped = fm.wrap(ct.target);
+        const results = await Promise.allSettled([
+            wrapped(ctx),
+            wrapped(ctx),
+            wrapped(ctx),
+            wrapped(ctx),
+        ]);
+        // Draws 0.4 and 0.4 (< 0.5) → dropped (rejected); 0.6 and 0.6 → passed through.
+        expect(results.filter((r) => r.status === 'rejected')).toHaveLength(2);
+        expect(ct.calls()).toBe(2); // dropped requests never reach the target
+        expect(fm.drained()).toHaveLength(2);
+        expect(fm.drained().every((f) => f.kind === 'drop')).toBe(true);
+    });
+    it('latency fault delays the real call (target still runs)', async () => {
+        const ct = countingTarget();
+        const fm = createFaultModel(fault.of([fault.latency({ ms: 50 })], { probability: 1 }), {
+            rng: () => 0,
+        });
+        const start = Date.now();
+        await fm.wrap(ct.target)(ctx);
+        expect(Date.now() - start).toBeGreaterThanOrEqual(45);
+        expect(ct.calls()).toBe(1);
+    });
+    it('abort fault fails even when the target ignores the signal', async () => {
+        const fm = createFaultModel(fault.of([fault.abort()], { probability: 1 }), { rng: () => 0 });
+        await expect(fm.wrap(noopTarget)(ctx)).rejects.toThrow();
+        expect(fm.drained()).toHaveLength(1);
+        expect(fm.drained()[0]?.kind).toBe('abort');
+    });
+    it('does not perturb when probability is 0', async () => {
+        const ct = countingTarget();
+        const fm = createFaultModel(fault.of([fault.drop()], { probability: 0 }), { rng: () => 0 });
+        await fm.wrap(ct.target)(ctx);
+        expect(ct.calls()).toBe(1);
+        expect(fm.drained()).toHaveLength(0);
+    });
+    it('round-robins across multiple fault kinds deterministically', async () => {
+        const fm = createFaultModel(fault.of([fault.drop(), fault.latency({ ms: 1 })], { probability: 1 }), { rng: () => 0 });
+        const wrapped = fm.wrap(noopTarget);
+        await Promise.allSettled([wrapped(ctx), wrapped(ctx), wrapped(ctx)]);
+        expect(fm.drained().map((f) => f.kind)).toEqual(['drop', 'latency', 'drop']);
+    });
+});
+//# sourceMappingURL=fault-model.test.js.map

package/dist/framework/execution/__tests__/fault-model.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-model.test.js","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/fault-model.test.ts"],"names":[],"mappings":"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"}

package/dist/framework/execution/__tests__/http-target.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Tests for the httpTarget helper (fetch stubbed).
+ */
+export {};
+//# sourceMappingURL=http-target.test.d.ts.map

package/dist/framework/execution/__tests__/http-target.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-target.test.d.ts","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/http-target.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/framework/execution/__tests__/http-target.test.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Tests for the httpTarget helper (fetch stubbed).
+ */
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { httpTarget } from '../http-target.js';
+const ctx = { signal: new AbortController().signal, correlationId: 'c' };
+const respond = (body, status) => () => Promise.resolve(new Response(body, { status }));
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+describe('httpTarget', () => {
+    it('resolves on a 2xx', async () => {
+        vi.stubGlobal('fetch', vi.fn(respond('ok', 200)));
+        await expect(httpTarget({ url: 'https://x.test' })(ctx)).resolves.toBeUndefined();
+    });
+    it('throws on a non-2xx, carrying the status', async () => {
+        vi.stubGlobal('fetch', vi.fn(respond('no', 503)));
+        await expect(httpTarget({ url: 'https://x.test' })(ctx)).rejects.toThrow(/503/);
+    });
+    it('forwards method, headers, body, and the abort signal', async () => {
+        const f = vi.fn(respond('ok', 200));
+        vi.stubGlobal('fetch', f);
+        await httpTarget({ url: 'https://x.test', method: 'POST', headers: { a: 'b' }, body: 'p' })(ctx);
+        expect(f).toHaveBeenCalledWith('https://x.test', expect.objectContaining({
+            method: 'POST',
+            headers: { a: 'b' },
+            body: 'p',
+            signal: ctx.signal,
+        }));
+    });
+    it('honours a custom okStatus predicate', async () => {
+        vi.stubGlobal('fetch', vi.fn(respond('nope', 404)));
+        await expect(httpTarget({ url: 'https://x.test', okStatus: (s) => s === 404 })(ctx)).resolves.toBeUndefined();
+    });
+});
+//# sourceMappingURL=http-target.test.js.map

package/dist/framework/execution/__tests__/http-target.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-target.test.js","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/http-target.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAI/C,MAAM,GAAG,GAAkB,EAAE,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;AAExF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE,CAAC,GAAG,EAAE,CACrD,OAAO,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AAElD,SAAS,CAAC,GAAG,EAAE;IACb,EAAE,CAAC,eAAe,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACjC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACpC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC1B,MAAM,UAAU,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CACzF,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAC5B,gBAAgB,EAChB,MAAM,CAAC,gBAAgB,CAAC;YACtB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE;YACnB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,MAAM,CACV,UAAU,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CACvE,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/framework/execution/__tests__/run-load-window.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Behaviour tests for the real load-window driver: it drives a
+ * BYO target, measures latency, classifies outcomes, bounds concurrency, and
+ * honours abort.
+ */
+export {};
+//# sourceMappingURL=run-load-window.test.d.ts.map

package/dist/framework/execution/__tests__/run-load-window.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-load-window.test.d.ts","sourceRoot":"","sources":["../../../../src/framework/execution/__tests__/run-load-window.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}