@overkill-dev/simulation 0.0.1 → 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Overkill contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,7 +1,35 @@
 {
-  "name": "@overkill-dev/simulation",
-  "version": "0.0.1",
-  "description": "Placeholder claiming the npm package name \"@overkill-dev/simulation\" so a trusted publisher can be configured. See https://github.com/npm/cli/issues/8544.",
-  "license": "MIT",
-  "deprecated": "Placeholder published as a workaround so a Trusted Publisher could be configured. See https://github.com/npm/cli/issues/8544."
-}
+    "author": "Christian Rackerseder <git@echooff.de>",
+    "bugs": {
+        "url": "https://github.com/enormora/overkill/issues"
+    },
+    "description": "Finite simulation descriptors and simulated server launchers for Overkill.",
+    "engines": {
+        "node": "^26.9.0"
+    },
+    "exports": {
+        ".": {
+            "import": "./packages/simulation/simulation.entry-point.js",
+            "types": "./packages/simulation/simulation.entry-point.d.ts"
+        },
+        "./http": {
+            "import": "./packages/simulation/http.entry-point.js",
+            "types": "./packages/simulation/http.entry-point.d.ts"
+        }
+    },
+    "homepage": "https://github.com/enormora/overkill#readme",
+    "keywords": [
+        "tdd",
+        "test",
+        "tests"
+    ],
+    "license": "MIT",
+    "name": "@overkill-dev/simulation",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/enormora/overkill.git"
+    },
+    "sideEffects": false,
+    "type": "module",
+    "version": "0.0.3"
+}

package/packages/simulation/http.entry-point.d.ts

@@ -0,0 +1,3 @@
+export { assertNoSimulatedHttpHandlerErrors, createSimulatedHttpListeningServer, startSimulatedHttpServer } from '../../simulation/simulated-http-server.ts';
+export type { SimulatedHttpListeningServer, SimulatedHttpServerHandle, SimulatedHttpServerOptions } from '../../simulation/simulated-http-server.ts';
+//# sourceMappingURL=http.entry-point.d.ts.map

package/packages/simulation/http.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/simulation/http.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,kCAAkC,EAClC,kCAAkC,EAClC,wBAAwB,EAC3B,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACR,4BAA4B,EAC5B,yBAAyB,EACzB,0BAA0B,EAC7B,MAAM,2CAA2C,CAAC"}

package/packages/simulation/http.entry-point.js

@@ -0,0 +1,2 @@
+export { assertNoSimulatedHttpHandlerErrors, createSimulatedHttpListeningServer, startSimulatedHttpServer } from "../../simulation/simulated-http-server.js";
+//# sourceMappingURL=http.entry-point.js.map

package/packages/simulation/http.entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/simulation/http.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,kCAAkC,EAClC,kCAAkC,EAClC,wBAAwB,EAC3B,MAAM,2CAA2C,CAAC"}

package/packages/simulation/simulation.entry-point.d.ts

@@ -0,0 +1,3 @@
+export { defineSimulatedHttpServer, defineSimulation, isDefinedSimulatedHttpServer, isDefinedSimulation } from '../../simulation/simulation.ts';
+export type { ScenarioKeyOf, SimulatedHttpHandler, SimulatedHttpRequestScenario, SimulatedHttpServerDefinition, SimulatedHttpServerDefinitionInput, SimulationDefinition, SimulationDefinitionInput, SimulationScenarioCatalog, SimulationScenarioDescriptor, SimulationScenarioFor, SimulationScenarioKey } from '../../simulation/simulation.ts';
+//# sourceMappingURL=simulation.entry-point.d.ts.map

package/packages/simulation/simulation.entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation.entry-point.d.ts","sourceRoot":"","sources":["../../../../../source/packages/simulation/simulation.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EACzB,gBAAgB,EAChB,4BAA4B,EAC5B,mBAAmB,EACtB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACR,aAAa,EACb,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,kCAAkC,EAClC,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACxB,MAAM,gCAAgC,CAAC"}

package/packages/simulation/simulation.entry-point.js

@@ -0,0 +1,2 @@
+export { defineSimulatedHttpServer, defineSimulation, isDefinedSimulatedHttpServer, isDefinedSimulation } from "../../simulation/simulation.js";
+//# sourceMappingURL=simulation.entry-point.js.map

