@kensio/yulin 1.17.1 → 1.18.0

package/dist/service/apigateway/api/resource/sim-rest-api-resource-id.js

@@ -0,0 +1,11 @@
+import { faker } from "@faker-js/faker";
+/**
+ * Allocate a resource id.
+ *
+ * Real API Gateway ids are opaque short lowercase alphanumeric strings. The
+ * exact length is no part of the API contract, so only the shape is matched.
+ */
+export function makeSimRestApiResourceId() {
+    return faker.helpers.fromRegExp(/[a-z0-9]{7}/);
+}
+//# sourceMappingURL=sim-rest-api-resource-id.js.map

package/dist/service/apigateway/api/resource/sim-rest-api-resource-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-resource-id.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/resource/sim-rest-api-resource-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AASxC;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAyB,CAAC;AACzE,CAAC"}

package/dist/service/apigateway/api/resource/sim-rest-api-resource-store.d.ts

@@ -0,0 +1,57 @@
+import type { SimRestApiPathPart } from "./sim-rest-api-path-part.js";
+import { type SimRestApiResourceId } from "./sim-rest-api-resource-id.js";
+import { SimRestApiResource } from "./sim-rest-api-resource.js";
+/**
+ * The path tree of one REST API, keyed by resource id.
+ *
+ * The tree is held flat and each resource names its parent, which is how the
+ * REST API addresses one: `GetResource` takes a resource id and nothing else,
+ * and `CreateResource` names its parent by id. Walking a request path is a
+ * matter of following parent ids, and it belongs to the serving layer.
+ */
+export declare class SimRestApiResourceStore {
+    /**
+     * The root resource, which every API is created with and which cannot be
+     * deleted.
+     */
+    readonly root: SimRestApiResource;
+    private readonly resources;
+    constructor();
+    /**
+     * Add a path part under a parent, refusing a part the parent already has.
+     */
+    addChild(parent: SimRestApiResource, pathPart: SimRestApiPathPart): SimRestApiResource;
+    /**
+     * Find a resource by id.
+     */
+    find(resourceId: string): SimRestApiResource | undefined;
+    /**
+     * Find a resource by its full path.
+     */
+    findByPath(path: string): SimRestApiResource | undefined;
+    /**
+     * The resources directly under a parent.
+     */
+    children(parentId: SimRestApiResourceId): SimRestApiResource[];
+    /**
+     * Forget a resource and everything under it, as DeleteResource does.
+     *
+     * Real API Gateway deletes the subtree with the resource. A caller tearing a
+     * path down therefore names only the top of it.
+     *
+     * The root is refused here rather than in the command, because this store
+     * creates the root and is what would be left holding a tree with no node to
+     * hang a path on.
+     */
+    remove(resource: SimRestApiResource): void;
+    /**
+     * Every resource of this API, the root first.
+     */
+    list(): SimRestApiResource[];
+    /**
+     * The full path a part gets under a parent. The root's own path is the
+     * separator, so a part under it takes no second one.
+     */
+    private childPath;
+}
+//# sourceMappingURL=sim-rest-api-resource-store.d.ts.map

package/dist/service/apigateway/api/resource/sim-rest-api-resource-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-resource-store.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/resource/sim-rest-api-resource-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,EAEnB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC;;;OAGG;IACH,SAAgB,IAAI,EAAE,kBAAkB,CAAC;IAEzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEJ,cAMC;IAED;;OAEG;IACH,QAAQ,CACN,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,kBAAkB,GAC3B,kBAAkB,CAkBpB;IAED;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEvD;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEvD;IAED;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,kBAAkB,EAAE,CAE7D;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAYzC;IAED;;OAEG;IACH,IAAI,IAAI,kBAAkB,EAAE,CAE3B;IAED;;;OAGG;IACH,OAAO,CAAC,SAAS;CAQlB"}

package/dist/service/apigateway/api/resource/sim-rest-api-resource-store.js

