@kensio/yulin 0.47.0 → 1.1.0

package/dist/service/apigatewayv2/api/integration/sim-http-api-integration.js

@@ -0,0 +1,54 @@
+import { faker } from "@faker-js/faker";
+/**
+ * Allocate an integration id.
+ *
+ * Real API Gateway ids are opaque short lowercase alphanumeric strings; the
+ * exact length is not part of the API contract, so only the shape is matched.
+ */
+export function makeSimHttpApiIntegrationId() {
+    return faker.helpers.fromRegExp(/[a-z0-9]{8}/);
+}
+/**
+ * A simulated HTTP API integration: what the API does with a request one of
+ * its routes matched.
+ *
+ * Only `AWS_PROXY` is modelled, so an integration is a Lambda function and the
+ * payload format that function is invoked with.
+ */
+export class SimHttpApiIntegration {
+    integrationId;
+    integrationType;
+    lambdaUri;
+    payloadFormatVersion;
+    description;
+    constructor(properties) {
+        this.integrationId = properties.integrationId;
+        this.integrationType = properties.integrationType;
+        this.lambdaUri = properties.lambdaUri;
+        this.payloadFormatVersion = properties.payloadFormatVersion;
+        this.description = properties.description;
+    }
+    /**
+     * The ARN of the Lambda function this integration invokes, as the request
+     * gave it and the API hands it back.
+     */
+    get integrationUri() {
+        return this.lambdaUri.uri;
+    }
+    /**
+     * Get the AWS-like view of this integration.
+     */
+    view() {
+        const view = {
+            IntegrationId: this.integrationId,
+            IntegrationType: this.integrationType,
+            IntegrationUri: this.integrationUri,
+            PayloadFormatVersion: this.payloadFormatVersion,
+        };
+        if (this.description !== undefined) {
+            view.Description = this.description;
+        }
+        return view;
+    }
+}
+//# sourceMappingURL=sim-http-api-integration.js.map

package/dist/service/apigatewayv2/api/integration/sim-http-api-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-integration.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/integration/sim-http-api-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAsBxC;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAA4B,CAAC;AAC5E,CAAC;AAqBD;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IAChB,aAAa,CAA0B;IACvC,eAAe,CAA4B;IAC3C,SAAS,CAAsB;IAC/B,oBAAoB,CAAiC;IACrD,WAAW,CAAsB;IAEjD,YAAY,UAA2C;QACrD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;QAC9C,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,oBAAoB,GAAG,UAAU,CAAC,oBAAoB,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,IAAI,GAA8B;YACtC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;SAChD,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/apigatewayv2/api/integration/sim-http-api-lambda-uri.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A URI naming the Lambda function something on an API invokes: the
+ * `IntegrationUri` of an `AWS_PROXY` integration, or the `AuthorizerUri` of a
+ * `REQUEST` authorizer. Both are written the same way.
+ *
+ * Only an unqualified function ARN is accepted. A version or alias qualifier
+ * on the end names a published function version, and simulated Lambda has no
+ * versions, so one is refused rather than invoked as the unpublished function
+ * it is not.
+ *
+ * Both URI forms reach the same function, and both are held as the function
+ * ARN, which is what the API hands back. Reading them here rather than in each
+ * caller is what lets an SDK caller, a template and an imported document write
+ * whichever form they write.
+ */
+export declare class SimHttpApiLambdaUri {
+    readonly uri: string;
+    readonly regionName: string;
+    readonly accountId: string;
+    readonly functionName: string;
+    private constructor();
+    /**
+     * Read an integration URI, refusing anything that is not a Lambda function
+     * ARN.
+     */
+    static parse(uri: string): SimHttpApiLambdaUri;
+    /**
+     * Read a `REQUEST` authorizer's URI, which names its function the same way.
+     */
+    static parseAuthorizerUri(uri: string): SimHttpApiLambdaUri;
+    private static read;
+    /**
+     * The function ARN a URI names, in either form it is written in.
+     */
+    private static functionArn;
+}
+//# sourceMappingURL=sim-http-api-lambda-uri.d.ts.map

package/dist/service/apigatewayv2/api/integration/sim-http-api-lambda-uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-lambda-uri.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/integration/sim-http-api-lambda-uri.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAmB;IAC9B,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,YAAY,EAAE,MAAM,CAAC;IAErC,OAAO,eAMN;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAO7C;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAO1D;IAED,OAAO,CAAC,MAAM,CAAC,IAAI;IAmBnB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAG3B"}