package/packages/simulation/simulation.entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation.entry-point.js","sourceRoot":"","sources":["../../../../../source/packages/simulation/simulation.entry-point.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EACzB,gBAAgB,EAChB,4BAA4B,EAC5B,mBAAmB,EACtB,MAAM,gCAAgC,CAAC"}

package/readme.md

@@ -1,7 +1,27 @@
-# @overkill-dev/simulation
+# `@overkill-dev/simulation`
 
-This version is a placeholder published only to claim the npm name `@overkill-dev/simulation` so a Trusted Publisher
-can subsequently be configured for it. It contains no real package content and is published already
-deprecated.
+Finite simulation descriptors for Overkill resource-backed tests.
 
-Workaround context: https://github.com/npm/cli/issues/8544
+```ts
+import { defineSimulatedHttpServer } from '@overkill-dev/simulation';
+
+const api = defineSimulatedHttpServer({
+    name: 'api',
+    scenarios: {
+        default: { title: 'standard responses' },
+        'payments-500': { status: 500, title: 'payment service fails' }
+    },
+    handle(_request, scenario) {
+        return Response.json({ scenario: scenario.key });
+    }
+});
+```
+
+Every simulation has a `default` scenario. Scenario descriptors require a
+`title` and may carry additional typed data for the simulator.
+
+Use `@overkill-dev/simulation/http` to launch a simulated HTTP server manually.
+Use `createSimulatedHttpServerResource(...)` from `@overkill-dev/resources`
+when a test runtime should own the server lifecycle. The resource adapter
+requires an explicit local address request, for example
+`{ kind: 'loopback', port: 0 }`.

package/sbom.cdx.json

@@ -0,0 +1,30 @@
+{
+    "$schema": "http://cyclonedx.org/schema/bom-1.6.schema.json",
+    "bomFormat": "CycloneDX",
+    "specVersion": "1.6",
+    "version": 1,
+    "metadata": {
+        "tools": {
+            "components": [
+                {
+                    "type": "application",
+                    "name": "packtory",
+                    "version": "0.0.97"
+                }
+            ]
+        },
+        "component": {
+            "type": "library",
+            "name": "@overkill-dev/simulation",
+            "version": "0.0.3",
+            "bom-ref": "pkg:npm/@overkill-dev/simulation@0.0.3",
+            "purl": "pkg:npm/@overkill-dev/simulation@0.0.3"
+        }
+    },
+    "components": [],
+    "dependencies": [
+        {
+            "ref": "pkg:npm/@overkill-dev/simulation@0.0.3"
+        }
+    ]
+}

package/simulation/simulated-http-server.d.ts

@@ -0,0 +1,40 @@
+import { type SimulatedHttpServerDefinition, type SimulationScenarioCatalog } from './simulation.ts';
+export type SimulatedHttpServerOptions<Name extends string, Scenarios extends SimulationScenarioCatalog> = {
+    readonly host?: string;
+    readonly port?: number;
+    readonly simulation: SimulatedHttpServerDefinition<Name, Scenarios>;
+};
+type SimulationWithScenarios = {
+    readonly scenarios: SimulationScenarioCatalog;
+};
+export type SimulatedHttpServerHandle<Simulation extends SimulationWithScenarios> = AsyncDisposable & {
+    readonly baseUrl: string;
+    readonly dispose: () => Promise<void>;
+    readonly scenarioUrl: (scenario: string & keyof Simulation['scenarios'], path: string) => string;
+};
+type ServerAddress = {
+    readonly port: number;
+};
+type ServerLifecycle = {
+    readonly address: () => ServerAddress | string | null;
+    readonly close: (callback: (error?: Error) => void) => unknown;
+    readonly listen: (port: number, host: string) => unknown;
+    readonly listening: boolean;
+    readonly off: {
+        (event: 'error', listener: (error: Error) => void): unknown;
+        (event: 'listening', listener: () => void): unknown;
+    };
+    readonly once: {
+        (event: 'error', listener: (error: Error) => void): unknown;
+        (event: 'listening', listener: () => void): unknown;
+    };
+};
+export type SimulatedHttpListeningServer = {
+    readonly errors: readonly unknown[];
+    readonly server: ServerLifecycle;
+};
+export declare function createSimulatedHttpListeningServer<Scenarios extends SimulationScenarioCatalog>(simulation: SimulatedHttpServerDefinition<string, Scenarios>, host: string): SimulatedHttpListeningServer;
+export declare function assertNoSimulatedHttpHandlerErrors(handlerErrors: readonly unknown[]): void;
+export declare function startSimulatedHttpServer<const Name extends string, const Scenarios extends SimulationScenarioCatalog>(options: SimulatedHttpServerOptions<Name, Scenarios>): Promise<SimulatedHttpServerHandle<SimulatedHttpServerDefinition<Name, Scenarios>>>;
+export {};
+//# sourceMappingURL=simulated-http-server.d.ts.map

