@kensio/yulin 0.47.0 → 1.0.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-greedy-segment.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-greedy-segment.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,sBAAsB,EACvB,MAAM,gCAAgC,CAAC;AAExC;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,qBAAqB;IACnE,SAAgB,IAAI,KAAqB;IACzC;;OAEG;IACH,SAAgB,SAAS,SAAS;IAClC,SAAgB,aAAa,EAAE,MAAM,CAAC;IAEtC,YAAY,aAAa,EAAE,MAAM,EAEhC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,sBAAsB,GAAG,SAAS,CASxE;CACF"}

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

@@ -0,0 +1,35 @@
+import { SimHttpApiPathParameter } from "./sim-http-api-path-parameters.js";
+import { greedySegmentRank, 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 class SimHttpApiGreedySegment {
+    rank = greedySegmentRank;
+    /**
+     * Every greedy segment has the same signature, whatever the name is.
+     */
+    signature = "{+}";
+    parameterName;
+    constructor(parameterName) {
+        this.parameterName = parameterName;
+    }
+    /**
+     * 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) {
+        if (remaining.length === 0) {
+            return undefined;
+        }
+        return new SimHttpApiSegmentMatch(remaining.length, new SimHttpApiPathParameter(this.parameterName, remaining.join("/")));
+    }
+}
+//# sourceMappingURL=sim-http-api-greedy-segment.js.map

package/dist/service/apigatewayv2/api/route/path/sim-http-api-greedy-segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-greedy-segment.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-greedy-segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EACL,iBAAiB,EAEjB,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IAClB,IAAI,GAAG,iBAAiB,CAAC;IACzC;;OAEG;IACa,SAAS,GAAG,KAAK,CAAC;IAClB,aAAa,CAAS;IAEtC,YAAY,aAAqB;QAC/B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,SAA4B;QAClC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,sBAAsB,CAC/B,SAAS,CAAC,MAAM,EAChB,IAAI,uBAAuB,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACrE,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+import { type SimHttpApiPathSegment, SimHttpApiSegmentMatch } from "./sim-http-api-path-segment.js";
+/**
+ * A route path segment naming one exact path segment, such as `pets`.
+ *
+ * It captures nothing, and it is the most specific kind of segment: a request
+ * matching a literal here matches nothing more general at the same position.
+ */
+export declare class SimHttpApiLiteralSegment implements SimHttpApiPathSegment {
+    readonly rank = 0;
+    /** A literal captures nothing, so it has no parameter to capture into. */
+    readonly parameterName: undefined;
+    readonly text: string;
+    constructor(text: string);
+    /**
+     * A literal has no parameter name to erase, so it is its own signature.
+     */
+    get signature(): string;
+    /**
+     * Take the one request segment this literal names, when it is there.
+     */
+    consume(remaining: readonly string[]): SimHttpApiSegmentMatch | undefined;
+}
+//# sourceMappingURL=sim-http-api-literal-segment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-literal-segment.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-literal-segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,sBAAsB,EACvB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,qBAAqB;IACpE,SAAgB,IAAI,KAAsB;IAC1C,0EAA0E;IAC1E,SAAgB,aAAa,YAAa;IAC1C,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,YAAY,IAAI,EAAE,MAAM,EAEvB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,sBAAsB,GAAG,SAAS,CAMxE;CACF"}

package/dist/service/apigatewayv2/api/route/path/sim-http-api-literal-segment.js

@@ -0,0 +1,32 @@
+import { literalSegmentRank, SimHttpApiSegmentMatch, } from "./sim-http-api-path-segment.js";
+/**
+ * A route path segment naming one exact path segment, such as `pets`.
+ *
+ * It captures nothing, and it is the most specific kind of segment: a request
+ * matching a literal here matches nothing more general at the same position.
+ */
+export class SimHttpApiLiteralSegment {
+    rank = literalSegmentRank;
+    /** A literal captures nothing, so it has no parameter to capture into. */
+    parameterName = undefined;
+    text;
+    constructor(text) {
+        this.text = text;
+    }
+    /**
+     * A literal has no parameter name to erase, so it is its own signature.
+     */
+    get signature() {
+        return this.text;
+    }
+    /**
+     * Take the one request segment this literal names, when it is there.
+     */
+    consume(remaining) {
+        if (remaining[0] !== this.text) {
+            return undefined;
+        }
+        return new SimHttpApiSegmentMatch(1);
+    }
+}
+//# sourceMappingURL=sim-http-api-literal-segment.js.map

package/dist/service/apigatewayv2/api/route/path/sim-http-api-literal-segment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-literal-segment.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-literal-segment.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAElB,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IACnB,IAAI,GAAG,kBAAkB,CAAC;IAC1C,0EAA0E;IAC1D,aAAa,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAS;IAE7B,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,SAA4B;QAClC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;CACF"}

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

@@ -0,0 +1,36 @@
+/**
+ * One value a parameterised route path captured from a request path.
+ */
+export declare class SimHttpApiPathParameter {
+    readonly name: string;
+    readonly value: string;
+    constructor(name: string, value: string);
+}
+/**
+ * The values the matched route captured from the request path.
+ *
+ * This is a class rather than a record because matching builds it up one
+ * segment at a time, and because an empty one has to stay tellable from one
+ * with values in it. It becomes a record only at the event boundary, which is
+ * the one place a handler reads it.
+ */
+export declare class SimHttpApiPathParameters {
+    private readonly captured;
+    /**
+     * Whether nothing was captured, which is what a route of only literal
+     * segments produces.
+     */
+    get isEmpty(): boolean;
+    /**
+     * Take a captured value, if the segment that offered it captured one.
+     *
+     * A literal segment captures nothing, so it is allowed to offer nothing
+     * rather than every caller having to ask whether there is anything to add.
+     */
+    add(parameter: SimHttpApiPathParameter | undefined): void;
+    /**
+     * The captured values as the event's `pathParameters` field holds them.
+     */
+    toRecord(): Record<string, string>;
+}
+//# sourceMappingURL=sim-http-api-path-parameters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-path-parameters.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-path-parameters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,uBAAuB;IAClC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,YAAY,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAGtC;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD;;;OAGG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAAS,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAMxD;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEjC;CACF"}

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

@@ -0,0 +1,48 @@
+/**
+ * One value a parameterised route path captured from a request path.
+ */
+export class SimHttpApiPathParameter {
+    name;
+    value;
+    constructor(name, value) {
+        this.name = name;
+        this.value = value;
+    }
+}
+/**
+ * The values the matched route captured from the request path.
+ *
+ * This is a class rather than a record because matching builds it up one
+ * segment at a time, and because an empty one has to stay tellable from one
+ * with values in it. It becomes a record only at the event boundary, which is
+ * the one place a handler reads it.
+ */
+export class SimHttpApiPathParameters {
+    captured = new Map();
+    /**
+     * Whether nothing was captured, which is what a route of only literal
+     * segments produces.
+     */
+    get isEmpty() {
+        return this.captured.size === 0;
+    }
+    /**
+     * Take a captured value, if the segment that offered it captured one.
+     *
+     * A literal segment captures nothing, so it is allowed to offer nothing
+     * rather than every caller having to ask whether there is anything to add.
+     */
+    add(parameter) {
+        if (parameter === undefined) {
+            return;
+        }
+        this.captured.set(parameter.name, parameter.value);
+    }
+    /**
+     * The captured values as the event's `pathParameters` field holds them.
+     */
+    toRecord() {
+        return Object.fromEntries(this.captured);
+    }
+}
+//# sourceMappingURL=sim-http-api-path-parameters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-path-parameters.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-path-parameters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAClB,IAAI,CAAS;IACb,KAAK,CAAS;IAE9B,YAAY,IAAY,EAAE,KAAa;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAwB;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEtD;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,SAA8C;QAChD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;CACF"}