package/dist/service/apigatewayv2/api/integration/sim-http-api-lambda-uri.js

@@ -0,0 +1,74 @@
+import { SimApiGatewayV2BadRequest } from "../../error/sim-api-gateway-v2.error.js";
+const lambdaFunctionArn = /^arn:aws:lambda:(?<regionName>[a-z0-9-]+):(?<accountId>\d{12}):function:(?<functionName>[a-zA-Z0-9-_]+)$/;
+/**
+ * The other form an integration URI is written in, wrapping a Lambda function
+ * ARN in an API Gateway path:
+ *
+ *   arn:aws:apigateway:eu-west-2:lambda:path/2015-03-31/functions/<function-arn>/invocations
+ *
+ * The date is the Lambda invoke API version and is part of the literal rather
+ * than something a caller chooses. An OpenAPI document being imported writes
+ * this form, and so does a hand-written CloudFormation template, while CDK
+ * emits the bare function ARN.
+ */
+const apiGatewayLambdaPathUri = /^arn:[^:]+:apigateway:[^:]+:lambda:path\/2015-03-31\/functions\/(?<functionArn>arn:[^/]+)\/invocations$/;
+/**
+ * A URI naming the Lambda function something on an API invokes: the
+ * `IntegrationUri` of an `AWS_PROXY` integration, or the `AuthorizerUri` of a
+ * `REQUEST` authorizer. Both are written the same way.
+ *
+ * Only an unqualified function ARN is accepted. A version or alias qualifier
+ * on the end names a published function version, and simulated Lambda has no
+ * versions, so one is refused rather than invoked as the unpublished function
+ * it is not.
+ *
+ * Both URI forms reach the same function, and both are held as the function
+ * ARN, which is what the API hands back. Reading them here rather than in each
+ * caller is what lets an SDK caller, a template and an imported document write
+ * whichever form they write.
+ */
+export class SimHttpApiLambdaUri {
+    uri;
+    regionName;
+    accountId;
+    functionName;
+    constructor(uri, groups) {
+        this.uri = uri;
+        /* v8 ignore next 3 -- the pattern that matched fills all three groups */
+        this.regionName = groups["regionName"] ?? "";
+        this.accountId = groups["accountId"] ?? "";
+        this.functionName = groups["functionName"] ?? "";
+    }
+    /**
+     * Read an integration URI, refusing anything that is not a Lambda function
+     * ARN.
+     */
+    static parse(uri) {
+        return this.read("IntegrationUri", uri, "an AWS_PROXY integration is simulated only for an unqualified Lambda " +
+            "function ARN");
+    }
+    /**
+     * Read a `REQUEST` authorizer's URI, which names its function the same way.
+     */
+    static parseAuthorizerUri(uri) {
+        return this.read("AuthorizerUri", uri, "a REQUEST authorizer is simulated only for an unqualified Lambda " +
+            "function ARN");
+    }
+    static read(option, uri, refusal) {
+        const functionArn = this.functionArn(uri);
+        const groups = lambdaFunctionArn.exec(functionArn)?.groups;
+        if (groups === undefined) {
+            throw new SimApiGatewayV2BadRequest(`${option} '${uri}' is not a simulated invocation target: ` +
+                `${refusal}, such as ` +
+                `arn:aws:lambda:eu-west-2:111111111111:function:orders`);
+        }
+        return new SimHttpApiLambdaUri(functionArn, groups);
+    }
+    /**
+     * The function ARN a URI names, in either form it is written in.
+     */
+    static functionArn(uri) {
+        return apiGatewayLambdaPathUri.exec(uri)?.groups?.["functionArn"] ?? uri;
+    }
+}
+//# sourceMappingURL=sim-http-api-lambda-uri.js.map

