@kensio/simnaril 0.0.0 → 0.1.1

package/README.md

@@ -32,6 +32,8 @@ Simnaril requires Node.js 24 or later.
 - [Simulation environments](docs/simulation-environments/README.md)
 - [Resource state](docs/resource-state/README.md)
 - [REST resources](docs/rest-resources/README.md)
+- [Request bodies](docs/request-bodies/README.md)
 - [Custom operations](docs/custom-operations/README.md)
 - [Middleware](docs/middleware/README.md)
+- [Webhooks](docs/webhooks/README.md)
 - [Composing a simulation](docs/composing-a-simulation/README.md)

package/dist/api.d.ts

@@ -1,15 +1,37 @@
-import { type HttpMiddleware, type HttpOperationContext, type RawHttpOperation } from "./http/operation.js";
+import type { HttpMiddleware, RawHttpOperation } from "./http/operation.js";
+import type { ErrorFormatter } from "./http/error-formatter.js";
+import { type RawHttpOperationHandler } from "./http/raw-operation.js";
+import type { RequestDecoder } from "./http/request-decoder.js";
 import { RestResource } from "./rest-resource.js";
 import type { RestResourceProps } from "./rest-resource-operation.js";
 import { SimResource, type SimResourceProps } from "./resource.js";
+/** Configures behaviour shared by every resource on one simulated API. */
+export interface SimApiProps {
+    /** The service name used in route errors. `SimApi` when none is given. */
+    name?: string;
+    /**
+     * How request bodies are read, for the resources that read one.
+     *
+     * JSON when none is given. A resource or an operation can name its own, and
+     * the closest one wins.
+     */
+    decode?: RequestDecoder;
+    /**
+     * How a thrown error becomes a response.
+     *
+     * Runs before the supplied `EntityNotFoundError` and `DuplicateEntityError`
+     * mappings, and declining an error with `undefined` leaves it to them.
+     */
+    formatError?: ErrorFormatter;
+}
 /** Configures conventional resource state and its HTTP operations. */
 export interface SimApiResourceProps<T extends object> extends SimResourceProps<T>, RestResourceProps {
 }
-/** Handles a raw HTTP operation after Simnaril has matched its route. */
-export type RawHttpOperationHandler = (context: HttpOperationContext) => Promise<Response> | Response;
 /** Routes HTTP requests to stateful simulated resources. */
 export declare class SimApi {
     #private;
+    readonly name: string;
+    constructor(props?: SimApiProps);
     /** Adds middleware around every matched operation in this API. */
     use(middleware: HttpMiddleware): this;
     /** Creates resource state and exposes its conventional HTTP operations. */

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAEzB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAsB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,sEAAsE;AACtE,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CACnD,SAAQ,gBAAgB,CAAC,CAAC,CAAC,EAAE,iBAAiB;CAAG;AAEnD,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAElC,4DAA4D;AAC5D,qBAAa,MAAM;;IAIjB,kEAAkE;IAClE,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAGpC;IAED,2EAA2E;IAC3E,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAKzE;IAED,4EAA4E;IAC5E,MAAM,CAAC,CAAC,SAAS,MAAM,EACrB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,KAAK,EAAE,iBAAiB,GACvB,YAAY,CAAC,CAAC,CAAC,CAejB;IAED,6CAA6C;IAC7C,SAAS,CACP,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,uBAAuB,GAC9B,gBAAgB,CAelB;IAED,yEAAyE;IACzE,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE1C;CAkBF"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAsB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAQnE,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CACnD,SAAQ,gBAAgB,CAAC,CAAC,CAAC,EAAE,iBAAiB;CAAG;AAEnD,4DAA4D;AAC5D,qBAAa,MAAM;;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAKtB,YAAY,KAAK,GAAE,WAAgB,EAIlC;IAED,kEAAkE;IAClE,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAGpC;IAED,2EAA2E;IAC3E,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAUzE;IAED,4EAA4E;IAC5E,MAAM,CAAC,CAAC,SAAS,MAAM,EACrB,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,KAAK,EAAE,iBAAiB,GACvB,YAAY,CAAC,CAAC,CAAC,CAgBjB;IAED,6CAA6C;IAC7C,SAAS,CACP,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,uBAAuB,GAC9B,gBAAgB,CAKlB;IAED,yEAAyE;IACzE,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE1C;CAUF"}

