@kensio/simnaril 0.0.0

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

@@ -0,0 +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"}

package/dist/http/operation-router.js

@@ -0,0 +1,63 @@
+import { DuplicateEntityError } from "../duplicate-entity-error.js";
+import { EntityNotFoundError } from "../entity-not-found-error.js";
+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 {
+    #middleware = [];
+    #operations = [];
+    use(middleware) {
+        this.#middleware.push(middleware);
+    }
+    register(operation) {
+        this.#operations.push(operation);
+    }
+    async handle(request) {
+        const pathname = new URL(request.url).pathname;
+        const method = request.method.toUpperCase();
+        let selected;
+        for (const operation of this.#operations) {
+            if (operation.method !== method) {
+                continue;
+            }
+            const match = operation.match(pathname);
+            if (match !== undefined &&
+                (selected === undefined ||
+                    operation.specificity > selected.operation.specificity)) {
+                selected = { match, operation };
+            }
+        }
+        if (selected === undefined) {
+            throw new UnimplementedRouteError(request);
+        }
+        return this.#run(selected.operation, request, selected.match);
+    }
+    async #run(operation, request, match) {
+        const context = {
+            params: match.params,
+            query: new URL(request.url).searchParams,
+            request,
+        };
+        const middleware = [
+            ...this.#middleware,
+            ...operation.resourceMiddleware,
+            ...operation.middleware,
+        ];
+        return runMiddleware(context, middleware, () => runHttpOperation(operation, match, context), (action) => this.#translateErrors(action));
+    }
+    async #translateErrors(action) {
+        try {
+            return await action();
+        }
+        catch (error) {
+            if (error instanceof EntityNotFoundError) {
+                return Response.json({ error: error.message }, { status: 404 });
+            }
+            if (error instanceof DuplicateEntityError) {
+                return Response.json({ error: error.message }, { status: 409 });
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=operation-router.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,51 @@
+import type { CompiledRoute, RouteMatch } from "./route.js";
+/** HTTP data shared by handlers and middleware for one matched operation. */
+export interface HttpOperationContext {
+    params: Readonly<Record<string, string>>;
+    query: URLSearchParams;
+    request: Request;
+}
+/** Runs around an HTTP operation and its encoded response. */
+export type HttpMiddleware = (context: HttpOperationContext, next: () => Promise<Response>) => Promise<Response> | Response;
+/** HTTP and semantic data supplied to a semantic operation handler. */
+export interface SemanticOperationContext<TInput, TResource> extends HttpOperationContext {
+    input: TInput;
+    resource: TResource;
+}
+/** Replaces the semantic behaviour of a supplied operation. */
+export interface SemanticOperationOverride<TInput, TOutput, TResource> {
+    handle: (context: SemanticOperationContext<TInput, TResource>) => Promise<TOutput> | TOutput;
+}
+export interface HttpOperation extends CompiledRoute {
+    decode: (request: Request) => Promise<unknown>;
+    encode: (output: unknown) => Promise<Response> | Response;
+    method: string;
+    middleware: readonly HttpMiddleware[];
+    operate: (input: unknown, context: HttpOperationContext) => unknown;
+    resourceMiddleware: readonly HttpMiddleware[];
+    transform: (decoded: unknown, match: RouteMatch) => unknown;
+}
+declare const middlewareAccess: unique symbol;
+declare const semanticRun: unique symbol;
+/** Adds operation middleware and replaces semantic behaviour when supported. */
+export declare class SemanticOperation<TInput, TOutput, TResource> {
+    #private;
+    constructor(handle: (context: SemanticOperationContext<TInput, TResource>) => Promise<TOutput> | TOutput);
+    /** Replaces this operation's semantic behaviour. */
+    override(replacement: SemanticOperationOverride<TInput, TOutput, TResource>): this;
+    /** Adds middleware around this operation. */
+    use(middleware: HttpMiddleware): this;
+    [semanticRun](context: SemanticOperationContext<TInput, TResource>): Promise<TOutput> | TOutput;
+    [middlewareAccess](): readonly HttpMiddleware[];
+}
+/** Adds middleware around a raw HTTP operation. */
+export interface RawHttpOperation {
+    /** Adds middleware around this operation. */
+    use: (middleware: HttpMiddleware) => this;
+    [middlewareAccess]: () => readonly HttpMiddleware[];
+}
+export declare function createRawHttpOperation(): RawHttpOperation;
+export declare function operationMiddleware<TInput, TOutput, TResource>(operation: RawHttpOperation | SemanticOperation<TInput, TOutput, TResource>): readonly HttpMiddleware[];
+export declare function runSemanticOperation<TInput, TOutput, TResource>(operation: SemanticOperation<TInput, TOutput, TResource>, context: SemanticOperationContext<TInput, TResource>): Promise<TOutput> | TOutput;
+export {};
+//# sourceMappingURL=operation.d.ts.map

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

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

package/dist/http/operation.js

@@ -0,0 +1,43 @@
+const middlewareAccess = Symbol("operation middleware");
+const semanticRun = Symbol("semantic operation handler");
+/** Adds operation middleware and replaces semantic behaviour when supported. */
+export class SemanticOperation {
+    #middleware = [];
+    #handle;
+    constructor(handle) {
+        this.#handle = handle;
+    }
+    /** Replaces this operation's semantic behaviour. */
+    override(replacement) {
+        this.#handle = replacement.handle;
+        return this;
+    }
+    /** Adds middleware around this operation. */
+    use(middleware) {
+        this.#middleware.push(middleware);
+        return this;
+    }
+    [semanticRun](context) {
+        return this.#handle(context);
+    }
+    [middlewareAccess]() {
+        return this.#middleware;
+    }
+}
+export function createRawHttpOperation() {
+    const middleware = [];
+    return {
+        use(added) {
+            middleware.push(added);
+            return this;
+        },
+        [middlewareAccess]: () => middleware,
+    };
+}
+export function operationMiddleware(operation) {
+    return operation[middlewareAccess]();
+}
+export function runSemanticOperation(operation, context) {
+    return operation[semanticRun](context);
+}
+//# sourceMappingURL=operation.js.map

package/dist/http/operation.js.map

@@ -0,0 +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"}

package/dist/http/resource-operation-registry.d.ts

@@ -0,0 +1,13 @@
+import type { RestResource } from "../rest-resource.js";
+import type { ResourceOperationProps, RestResourceOperations, RestResourceProps } from "../rest-resource-operation.js";
+import type { HttpMiddleware, HttpOperation, SemanticOperation } from "./operation.js";
+/** Registers supplied and custom operations owned by one REST resource. */
+export declare class ResourceOperationRegistry<T extends object> {
+    #private;
+    readonly operations: RestResourceOperations<T>;
+    constructor(resource: RestResource<T>, configuration: RestResourceProps["operations"]);
+    use(middleware: HttpMiddleware): void;
+    add<TInput, TOutput>(name: string, props: ResourceOperationProps<T, TInput, TOutput>): SemanticOperation<TInput, TOutput, RestResource<T>>;
+    attach(registerOperation: (operation: HttpOperation) => void): void;
+}
+//# sourceMappingURL=resource-operation-registry.d.ts.map

package/dist/http/resource-operation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-operation-registry.d.ts","sourceRoot":"","sources":["../../src/http/resource-operation-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAIxB,2EAA2E;AAC3E,qBAAa,yBAAyB,CAAC,CAAC,SAAS,MAAM;;IACrD,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAa/C,YACE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,aAAa,EAAE,iBAAiB,CAAC,YAAY,CAAC,EAU/C;IAED,GAAG,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAEpC;IAED,GAAG,CAAC,MAAM,EAAE,OAAO,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAChD,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAsBrD;IAED,MAAM,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAMlE;CACF"}

package/dist/http/resource-operation-registry.js

@@ -0,0 +1,46 @@
+import { resourceOperation } from "./resource-operation.js";
+import { restResourceOperations } from "./rest-resource-operations.js";
+/** Registers supplied and custom operations owned by one REST resource. */
+export class ResourceOperationRegistry {
+    operations;
+    #httpOperations;
+    #middleware = [];
+    #names = new Set([
+        "list",
+        "create",
+        "get",
+        "update",
+        "delete",
+    ]);
+    #resource;
+    #registerOperation;
+    constructor(resource, configuration) {
+        this.#resource = resource;
+        const supplied = restResourceOperations(resource, configuration, this.#middleware);
+        this.#httpOperations = supplied.http;
+        this.operations = supplied.semantic;
+    }
+    use(middleware) {
+        this.#middleware.push(middleware);
+    }
+    add(name, props) {
+        if (this.#names.has(name)) {
+            throw new TypeError(`An operation named "${name}" already exists on resource path "${this.#resource.path}".`);
+        }
+        if (!props.path.startsWith("/")) {
+            throw new TypeError(`Expected a resource operation path such as "/:id/archive", received "${props.path}".`);
+        }
+        const operation = resourceOperation(this.#resource, this.#middleware, props);
+        this.#names.add(name);
+        this.#httpOperations.push(operation.http);
+        this.#registerOperation?.(operation.http);
+        return operation.semantic;
+    }
+    attach(registerOperation) {
+        this.#registerOperation = registerOperation;
+        for (const operation of this.#httpOperations) {
+            registerOperation(operation);
+        }
+    }
+}
+//# sourceMappingURL=resource-operation-registry.js.map

package/dist/http/resource-operation-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-operation-registry.js","sourceRoot":"","sources":["../../src/http/resource-operation-registry.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,2EAA2E;AAC3E,MAAM,OAAO,yBAAyB;IAC3B,UAAU,CAA4B;IACtC,eAAe,CAAkB;IACjC,WAAW,GAAqB,EAAE,CAAC;IACnC,MAAM,GAAG,IAAI,GAAG,CAAS;QAChC,MAAM;QACN,QAAQ;QACR,KAAK;QACL,QAAQ;QACR,QAAQ;KACT,CAAC,CAAC;IACM,SAAS,CAAkB;IACpC,kBAAkB,CAAmD;IAErE,YACE,QAAyB,EACzB,aAA8C;QAE9C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,MAAM,QAAQ,GAAG,sBAAsB,CACrC,QAAQ,EACR,aAAa,EACb,IAAI,CAAC,WAAW,CACjB,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,UAA0B;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CACD,IAAY,EACZ,KAAiD;QAEjD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CACjB,uBAAuB,IAAI,sCAAsC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CACzF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CACjB,wEAAwE,KAAK,CAAC,IAAI,IAAI,CACvF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,iBAAiB,CACjC,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,WAAW,EAChB,KAAK,CACN,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,kBAAkB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,iBAAqD;QAC1D,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAE5C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC7C,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+import type { RestResource } from "../rest-resource.js";
+import type { ResourceOperationProps } from "../rest-resource-operation.js";
+import { type HttpMiddleware, type HttpOperation, SemanticOperation } from "./operation.js";
+/** Builds one named semantic operation below a resource path. */
+export declare function resourceOperation<T extends object, TInput, TOutput>(resource: RestResource<T>, middleware: readonly HttpMiddleware[], props: ResourceOperationProps<T, TInput, TOutput>): {
+    http: HttpOperation;
+    semantic: SemanticOperation<TInput, TOutput, RestResource<T>>;
+};
+//# sourceMappingURL=resource-operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-operation.d.ts","sourceRoot":"","sources":["../../src/http/resource-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAYxB,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,EACjE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,UAAU,EAAE,SAAS,cAAc,EAAE,EACrC,KAAK,EAAE,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAChD;IACD,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D,CAgBA"}

package/dist/http/resource-operation.js

@@ -0,0 +1,25 @@
+import { SemanticOperation, } from "./operation.js";
+import { compileRoute } from "./route.js";
+import { semanticHttpOperation } from "./semantic-http-operation.js";
+const decodeResourceOperation = async (request) => request.body === null ? undefined : request.json();
+const encodeResourceOperation = (output) => output === undefined
+    ? new Response(undefined, { status: 204 })
+    : Response.json(output);
+/** Builds one named semantic operation below a resource path. */
+export function resourceOperation(resource, middleware, props) {
+    const route = compileRoute(`${resource.path}${props.path}`);
+    const semantic = new SemanticOperation(props.handle);
+    return {
+        semantic,
+        http: semanticHttpOperation({
+            decode: decodeResourceOperation,
+            encode: encodeResourceOperation,
+            method: props.method,
+            resource,
+            resourceMiddleware: middleware,
+            route,
+            semantic,
+        }),
+    };
+}
+//# sourceMappingURL=resource-operation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resource-operation.js","sourceRoot":"","sources":["../../src/http/resource-operation.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,uBAAuB,GAAG,KAAK,EAAE,OAAgB,EAAoB,EAAE,CAC3E,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;AAErD,MAAM,uBAAuB,GAAG,CAAC,MAAe,EAAY,EAAE,CAC5D,MAAM,KAAK,SAAS;IAClB,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC1C,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAE5B,iEAAiE;AACjE,MAAM,UAAU,iBAAiB,CAC/B,QAAyB,EACzB,UAAqC,EACrC,KAAiD;IAKjD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO;QACL,QAAQ;QACR,IAAI,EAAE,qBAAqB,CAAC;YAC1B,MAAM,EAAE,uBAAuB;YAC/B,MAAM,EAAE,uBAAuB;YAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ;YACR,kBAAkB,EAAE,UAAU;YAC9B,KAAK;YACL,QAAQ;SACT,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/http/rest-resource-operations.d.ts

@@ -0,0 +1,9 @@
+import type { RestResource } from "../rest-resource.js";
+import type { RestResourceOperationConfiguration, RestResourceOperations } from "../rest-resource-operation.js";
+import { type HttpMiddleware, type HttpOperation } from "./operation.js";
+/** Builds conventional collection and item operations for one resource. */
+export declare function restResourceOperations<T extends object>(resource: RestResource<T>, configuration?: Partial<Record<keyof RestResourceOperations<T>, RestResourceOperationConfiguration>>, resourceMiddleware?: readonly HttpMiddleware[]): {
+    http: HttpOperation[];
+    semantic: RestResourceOperations<T>;
+};
+//# sourceMappingURL=rest-resource-operations.d.ts.map

package/dist/http/rest-resource-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-resource-operations.d.ts","sourceRoot":"","sources":["../../src/http/rest-resource-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,kCAAkC,EAClC,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAGnB,MAAM,gBAAgB,CAAC;AAoExB,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,EACzB,aAAa,GAAE,OAAO,CACpB,MAAM,CAAC,MAAM,sBAAsB,CAAC,CAAC,CAAC,EAAE,kCAAkC,CAAC,CACvE,EACN,kBAAkB,GAAE,SAAS,cAAc,EAAO,GACjD;IAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAA;CAAE,CAqEhE"}

package/dist/http/rest-resource-operations.js

@@ -0,0 +1,97 @@
+import { SemanticOperation, } from "./operation.js";
+import { compileRoute } from "./route.js";
+import { semanticHttpOperation } from "./semantic-http-operation.js";
+const decodeEmpty = () => Promise.resolve();
+const decodeJson = async (request) => request.json();
+const encodeJson = (status) => (output) => Response.json(output, { status });
+const encodeEmpty = () => new Response(undefined, { status: 204 });
+const requiredPathParameter = (params, name) => {
+    const value = params[name];
+    if (value === undefined) {
+        throw new TypeError(`Matched operation has no ":${name}" path parameter.`);
+    }
+    return value;
+};
+const suppliedOperation = (props) => {
+    const semantic = new SemanticOperation(props.handle);
+    const route = compileRoute(`${props.resource.path}${props.configuration?.path ?? props.defaultPath}`, props.requiredParameters);
+    return {
+        semantic,
+        http: semanticHttpOperation({
+            decode: props.decode,
+            encode: props.encode,
+            method: props.configuration?.method ?? props.defaultMethod,
+            resource: props.resource,
+            resourceMiddleware: props.resourceMiddleware,
+            route,
+            semantic,
+        }),
+    };
+};
+/** Builds conventional collection and item operations for one resource. */
+export function restResourceOperations(resource, configuration = {}, resourceMiddleware = []) {
+    const list = suppliedOperation({
+        resource,
+        resourceMiddleware,
+        configuration: configuration.list,
+        defaultMethod: "GET",
+        defaultPath: "",
+        decode: decodeEmpty,
+        handle: ({ resource: operationResource }) => operationResource.list(),
+        encode: encodeJson(200),
+    });
+    const create = suppliedOperation({
+        resource,
+        resourceMiddleware,
+        configuration: configuration.create,
+        defaultMethod: "POST",
+        defaultPath: "",
+        decode: decodeJson,
+        handle: ({ input, resource: operationResource }) => operationResource.create(input),
+        encode: encodeJson(201),
+    });
+    const get = suppliedOperation({
+        resource,
+        resourceMiddleware,
+        configuration: configuration.get,
+        defaultMethod: "GET",
+        defaultPath: "/:id",
+        decode: decodeEmpty,
+        handle: ({ params, resource: operationResource }) => operationResource.get(requiredPathParameter(params, "id")),
+        encode: encodeJson(200),
+        requiredParameters: ["id"],
+    });
+    const update = suppliedOperation({
+        resource,
+        resourceMiddleware,
+        configuration: configuration.update,
+        defaultMethod: "PATCH",
+        defaultPath: "/:id",
+        decode: decodeJson,
+        handle: ({ input, params, resource: operationResource }) => operationResource.update(requiredPathParameter(params, "id"), input),
+        encode: encodeJson(200),
+        requiredParameters: ["id"],
+    });
+    const deleteOperation = suppliedOperation({
+        resource,
+        resourceMiddleware,
+        configuration: configuration.delete,
+        defaultMethod: "DELETE",
+        defaultPath: "/:id",
+        decode: decodeEmpty,
+        handle: ({ params, resource: operationResource }) => operationResource.delete(requiredPathParameter(params, "id")),
+        encode: encodeEmpty,
+        requiredParameters: ["id"],
+    });
+    return {
+        http: [list.http, create.http, get.http, update.http, deleteOperation.http],
+        semantic: {
+            list: list.semantic,
+            create: create.semantic,
+            get: get.semantic,
+            update: update.semantic,
+            delete: deleteOperation.semantic,
+        },
+    };
+}
+//# sourceMappingURL=rest-resource-operations.js.map

package/dist/http/rest-resource-operations.js.map

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

package/dist/http/route.d.ts

@@ -0,0 +1,14 @@
+export interface RouteMatch {
+    params: Readonly<Record<string, string>>;
+}
+export interface CompiledRoute {
+    match: (pathname: string) => RouteMatch | undefined;
+    specificity: number;
+}
+/** Compiles an absolute path template with named parameters. */
+export declare function compileRoute(path: string, requiredParameters?: readonly string[]): CompiledRoute;
+/** Validates an absolute operation path or path template. */
+export declare function validateOperationPath(path: string): void;
+/** Normalizes and validates one HTTP method. */
+export declare function normalizeMethod(method: string): string;
+//# sourceMappingURL=route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/http/route.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,GAAG,SAAS,CAAC;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,kBAAkB,GAAE,SAAS,MAAM,EAAO,GACzC,aAAa,CA6Ef;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAexD;AAED,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD"}

package/dist/http/route.js

@@ -0,0 +1,77 @@
+/** Compiles an absolute path template with named parameters. */
+export function compileRoute(path, requiredParameters = []) {
+    validateOperationPath(path);
+    const segments = path === "/" ? [] : path.slice(1).split("/");
+    const parameterNames = new Set();
+    for (const segment of segments) {
+        if (!segment.startsWith(":")) {
+            continue;
+        }
+        const name = segment.slice(1);
+        if (!/^[A-Za-z_][A-Za-z\d_]*$/u.test(name)) {
+            throw new TypeError(`Expected a named path parameter such as ":id", received "${segment}".`);
+        }
+        if (parameterNames.has(name)) {
+            throw new TypeError(`Path parameter ":${name}" appears more than once.`);
+        }
+        parameterNames.add(name);
+    }
+    for (const name of requiredParameters) {
+        if (!parameterNames.has(name)) {
+            throw new TypeError(`Operation path "${path}" must include path parameter ":${name}".`);
+        }
+    }
+    const literalSegments = segments.filter((segment) => !segment.startsWith(":")).length;
+    const literalLength = segments
+        .filter((segment) => !segment.startsWith(":"))
+        .join("/").length;
+    return {
+        specificity: literalSegments * 1_000_000 + segments.length * 1000 + literalLength,
+        match: (pathname) => {
+            const candidateSegments = pathname === "/" ? [] : pathname.slice(1).split("/");
+            if (candidateSegments.length !== segments.length) {
+                return undefined;
+            }
+            const params = {};
+            for (const [index, segment] of segments.entries()) {
+                const candidate = candidateSegments[index] ?? "";
+                if (candidate.length === 0) {
+                    return undefined;
+                }
+                if (!segment.startsWith(":")) {
+                    if (candidate !== segment) {
+                        return undefined;
+                    }
+                    continue;
+                }
+                try {
+                    params[segment.slice(1)] = decodeURIComponent(candidate);
+                }
+                catch {
+                    return undefined;
+                }
+            }
+            return { params };
+        },
+    };
+}
+/** Validates an absolute operation path or path template. */
+export function validateOperationPath(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 an absolute operation path such as "/widgets/:id", received "${path}".`);
+    }
+}
+/** Normalizes and validates one HTTP method. */
+export function normalizeMethod(method) {
+    if (!/^[!#$%&'*+\-.^_`|~A-Za-z\d]+$/u.test(method)) {
+        throw new TypeError(`Expected an HTTP method, received "${method}".`);
+    }
+    return method.toUpperCase();
+}
+//# sourceMappingURL=route.js.map

package/dist/http/route.js.map

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

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

@@ -0,0 +1,16 @@
+import type { RestResource } from "../rest-resource.js";
+import { type HttpMiddleware, type HttpOperation, type SemanticOperation } from "./operation.js";
+import type { CompiledRoute } from "./route.js";
+interface SemanticHttpOperationProps<T extends object, TInput, TOutput> {
+    decode: (request: Request) => Promise<unknown>;
+    encode: (output: unknown) => Promise<Response> | Response;
+    method: string;
+    resource: RestResource<T>;
+    resourceMiddleware: readonly HttpMiddleware[];
+    route: CompiledRoute;
+    semantic: SemanticOperation<TInput, TOutput, RestResource<T>>;
+}
+/** Adapts a semantic resource operation to shared HTTP execution. */
+export declare function semanticHttpOperation<T extends object, TInput, TOutput>(props: SemanticHttpOperationProps<T, TInput, TOutput>): HttpOperation;
+export {};
+//# sourceMappingURL=semantic-http-operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-http-operation.d.ts","sourceRoot":"","sources":["../../src/http/semantic-http-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAGlB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,UAAU,0BAA0B,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO;IACpE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1B,kBAAkB,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,OAAO,EACrE,KAAK,EAAE,0BAA0B,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GACpD,aAAa,CAgBf"}

package/dist/http/semantic-http-operation.js

@@ -0,0 +1,20 @@
+import { operationMiddleware, runSemanticOperation, } from "./operation.js";
+import { normalizeMethod } from "./route.js";
+/** Adapts a semantic resource operation to shared HTTP execution. */
+export function semanticHttpOperation(props) {
+    return {
+        ...props.route,
+        decode: props.decode,
+        encode: props.encode,
+        method: normalizeMethod(props.method),
+        middleware: operationMiddleware(props.semantic),
+        operate: (input, context) => runSemanticOperation(props.semantic, {
+            ...context,
+            input: input,
+            resource: props.resource,
+        }),
+        resourceMiddleware: props.resourceMiddleware,
+        transform: (decoded) => decoded,
+    };
+}
+//# sourceMappingURL=semantic-http-operation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-http-operation.js","sourceRoot":"","sources":["../../src/http/semantic-http-operation.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,mBAAmB,EACnB,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAY7C,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CACnC,KAAqD;IAErD,OAAO;QACL,GAAG,KAAK,CAAC,KAAK;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC;QACrC,UAAU,EAAE,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAC1B,oBAAoB,CAAC,KAAK,CAAC,QAAQ,EAAE;YACnC,GAAG,OAAO;YACV,KAAK,EAAE,KAAe;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;QACJ,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { SimApi, type RawHttpOperationHandler, type SimApiResourceProps, } from "./api.js";
+export { SimEnvironment, type SimEnvironmentProps, type SimService, type UnhandledRequestPolicy, } from "./environment.js";
+export { DuplicateEntityError } from "./duplicate-entity-error.js";
+export { EntityNotFoundError } from "./entity-not-found-error.js";
+export { type HttpMiddleware, type HttpOperationContext, type RawHttpOperation, SemanticOperation, type SemanticOperationContext, type SemanticOperationOverride, } from "./http/operation.js";
+export { RestResource } from "./rest-resource.js";
+export { type ResourceOperationProps, type RestResourceOperationConfiguration, type RestResourceOperationName, type RestResourceOperations, type RestResourceProps, } from "./rest-resource-operation.js";
+export { SimResource, type SimResourceProps } from "./resource.js";
+export { UnclaimedOriginError } from "./unclaimed-origin-error.js";
+export { UnimplementedRouteError } from "./unimplemented-route-error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,GACzB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,kCAAkC,EACvC,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { SimApi, } from "./api.js";
+export { SimEnvironment, } from "./environment.js";
+export { DuplicateEntityError } from "./duplicate-entity-error.js";
+export { EntityNotFoundError } from "./entity-not-found-error.js";
+export { SemanticOperation, } from "./http/operation.js";
+export { RestResource } from "./rest-resource.js";
+export {} from "./rest-resource-operation.js";
+export { SimResource } from "./resource.js";
+export { UnclaimedOriginError } from "./unclaimed-origin-error.js";
+export { UnimplementedRouteError } from "./unimplemented-route-error.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,GAGP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,cAAc,GAIf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAIL,iBAAiB,GAGlB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAMN,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC"}