package/dist/service/apigatewayv2/api/integration/sim-http-api-lambda-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-lambda-uri.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/integration/sim-http-api-lambda-uri.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAEpF,MAAM,iBAAiB,GACrB,0GAA0G,CAAC;AAE7G;;;;;;;;;;GAUG;AACH,MAAM,uBAAuB,GAC3B,yGAAyG,CAAC;AAE5G;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,mBAAmB;IACd,GAAG,CAAS;IACZ,UAAU,CAAS;IACnB,SAAS,CAAS;IAClB,YAAY,CAAS;IAErC,YAAoB,GAAW,EAAE,MAA8B;QAC7D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,yEAAyE;QACzE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,IAAI,CACd,gBAAgB,EAChB,GAAG,EACH,uEAAuE;YACrE,cAAc,CACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,GAAW;QACnC,OAAO,IAAI,CAAC,IAAI,CACd,eAAe,EACf,GAAG,EACH,mEAAmE;YACjE,cAAc,CACjB,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,IAAI,CACjB,MAAc,EACd,GAAW,EACX,OAAe;QAEf,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAE3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,yBAAyB,CACjC,GAAG,MAAM,KAAK,GAAG,0CAA0C;gBACzD,GAAG,OAAO,YAAY;gBACtB,uDAAuD,CAC1D,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,WAAW,CAAC,GAAW;QACpC,OAAO,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC;IAC3E,CAAC;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-default-route-key.d.ts

@@ -0,0 +1,36 @@
+import { SimHttpApiPathParameters } from "../path/sim-http-api-path-parameters.js";
+import { SimHttpApiRouteRank } from "../sim-http-api-route-rank.js";
+import type { SimHttpApiRouteKey } from "./sim-http-api-route-key.js";
+/**
+ * The catch-all route key, which serves any method and path the API has no
+ * more specific route for.
+ */
+export declare const simHttpApiDefaultRouteKey = "$default";
+/**
+ * The `$default` route.
+ *
+ * It matches everything and captures nothing, and it loses to every other
+ * matching route, which is the tier AWS documents it in.
+ */
+export declare class SimHttpApiDefaultRouteKey implements SimHttpApiRouteKey {
+    readonly text = "$default";
+    readonly signature = "$default";
+    readonly rank: SimHttpApiRouteRank;
+    /**
+     * Match any request, capturing nothing.
+     *
+     * The empty capture is what keeps `pathParameters` out of the event for a
+     * `$default` match, which is what real API Gateway does with it. That is
+     * observed rather than documented.
+     */
+    match(): SimHttpApiPathParameters;
+    /**
+     * Name this route in an `execute-api` ARN.
+     *
+     * The catch-all has no method and no path of its own, and both collapse into
+     * the single literal `$default`, so the ARN ends `<apiId>/<stage>/$default`.
+     * AWS gives that form as a CLI example for granting a `$default` route.
+     */
+    methodAndPath(): string;
+}
+//# sourceMappingURL=sim-http-api-default-route-key.d.ts.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-default-route-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-default-route-key.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-default-route-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAEL,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAAa,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,SAAgB,IAAI,cAA6B;IACjD,SAAgB,SAAS,cAA6B;IACtD,SAAgB,IAAI,sBAIjB;IAEH;;;;;;OAMG;IACH,KAAK,IAAI,wBAAwB,CAEhC;IAED;;;;;;OAMG;IACH,aAAa,IAAI,MAAM,CAEtB;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-default-route-key.js

@@ -0,0 +1,44 @@
+import { SimHttpApiPathParameters } from "../path/sim-http-api-path-parameters.js";
+import { defaultRouteTier, SimHttpApiRouteRank, } from "../sim-http-api-route-rank.js";
+import { exactMethodRank } from "./sim-http-api-route-method.js";
+/**
+ * The catch-all route key, which serves any method and path the API has no
+ * more specific route for.
+ */
+export const simHttpApiDefaultRouteKey = "$default";
+/**
+ * The `$default` route.
+ *
+ * It matches everything and captures nothing, and it loses to every other
+ * matching route, which is the tier AWS documents it in.
+ */
+export class SimHttpApiDefaultRouteKey {
+    text = simHttpApiDefaultRouteKey;
+    signature = simHttpApiDefaultRouteKey;
+    rank = new SimHttpApiRouteRank({
+        tier: defaultRouteTier,
+        methodRank: exactMethodRank,
+        segmentRanks: [],
+    });
+    /**
+     * Match any request, capturing nothing.
+     *
+     * The empty capture is what keeps `pathParameters` out of the event for a
+     * `$default` match, which is what real API Gateway does with it. That is
+     * observed rather than documented.
+     */
+    match() {
+        return new SimHttpApiPathParameters();
+    }
+    /**
+     * Name this route in an `execute-api` ARN.
+     *
+     * The catch-all has no method and no path of its own, and both collapse into
+     * the single literal `$default`, so the ARN ends `<apiId>/<stage>/$default`.
+     * AWS gives that form as a CLI example for granting a `$default` route.
+     */
+    methodAndPath() {
+        return simHttpApiDefaultRouteKey;
+    }
+}
+//# sourceMappingURL=sim-http-api-default-route-key.js.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-default-route-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-default-route-key.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-default-route-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IACpB,IAAI,GAAG,yBAAyB,CAAC;IACjC,SAAS,GAAG,yBAAyB,CAAC;IACtC,IAAI,GAAG,IAAI,mBAAmB,CAAC;QAC7C,IAAI,EAAE,gBAAgB;QACtB,UAAU,EAAE,eAAe;QAC3B,YAAY,EAAE,EAAE;KACjB,CAAC,CAAC;IAEH;;;;;;OAMG;IACH,KAAK;QACH,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,aAAa;QACX,OAAO,yBAAyB,CAAC;IACnC,CAAC;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-method-route-key.d.ts

