@kensio/yulin 1.17.2 → 1.18.1

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

@@ -0,0 +1,41 @@
+import { faker } from "@faker-js/faker";
+/**
+ * Allocate a deployment id, in the opaque short lowercase alphanumeric shape
+ * real API Gateway uses.
+ */
+export function makeSimRestApiDeploymentId() {
+    return faker.helpers.fromRegExp(/[a-z0-9]{6}/);
+}
+/**
+ * A simulated REST API deployment: a snapshot a stage points at.
+ *
+ * Real API Gateway freezes the resources and methods into the deployment, and
+ * an edit made afterwards reaches no client until another deployment is
+ * created. Here a deployment records that one was made and when. A stage
+ * serves the API's current resources, so a test editing a method sees the
+ * change without redeploying, which is the one place this departs from AWS.
+ */
+export class SimRestApiDeployment {
+    deploymentId;
+    createdDate;
+    description;
+    constructor(properties) {
+        this.deploymentId = properties.deploymentId;
+        this.createdDate = properties.createdDate;
+        this.description = properties.description;
+    }
+    /**
+     * Get the AWS-like view of this deployment.
+     */
+    view() {
+        const view = {
+            id: this.deploymentId,
+            createdDate: new Date(this.createdDate),
+        };
+        if (this.description !== undefined) {
+            view.description = this.description;
+        }
+        return view;
+    }
+}
+//# sourceMappingURL=sim-rest-api-deployment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-deployment.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/deployment/sim-rest-api-deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AASxC;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAA2B,CAAC;AAC3E,CAAC;AAiBD;;;;;;;;GAQG;AACH,MAAM,OAAO,oBAAoB;IACf,YAAY,CAAyB;IACrC,WAAW,CAAO;IAClB,WAAW,CAAsB;IAEjD,YAAY,UAA0C;QACpD,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,IAAI,GAA6B;YACrC,EAAE,EAAE,IAAI,CAAC,YAAY;YACrB,WAAW,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC;SACxC,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACtC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,59 @@
+import type { SimRestApiMethod } from "../method/sim-rest-api-method.js";
+import type { SimRestApiResource } from "../resource/sim-rest-api-resource.js";
+import type { SimRestApiStage } from "../stage/sim-rest-api-stage.js";
+import type { SimRestApi } from "../sim-rest-api.js";
+import type { SimRestApiRequest } from "./sim-rest-api-request.js";
+/**
+ * What a simulated REST API found for one request.
+ */
+export interface SimRestApiMatch {
+    readonly stage: SimRestApiStage;
+    readonly resource: SimRestApiResource;
+    readonly method: SimRestApiMethod;
+    readonly pathParameters: Readonly<Record<string, string>>;
+    /**
+     * The request path with the stage segment taken off and no leading
+     * separator, such as `orders/6`. A request to the stage root leaves it
+     * empty.
+     *
+     * This is the path a Lambda authorizer's `methodArn` names, which is the
+     * path the client asked for rather than the resource template it matched.
+     */
+    readonly pathAfterStage: string;
+}
+/**
+ * Why a request reached nothing.
+ *
+ * The two are told apart because real API Gateway answers them differently. A
+ * stage that is not there is a plain `Forbidden`, while a request that reached
+ * the stage and matched no method gets the `Missing Authentication Token`
+ * message API Gateway is well known for.
+ */
+export type SimRestApiMiss = "stage" | "route";
+/**
+ * Matches a request to a stage, a resource and a method of one REST API.
+ *
+ * The stage goes first, because every REST API request carries its stage as
+ * the first path segment and the resource tree knows nothing about it. A
+ * request to `/prod/orders/6` on stage `prod` reaches the tree as the segments
+ * `orders` and `6`.
+ */
+export declare class SimRestApiMatcher {
+    private readonly walk;
+    /**
+     * Find what should handle one request, or why nothing does.
+     */
+    match(restApi: SimRestApi, request: SimRestApiRequest): SimRestApiMatch | SimRestApiMiss;
+    /**
+     * The method of the reached resource that answers this request.
+     *
+     * An explicit method wins over `ANY`, which is the catch-all for whatever
+     * the resource declares no method of its own for.
+     */
+    private matched;
+}
+/**
+ * Whether matching found something to invoke.
+ */
+export declare function isSimRestApiMatch(match: SimRestApiMatch | SimRestApiMiss): match is SimRestApiMatch;
+//# sourceMappingURL=sim-rest-api-match.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-match.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/match/sim-rest-api-match.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAMnE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/C;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAErD;;OAEG;IACH,KAAK,CACH,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,iBAAiB,GACzB,eAAe,GAAG,cAAc,CAelC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAO;CAchB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,GAAG,cAAc,GACtC,KAAK,IAAI,eAAe,CAE1B"}

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