package/simulation/simulated-http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulated-http-server.d.ts","sourceRoot":"","sources":["../../../../source/simulation/simulated-http-server.ts"],"names":[],"mappings":"AACA,OAAO,EAEH,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EACjC,MAAM,iBAAiB,CAAC;AAMzB,MAAM,MAAM,0BAA0B,CAClC,IAAI,SAAS,MAAM,EACnB,SAAS,SAAS,yBAAyB,IAC3C;IACA,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;CACvE,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC3B,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,yBAAyB,CAAC,UAAU,SAAS,uBAAuB,IAAI,eAAe,GAAG;IAClG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACpG,CAAC;AAMF,KAAK,aAAa,GAAG;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB,CAAC;AAIF,KAAK,eAAe,GAAG;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAAK,OAAO,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE;QACV,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;QAC5D,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;KACvD,CAAC;IACF,QAAQ,CAAC,IAAI,EAAE;QACX,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;QAC5D,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;KACvD,CAAC;CACL,CAAC;AAkBF,MAAM,MAAM,4BAA4B,GAAG;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CACpC,CAAC;AAgSF,wBAAgB,kCAAkC,CAAC,SAAS,SAAS,yBAAyB,EAC1F,UAAU,EAAE,6BAA6B,CAAC,MAAM,EAAE,SAAS,CAAC,EAC5D,IAAI,EAAE,MAAM,GACb,4BAA4B,CAQ9B;AAED,wBAAgB,kCAAkC,CAAC,aAAa,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAI1F;AAED,wBAAsB,wBAAwB,CAC1C,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,SAAS,SAAS,yBAAyB,EAEjD,OAAO,EAAE,0BAA0B,CAAC,IAAI,EAAE,SAAS,CAAC,GACrD,OAAO,CAAC,yBAAyB,CAAC,6BAA6B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAYpF"}

package/simulation/simulated-http-server.js