@@ -0,0 +1,48 @@
+import type { SimHttpApiPathParameters } from "../path/sim-http-api-path-parameters.js";
+import type { SimHttpApiRoutePath } from "../path/sim-http-api-route-path.js";
+import { SimHttpApiRouteRank } from "../sim-http-api-route-rank.js";
+import type { SimHttpApiRouteRequest } from "../sim-http-api-route-request.js";
+import type { SimHttpApiRouteMethod } from "./sim-http-api-route-method.js";
+import type { SimHttpApiRouteKey } from "./sim-http-api-route-key.js";
+interface SimHttpApiMethodRouteKeyProperties {
+    readonly method: SimHttpApiRouteMethod;
+    readonly path: SimHttpApiRoutePath;
+}
+/**
+ * A route key naming a method and a path, such as `GET /pets/{petId}`.
+ */
+export declare class SimHttpApiMethodRouteKey implements SimHttpApiRouteKey {
+    readonly method: SimHttpApiRouteMethod;
+    readonly path: SimHttpApiRoutePath;
+    readonly rank: SimHttpApiRouteRank;
+    constructor(properties: SimHttpApiMethodRouteKeyProperties);
+    /**
+     * The route key as it was written.
+     */
+    get text(): string;
+    /**
+     * The route key with its parameter names erased, which is the identity real
+     * API Gateway gives the route.
+     */
+    get signature(): string;
+    /**
+     * Match a request of the right method against this route's path.
+     *
+     * A request whose path matches and whose method does not simply misses this
+     * route, rather than being told it used the wrong method. An HTTP API with
+     * nothing else to catch it answers 404 rather than 405, which is observed
+     * rather than documented.
+     */
+    match(request: SimHttpApiRouteRequest): SimHttpApiPathParameters | undefined;
+    /**
+     * Name this route in an `execute-api` ARN, as `GET/pets/{petId}`.
+     *
+     * The path is the route key's template, braces and all, rather than the path
+     * the request asked for. The method is the request's, since a route key of
+     * `ANY /pets` serves a request of any method and the ARN names one method.
+     */
+    methodAndPath(requestMethod: string): string;
+    private get tier();
+}
+export {};
+//# sourceMappingURL=sim-http-api-method-route-key.d.ts.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-method-route-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-method-route-key.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-method-route-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAGL,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IACjE,SAAgB,MAAM,EAAE,qBAAqB,CAAC;IAC9C,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAC1C,SAAgB,IAAI,EAAE,mBAAmB,CAAC;IAE1C,YAAY,UAAU,EAAE,kCAAkC,EAQzD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,wBAAwB,GAAG,SAAS,CAM3E;IAED;;;;;;OAMG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE3C;IAED,OAAO,KAAK,IAAI,GAMf;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-method-route-key.js