@@ -0,0 +1,96 @@
+import { SimApiGatewayBadRequest, SimApiGatewayConflict, } from "../../error/sim-api-gateway.error.js";
+import { makeSimRestApiResourceId, } from "./sim-rest-api-resource-id.js";
+import { SimRestApiResource, simRestApiRootPath, } from "./sim-rest-api-resource.js";
+/**
+ * The path tree of one REST API, keyed by resource id.
+ *
+ * The tree is held flat and each resource names its parent, which is how the
+ * REST API addresses one: `GetResource` takes a resource id and nothing else,
+ * and `CreateResource` names its parent by id. Walking a request path is a
+ * matter of following parent ids, and it belongs to the serving layer.
+ */
+export class SimRestApiResourceStore {
+    /**
+     * The root resource, which every API is created with and which cannot be
+     * deleted.
+     */
+    root;
+    resources = new Map();
+    constructor() {
+        this.root = new SimRestApiResource({
+            resourceId: makeSimRestApiResourceId(),
+            path: simRestApiRootPath,
+        });
+        this.resources.set(this.root.resourceId, this.root);
+    }
+    /**
+     * Add a path part under a parent, refusing a part the parent already has.
+     */
+    addChild(parent, pathPart) {
+        const path = this.childPath(parent, pathPart);
+        if (this.findByPath(path) !== undefined) {
+            throw new SimApiGatewayConflict(`Another resource with the same parent already has this name: ${pathPart.pathPart}`);
+        }
+        const resource = new SimRestApiResource({
+            resourceId: makeSimRestApiResourceId(),
+            parentId: parent.resourceId,
+            pathPart,
+            path,
+        });
+        this.resources.set(resource.resourceId, resource);
+        return resource;
+    }
+    /**
+     * Find a resource by id.
+     */
+    find(resourceId) {
+        return this.resources.get(resourceId);
+    }
+    /**
+     * Find a resource by its full path.
+     */
+    findByPath(path) {
+        return this.list().find((resource) => resource.path === path);
+    }
+    /**
+     * The resources directly under a parent.
+     */
+    children(parentId) {
+        return this.list().filter((resource) => resource.parentId === parentId);
+    }
+    /**
+     * Forget a resource and everything under it, as DeleteResource does.
+     *
+     * Real API Gateway deletes the subtree with the resource. A caller tearing a
+     * path down therefore names only the top of it.
+     *
+     * The root is refused here rather than in the command, because this store
+     * creates the root and is what would be left holding a tree with no node to
+     * hang a path on.
+     */
+    remove(resource) {
+        if (resource.resourceId === this.root.resourceId) {
+            throw new SimApiGatewayBadRequest("The root resource cannot be deleted, as every REST API has one");
+        }
+        for (const child of this.children(resource.resourceId)) {
+            this.remove(child);
+        }
+        this.resources.delete(resource.resourceId);
+    }
+    /**
+     * Every resource of this API, the root first.
+     */
+    list() {
+        return this.resources.values().toArray();
+    }
+    /**
+     * The full path a part gets under a parent. The root's own path is the
+     * separator, so a part under it takes no second one.
+     */
+    childPath(parent, pathPart) {
+        return parent.path === simRestApiRootPath
+            ? `${simRestApiRootPath}${pathPart.pathPart}`
+            : `${parent.path}/${pathPart.pathPart}`;
+    }
+}
+//# sourceMappingURL=sim-rest-api-resource-store.js.map

package/dist/service/apigateway/api/resource/sim-rest-api-resource-store.js.map

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

package/dist/service/apigateway/api/resource/sim-rest-api-resource.d.ts