@@ -0,0 +1,48 @@
+import { simRestApiAnyMethod } from "../method/sim-rest-api-method.js";
+import { SimRestApiResourceWalk, } from "./sim-rest-api-resource-walk.js";
+/**
+ * Matches a request to a stage, a resource and a method of one REST API.
+ *
+ * The stage goes first, because every REST API request carries its stage as
+ * the first path segment and the resource tree knows nothing about it. A
+ * request to `/prod/orders/6` on stage `prod` reaches the tree as the segments
+ * `orders` and `6`.
+ */
+export class SimRestApiMatcher {
+    walk = new SimRestApiResourceWalk();
+    /**
+     * Find what should handle one request, or why nothing does.
+     */
+    match(restApi, request) {
+        const [stageName, ...segments] = request.segments;
+        const stage = restApi.stages.find(stageName ?? "");
+        if (stage === undefined) {
+            return "stage";
+        }
+        const reached = this.walk.walk(restApi.resources, segments);
+        if (reached === undefined) {
+            return "route";
+        }
+        return this.matched(stage, reached, request, segments.join("/")) ?? "route";
+    }
+    /**
+     * The method of the reached resource that answers this request.
+     *
+     * An explicit method wins over `ANY`, which is the catch-all for whatever
+     * the resource declares no method of its own for.
+     */
+    matched(stage, reached, request, pathAfterStage) {
+        const method = reached.resource.findMethod(request.method) ??
+            reached.resource.findMethod(simRestApiAnyMethod);
+        return method === undefined
+            ? undefined
+            : { stage, method, pathAfterStage, ...reached };
+    }
+}
+/**
+ * Whether matching found something to invoke.
+ */
+export function isSimRestApiMatch(match) {
+    return typeof match !== "string";
+}
+//# sourceMappingURL=sim-rest-api-match.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-match.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/match/sim-rest-api-match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAMvE,OAAO,EAEL,sBAAsB,GACvB,MAAM,iCAAiC,CAAC;AA+BzC;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IACX,IAAI,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAErD;;OAEG;IACH,KAAK,CACH,OAAmB,EACnB,OAA0B;QAE1B,MAAM,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAEnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE5D,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACK,OAAO,CACb,KAAsB,EACtB,OAAgC,EAChC,OAA0B,EAC1B,cAAsB;QAEtB,MAAM,MAAM,GACV,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;YAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;QAEnD,OAAO,MAAM,KAAK,SAAS;YACzB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAuC;IAEvC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,23 @@
+interface SimRestApiRequestProperties {
+    readonly method: string;
+    readonly path: string;
+}
+/**
+ * One HTTP request as a simulated REST API sees it for matching.
+ *
+ * The path is the whole request path, stage segment and all. A REST API always
+ * carries its stage as the first segment, and taking it off is the first step
+ * of matching rather than something the caller does beforehand.
+ */
+export declare class SimRestApiRequest {
+    readonly method: string;
+    readonly path: string;
+    constructor(properties: SimRestApiRequestProperties);
+    /**
+     * The path segments, with the empty strings a leading or trailing separator
+     * produces dropped.
+     */
+    get segments(): readonly string[];
+}
+export {};
+//# sourceMappingURL=sim-rest-api-request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-request.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/match/sim-rest-api-request.ts"],"names":[],"mappings":"AAAA,UAAU,2BAA2B;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,YAAY,UAAU,EAAE,2BAA2B,EAGlD;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAEhC;CACF"}

package/dist/service/apigateway/api/match/sim-rest-api-request.js