@@ -0,0 +1,235 @@
+import http, {} from 'node:http';
+import { isDefinedSimulatedHttpServer } from "./simulation.js";
+const scenarioQueryParameterName = '__overkill_scenario';
+const unknownScenarioStatus = 400;
+const handlerFailureStatus = 500;
+function asyncDisposeSymbol() {
+    const value = Reflect.get(Symbol, 'asyncDispose');
+    if (typeof value !== 'symbol') {
+        throw new TypeError('Runtime does not provide Symbol.asyncDispose.');
+    }
+    return value;
+}
+async function collectRequestBody(request) {
+    if (request.method === 'GET' || request.method === 'HEAD') {
+        return null;
+    }
+    return await new Promise(function collectBody(resolve, reject) {
+        const chunks = [];
+        request.on('data', function recordChunk(chunk) {
+            chunks.push(chunk);
+        });
+        request.on('error', reject);
+        request.on('end', function resolveBody() {
+            resolve(Buffer.concat(chunks));
+        });
+    });
+}
+function requestHeaders(request) {
+    const headers = new Headers();
+    for (const [name, value] of Object.entries(request.headers)) {
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                headers.append(name, item);
+            }
+        }
+        else if (value !== undefined) {
+            headers.set(name, value);
+        }
+    }
+    return headers;
+}
+async function responseBody(response) {
+    const body = await response.arrayBuffer();
+    return Buffer.from(body);
+}
+function scenarioUrl(baseUrl, scenario, path) {
+    const url = new URL(path, baseUrl);
+    url.searchParams.set(scenarioQueryParameterName, scenario);
+    return url.href;
+}
+function readListenAddress(server, host) {
+    const address = server.address();
+    if (typeof address !== 'object' || address === null) {
+        throw new TypeError('Simulated HTTP server did not expose a TCP address.');
+    }
+    return {
+        host,
+        port: address.port
+    };
+}
+function serverBaseUrl(server, host) {
+    const listenAddress = readListenAddress(server, host);
+    return `http://${listenAddress.host}:${listenAddress.port}`;
+}
+async function listen(server, host, port) {
+    return await new Promise(function startListening(resolve, reject) {
+        const listener = {
+            reject(error) {
+                server.off('listening', listener.resolve);
+                reject(error);
+            },
+            resolve() {
+                server.off('error', listener.reject);
+                resolve(readListenAddress(server, host));
+            }
+        };
+        server.once('error', listener.reject);
+        server.once('listening', listener.resolve);
+        server.listen(port, host);
+    });
+}
+async function closeServer(server) {
+    await new Promise(function close(resolve, reject) {
+        server.close(function finish(error) {
+            if (error === undefined) {
+                resolve();
+            }
+            else {
+                reject(error);
+            }
+        });
+    });
+}
+function webResponseHeaders(webResponse) {
+    const headers = {};
+    webResponse.headers.forEach(function recordHeader(value, name) {
+        headers[name] = value;
+    });
+    return headers;
+}
+async function sendWebResponse(response, webResponse) {
+    const body = await responseBody(webResponse);
+    response.writeHead(webResponse.status, webResponse.statusText, webResponseHeaders(webResponse));
+    response.end(body);
+}
+function sendTextResponse(response, status, body) {
+    response.writeHead(status);
+    response.end(body);
+}
+async function createWebRequest(request, baseUrl) {
+    const requestUrl = new URL(request.url ?? '/', baseUrl);
+    const scenario = requestUrl.searchParams.get(scenarioQueryParameterName) ?? 'default';
+    requestUrl.searchParams.delete(scenarioQueryParameterName);
+    const body = await collectRequestBody(request);
+    const init = {
+        headers: requestHeaders(request),
+        method: request.method ?? 'GET'
+    };
+    return {
+        request: body === null ? new Request(requestUrl, init) : new Request(requestUrl, { ...init, body }),
+        scenario
+    };
+}
+function disposalError(error) {
+    return error instanceof Error
+        ? error
+        : new Error('Simulation handler failed with a non-error value.', { cause: error });
+}
+function isSimulatedHttpServerHandle(handle) {
+    return Reflect.has(handle, asyncDisposeSymbol());
+}
+function simulatedHttpServerHandle(baseUrl, disposeServer) {
+    const handle = {
+        baseUrl,
+        scenarioUrl(scenario, path) {
+            return scenarioUrl(baseUrl, scenario, path);
+        },
+        dispose: disposeServer
+    };
+    Object.defineProperty(handle, asyncDisposeSymbol(), { value: disposeServer });
+    const frozenHandle = Object.freeze(handle);
+    if (isSimulatedHttpServerHandle(frozenHandle)) {
+        return frozenHandle;
+    }
+    throw new TypeError('Simulated HTTP server handle is incomplete.');
+}
+async function respondToSimulationRequest(response, simulation, request, scenario) {
+    if (!Object.hasOwn(simulation.scenarios, scenario)) {
+        sendTextResponse(response, unknownScenarioStatus, 'Unknown simulation scenario.');
+        return;
+    }
+    const scenarioKey = scenario;
+    const descriptor = simulation.scenarios[scenarioKey];
+    await sendWebResponse(response, await simulation.handle(request, { descriptor, key: scenarioKey }));
+}
+async function routeSimulationRequest(context) {
+    try {
+        const webRequest = await createWebRequest(context.request, context.baseUrl);
+        await respondToSimulationRequest(context.response, context.simulation, webRequest.request, webRequest.scenario);
+    }
+    catch (error) {
+        try {
+            context.recordError(error);
+            sendTextResponse(context.response, handlerFailureStatus, 'Simulation handler failed.');
+        }
+        catch (responseError) {
+            context.recordError(responseError);
+        }
+    }
+}
+function startGuardedRoute(routePromise) {
+    Reflect.get(routePromise, Symbol.toStringTag);
+}
+function createServer(simulation, host, recordError) {
+    const server = http.createServer(function handleRequest(request, response) {
+        startGuardedRoute(routeSimulationRequest({
+            request,
+            response,
+            simulation,
+            baseUrl: serverBaseUrl(server, host),
+            recordError
+        }));
+    });
+    return server;
+}
+async function listenBaseUrl(server, host, port) {
+    const listenAddress = await listen(server, host, port);
+    return `http://${listenAddress.host}:${listenAddress.port}`;
+}
+function createHandlerErrors() {
+    const errors = [];
+    return {
+        errors,
+        record(error) {
+            errors.push(error);
+        }
+    };
+}
+function createServerDisposal(server, handlerErrors) {
+    let disposal = null;
+    return async function disposeServer() {
+        if (disposal === null) {
+            disposal = closeServer(server);
+        }
+        await disposal;
+        if (handlerErrors[0] !== undefined) {
+            throw disposalError(handlerErrors[0]);
+        }
+    };
+}
+export function createSimulatedHttpListeningServer(simulation, host) {
+    const handlerErrors = createHandlerErrors();
+    const server = createServer(simulation, host, handlerErrors.record);
+    return {
+        errors: handlerErrors.errors,
+        server
+    };
+}
+export function assertNoSimulatedHttpHandlerErrors(handlerErrors) {
+    if (handlerErrors[0] !== undefined) {
+        throw disposalError(handlerErrors[0]);
+    }
+}
+export async function startSimulatedHttpServer(options) {
+    if (!isDefinedSimulatedHttpServer(options.simulation)) {
+        throw new TypeError('startSimulatedHttpServer() requires a simulated HTTP server definition.');
+    }
+    const host = options.host ?? '127.0.0.1';
+    const port = options.port ?? 0;
+    const listeningServer = createSimulatedHttpListeningServer(options.simulation, host);
+    const baseUrl = await listenBaseUrl(listeningServer.server, host, port);
+    const disposeServer = createServerDisposal(listeningServer.server, listeningServer.errors);
+    return simulatedHttpServerHandle(baseUrl, disposeServer);
+}
+//# sourceMappingURL=simulated-http-server.js.map