@@ -0,0 +1,75 @@
+import type { SimRestApiMethod, SimRestApiMethodView } from "../method/sim-rest-api-method.js";
+import type { SimRestApiPathPart } from "./sim-rest-api-path-part.js";
+import type { SimRestApiResourceId } from "./sim-rest-api-resource-id.js";
+/**
+ * The path of the root resource, which every API is created with.
+ */
+export declare const simRestApiRootPath = "/";
+interface SimRestApiResourceProperties {
+    readonly resourceId: SimRestApiResourceId;
+    readonly parentId?: SimRestApiResourceId | undefined;
+    readonly pathPart?: SimRestApiPathPart | undefined;
+    readonly path: string;
+}
+/**
+ * Minimal structural resource view, as the Create and Get commands return.
+ */
+export interface SimRestApiResourceView {
+    id: string;
+    path: string;
+    parentId?: string;
+    pathPart?: string;
+    resourceMethods?: Record<string, SimRestApiMethodView>;
+}
+/**
+ * A simulated REST API resource: one node of the API's path tree.
+ *
+ * The root resource carries no parent and no path part, and every other
+ * resource is a path part under a parent. A resource owns the methods declared
+ * on it, keyed by HTTP method, because a method is addressed by resource id
+ * and HTTP method on real AWS and none of them outlives its resource.
+ */
+export declare class SimRestApiResource {
+    readonly resourceId: SimRestApiResourceId;
+    readonly parentId?: SimRestApiResourceId | undefined;
+    readonly pathPart?: SimRestApiPathPart | undefined;
+    readonly path: string;
+    private readonly methods;
+    constructor(properties: SimRestApiResourceProperties);
+    /**
+     * Whether this resource captures the rest of the path, which is what a
+     * `{proxy+}` part does. Such a resource takes no children, since nothing can
+     * follow a segment that has already matched everything left.
+     */
+    get greedy(): boolean;
+    /**
+     * Declare a method on this resource, refusing one already declared.
+     */
+    addMethod(method: SimRestApiMethod): void;
+    /**
+     * Find a method declared on this resource by HTTP method.
+     */
+    findMethod(httpMethod: string): SimRestApiMethod | undefined;
+    /**
+     * Forget a method, as DeleteMethod does. Its integration goes with it,
+     * because the integration belongs to the method.
+     */
+    removeMethod(httpMethod: string): void;
+    /**
+     * Every method declared on this resource.
+     */
+    listMethods(): SimRestApiMethod[];
+    /**
+     * Get the AWS-like view of this resource.
+     *
+     * The methods are left out unless they were asked for, which is what the
+     * `embed` option of `GetResource` and `GetResources` decides. Real API
+     * Gateway omits them by default, and a caller reading them from an
+     * unembedded response would be reading something AWS never sends.
+     */
+    view(options?: {
+        readonly methods?: boolean;
+    }): SimRestApiResourceView;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-resource.d.ts.map

package/dist/service/apigateway/api/resource/sim-rest-api-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-resource.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/resource/sim-rest-api-resource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,UAAU,4BAA4B;IACpC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CACxD;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,SAAgB,UAAU,EAAE,oBAAoB,CAAC;IACjD,SAAgB,QAAQ,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAC5D,SAAgB,QAAQ,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC1D,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,YAAY,UAAU,EAAE,4BAA4B,EAKnD;IAED;;;;OAIG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAQxC;IAED;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE3D;IAED;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAErC;IAED;;OAEG;IACH,WAAW,IAAI,gBAAgB,EAAE,CAEhC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,sBAAsB,CAqBzE;CACF"}

package/dist/service/apigateway/api/resource/sim-rest-api-resource.js

@@ -0,0 +1,87 @@
+import { SimApiGatewayConflict } from "../../error/sim-api-gateway.error.js";
+/**
+ * The path of the root resource, which every API is created with.
+ */
+export const simRestApiRootPath = "/";
+/**
+ * A simulated REST API resource: one node of the API's path tree.
+ *
+ * The root resource carries no parent and no path part, and every other
+ * resource is a path part under a parent. A resource owns the methods declared
+ * on it, keyed by HTTP method, because a method is addressed by resource id
+ * and HTTP method on real AWS and none of them outlives its resource.
+ */
+export class SimRestApiResource {
+    resourceId;
+    parentId;
+    pathPart;
+    path;
+    methods = new Map();
+    constructor(properties) {
+        this.resourceId = properties.resourceId;
+        this.parentId = properties.parentId;
+        this.pathPart = properties.pathPart;
+        this.path = properties.path;
+    }
+    /**
+     * Whether this resource captures the rest of the path, which is what a
+     * `{proxy+}` part does. Such a resource takes no children, since nothing can
+     * follow a segment that has already matched everything left.
+     */
+    get greedy() {
+        return this.pathPart?.greedy ?? false;
+    }
+    /**
+     * Declare a method on this resource, refusing one already declared.
+     */
+    addMethod(method) {
+        if (this.methods.has(method.httpMethod)) {
+            throw new SimApiGatewayConflict(`Method ${method.httpMethod} already exists on resource ${this.path}`);
+        }
+        this.methods.set(method.httpMethod, method);
+    }
+    /**
+     * Find a method declared on this resource by HTTP method.
+     */
+    findMethod(httpMethod) {
+        return this.methods.get(httpMethod);
+    }
+    /**
+     * Forget a method, as DeleteMethod does. Its integration goes with it,
+     * because the integration belongs to the method.
+     */
+    removeMethod(httpMethod) {
+        this.methods.delete(httpMethod);
+    }
+    /**
+     * Every method declared on this resource.
+     */
+    listMethods() {
+        return this.methods.values().toArray();
+    }
+    /**
+     * Get the AWS-like view of this resource.
+     *
+     * The methods are left out unless they were asked for, which is what the
+     * `embed` option of `GetResource` and `GetResources` decides. Real API
+     * Gateway omits them by default, and a caller reading them from an
+     * unembedded response would be reading something AWS never sends.
+     */
+    view(options = {}) {
+        const view = {
+            id: this.resourceId,
+            path: this.path,
+        };
+        if (this.parentId !== undefined) {
+            view.parentId = this.parentId;
+        }
+        if (this.pathPart !== undefined) {
+            view.pathPart = this.pathPart.pathPart;
+        }
+        if (options.methods === true && this.methods.size > 0) {
+            view.resourceMethods = Object.fromEntries(this.listMethods().map((method) => [method.httpMethod, method.view()]));
+        }
+        return view;
+    }
+}
+//# sourceMappingURL=sim-rest-api-resource.js.map

package/dist/service/apigateway/api/resource/sim-rest-api-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-resource.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/resource/sim-rest-api-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAQ7E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAoBtC;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACb,UAAU,CAAuB;IACjC,QAAQ,CAAoC;IAC5C,QAAQ,CAAkC;IAC1C,IAAI,CAAS;IAEZ,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE/D,YAAY,UAAwC;QAClD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAwB;QAChC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,qBAAqB,CAC7B,UAAU,MAAM,CAAC,UAAU,+BAA+B,IAAI,CAAC,IAAI,EAAE,CACtE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAkB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,UAAkB;QAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,GAAmC,EAAE;QAC/C,MAAM,IAAI,GAA2B;YACnC,EAAE,EAAE,IAAI,CAAC,UAAU;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;QAEF,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,CACvC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CACvE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/service/apigateway/api/sim-rest-api-declared-method.d.ts

@@ -0,0 +1,22 @@
+import type { SimRestApiProxyAuthorization } from "./sim-rest-api-proxy-authorizer.js";
+import type { SimApiGateway } from "../sim-api-gateway.js";
+interface SimRestApiDeclaredMethodInput {
+    readonly restApiId: string;
+    readonly rootResourceId: string;
+    readonly resourcePath: string;
+    readonly httpMethod: string;
+    readonly functionArn: string;
+    /** How every method of the API says who may call it. */
+    readonly authorization: SimRestApiProxyAuthorization;
+}
+/**
+ * Declare every path template of an API, each with its method and the
+ * integration behind it.
+ *
+ * They are declared one at a time because they share resources. Two paths
+ * under `/orders` build that resource once, and whichever gets there first
+ * creates it.
+ */
+export declare function declaredMethods(apiGateway: SimApiGateway, resourcePaths: readonly string[], input: Omit<SimRestApiDeclaredMethodInput, "resourcePath">): Promise<void>;
+export {};
+//# sourceMappingURL=sim-rest-api-declared-method.d.ts.map

package/dist/service/apigateway/api/sim-rest-api-declared-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-declared-method.d.ts","sourceRoot":"","sources":["../../../../src/service/apigateway/api/sim-rest-api-declared-method.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,UAAU,6BAA6B;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;CACtD;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,aAAa,EACzB,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,KAAK,EAAE,IAAI,CAAC,6BAA6B,EAAE,cAAc,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/service/apigateway/api/sim-rest-api-declared-method.js

@@ -0,0 +1,61 @@
+/**
+ * Declare every path template of an API, each with its method and the
+ * integration behind it.
+ *
+ * They are declared one at a time because they share resources. Two paths
+ * under `/orders` build that resource once, and whichever gets there first
+ * creates it.
+ */
+export async function declaredMethods(apiGateway, resourcePaths, input) {
+    for (const resourcePath of resourcePaths) {
+        // oxlint-disable-next-line no-await-in-loop -- paths share resources, so one at a time
+        await declaredMethod(apiGateway, { ...input, resourcePath });
+    }
+}
+/**
+ * Declare one path template, its method, and the integration behind it.
+ */
+async function declaredMethod(apiGateway, input) {
+    const { restApiId, httpMethod } = input;
+    const resourceId = await declaredResource(apiGateway, restApiId, input.rootResourceId, input.resourcePath);
+    await apiGateway.putMethod({
+        input: { restApiId, resourceId, httpMethod, ...input.authorization },
+    });
+    await apiGateway.putIntegration({
+        input: {
+            restApiId,
+            resourceId,
+            httpMethod,
+            type: "AWS_PROXY",
+            integrationHttpMethod: "POST",
+            uri: input.functionArn,
+        },
+    });
+}
+/**
+ * Declare the chain of resources one path template needs, reusing whatever the
+ * API already has, and answer the id of the leaf.
+ */
+async function declaredResource(apiGateway, restApiId, rootResourceId, resourcePath) {
+    const pathParts = resourcePath.split("/").filter((part) => part !== "");
+    let parentId = rootResourceId;
+    for (const pathPart of pathParts) {
+        const existing = apiGateway
+            .findRestApi(restApiId)
+            ?.resources.list()
+            .find((one) => one.parentId === parentId && one.pathPart?.pathPart === pathPart);
+        if (existing !== undefined) {
+            parentId = existing.resourceId;
+            continue;
+        }
+        // Each resource is the parent of the next, so the chain is built one at a
+        // time rather than in parallel.
+        // oxlint-disable-next-line no-await-in-loop -- each parent id comes from the call before it
+        const created = await apiGateway.createResource({
+            input: { restApiId, parentId, pathPart },
+        });
+        parentId = created.id;
+    }
+    return parentId;
+}
+//# sourceMappingURL=sim-rest-api-declared-method.js.map

package/dist/service/apigateway/api/sim-rest-api-declared-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-declared-method.js","sourceRoot":"","sources":["../../../../src/service/apigateway/api/sim-rest-api-declared-method.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAyB,EACzB,aAAgC,EAChC,KAA0D;IAE1D,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,uFAAuF;QACvF,MAAM,cAAc,CAAC,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAC3B,UAAyB,EACzB,KAAoC;IAEpC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IACxC,MAAM,UAAU,GAAG,MAAM,gBAAgB,CACvC,UAAU,EACV,SAAS,EACT,KAAK,CAAC,cAAc,EACpB,KAAK,CAAC,YAAY,CACnB,CAAC;IAEF,MAAM,UAAU,CAAC,SAAS,CAAC;QACzB,KAAK,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE;KACrE,CAAC,CAAC;IACH,MAAM,UAAU,CAAC,cAAc,CAAC;QAC9B,KAAK,EAAE;YACL,SAAS;YACT,UAAU;YACV,UAAU;YACV,IAAI,EAAE,WAAW;YACjB,qBAAqB,EAAE,MAAM;YAC7B,GAAG,EAAE,KAAK,CAAC,WAAW;SACvB;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAC7B,UAAyB,EACzB,SAAiB,EACjB,cAAsB,EACtB,YAAoB;IAEpB,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACxE,IAAI,QAAQ,GAAG,cAAc,CAAC;IAE9B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,UAAU;aACxB,WAAW,CAAC,SAAS,CAAC;YACvB,EAAE,SAAS,CAAC,IAAI,EAAE;aACjB,IAAI,CACH,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CACnE,CAAC;QAEJ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC;YAC/B,SAAS;QACX,CAAC;QAED,0EAA0E;QAC1E,gCAAgC;QAChC,4FAA4F;QAC5F,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC;YAC9C,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;SACzC,CAAC,CAAC;QACH,QAAQ,GAAG,OAAO,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/service/apigateway/api/sim-rest-api-execute-api-arn.d.ts

@@ -0,0 +1,76 @@
+import type { SimRestApiMatch } from "./match/sim-rest-api-match.js";
+import type { SimRestApi } from "./sim-rest-api.js";
+interface SimRestApiExecuteApiArnProperties {
+    readonly restApi: SimRestApi;
+    readonly stageName: string;
+    /** The method and path part, such as `GET/orders/{orderId}`. */
+    readonly methodAndPath: string;
+}
+/**
+ * The `execute-api` ARN of one request to a REST API.
+ *
+ * ```text
+ * arn:aws:execute-api:<region>:<account>:<apiId>/<stage>/<METHOD>/<path>
+ * ```
+ *
+ * This is the `SourceArn` an `AWS::Lambda::Permission` for a proxy integration
+ * is granted on, and it is the same shape an HTTP API uses. What differs is
+ * the last part. A REST API names the resource path template with its braces
+ * intact, which is the form CDK's `arnForExecuteApi` writes, while an HTTP API
+ * names a route key.
+ *
+ * The method segment carries the verb the client used rather than the `ANY` a
+ * resource may have declared. CDK wildcards that segment, and a concrete verb
+ * matches a wildcard where a literal `ANY` would not, so this is the reading
+ * that keeps a CDK-deployed API working.
+ *
+ * Three things want this ARN and they fill the last part differently:
+ *
+ * - the invoke permission a Lambda integration is authorized against, where
+ *   the path is the matched resource's template with its braces intact;
+ * - the `methodArn` a Lambda authorizer is handed, and the resource the policy
+ *   it answers with is evaluated against, where the path is the one the client
+ *   asked for;
+ * - the ARN API Gateway invokes an authorizer's own function under, which
+ *   names the authorizer and no stage at all.
+ */
+export declare class SimRestApiExecuteApiArn {
+    private readonly restApi;
+    private readonly stageName;
+    private readonly methodAndPath;
+    constructor(properties: SimRestApiExecuteApiArnProperties);
+    /**
+     * The ARN of the method a request matched.
+     */
+    static forMatch(restApi: SimRestApi, match: SimRestApiMatch, requestMethod: string): SimRestApiExecuteApiArn;
+    /**
+     * The ARN of the request a client made, which is the `methodArn` a Lambda
+     * authorizer is handed.
+     *
+     * This names the concrete path rather than the resource template, so an
+     * authorizer behind a `{proxy+}` sees the path that was asked for. The
+     * policy it answers with is evaluated against this same ARN, which is why an
+     * authorizer allowing one path leaves another unauthorized.
+     */
+    static forRequest(restApi: SimRestApi, match: SimRestApiMatch, requestMethod: string): SimRestApiExecuteApiArn;
+    /**
+     * The ARN API Gateway invokes one of an API's authorizers under.
+     *
+     * ```text
+     * arn:aws:execute-api:<region>:<account>:<apiId>/authorizers/<authorizerId>
+     * ```
+     *
+     * This is the `SourceArn` AWS documents for granting API Gateway permission
+     * to invoke a Lambda authorizer's function, and it names no stage. An
+     * authorizer belongs to the API rather than to anything serving a request. A
+     * function integrated behind a method and used as that method's authorizer
+     * therefore needs two permissions, as it does on AWS.
+     */
+    static forAuthorizer(restApi: SimRestApi, authorizerId: string): SimRestApiExecuteApiArn;
+    /**
+     * The ARN as a permission or a policy names it.
+     */
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-execute-api-arn.d.ts.map

package/dist/service/apigateway/api/sim-rest-api-execute-api-arn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-execute-api-arn.d.ts","sourceRoot":"","sources":["../../../../src/service/apigateway/api/sim-rest-api-execute-api-arn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,UAAU,iCAAiC;IACzC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,YAAY,UAAU,EAAE,iCAAiC,EAIxD;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,GACpB,uBAAuB,CAQzB;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,GACpB,uBAAuB,CAMzB;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,aAAa,CAClB,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GACnB,uBAAuB,CAMzB;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM,CAOjB;CACF"}

package/dist/service/apigateway/api/sim-rest-api-execute-api-arn.js

@@ -0,0 +1,95 @@
+/**
+ * The `execute-api` ARN of one request to a REST API.
+ *
+ * ```text
+ * arn:aws:execute-api:<region>:<account>:<apiId>/<stage>/<METHOD>/<path>
+ * ```
+ *
+ * This is the `SourceArn` an `AWS::Lambda::Permission` for a proxy integration
+ * is granted on, and it is the same shape an HTTP API uses. What differs is
+ * the last part. A REST API names the resource path template with its braces
+ * intact, which is the form CDK's `arnForExecuteApi` writes, while an HTTP API
+ * names a route key.
+ *
+ * The method segment carries the verb the client used rather than the `ANY` a
+ * resource may have declared. CDK wildcards that segment, and a concrete verb
+ * matches a wildcard where a literal `ANY` would not, so this is the reading
+ * that keeps a CDK-deployed API working.
+ *
+ * Three things want this ARN and they fill the last part differently:
+ *
+ * - the invoke permission a Lambda integration is authorized against, where
+ *   the path is the matched resource's template with its braces intact;
+ * - the `methodArn` a Lambda authorizer is handed, and the resource the policy
+ *   it answers with is evaluated against, where the path is the one the client
+ *   asked for;
+ * - the ARN API Gateway invokes an authorizer's own function under, which
+ *   names the authorizer and no stage at all.
+ */
+export class SimRestApiExecuteApiArn {
+    restApi;
+    stageName;
+    methodAndPath;
+    constructor(properties) {
+        this.restApi = properties.restApi;
+        this.stageName = properties.stageName;
+        this.methodAndPath = properties.methodAndPath;
+    }
+    /**
+     * The ARN of the method a request matched.
+     */
+    static forMatch(restApi, match, requestMethod) {
+        return new SimRestApiExecuteApiArn({
+            restApi,
+            stageName: match.stage.stageName,
+            // The resource path carries a leading separator and the ARN supplies its
+            // own, so a root-resource request reads `<apiId>/<stage>/GET/`.
+            methodAndPath: `${requestMethod}${match.resource.path}`,
+        });
+    }
+    /**
+     * The ARN of the request a client made, which is the `methodArn` a Lambda
+     * authorizer is handed.
+     *
+     * This names the concrete path rather than the resource template, so an
+     * authorizer behind a `{proxy+}` sees the path that was asked for. The
+     * policy it answers with is evaluated against this same ARN, which is why an
+     * authorizer allowing one path leaves another unauthorized.
+     */
+    static forRequest(restApi, match, requestMethod) {
+        return new SimRestApiExecuteApiArn({
+            restApi,
+            stageName: match.stage.stageName,
+            methodAndPath: `${requestMethod.toUpperCase()}/${match.pathAfterStage}`,
+        });
+    }
+    /**
+     * The ARN API Gateway invokes one of an API's authorizers under.
+     *
+     * ```text
+     * arn:aws:execute-api:<region>:<account>:<apiId>/authorizers/<authorizerId>
+     * ```
+     *
+     * This is the `SourceArn` AWS documents for granting API Gateway permission
+     * to invoke a Lambda authorizer's function, and it names no stage. An
+     * authorizer belongs to the API rather than to anything serving a request. A
+     * function integrated behind a method and used as that method's authorizer
+     * therefore needs two permissions, as it does on AWS.
+     */
+    static forAuthorizer(restApi, authorizerId) {
+        return new SimRestApiExecuteApiArn({
+            restApi,
+            stageName: "authorizers",
+            methodAndPath: authorizerId,
+        });
+    }
+    /**
+     * The ARN as a permission or a policy names it.
+     */
+    toString() {
+        const { accountId, regionName } = this.restApi.accountRegionScope;
+        return (`arn:aws:execute-api:${regionName}:${accountId}:` +
+            `${this.restApi.apiId}/${this.stageName}/${this.methodAndPath}`);
+    }
+}
+//# sourceMappingURL=sim-rest-api-execute-api-arn.js.map

package/dist/service/apigateway/api/sim-rest-api-execute-api-arn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-execute-api-arn.js","sourceRoot":"","sources":["../../../../src/service/apigateway/api/sim-rest-api-execute-api-arn.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,uBAAuB;IACjB,OAAO,CAAa;IACpB,SAAS,CAAS;IAClB,aAAa,CAAS;IAEvC,YAAY,UAA6C;QACvD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,OAAmB,EACnB,KAAsB,EACtB,aAAqB;QAErB,OAAO,IAAI,uBAAuB,CAAC;YACjC,OAAO;YACP,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;YAChC,yEAAyE;YACzE,gEAAgE;YAChE,aAAa,EAAE,GAAG,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CACf,OAAmB,EACnB,KAAsB,EACtB,aAAqB;QAErB,OAAO,IAAI,uBAAuB,CAAC;YACjC,OAAO;YACP,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;YAChC,aAAa,EAAE,GAAG,aAAa,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE;SACxE,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,aAAa,CAClB,OAAmB,EACnB,YAAoB;QAEpB,OAAO,IAAI,uBAAuB,CAAC;YACjC,OAAO;YACP,SAAS,EAAE,aAAa;YACxB,aAAa,EAAE,YAAY;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC;QAElE,OAAO,CACL,uBAAuB,UAAU,IAAI,SAAS,GAAG;YACjD,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,aAAa,EAAE,CAChE,CAAC;IACJ,CAAC;CACF"}

package/dist/service/apigateway/api/sim-rest-api-host.d.ts

@@ -0,0 +1,23 @@
+interface SimRestApiHostProperties {
+    readonly apiId: string;
+    readonly regionName: string;
+}
+/**
+ * Build the real AWS endpoint hostname for a REST API.
+ *
+ * REST APIs and HTTP APIs are issued endpoints under the same `execute-api`
+ * host, which is why the two labels come from one place. What differs is the
+ * path. Every REST API request carries its stage as the first path segment,
+ * where an HTTP API can serve a `$default` stage at the root.
+ */
+export declare function simRestApiHost(properties: SimRestApiHostProperties): string;
+/**
+ * Build the logical hostname for a REST API: the AWS endpoint hostname without
+ * the real AWS domain.
+ *
+ * This is the form Yulin serves on localhost, where the `.amazonaws.com` tail
+ * is replaced by the local suffix.
+ */
+export declare function simRestApiLogicalHost(properties: SimRestApiHostProperties): string;
+export {};
+//# sourceMappingURL=sim-rest-api-host.d.ts.map