@@ -0,0 +1,23 @@
+/**
+ * One HTTP request as a simulated REST API sees it for matching.
+ *
+ * The path is the whole request path, stage segment and all. A REST API always
+ * carries its stage as the first segment, and taking it off is the first step
+ * of matching rather than something the caller does beforehand.
+ */
+export class SimRestApiRequest {
+    method;
+    path;
+    constructor(properties) {
+        this.method = properties.method;
+        this.path = properties.path;
+    }
+    /**
+     * The path segments, with the empty strings a leading or trailing separator
+     * produces dropped.
+     */
+    get segments() {
+        return this.path.split("/").filter((segment) => segment.length > 0);
+    }
+}
+//# sourceMappingURL=sim-rest-api-request.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-request.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/match/sim-rest-api-request.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IACZ,MAAM,CAAS;IACf,IAAI,CAAS;IAE7B,YAAY,UAAuC;QACjD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;CACF"}

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

@@ -0,0 +1,39 @@
+import type { SimRestApiResourceStore } from "../resource/sim-rest-api-resource-store.js";
+import type { SimRestApiResource } from "../resource/sim-rest-api-resource.js";
+/**
+ * The resource a request path reached, and the path parameters captured on the
+ * way to it.
+ */
+export interface SimRestApiResourceMatch {
+    readonly resource: SimRestApiResource;
+    readonly pathParameters: Readonly<Record<string, string>>;
+}
+/**
+ * Walks a request path down a REST API's resource tree.
+ *
+ * At each segment the children are tried in the order real API Gateway
+ * resolves them: an exact literal first, then a single-segment `{name}` path
+ * parameter, then a greedy `{name+}` one that takes the rest of the path. That
+ * order is what makes `/orders/new` reach a literal `new` resource where an
+ * `{orderId}` sibling would otherwise have caught it.
+ */
+export declare class SimRestApiResourceWalk {
+    /**
+     * Find the resource a request path reaches, if the tree has one.
+     */
+    walk(resources: SimRestApiResourceStore, segments: readonly string[]): SimRestApiResourceMatch | undefined;
+    private from;
+    /**
+     * Follow a child whose path part is the segment itself.
+     */
+    private literal;
+    /**
+     * Follow a `{name}` child, capturing the segment it stands for.
+     */
+    private parameter;
+    /**
+     * Follow a `{name+}` child, which takes every segment that is left.
+     */
+    private greedy;
+}
+//# sourceMappingURL=sim-rest-api-resource-walk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-resource-walk.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/match/sim-rest-api-resource-walk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3D;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,IAAI,CACF,SAAS,EAAE,uBAAuB,EAClC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,uBAAuB,GAAG,SAAS,CAErC;IAED,OAAO,CAAC,IAAI;IAmBZ;;OAEG;IACH,OAAO,CAAC,OAAO;IAiBf;;OAEG;IACH,OAAO,CAAC,SAAS;IAsBjB;;OAEG;IACH,OAAO,CAAC,MAAM;CAoBf"}

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

@@ -0,0 +1,81 @@
+/**
+ * Walks a request path down a REST API's resource tree.
+ *
+ * At each segment the children are tried in the order real API Gateway
+ * resolves them: an exact literal first, then a single-segment `{name}` path
+ * parameter, then a greedy `{name+}` one that takes the rest of the path. That
+ * order is what makes `/orders/new` reach a literal `new` resource where an
+ * `{orderId}` sibling would otherwise have caught it.
+ */
+export class SimRestApiResourceWalk {
+    /**
+     * Find the resource a request path reaches, if the tree has one.
+     */
+    walk(resources, segments) {
+        return this.from(resources, resources.root, segments, {});
+    }
+    from(resources, resource, segments, captured) {
+        if (segments.length === 0) {
+            return { resource, pathParameters: captured };
+        }
+        const children = resources.children(resource.resourceId);
+        return (this.literal(resources, children, segments, captured) ??
+            this.parameter(resources, children, segments, captured) ??
+            this.greedy(children, segments, captured));
+    }
+    /**
+     * Follow a child whose path part is the segment itself.
+     */
+    literal(resources, children, segments, captured) {
+        const child = children.find((one) => one.pathPart?.parameterName === undefined &&
+            one.pathPart?.pathPart === segments[0]);
+        return child === undefined
+            ? undefined
+            : this.from(resources, child, segments.slice(1), captured);
+    }
+    /**
+     * Follow a `{name}` child, capturing the segment it stands for.
+     */
+    parameter(resources, children, segments, captured) {
+        const child = children.find((one) => one.pathPart?.parameterName !== undefined && !one.greedy);
+        const name = child?.pathPart?.parameterName;
+        if (child === undefined || name === undefined) {
+            return undefined;
+        }
+        return this.from(resources, child, segments.slice(1), {
+            ...captured,
+            /* v8 ignore next -- the walk only recurses while a segment is left */
+            [name]: decodedSegment(segments[0] ?? ""),
+        });
+    }
+    /**
+     * Follow a `{name+}` child, which takes every segment that is left.
+     */
+    greedy(children, segments, captured) {
+        const child = children.find((one) => one.greedy);
+        const name = child?.pathPart?.parameterName;
+        if (child === undefined || name === undefined) {
+            return undefined;
+        }
+        return {
+            resource: child,
+            pathParameters: {
+                ...captured,
+                [name]: segments.map((segment) => decodedSegment(segment)).join("/"),
+            },
+        };
+    }
+}
+/**
+ * A path segment as a handler reads it. API Gateway percent-decodes what it
+ * puts in `pathParameters`, and leaves a segment it cannot decode alone.
+ */
+function decodedSegment(segment) {
+    try {
+        return decodeURIComponent(segment);
+    }
+    catch {
+        return segment;
+    }
+}
+//# sourceMappingURL=sim-rest-api-resource-walk.js.map

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

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

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