@@ -0,0 +1,62 @@
+import { fullMatchTier, greedyMatchTier, SimHttpApiRouteRank, } from "../sim-http-api-route-rank.js";
+/**
+ * A route key naming a method and a path, such as `GET /pets/{petId}`.
+ */
+export class SimHttpApiMethodRouteKey {
+    method;
+    path;
+    rank;
+    constructor(properties) {
+        this.method = properties.method;
+        this.path = properties.path;
+        this.rank = new SimHttpApiRouteRank({
+            tier: this.tier,
+            methodRank: this.method.rank,
+            segmentRanks: this.path.segmentRanks,
+        });
+    }
+    /**
+     * The route key as it was written.
+     */
+    get text() {
+        return `${this.method.token} ${this.path.text}`;
+    }
+    /**
+     * The route key with its parameter names erased, which is the identity real
+     * API Gateway gives the route.
+     */
+    get signature() {
+        return `${this.method.token} ${this.path.signature}`;
+    }
+    /**
+     * Match a request of the right method against this route's path.
+     *
+     * A request whose path matches and whose method does not simply misses this
+     * route, rather than being told it used the wrong method. An HTTP API with
+     * nothing else to catch it answers 404 rather than 405, which is observed
+     * rather than documented.
+     */
+    match(request) {
+        if (!this.method.matches(request.method)) {
+            return undefined;
+        }
+        return this.path.match(request.segments);
+    }
+    /**
+     * Name this route in an `execute-api` ARN, as `GET/pets/{petId}`.
+     *
+     * The path is the route key's template, braces and all, rather than the path
+     * the request asked for. The method is the request's, since a route key of
+     * `ANY /pets` serves a request of any method and the ARN names one method.
+     */
+    methodAndPath(requestMethod) {
+        return `${requestMethod}${this.path.text}`;
+    }
+    get tier() {
+        if (this.path.hasGreedySegment) {
+            return greedyMatchTier;
+        }
+        return fullMatchTier;
+    }
+}
+//# sourceMappingURL=sim-http-api-method-route-key.js.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-method-route-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-method-route-key.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-method-route-key.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAUvC;;GAEG;AACH,MAAM,OAAO,wBAAwB;IACnB,MAAM,CAAwB;IAC9B,IAAI,CAAsB;IAC1B,IAAI,CAAsB;IAE1C,YAAY,UAA8C;QACxD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,mBAAmB,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YAC5B,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;SACrC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACX,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACvD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAA+B;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,aAAqB;QACjC,OAAO,GAAG,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,IAAY,IAAI;QACd,IAAI,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC/B,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key-parser.d.ts

@@ -0,0 +1,18 @@
+import type { SimHttpApiRouteKey } from "./sim-http-api-route-key.js";
+/**
+ * Reads the `RouteKey` a `CreateRoute` request carries.
+ *
+ * A route key is either the literal `$default` or a method and a path
+ * separated by one space. Everything else is refused here, which is where real
+ * API Gateway refuses it too: a route key that cannot be read is a route that
+ * would never match a request, and finding that out at request time rather
+ * than at creation time is the failure worth avoiding.
+ */
+export declare class SimHttpApiRouteKeyParser {
+    private readonly pathParser;
+    /**
+     * Read a route key, or refuse it.
+     */
+    parse(routeKey: string): SimHttpApiRouteKey;
+}
+//# sourceMappingURL=sim-http-api-route-key-parser.d.ts.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-key-parser.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-route-key-parser.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;GAQG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;IAE9D;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAqB1C;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key-parser.js

@@ -0,0 +1,37 @@
+import { SimApiGatewayV2BadRequest } from "../../../error/sim-api-gateway-v2.error.js";
+import { SimHttpApiRoutePathParser } from "../path/sim-http-api-route-path-parser.js";
+import { SimHttpApiDefaultRouteKey, simHttpApiDefaultRouteKey, } from "./sim-http-api-default-route-key.js";
+import { SimHttpApiMethodRouteKey } from "./sim-http-api-method-route-key.js";
+import { SimHttpApiRouteMethod } from "./sim-http-api-route-method.js";
+/**
+ * Reads the `RouteKey` a `CreateRoute` request carries.
+ *
+ * A route key is either the literal `$default` or a method and a path
+ * separated by one space. Everything else is refused here, which is where real
+ * API Gateway refuses it too: a route key that cannot be read is a route that
+ * would never match a request, and finding that out at request time rather
+ * than at creation time is the failure worth avoiding.
+ */
+export class SimHttpApiRouteKeyParser {
+    pathParser = new SimHttpApiRoutePathParser();
+    /**
+     * Read a route key, or refuse it.
+     */
+    parse(routeKey) {
+        if (routeKey === simHttpApiDefaultRouteKey) {
+            return new SimHttpApiDefaultRouteKey();
+        }
+        const parts = routeKey.split(" ");
+        if (parts.length !== 2) {
+            throw new SimApiGatewayV2BadRequest(`Route key '${routeKey}' is not a route key: a route key is either ` +
+                `$default or a method and a path separated by one space, such as ` +
+                `'GET /pets'`);
+        }
+        const [method = "", path = ""] = parts;
+        return new SimHttpApiMethodRouteKey({
+            method: SimHttpApiRouteMethod.parse(method, routeKey),
+            path: this.pathParser.parse(path, routeKey),
+        });
+    }
+}
+//# sourceMappingURL=sim-http-api-route-key-parser.js.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-key-parser.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-route-key-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE;;;;;;;;GAQG;AACH,MAAM,OAAO,wBAAwB;IAClB,UAAU,GAAG,IAAI,yBAAyB,EAAE,CAAC;IAE9D;;OAEG;IACH,KAAK,CAAC,QAAgB;QACpB,IAAI,QAAQ,KAAK,yBAAyB,EAAE,CAAC;YAC3C,OAAO,IAAI,yBAAyB,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,yBAAyB,CACjC,cAAc,QAAQ,8CAA8C;gBAClE,kEAAkE;gBAClE,aAAa,CAChB,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;QAEvC,OAAO,IAAI,wBAAwB,CAAC;YAClC,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC;YACrD,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key.d.ts