package/simulation/simulated-http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulated-http-server.js","sourceRoot":"","sources":["../../../../source/simulation/simulated-http-server.ts"],"names":[],"mappings":"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"}

package/simulation/simulation.d.ts

@@ -0,0 +1,42 @@
+declare const simulationDefinitionBrand: unique symbol;
+declare const simulatedHttpServerDefinitionBrand: unique symbol;
+export type SimulationScenarioDescriptor = {
+    readonly title: string;
+};
+export type SimulationScenarioCatalog = Readonly<Record<string, SimulationScenarioDescriptor>> & {
+    readonly default: SimulationScenarioDescriptor;
+};
+export type SimulationDefinitionInput<Name extends string, Scenarios extends SimulationScenarioCatalog> = {
+    readonly name: Name;
+    readonly scenarios: Scenarios;
+};
+export type SimulationDefinition<Name extends string = string, Scenarios extends SimulationScenarioCatalog = SimulationScenarioCatalog> = SimulationDefinitionInput<Name, Scenarios> & {
+    readonly kind: 'simulation';
+    readonly [simulationDefinitionBrand]: true;
+};
+export type SimulationScenarioKey<Simulation> = Simulation extends {
+    readonly scenarios: infer Scenarios extends SimulationScenarioCatalog;
+} ? string & keyof Scenarios : never;
+export type ScenarioKeyOf<Simulation> = SimulationScenarioKey<Simulation>;
+export type SimulationScenarioFor<Simulation, Scenario extends SimulationScenarioKey<Simulation>> = Simulation extends {
+    readonly scenarios: infer Scenarios extends SimulationScenarioCatalog;
+} ? Scenarios[Scenario] : never;
+export type SimulatedHttpRequestScenario<Scenario extends string, Descriptor extends SimulationScenarioDescriptor> = {
+    readonly descriptor: Descriptor;
+    readonly key: Scenario;
+};
+export type SimulatedHttpHandler<Scenarios extends SimulationScenarioCatalog> = <Scenario extends string & keyof Scenarios>(request: Request, scenario: SimulatedHttpRequestScenario<Scenario, Scenarios[Scenario]>) => Promise<Response> | Response;
+export type SimulatedHttpServerDefinitionInput<Name extends string, Scenarios extends SimulationScenarioCatalog> = SimulationDefinitionInput<Name, Scenarios> & {
+    readonly handle: SimulatedHttpHandler<Scenarios>;
+};
+export type SimulatedHttpServerDefinition<Name extends string = string, Scenarios extends SimulationScenarioCatalog = SimulationScenarioCatalog> = SimulatedHttpServerDefinitionInput<Name, Scenarios> & {
+    readonly kind: 'simulated-http-server';
+    readonly [simulationDefinitionBrand]: true;
+    readonly [simulatedHttpServerDefinitionBrand]: true;
+};
+export declare function defineSimulation<const Name extends string, const Scenarios extends SimulationScenarioCatalog>(definition: SimulationDefinitionInput<Name, Scenarios>): SimulationDefinition<Name, Scenarios>;
+export declare function defineSimulatedHttpServer<const Name extends string, const Scenarios extends SimulationScenarioCatalog>(definition: SimulatedHttpServerDefinitionInput<Name, Scenarios>): SimulatedHttpServerDefinition<Name, Scenarios>;
+export declare function isDefinedSimulation(value: unknown): value is SimulationDefinition;
+export declare function isDefinedSimulatedHttpServer(value: unknown): value is SimulatedHttpServerDefinition;
+export {};
+//# sourceMappingURL=simulation.d.ts.map