package/dist/api.js

@@ -1,12 +1,23 @@
-import { createRawHttpOperation, operationMiddleware, } from "./http/operation.js";
 import { OperationRouter } from "./http/operation-router.js";
-import { compileRoute, normalizeMethod } from "./http/route.js";
+import { rawOperation, } from "./http/raw-operation.js";
+import { validateResourcePath } from "./http/resource-path.js";
 import { attachRestResource, RestResource } from "./rest-resource.js";
 import { SimResource } from "./resource.js";
+const resourcePathShape = (path) => path
+    .split("/")
+    .map((segment) => (segment.startsWith(":") ? ":" : segment))
+    .join("/");
 /** Routes HTTP requests to stateful simulated resources. */
 export class SimApi {
+    name;
     #paths = new Set();
-    #router = new OperationRouter();
+    #router;
+    #decode;
+    constructor(props = {}) {
+        this.name = props.name ?? "SimApi";
+        this.#decode = props.decode;
+        this.#router = new OperationRouter(this.name, props.formatError);
+    }
     /** Adds middleware around every matched operation in this API. */
     use(middleware) {
         this.#router.use(middleware);
@@ -14,53 +25,46 @@ export class SimApi {
     }
     /** Creates resource state and exposes its conventional HTTP operations. */
     resource(props) {
-        const { operations, path, ...stateProps } = props;
-        const restProps = operations === undefined ? { path } : { operations, path };
+        const { decode, itemPath, locate, operations, path, ...stateProps } = props;
+        const restProps = {
+            path,
+            ...(decode === undefined ? {} : { decode }),
+            ...(itemPath === undefined ? {} : { itemPath }),
+            ...(locate === undefined ? {} : { locate }),
+            ...(operations === undefined ? {} : { operations }),
+        };
         return this.expose(new SimResource(stateProps), restProps);
     }
     /** Exposes existing resource state through conventional HTTP operations. */
     expose(state, props) {
-        this.#validateResourcePath(props.path);
-        if (this.#paths.has(props.path)) {
+        validateResourcePath(props.path);
+        const pathShape = resourcePathShape(props.path);
+        if (this.#paths.has(pathShape)) {
             throw new TypeError(`A resource is already exposed at collection path "${props.path}".`);
         }
-        const resource = new RestResource(state, props);
+        const resource = new RestResource(state, this.#withApiDecode(props));
         attachRestResource(resource, (operation) => {
             this.#router.register(operation);
         });
-        this.#paths.add(props.path);
+        this.#paths.add(pathShape);
         return resource;
     }
     /** Adds a raw HTTP operation to this API. */
     operation(method, path, handle) {
-        const route = compileRoute(path);
-        const operation = createRawHttpOperation();
-        this.#router.register({
-            ...route,
-            decode: () => Promise.resolve(),
-            encode: (output) => output,
-            method: normalizeMethod(method),
-            middleware: operationMiddleware(operation),
-            operate: (_input, context) => handle(context),
-            resourceMiddleware: [],
-            transform: (decoded) => decoded,
-        });
-        return operation;
+        const built = rawOperation(method, path, handle);
+        this.#router.register(built.http);
+        return built.operation;
     }
     /** Handles one request through the matching simulated HTTP operation. */
     handle(request) {
         return this.#router.handle(request);
     }
-    #validateResourcePath(path) {
-        const base = new URL("https://simnaril.invalid");
-        const url = new URL(path, base);
-        if (url.origin !== base.origin ||
-            url.pathname !== path ||
-            url.search !== "" ||
-            url.hash !== "" ||
-            !/^\/[^/:]+(?:\/[^/:]+)*$/u.test(path)) {
-            throw new TypeError(`Expected a resource collection path such as "/widgets", received "${path}".`);
+    /** Applies the API's decoder to a resource that has not named its own. */
+    #withApiDecode(props) {
+        if (props.decode !== undefined || this.#decode === undefined) {
+            return props;
         }
+        return { ...props, decode: this.#decode };
     }
 }
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/http/decode-form.d.ts

@@ -0,0 +1,38 @@
+import type { RequestDecoder } from "./request-decoder.js";
+/**
+ * Reads an `application/x-www-form-urlencoded` body with bracketed nesting.
+ *
+ * A wire format, and not one service's dialect. Stripe, Rails and PHP
+ * applications all speak it, and all three write nesting the same way.
+ *
+ * ```text
+ * line_items[0][price_data][unit_amount]=250
+ * ```
+ *
+ * becomes
+ *
+ * ```json
+ * { "line_items": [{ "price_data": { "unit_amount": "250" } }] }
+ * ```
+ *
+ * Every leaf is a string. A form body carries no types, and guessing at them
+ * would make `quantity=1` and `postcode=01234` disagree about what a digit is.
+ * The resource's own creation behaviour converts what it needs.
+ *
+ * The header is ignored. What a body says it is and what it holds are two
+ * facts, and a decoder chosen by hand has already settled the first.
+ *
+ * ## What it refuses
+ *
+ * A real encoder emits well-formed keys. The cases below are hostile or
+ * mistaken input, and each throws a `SyntaxError`, the way a malformed JSON
+ * body already does.
+ *
+ * - A key given twice (`name=a&name=b`). Which one wins is a guess, and losing
+ *   half a request quietly is worse than stopping.
+ * - A key needing one part to hold both a value and more keys (`a=1&a[b]=2`).
+ * - An empty bracket anywhere but the end (`a[][b]=1`).
+ * - A key brackets cannot be read out of (`a[b`, `[a]`).
+ */
+export declare const decodeForm: RequestDecoder;
+//# sourceMappingURL=decode-form.d.ts.map

package/dist/http/decode-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-form.d.ts","sourceRoot":"","sources":["../../src/http/decode-form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,UAAU,EAAE,cASxB,CAAC"}

package/dist/http/decode-form.js

@@ -0,0 +1,119 @@
+/**
+ * Reads an `application/x-www-form-urlencoded` body with bracketed nesting.
+ *
+ * A wire format, and not one service's dialect. Stripe, Rails and PHP
+ * applications all speak it, and all three write nesting the same way.
+ *
+ * ```text
+ * line_items[0][price_data][unit_amount]=250
+ * ```
+ *
+ * becomes
+ *
+ * ```json
+ * { "line_items": [{ "price_data": { "unit_amount": "250" } }] }
+ * ```
+ *
+ * Every leaf is a string. A form body carries no types, and guessing at them
+ * would make `quantity=1` and `postcode=01234` disagree about what a digit is.
+ * The resource's own creation behaviour converts what it needs.
+ *
+ * The header is ignored. What a body says it is and what it holds are two
+ * facts, and a decoder chosen by hand has already settled the first.
+ *
+ * ## What it refuses
+ *
+ * A real encoder emits well-formed keys. The cases below are hostile or
+ * mistaken input, and each throws a `SyntaxError`, the way a malformed JSON
+ * body already does.
+ *
+ * - A key given twice (`name=a&name=b`). Which one wins is a guess, and losing
+ *   half a request quietly is worse than stopping.
+ * - A key needing one part to hold both a value and more keys (`a=1&a[b]=2`).
+ * - An empty bracket anywhere but the end (`a[][b]=1`).
+ * - A key brackets cannot be read out of (`a[b`, `[a]`).
+ */
+export const decodeForm = async (request) => {
+    const body = await request.text();
+    const root = new Map();
+    for (const [key, value] of new URLSearchParams(body)) {
+        insert(root, key, value);
+    }
+    return materialise(root);
+};
+/** A branch of the tree, as opposed to a leaf holding one value. */
+const isBranch = (held) => held instanceof Map;
+/** A key is a name followed by any number of bracketed parts. */
+const keyPattern = /^(?<name>[^[\]]+)(?<parts>(?:\[[^[\]]*\])*)$/u;
+const partPattern = /\[(?<part>[^[\]]*)\]/gu;
+const indexPattern = /^\d+$/u;
+/** The parts of one form key, outermost first. */
+function partsOf(key) {
+    const match = keyPattern.exec(key);
+    const name = match?.groups?.["name"];
+    if (name === undefined) {
+        throw new SyntaxError(`Form key "${key}" is not a name followed by bracketed parts.`);
+    }
+    const parts = [name];
+    for (const part of (match?.groups?.["parts"] ?? "").matchAll(partPattern)) {
+        parts.push(part.groups?.["part"] ?? "");
+    }
+    return parts;
+}
+/** Puts one key's value into the tree, growing branches on the way down. */
+function insert(root, key, value) {
+    const parts = partsOf(key);
+    let node = root;
+    for (const [depth, part] of parts.entries()) {
+        const last = depth === parts.length - 1;
+        if (part === "" && !last) {
+            throw new SyntaxError(`Form key "${key}" has an empty bracket before its last part.`);
+        }
+        // An empty bracket appends, and the position it takes is the branch's size.
+        const name = part === "" ? String(node.size) : part;
+        if (last) {
+            if (node.has(name)) {
+                throw new SyntaxError(`Form key "${key}" is given twice.`);
+            }
+            node.set(name, value);
+            return;
+        }
+        node = branchAt(node, name, key);
+    }
+}
+/** The branch below `name`, created when it is the first key to need one. */
+function branchAt(node, name, key) {
+    const held = node.get(name);
+    if (isBranch(held)) {
+        return held;
+    }
+    if (held !== undefined) {
+        throw new SyntaxError(`Form key "${key}" needs "${name}" to hold a value and more keys at once.`);
+    }
+    const branch = new Map();
+    node.set(name, branch);
+    return branch;
+}
+/**
+ * Turns the tree into arrays and objects.
+ *
+ * A branch whose every part is a run of digits becomes an array. The digits
+ * order the entries and do not position them, so `a[0]`, `a[5]` and `a[9]`
+ * give three elements and never a sparse array of ten. A real encoder counts
+ * from zero, where the two readings agree.
+ */
+function materialise(node) {
+    const entries = [...node].map(([name, held]) => [name, isBranch(held) ? materialise(held) : held]);
+    if (entries.length > 0 &&
+        entries.every(([name]) => indexPattern.test(name))) {
+        return entries
+            .toSorted(([one], [other]) => Number(one) - Number(other))
+            .map(([, held]) => held);
+    }
+    /*
+     * `Object.fromEntries` defines own data properties, so a `__proto__` part of
+     * a hostile key lands beside the others and reaches no prototype.
+     */
+    return Object.fromEntries(entries);
+}
+//# sourceMappingURL=decode-form.js.map

package/dist/http/decode-form.js.map

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

package/dist/http/error-formatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Turns an error thrown by an operation into the response one API answers with.
+ *
+ * A real service has one error envelope across every endpoint. Stripe's is
+ * `{ error: { type, code, message, param } }`, GitHub's is
+ * `{ message, documentation_url }`, and simulating either takes describing the
+ * shape once.
+ *
+ * Returning `undefined` declines the error and leaves it to the supplied
+ * mappings, so a formatter can shape the errors it knows and ignore the rest.
+ */
+export type ErrorFormatter = (error: unknown) => Response | undefined;
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/http/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../src/http/error-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC"}

package/dist/http/error-formatter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-formatter.js.map

package/dist/http/error-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.js","sourceRoot":"","sources":["../../src/http/error-formatter.ts"],"names":[],"mappings":""}

package/dist/http/operation-router.d.ts

@@ -1,7 +1,9 @@
+import type { ErrorFormatter } from "./error-formatter.js";
 import type { HttpMiddleware, HttpOperation } from "./operation.js";
 /** Selects and runs registered operations for one simulated API. */
 export declare class OperationRouter {
     #private;
+    constructor(apiName: string, formatError?: ErrorFormatter);
     use(middleware: HttpMiddleware): void;
     register(operation: HttpOperation): void;
     handle(request: Request): Promise<Response>;

package/dist/http/operation-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation-router.d.ts","sourceRoot":"","sources":["../../src/http/operation-router.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,gBAAgB,CAAC;AAIxB,oEAAoE;AACpE,qBAAa,eAAe;;IAI1B,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAEpC;IAED,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAEvC;IAEK,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0BhD;CA2CF"}
+{"version":3,"file":"operation-router.d.ts","sourceRoot":"","sources":["../../src/http/operation-router.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,gBAAgB,CAAC;AAIxB,oEAAoE;AACpE,qBAAa,eAAe;;IAM1B,YAAY,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,EAGxD;IAED,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAEpC;IAED,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAEvC;IAEK,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0BhD;CAsDF"}

package/dist/http/operation-router.js

@@ -4,8 +4,14 @@ import { UnimplementedRouteError } from "../unimplemented-route-error.js";
 import { runHttpOperation, runMiddleware } from "./operation-pipeline.js";
 /** Selects and runs registered operations for one simulated API. */
 export class OperationRouter {
+    #apiName;
     #middleware = [];
     #operations = [];
+    #formatError;
+    constructor(apiName, formatError) {
+        this.#apiName = apiName;
+        this.#formatError = formatError;
+    }
     use(middleware) {
         this.#middleware.push(middleware);
     }
@@ -28,7 +34,7 @@ export class OperationRouter {
             }
         }
         if (selected === undefined) {
-            throw new UnimplementedRouteError(request);
+            throw new UnimplementedRouteError(request, this.#apiName);
         }
         return this.#run(selected.operation, request, selected.match);
     }
@@ -50,6 +56,15 @@ export class OperationRouter {
             return await action();
         }
         catch (error) {
+            /*
+             * The API's own formatter goes first, so a service that shapes its errors
+             * shapes these two as well. Declining one leaves it to the mappings
+             * below.
+             */
+            const formatted = this.#formatError?.(error);
+            if (formatted !== undefined) {
+                return formatted;
+            }
             if (error instanceof EntityNotFoundError) {
                 return Response.json({ error: error.message }, { status: 404 });
             }

package/dist/http/operation-router.js.map

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

package/dist/http/operation.d.ts

@@ -1,3 +1,4 @@
+import type { RequestDecoder } from "./request-decoder.js";
 import type { CompiledRoute, RouteMatch } from "./route.js";
 /** HTTP data shared by handlers and middleware for one matched operation. */
 export interface HttpOperationContext {
@@ -17,7 +18,7 @@ export interface SemanticOperationOverride<TInput, TOutput, TResource> {
     handle: (context: SemanticOperationContext<TInput, TResource>) => Promise<TOutput> | TOutput;
 }
 export interface HttpOperation extends CompiledRoute {
-    decode: (request: Request) => Promise<unknown>;
+    decode: RequestDecoder;
     encode: (output: unknown) => Promise<Response> | Response;
     method: string;
     middleware: readonly HttpMiddleware[];

package/dist/http/operation.d.ts.map

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

package/dist/http/operation.js.map

@@ -1 +1 @@
-{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../src/http/operation.ts"],"names":[],"mappings":"AAyCA,MAAM,gBAAgB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AACxD,MAAM,WAAW,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAEzD,gFAAgF;AAChF,MAAM,OAAO,iBAAiB;IACnB,WAAW,GAAqB,EAAE,CAAC;IAC5C,OAAO,CAEyB;IAEhC,YACE,MAE+B;QAE/B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,oDAAoD;IACpD,QAAQ,CACN,WAAkE;QAElE,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,GAAG,CAAC,UAA0B;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,CAAC,WAAW,CAAC,CACX,OAAoD;QAEpD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,CAAC,gBAAgB,CAAC;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AASD,MAAM,UAAU,sBAAsB;IACpC,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,OAAO;QACL,GAAG,CAAC,KAAK;YACP,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAA2E;IAE3E,OAAO,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAwD,EACxD,OAAoD;IAEpD,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../src/http/operation.ts"],"names":[],"mappings":"AA0CA,MAAM,gBAAgB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AACxD,MAAM,WAAW,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAEzD,gFAAgF;AAChF,MAAM,OAAO,iBAAiB;IACnB,WAAW,GAAqB,EAAE,CAAC;IAC5C,OAAO,CAEyB;IAEhC,YACE,MAE+B;QAE/B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,oDAAoD;IACpD,QAAQ,CACN,WAAkE;QAElE,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6CAA6C;IAC7C,GAAG,CAAC,UAA0B;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,CAAC,WAAW,CAAC,CACX,OAAoD;QAEpD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,CAAC,gBAAgB,CAAC;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF;AASD,MAAM,UAAU,sBAAsB;IACpC,MAAM,UAAU,GAAqB,EAAE,CAAC;IAExC,OAAO;QACL,GAAG,CAAC,KAAK;YACP,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,CAAC,gBAAgB,CAAC,EAAE,GAAG,EAAE,CAAC,UAAU;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,SAA2E;IAE3E,OAAO,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAwD,EACxD,OAAoD;IAEpD,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/http/path-parameter.d.ts

@@ -0,0 +1,3 @@
+/** Returns one matched path parameter or throws when it is absent. */
+export declare function requirePathParameter(params: Readonly<Record<string, string>>, name: string): string;
+//# sourceMappingURL=path-parameter.d.ts.map

package/dist/http/path-parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-parameter.d.ts","sourceRoot":"","sources":["../../src/http/path-parameter.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxC,IAAI,EAAE,MAAM,GACX,MAAM,CAYR"}

package/dist/http/path-parameter.js

@@ -0,0 +1,12 @@
+/** Returns one matched path parameter or throws when it is absent. */
+export function requirePathParameter(params, name) {
+    if (!Object.hasOwn(params, name)) {
+        throw new TypeError(`Matched operation has no ":${name}" path parameter.`);
+    }
+    const value = params[name];
+    if (value === undefined) {
+        throw new TypeError(`Matched operation has no ":${name}" path parameter.`);
+    }
+    return value;
+}
+//# sourceMappingURL=path-parameter.js.map

package/dist/http/path-parameter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-parameter.js","sourceRoot":"","sources":["../../src/http/path-parameter.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,UAAU,oBAAoB,CAClC,MAAwC,EACxC,IAAY;IAEZ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,8BAA8B,IAAI,mBAAmB,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,8BAA8B,IAAI,mBAAmB,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/http/raw-operation.d.ts

@@ -0,0 +1,16 @@
+import type { HttpOperationContext, RawHttpOperation } from "./operation.js";
+import type { HttpOperation } from "./operation.js";
+/** Handles a raw HTTP operation after Simnaril has matched its route. */
+export type RawHttpOperationHandler = (context: HttpOperationContext) => Promise<Response> | Response;
+/**
+ * Builds an operation whose handler owns the whole response.
+ *
+ * The router still supplies the matched path parameters and the query, so a
+ * handler down here reimplements no route matching. Everything above that is
+ * the handler's, including the status and the body.
+ */
+export declare function rawOperation(method: string, path: string, handle: RawHttpOperationHandler): {
+    http: HttpOperation;
+    operation: RawHttpOperation;
+};
+//# sourceMappingURL=raw-operation.d.ts.map

package/dist/http/raw-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-operation.d.ts","sourceRoot":"","sources":["../../src/http/raw-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAElC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,uBAAuB,GAC9B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,CAgBtD"}

package/dist/http/raw-operation.js

@@ -0,0 +1,27 @@
+import { createRawHttpOperation, operationMiddleware } from "./operation.js";
+import { decodeNothing } from "./request-decoder.js";
+import { compileRoute, normalizeMethod } from "./route.js";
+/**
+ * Builds an operation whose handler owns the whole response.
+ *
+ * The router still supplies the matched path parameters and the query, so a
+ * handler down here reimplements no route matching. Everything above that is
+ * the handler's, including the status and the body.
+ */
+export function rawOperation(method, path, handle) {
+    const operation = createRawHttpOperation();
+    return {
+        operation,
+        http: {
+            ...compileRoute(path),
+            decode: decodeNothing,
+            encode: (output) => output,
+            method: normalizeMethod(method),
+            middleware: operationMiddleware(operation),
+            operate: (_input, context) => handle(context),
+            resourceMiddleware: [],
+            transform: (decoded) => decoded,
+        },
+    };
+}
+//# sourceMappingURL=raw-operation.js.map

package/dist/http/raw-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-operation.js","sourceRoot":"","sources":["../../src/http/raw-operation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAO3D;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,IAAY,EACZ,MAA+B;IAE/B,MAAM,SAAS,GAAG,sBAAsB,EAAE,CAAC;IAE3C,OAAO;QACL,SAAS;QACT,IAAI,EAAE;YACJ,GAAG,YAAY,CAAC,IAAI,CAAC;YACrB,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAkB;YACtC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;YAC/B,UAAU,EAAE,mBAAmB,CAAC,SAAS,CAAC;YAC1C,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;YAC7C,kBAAkB,EAAE,EAAE;YACtB,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;SAChC;KACF,CAAC;AACJ,CAAC"}

package/dist/http/request-decoder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Reads a request body into the input a semantic operation receives.
+ *
+ * JSON is the default and stays the default. A decoder is supplied for the
+ * services that speak something else on the way in. Stripe, Rails and PHP
+ * applications all take `application/x-www-form-urlencoded` and answer with
+ * JSON, and simulating one takes this hook.
+ *
+ * A decoder is only ever asked for a body by an operation that has one to read.
+ * `GET` and `DELETE` inherit none, whatever is configured above them.
+ */
+export type RequestDecoder = (request: Request) => unknown;
+/** The default decoder, and what an operation uses when none is supplied. */
+export declare const decodeJson: RequestDecoder;
+/**
+ * Runs a decoder only when the request arrived with a body.
+ *
+ * An operation that may be called either way asks for this. Handing the
+ * decoder a request with no body is how `decodeJson` comes to answer
+ * `Unexpected end of JSON input` for a `DELETE` that was sent nothing.
+ */
+export declare const decodeWhenPresent: (decode: RequestDecoder) => RequestDecoder;
+/**
+ * Reads nothing at all.
+ *
+ * What an operation with no body to read uses. Internal, and kept beside the
+ * default so the two live together.
+ */
+export declare const decodeNothing: () => undefined;
+//# sourceMappingURL=request-decoder.d.ts.map

package/dist/http/request-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-decoder.d.ts","sourceRoot":"","sources":["../../src/http/request-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;AAE3D,6EAA6E;AAC7E,eAAO,MAAM,UAAU,EAAE,cAA4C,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,WACnB,cAAc,KAAG,cAE2B,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAO,SAAsB,CAAC"}

package/dist/http/request-decoder.js

@@ -0,0 +1,18 @@
+/** The default decoder, and what an operation uses when none is supplied. */
+export const decodeJson = (request) => request.json();
+/**
+ * Runs a decoder only when the request arrived with a body.
+ *
+ * An operation that may be called either way asks for this. Handing the
+ * decoder a request with no body is how `decodeJson` comes to answer
+ * `Unexpected end of JSON input` for a `DELETE` that was sent nothing.
+ */
+export const decodeWhenPresent = (decode) => (request) => request.body === null ? undefined : decode(request);
+/**
+ * Reads nothing at all.
+ *
+ * What an operation with no body to read uses. Internal, and kept beside the
+ * default so the two live together.
+ */
+export const decodeNothing = () => undefined;
+//# sourceMappingURL=request-decoder.js.map

package/dist/http/request-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-decoder.js","sourceRoot":"","sources":["../../src/http/request-decoder.ts"],"names":[],"mappings":"AAaA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,UAAU,GAAmB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,CAAC,MAAsB,EAAkB,EAAE,CAC3C,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAExD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAc,EAAE,CAAC,SAAS,CAAC"}