@@ -0,0 +1,38 @@
+import type { SimHttpApiPathParameters } from "../path/sim-http-api-path-parameters.js";
+import type { SimHttpApiRouteRank } from "../sim-http-api-route-rank.js";
+import type { SimHttpApiRouteRequest } from "../sim-http-api-route-request.js";
+/**
+ * A parsed route key: what decides whether a route serves a request, and what
+ * it captures from the path when it does.
+ *
+ * There are two of these, the `$default` catch-all and a method with a path,
+ * and they answer the same questions differently rather than the caller asking
+ * which one it has.
+ */
+export interface SimHttpApiRouteKey {
+    /** The route key as it was written, which is what `RouteKey` reports. */
+    readonly text: string;
+    /**
+     * The route key with parameter names erased, which is the identity real API
+     * Gateway gives a route: `GET /pets/{id}` and `GET /pets/{petId}` are one
+     * route and the second is a conflict.
+     */
+    readonly signature: string;
+    /** How specific this route is, for choosing between matching routes. */
+    readonly rank: SimHttpApiRouteRank;
+    /**
+     * The path parameters this route captures from a request it matches, or
+     * nothing when it does not match.
+     */
+    match(request: SimHttpApiRouteRequest): SimHttpApiPathParameters | undefined;
+    /**
+     * How this route names itself in an `execute-api` ARN, given the method of
+     * the request that matched it.
+     *
+     * The method is the request's rather than the route's, because a route key
+     * of `ANY /pets` is matched by a `GET` request and API Gateway puts a
+     * concrete verb in the ARN. `SimHttpApiExecuteApiArn` has the reasoning.
+     */
+    methodAndPath(requestMethod: string): string;
+}
+//# sourceMappingURL=sim-http-api-route-key.d.ts.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-key.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-route-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,wBAAwB,GAAG,SAAS,CAAC;IAC7E;;;;;;;OAOG;IACH,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sim-http-api-route-key.js.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-key.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-route-key.ts"],"names":[],"mappings":""}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-method.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The method token matching any method, which is what makes a route the one
+ * for a path whatever the request did to it.
+ */
+export declare const simHttpApiAnyMethod = "ANY";
+export declare const exactMethodRank = 0;
+export declare const anyMethodRank = 1;
+/**
+ * The method half of a route key, such as the `GET` of `GET /pets`.
+ */
+export declare class SimHttpApiRouteMethod {
+    readonly token: string;
+    constructor(token: string);
+    /**
+     * Read a method token, naming the whole route key in anything refused.
+     *
+     * The token is upper-case or nothing, so `get /pets` is refused. That real
+     * API Gateway refuses it at `CreateRoute` is observed rather than
+     * documented, but a lower-case method here would be a route that never
+     * matched a request, which is worse than being told about it early.
+     */
+    static parse(token: string, routeKey: string): SimHttpApiRouteMethod;
+    /**
+     * How specific this method is. An exact method beats `ANY`.
+     */
+    get rank(): number;
+    /**
+     * Whether a request of this method reaches this route.
+     */
+    matches(requestMethod: string): boolean;
+}
+//# sourceMappingURL=sim-http-api-route-method.d.ts.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-method.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-route-method.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAgBzC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B;;GAEG;AACH,qBAAa,qBAAqB;IAChC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,YAAY,KAAK,EAAE,MAAM,EAExB;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAUnE;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAMjB;IAED;;OAEG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAMtC;CACF"}

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-method.js