package/simulation/simulation.d.ts.map

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

package/simulation/simulation.js

@@ -0,0 +1,74 @@
+const simulationDefinitionBrand = Symbol('overkill.simulationDefinition');
+const simulatedHttpServerDefinitionBrand = Symbol('overkill.simulatedHttpServerDefinition');
+const descriptorNamePattern = /^[A-Za-z0-9._-]+$/u;
+function assertDescriptorName(kind, name) {
+    if (!descriptorNamePattern.test(name)) {
+        throw new TypeError(`${kind} "${name}" must match ${descriptorNamePattern.source}.`);
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertScenarioDescriptor(scenarioKey, descriptor) {
+    if (!isRecord(descriptor)) {
+        throw new TypeError(`Simulation scenario "${scenarioKey}" must be an object.`);
+    }
+    if (typeof descriptor.title !== 'string' || descriptor.title.length === 0) {
+        throw new TypeError(`Simulation scenario "${scenarioKey}" requires a non-empty title.`);
+    }
+}
+function scenarioCatalogEntries(scenarios) {
+    if (!isRecord(scenarios)) {
+        throw new TypeError('Simulation scenarios must be an object.');
+    }
+    const scenarioEntries = Object.entries(scenarios);
+    if (scenarioEntries.length === 0) {
+        throw new TypeError('Simulation scenarios must not be empty.');
+    }
+    if (!Object.hasOwn(scenarios, 'default')) {
+        throw new TypeError('Simulation scenarios must include a "default" scenario.');
+    }
+    return scenarioEntries;
+}
+function freezeScenarioCatalog(scenarios) {
+    const scenarioEntries = scenarioCatalogEntries(scenarios);
+    for (const [scenarioKey, descriptor] of scenarioEntries) {
+        assertDescriptorName('Simulation scenario', scenarioKey);
+        assertScenarioDescriptor(scenarioKey, descriptor);
+        Object.freeze(descriptor);
+    }
+    return Object.freeze(scenarios);
+}
+export function defineSimulation(definition) {
+    assertDescriptorName('Simulation', definition.name);
+    return Object.freeze({
+        name: definition.name,
+        scenarios: freezeScenarioCatalog(definition.scenarios),
+        kind: 'simulation',
+        [simulationDefinitionBrand]: true
+    });
+}
+export function defineSimulatedHttpServer(definition) {
+    if (typeof definition.handle !== 'function') {
+        throw new TypeError('Simulated HTTP server requires a handler function.');
+    }
+    const simulation = defineSimulation(definition);
+    return Object.freeze({
+        name: simulation.name,
+        scenarios: simulation.scenarios,
+        handle: definition.handle,
+        kind: 'simulated-http-server',
+        [simulationDefinitionBrand]: true,
+        [simulatedHttpServerDefinitionBrand]: true
+    });
+}
+export function isDefinedSimulation(value) {
+    return typeof value === 'object' &&
+        value !== null &&
+        Reflect.get(value, simulationDefinitionBrand) === true;
+}
+export function isDefinedSimulatedHttpServer(value) {
+    return isDefinedSimulation(value) &&
+        Reflect.get(value, simulatedHttpServerDefinitionBrand) === true;
+}
+//# sourceMappingURL=simulation.js.map

package/simulation/simulation.js.map

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