@@ -0,0 +1,49 @@
+import type { SimRestApiLambdaUri } from "./sim-rest-api-lambda-uri.js";
+/**
+ * The only integration type simulated: a Lambda proxy integration.
+ *
+ * `MOCK`, `HTTP`, `HTTP_PROXY` and the non-proxy `AWS` type are refused rather
+ * than treated as this one, because each of them answers a request from
+ * somewhere else entirely.
+ */
+export type SimRestApiIntegrationType = "AWS_PROXY";
+/**
+ * The HTTP method API Gateway uses to call a Lambda integration. It is always
+ * `POST`, whatever method the client used, because that is the method the
+ * Lambda invoke API takes.
+ */
+export declare const simRestApiLambdaIntegrationHttpMethod = "POST";
+interface SimRestApiIntegrationProperties {
+    readonly integrationType: SimRestApiIntegrationType;
+    readonly lambdaUri: SimRestApiLambdaUri;
+    readonly integrationHttpMethod: string;
+}
+/**
+ * Minimal structural integration view, as the Put and Get commands return.
+ */
+export interface SimRestApiIntegrationView {
+    type: SimRestApiIntegrationType;
+    httpMethod: string;
+    uri: string;
+}
+/**
+ * A simulated REST API integration: what the API does with a request one of
+ * its methods matched.
+ *
+ * Only `AWS_PROXY` is modelled, so an integration is the Lambda function the
+ * method invokes. An integration belongs to one method of one resource, unlike
+ * an HTTP API integration, which is a resource of its own that several routes
+ * can share.
+ */
+export declare class SimRestApiIntegration {
+    readonly integrationType: SimRestApiIntegrationType;
+    readonly lambdaUri: SimRestApiLambdaUri;
+    readonly integrationHttpMethod: string;
+    constructor(properties: SimRestApiIntegrationProperties);
+    /**
+     * Get the AWS-like view of this integration.
+     */
+    view(): SimRestApiIntegrationView;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-integration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-integration.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/method/sim-rest-api-integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG,WAAW,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,qCAAqC,SAAS,CAAC;AAE5D,UAAU,+BAA+B;IACvC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,yBAAyB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;IAChC,SAAgB,eAAe,EAAE,yBAAyB,CAAC;IAC3D,SAAgB,SAAS,EAAE,mBAAmB,CAAC;IAC/C,SAAgB,qBAAqB,EAAE,MAAM,CAAC;IAE9C,YAAY,UAAU,EAAE,+BAA+B,EAItD;IAED;;OAEG;IACH,IAAI,IAAI,yBAAyB,CAMhC;CACF"}

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

@@ -0,0 +1,36 @@
+/**
+ * The HTTP method API Gateway uses to call a Lambda integration. It is always
+ * `POST`, whatever method the client used, because that is the method the
+ * Lambda invoke API takes.
+ */
+export const simRestApiLambdaIntegrationHttpMethod = "POST";
+/**
+ * A simulated REST API integration: what the API does with a request one of
+ * its methods matched.
+ *
+ * Only `AWS_PROXY` is modelled, so an integration is the Lambda function the
+ * method invokes. An integration belongs to one method of one resource, unlike
+ * an HTTP API integration, which is a resource of its own that several routes
+ * can share.
+ */
+export class SimRestApiIntegration {
+    integrationType;
+    lambdaUri;
+    integrationHttpMethod;
+    constructor(properties) {
+        this.integrationType = properties.integrationType;
+        this.lambdaUri = properties.lambdaUri;
+        this.integrationHttpMethod = properties.integrationHttpMethod;
+    }
+    /**
+     * Get the AWS-like view of this integration.
+     */
+    view() {
+        return {
+            type: this.integrationType,
+            httpMethod: this.integrationHttpMethod,
+            uri: this.lambdaUri.uri,
+        };
+    }
+}
+//# sourceMappingURL=sim-rest-api-integration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-integration.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/method/sim-rest-api-integration.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,MAAM,CAAC;AAiB5D;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAqB;IAChB,eAAe,CAA4B;IAC3C,SAAS,CAAsB;IAC/B,qBAAqB,CAAS;IAE9C,YAAY,UAA2C;QACrD,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,qBAAqB,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,eAAe;YAC1B,UAAU,EAAE,IAAI,CAAC,qBAAqB;YACtC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG;SACxB,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,30 @@
+/**
+ * A URI naming the Lambda function a REST API method invokes.
+ *
+ * It is written either as the bare function ARN or wrapped in the API Gateway
+ * invoke path CDK, CloudFormation and OpenAPI documents all emit. The string
+ * is kept as it was given, because `GetIntegration` echoes back what was
+ * configured rather than a form of its own, and the function ARN is held
+ * beside it for whatever has to reach the function.
+ *
+ * A version or alias qualifier on the end of the ARN is held apart from the
+ * function name, because the name finds the function and the qualifier picks
+ * which of its versions runs. Neither is resolved here. An integration built
+ * on an alias therefore follows that alias wherever it is moved to afterwards.
+ */
+export declare class SimRestApiLambdaUri {
+    /** The URI as it was configured, which is what the API hands back. */
+    readonly uri: string;
+    /** The function ARN the URI named, with any wrapper taken off. */
+    readonly functionArn: string;
+    readonly regionName: string;
+    readonly accountId: string;
+    readonly functionName: string;
+    readonly qualifier: string | undefined;
+    private constructor();
+    /**
+     * Read an integration URI, refusing anything other than a Lambda function.
+     */
+    static parse(uri: string): SimRestApiLambdaUri;
+}
+//# sourceMappingURL=sim-rest-api-lambda-uri.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-lambda-uri.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/method/sim-rest-api-lambda-uri.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAC9B,sEAAsE;IACtE,SAAgB,GAAG,EAAE,MAAM,CAAC;IAE5B,kEAAkE;IAClE,SAAgB,WAAW,EAAE,MAAM,CAAC;IAEpC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9C,OAAO,eAcN;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAe7C;CACF"}

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

@@ -0,0 +1,50 @@
+import { simLambdaInvocationUriOf } from "../../../lambda/function/uri/sim-lambda-invocation-uri.js";
+import { SimApiGatewayBadRequest } from "../../error/sim-api-gateway.error.js";
+/**
+ * A URI naming the Lambda function a REST API method invokes.
+ *
+ * It is written either as the bare function ARN or wrapped in the API Gateway
+ * invoke path CDK, CloudFormation and OpenAPI documents all emit. The string
+ * is kept as it was given, because `GetIntegration` echoes back what was
+ * configured rather than a form of its own, and the function ARN is held
+ * beside it for whatever has to reach the function.
+ *
+ * A version or alias qualifier on the end of the ARN is held apart from the
+ * function name, because the name finds the function and the qualifier picks
+ * which of its versions runs. Neither is resolved here. An integration built
+ * on an alias therefore follows that alias wherever it is moved to afterwards.
+ */
+export class SimRestApiLambdaUri {
+    /** The URI as it was configured, which is what the API hands back. */
+    uri;
+    /** The function ARN the URI named, with any wrapper taken off. */
+    functionArn;
+    regionName;
+    accountId;
+    functionName;
+    qualifier;
+    constructor(properties) {
+        this.uri = properties.uri;
+        this.functionArn = properties.functionArn;
+        this.regionName = properties.regionName;
+        this.accountId = properties.accountId;
+        this.functionName = properties.functionName;
+        this.qualifier = properties.qualifier;
+    }
+    /**
+     * Read an integration URI, refusing anything other than a Lambda function.
+     */
+    static parse(uri) {
+        const invocation = simLambdaInvocationUriOf(uri);
+        if (invocation === undefined) {
+            throw new SimApiGatewayBadRequest(`uri '${uri}' is not a simulated invocation target: an AWS_PROXY ` +
+                `integration is simulated only for a Lambda function ARN, with or ` +
+                `without a version or alias qualifier, such as ` +
+                `arn:aws:lambda:eu-west-2:111111111111:function:orders or ` +
+                `arn:aws:apigateway:eu-west-2:lambda:path/2015-03-31/functions/` +
+                `arn:aws:lambda:eu-west-2:111111111111:function:orders/invocations`);
+        }
+        return new SimRestApiLambdaUri({ ...invocation, uri });
+    }
+}
+//# sourceMappingURL=sim-rest-api-lambda-uri.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-lambda-uri.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/method/sim-rest-api-lambda-uri.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,mBAAmB;IAC9B,sEAAsE;IACtD,GAAG,CAAS;IAE5B,kEAAkE;IAClD,WAAW,CAAS;IAEpB,UAAU,CAAS;IACnB,SAAS,CAAS;IAClB,YAAY,CAAS;IACrB,SAAS,CAAqB;IAE9C,YAAoB,UAOnB;QACC,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAW;QACtB,MAAM,UAAU,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAEjD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,uBAAuB,CAC/B,QAAQ,GAAG,uDAAuD;gBAChE,mEAAmE;gBACnE,gDAAgD;gBAChD,2DAA2D;gBAC3D,gEAAgE;gBAChE,mEAAmE,CACtE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,mBAAmB,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}

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

@@ -0,0 +1,26 @@
+/**
+ * The scopes a method asks a token for.
+ *
+ * A method with no scopes asks for nothing beyond a token its authorizer
+ * accepted. A method with scopes is satisfied by any one of them, which is
+ * what AWS documents: the check is any-of, not all-of.
+ *
+ * Only a `COGNITO_USER_POOLS` method has them, since they are checked against
+ * the token's own `scope` claim.
+ */
+export declare class SimRestApiMethodScopes {
+    readonly values: readonly string[];
+    constructor(values?: readonly string[]);
+    /**
+     * Whether this method asks for no scope in particular.
+     */
+    get isEmpty(): boolean;
+    /**
+     * Whether a token claiming these scopes may have this method.
+     *
+     * A token claiming no scopes at all, which is every Cognito id token, meets
+     * no method scope and is refused by any method that asks for one.
+     */
+    permits(claimed: readonly string[] | null): boolean;
+}
+//# sourceMappingURL=sim-rest-api-method-scopes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-method-scopes.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/method/sim-rest-api-method-scopes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1C,YAAY,MAAM,GAAE,SAAS,MAAM,EAAO,EAEzC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAUlD;CACF"}

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

@@ -0,0 +1,38 @@
+/**
+ * The scopes a method asks a token for.
+ *
+ * A method with no scopes asks for nothing beyond a token its authorizer
+ * accepted. A method with scopes is satisfied by any one of them, which is
+ * what AWS documents: the check is any-of, not all-of.
+ *
+ * Only a `COGNITO_USER_POOLS` method has them, since they are checked against
+ * the token's own `scope` claim.
+ */
+export class SimRestApiMethodScopes {
+    values;
+    constructor(values = []) {
+        this.values = values;
+    }
+    /**
+     * Whether this method asks for no scope in particular.
+     */
+    get isEmpty() {
+        return this.values.length === 0;
+    }
+    /**
+     * Whether a token claiming these scopes may have this method.
+     *
+     * A token claiming no scopes at all, which is every Cognito id token, meets
+     * no method scope and is refused by any method that asks for one.
+     */
+    permits(claimed) {
+        if (this.isEmpty) {
+            return true;
+        }
+        if (claimed === null) {
+            return false;
+        }
+        return claimed.some((scope) => this.values.includes(scope));
+    }
+}
+//# sourceMappingURL=sim-rest-api-method-scopes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-method-scopes.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/api/method/sim-rest-api-method-scopes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,OAAO,sBAAsB;IACjB,MAAM,CAAoB;IAE1C,YAAY,MAAM,GAAsB,EAAE;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAiC;QACvC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF"}