@@ -0,0 +1,65 @@
+import { SimApiGatewayV2BadRequest } from "../../../error/sim-api-gateway-v2.error.js";
+/**
+ * The method token matching any method, which is what makes a route the one
+ * for a path whatever the request did to it.
+ */
+export const simHttpApiAnyMethod = "ANY";
+/**
+ * The method tokens an HTTP API route key may name.
+ */
+const routeMethods = new Set([
+    "GET",
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE",
+    "HEAD",
+    "OPTIONS",
+    simHttpApiAnyMethod,
+]);
+export const exactMethodRank = 0;
+export const anyMethodRank = 1;
+/**
+ * The method half of a route key, such as the `GET` of `GET /pets`.
+ */
+export class SimHttpApiRouteMethod {
+    token;
+    constructor(token) {
+        this.token = token;
+    }
+    /**
+     * Read a method token, naming the whole route key in anything refused.
+     *
+     * The token is upper-case or nothing, so `get /pets` is refused. That real
+     * API Gateway refuses it at `CreateRoute` is observed rather than
+     * documented, but a lower-case method here would be a route that never
+     * matched a request, which is worse than being told about it early.
+     */
+    static parse(token, routeKey) {
+        if (!routeMethods.has(token)) {
+            throw new SimApiGatewayV2BadRequest(`Route key '${routeKey}' does not name an HTTP method: a route key is ` +
+                `either $default or an upper-case method and a path, such as ` +
+                `'GET /pets'`);
+        }
+        return new SimHttpApiRouteMethod(token);
+    }
+    /**
+     * How specific this method is. An exact method beats `ANY`.
+     */
+    get rank() {
+        if (this.token === simHttpApiAnyMethod) {
+            return anyMethodRank;
+        }
+        return exactMethodRank;
+    }
+    /**
+     * Whether a request of this method reaches this route.
+     */
+    matches(requestMethod) {
+        if (this.token === simHttpApiAnyMethod) {
+            return true;
+        }
+        return this.token === requestMethod;
+    }
+}
+//# sourceMappingURL=sim-http-api-route-method.js.map

package/dist/service/apigatewayv2/api/route/key/sim-http-api-route-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-method.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/key/sim-http-api-route-method.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAEvF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC;;GAEG;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;IACT,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAChB,KAAK,CAAS;IAE9B,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,QAAgB;QAC1C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,yBAAyB,CACjC,cAAc,QAAQ,iDAAiD;gBACrE,8DAA8D;gBAC9D,aAAa,CAChB,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,IAAI,IAAI,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;YACvC,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,aAAqB;QAC3B,IAAI,IAAI,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,KAAK,aAAa,CAAC;IACtC,CAAC;CACF"}

package/dist/service/apigatewayv2/api/route/path/sim-http-api-greedy-segment.d.ts

@@ -0,0 +1,27 @@
+import { type SimHttpApiPathSegment, SimHttpApiSegmentMatch } from "./sim-http-api-path-segment.js";
+/**
+ * A route path segment capturing everything left of the path, such as
+ * `{proxy+}`.
+ *
+ * It is only ever the last segment of a route path, which is what makes
+ * "everything left" well defined.
+ */
+export declare class SimHttpApiGreedySegment implements SimHttpApiPathSegment {
+    readonly rank = 2;
+    /**
+     * Every greedy segment has the same signature, whatever the name is.
+     */
+    readonly signature = "{+}";
+    readonly parameterName: string;
+    constructor(parameterName: string);
+    /**
+     * Take everything left of the request path.
+     *
+     * Two things here are observed rather than documented. A greedy segment
+     * needs at least one segment to match, so `GET /pets/{proxy+}` does not
+     * match `/pets`. And the captured value has no leading slash, so `/pets` and
+     * `cat/1` produce `cat/1` rather than `/cat/1`.
+     */
+    consume(remaining: readonly string[]): SimHttpApiSegmentMatch | undefined;
+}
+//# sourceMappingURL=sim-http-api-greedy-segment.d.ts.map