@kensio/yulin 0.47.0 → 1.1.0

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

@@ -0,0 +1,23 @@
+import { type SimHttpApiPathSegment, SimHttpApiSegmentMatch } from "./sim-http-api-path-segment.js";
+/**
+ * A route path segment capturing one path segment, such as `{petId}`.
+ *
+ * It matches exactly one segment, whatever is in it, and the value reaches the
+ * handler as `event.pathParameters.petId`.
+ */
+export declare class SimHttpApiVariableSegment implements SimHttpApiPathSegment {
+    readonly rank = 1;
+    /**
+     * Every parameter segment has the same signature, whatever the name is, so
+     * `GET /pets/{id}` and `GET /pets/{petId}` are one route.
+     */
+    readonly signature = "{}";
+    readonly parameterName: string;
+    constructor(parameterName: string);
+    /**
+     * Take the one request segment this parameter names, when there is one with
+     * something in it.
+     */
+    consume(remaining: readonly string[]): SimHttpApiSegmentMatch | undefined;
+}
+//# sourceMappingURL=sim-http-api-variable-segment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-variable-segment.d.ts","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-variable-segment.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,qBAAqB,EAC1B,sBAAsB,EAEvB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;IACrE,SAAgB,IAAI,KAAuB;IAC3C;;;OAGG;IACH,SAAgB,SAAS,QAAQ;IACjC,SAAgB,aAAa,EAAE,MAAM,CAAC;IAEtC,YAAY,aAAa,EAAE,MAAM,EAEhC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,sBAAsB,GAAG,SAAS,CAWxE;CACF"}

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

@@ -0,0 +1,32 @@
+import { SimHttpApiPathParameter } from "./sim-http-api-path-parameters.js";
+import { SimHttpApiSegmentMatch, variableSegmentRank, } from "./sim-http-api-path-segment.js";
+/**
+ * A route path segment capturing one path segment, such as `{petId}`.
+ *
+ * It matches exactly one segment, whatever is in it, and the value reaches the
+ * handler as `event.pathParameters.petId`.
+ */
+export class SimHttpApiVariableSegment {
+    rank = variableSegmentRank;
+    /**
+     * Every parameter segment has the same signature, whatever the name is, so
+     * `GET /pets/{id}` and `GET /pets/{petId}` are one route.
+     */
+    signature = "{}";
+    parameterName;
+    constructor(parameterName) {
+        this.parameterName = parameterName;
+    }
+    /**
+     * Take the one request segment this parameter names, when there is one with
+     * something in it.
+     */
+    consume(remaining) {
+        const [value] = remaining;
+        if (value === undefined || value.length === 0) {
+            return undefined;
+        }
+        return new SimHttpApiSegmentMatch(1, new SimHttpApiPathParameter(this.parameterName, value));
+    }
+}
+//# sourceMappingURL=sim-http-api-variable-segment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-variable-segment.js","sourceRoot":"","sources":["../../../../../../src/service/apigatewayv2/api/route/path/sim-http-api-variable-segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAEL,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAExC;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IACpB,IAAI,GAAG,mBAAmB,CAAC;IAC3C;;;OAGG;IACa,SAAS,GAAG,IAAI,CAAC;IACjB,aAAa,CAAS;IAEtC,YAAY,aAAqB;QAC/B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAA4B;QAClC,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;QAE1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,sBAAsB,CAC/B,CAAC,EACD,IAAI,uBAAuB,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CACvD,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,47 @@
+/**
+ * The three tiers AWS documents for route selection, most specific first: a
+ * route matching the whole path, a route ending in a greedy parameter, then
+ * the `$default` catch-all.
+ */
+export declare const fullMatchTier = 0;
+export declare const greedyMatchTier = 1;
+export declare const defaultRouteTier = 2;
+interface SimHttpApiRouteRankProperties {
+    readonly tier: number;
+    readonly methodRank: number;
+    readonly segmentRanks: readonly number[];
+}
+/**
+ * How specific one route is, and therefore which of two matching routes serves
+ * a request.
+ *
+ * The whole precedence rule lives in `compareTo`, in the order it is applied:
+ *
+ * 1. The tier. AWS documents this one: a full match beats a greedy match,
+ *    which beats `$default`.
+ * 2. The method. An exact method beats `ANY`. Observed rather than documented,
+ *    as is its place above the path comparison rather than below it.
+ * 3. The path, segment by segment from the left, with a literal beating a
+ *    `{name}` parameter and a `{name}` beating a `{name+}`. The first two rows
+ *    of AWS's worked example give the literal-beats-parameter part. Comparing
+ *    left to right rather than counting characters is what makes
+ *    `GET /a/b/{c}` beat `GET /a/{b}/ccccc`, which has more literal characters
+ *    and is less specific where it counts. It is also what gives the observed
+ *    rule that the longest literal prefix wins between two greedy routes:
+ *    `GET /pets/dog/{proxy+}` and `GET /pets/{proxy+}` differ at the second
+ *    segment, where one has a literal and the other has taken everything.
+ */
+export declare class SimHttpApiRouteRank {
+    readonly tier: number;
+    readonly methodRank: number;
+    readonly segmentRanks: readonly number[];
+    constructor(properties: SimHttpApiRouteRankProperties);
+    /**
+     * Compare this rank with another, negative meaning this one is more specific
+     * and therefore wins.
+     */
+    compareTo(other: SimHttpApiRouteRank): number;
+    private compareSegments;
+}
+export {};
+//# sourceMappingURL=sim-http-api-route-rank.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-rank.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-rank.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,UAAU,6BAA6B;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAmB;IAC9B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEhD,YAAY,UAAU,EAAE,6BAA6B,EAIpD;IAED;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAU5C;IAED,OAAO,CAAC,eAAe;CAoBxB"}

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

@@ -0,0 +1,66 @@
+/**
+ * The three tiers AWS documents for route selection, most specific first: a
+ * route matching the whole path, a route ending in a greedy parameter, then
+ * the `$default` catch-all.
+ */
+export const fullMatchTier = 0;
+export const greedyMatchTier = 1;
+export const defaultRouteTier = 2;
+/**
+ * How specific one route is, and therefore which of two matching routes serves
+ * a request.
+ *
+ * The whole precedence rule lives in `compareTo`, in the order it is applied:
+ *
+ * 1. The tier. AWS documents this one: a full match beats a greedy match,
+ *    which beats `$default`.
+ * 2. The method. An exact method beats `ANY`. Observed rather than documented,
+ *    as is its place above the path comparison rather than below it.
+ * 3. The path, segment by segment from the left, with a literal beating a
+ *    `{name}` parameter and a `{name}` beating a `{name+}`. The first two rows
+ *    of AWS's worked example give the literal-beats-parameter part. Comparing
+ *    left to right rather than counting characters is what makes
+ *    `GET /a/b/{c}` beat `GET /a/{b}/ccccc`, which has more literal characters
+ *    and is less specific where it counts. It is also what gives the observed
+ *    rule that the longest literal prefix wins between two greedy routes:
+ *    `GET /pets/dog/{proxy+}` and `GET /pets/{proxy+}` differ at the second
+ *    segment, where one has a literal and the other has taken everything.
+ */
+export class SimHttpApiRouteRank {
+    tier;
+    methodRank;
+    segmentRanks;
+    constructor(properties) {
+        this.tier = properties.tier;
+        this.methodRank = properties.methodRank;
+        this.segmentRanks = properties.segmentRanks;
+    }
+    /**
+     * Compare this rank with another, negative meaning this one is more specific
+     * and therefore wins.
+     */
+    compareTo(other) {
+        if (this.tier !== other.tier) {
+            return this.tier - other.tier;
+        }
+        if (this.methodRank !== other.methodRank) {
+            return this.methodRank - other.methodRank;
+        }
+        return this.compareSegments(other);
+    }
+    compareSegments(other) {
+        const shared = Math.min(this.segmentRanks.length, other.segmentRanks.length);
+        for (let index = 0; index < shared; index++) {
+            const mine = this.segmentRanks.at(index) ?? 0;
+            const theirs = other.segmentRanks.at(index) ?? 0;
+            if (mine !== theirs) {
+                return mine - theirs;
+            }
+        }
+        /* v8 ignore next -- two routes matching one request always differ
+           somewhere in the segments they share: if they did not, they would be the
+           same route key, and the second is refused as a conflict */
+        return 0;
+    }
+}
+//# sourceMappingURL=sim-http-api-route-rank.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-rank.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-rank.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAQlC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,mBAAmB;IACd,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,YAAY,CAAoB;IAEhD,YAAY,UAAyC;QACnD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAA0B;QAClC,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAC5C,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAEO,eAAe,CAAC,KAA0B;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,IAAI,CAAC,YAAY,CAAC,MAAM,EACxB,KAAK,CAAC,YAAY,CAAC,MAAM,CAC1B,CAAC;QAEF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEjD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,OAAO,IAAI,GAAG,MAAM,CAAC;YACvB,CAAC;QACH,CAAC;QAED;;qEAE6D;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+interface SimHttpApiRouteRequestProperties {
+    readonly method: string;
+    readonly segments: readonly string[];
+}
+/**
+ * One request as route selection sees it: the HTTP method, and the path
+ * segments left once the stage has taken its own.
+ *
+ * A named stage is a path segment the routes know nothing about, so
+ * `/dev/pets/6` on stage `dev` reaches route selection as `pets` then `6`.
+ */
+export declare class SimHttpApiRouteRequest {
+    readonly method: string;
+    readonly segments: readonly string[];
+    constructor(properties: SimHttpApiRouteRequestProperties);
+}
+export {};
+//# sourceMappingURL=sim-http-api-route-request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-request.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-request.ts"],"names":[],"mappings":"AAAA,UAAU,gCAAgC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C,YAAY,UAAU,EAAE,gCAAgC,EAGvD;CACF"}

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

@@ -0,0 +1,16 @@
+/**
+ * One request as route selection sees it: the HTTP method, and the path
+ * segments left once the stage has taken its own.
+ *
+ * A named stage is a path segment the routes know nothing about, so
+ * `/dev/pets/6` on stage `dev` reaches route selection as `pets` then `6`.
+ */
+export class SimHttpApiRouteRequest {
+    method;
+    segments;
+    constructor(properties) {
+        this.method = properties.method;
+        this.segments = properties.segments;
+    }
+}
+//# sourceMappingURL=sim-http-api-route-request.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-request.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-request.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IACjB,MAAM,CAAS;IACf,QAAQ,CAAoB;IAE5C,YAAY,UAA4C;QACtD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IACtC,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+/**
+ * The scopes a route asks a token for.
+ *
+ * A route with no scopes asks for nothing beyond a token the authorizer
+ * accepted. A route with scopes is satisfied by any one of them, which is what
+ * AWS documents: the check is any-of, not all-of.
+ */
+export declare class SimHttpApiRouteScopes {
+    readonly values: readonly string[];
+    constructor(values?: readonly string[]);
+    /**
+     * Whether this route asks for no scope in particular.
+     */
+    get isEmpty(): boolean;
+    /**
+     * Whether a token claiming these scopes may have this route.
+     *
+     * A token claiming no scopes at all, which is every Cognito id token, meets
+     * no route scope and is refused by any route that asks for one.
+     */
+    permits(claimed: readonly string[] | null): boolean;
+}
+//# sourceMappingURL=sim-http-api-route-scopes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-scopes.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-scopes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,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/apigatewayv2/api/route/sim-http-api-route-scopes.js

@@ -0,0 +1,35 @@
+/**
+ * The scopes a route asks a token for.
+ *
+ * A route with no scopes asks for nothing beyond a token the authorizer
+ * accepted. A route with scopes is satisfied by any one of them, which is what
+ * AWS documents: the check is any-of, not all-of.
+ */
+export class SimHttpApiRouteScopes {
+    values;
+    constructor(values = []) {
+        this.values = values;
+    }
+    /**
+     * Whether this route asks for no scope in particular.
+     */
+    get isEmpty() {
+        return this.values.length === 0;
+    }
+    /**
+     * Whether a token claiming these scopes may have this route.
+     *
+     * A token claiming no scopes at all, which is every Cognito id token, meets
+     * no route scope and is refused by any route 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-http-api-route-scopes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-scopes.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-scopes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IAChB,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"}

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

@@ -0,0 +1,36 @@
+import type { SimHttpApiPathParameters } from "./path/sim-http-api-path-parameters.js";
+import type { SimHttpApiRouteRequest } from "./sim-http-api-route-request.js";
+import type { SimHttpApiRoute } from "./sim-http-api-route.js";
+interface SimHttpApiRouteSelectionProperties {
+    readonly route: SimHttpApiRoute;
+    readonly pathParameters: SimHttpApiPathParameters;
+}
+/**
+ * One route that matched a request, with what it captured from the path.
+ */
+export declare class SimHttpApiRouteSelection {
+    readonly route: SimHttpApiRoute;
+    readonly pathParameters: SimHttpApiPathParameters;
+    constructor(properties: SimHttpApiRouteSelectionProperties);
+    /**
+     * Whether this route is the more specific of the two, and so the one that
+     * serves the request.
+     */
+    beats(other: SimHttpApiRouteSelection): boolean;
+}
+/**
+ * Picks the route that serves one request.
+ *
+ * Every route is asked whether it matches, and the most specific of the ones
+ * that do wins. There is always one winner: two route keys that would rank the
+ * same for a request are the same route key, and the second of those is
+ * refused as a conflict when it is created.
+ */
+export declare class SimHttpApiRouteSelector {
+    /**
+     * Find the route serving this request, if the API has one.
+     */
+    select(routes: readonly SimHttpApiRoute[], request: SimHttpApiRouteRequest): SimHttpApiRouteSelection | undefined;
+}
+export {};
+//# sourceMappingURL=sim-http-api-route-selector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-selector.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC;CACnD;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,SAAgB,KAAK,EAAE,eAAe,CAAC;IACvC,SAAgB,cAAc,EAAE,wBAAwB,CAAC;IAEzD,YAAY,UAAU,EAAE,kCAAkC,EAGzD;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAE9C;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC;;OAEG;IACH,MAAM,CACJ,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,OAAO,EAAE,sBAAsB,GAC9B,wBAAwB,GAAG,SAAS,CAqBtC;CACF"}

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

@@ -0,0 +1,49 @@
+/**
+ * One route that matched a request, with what it captured from the path.
+ */
+export class SimHttpApiRouteSelection {
+    route;
+    pathParameters;
+    constructor(properties) {
+        this.route = properties.route;
+        this.pathParameters = properties.pathParameters;
+    }
+    /**
+     * Whether this route is the more specific of the two, and so the one that
+     * serves the request.
+     */
+    beats(other) {
+        return this.route.key.rank.compareTo(other.route.key.rank) < 0;
+    }
+}
+/**
+ * Picks the route that serves one request.
+ *
+ * Every route is asked whether it matches, and the most specific of the ones
+ * that do wins. There is always one winner: two route keys that would rank the
+ * same for a request are the same route key, and the second of those is
+ * refused as a conflict when it is created.
+ */
+export class SimHttpApiRouteSelector {
+    /**
+     * Find the route serving this request, if the API has one.
+     */
+    select(routes, request) {
+        let selected;
+        for (const route of routes) {
+            const pathParameters = route.key.match(request);
+            if (pathParameters === undefined) {
+                continue;
+            }
+            const candidate = new SimHttpApiRouteSelection({
+                route,
+                pathParameters,
+            });
+            if (selected === undefined || candidate.beats(selected)) {
+                selected = candidate;
+            }
+        }
+        return selected;
+    }
+}
+//# sourceMappingURL=sim-http-api-route-selector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-selector.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-selector.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,MAAM,OAAO,wBAAwB;IACnB,KAAK,CAAkB;IACvB,cAAc,CAA2B;IAEzD,YAAY,UAA8C;QACxD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAA+B;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IAClC;;OAEG;IACH,MAAM,CACJ,MAAkC,EAClC,OAA+B;QAE/B,IAAI,QAA8C,CAAC;QAEnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,cAAc,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC;gBAC7C,KAAK;gBACL,cAAc;aACf,CAAC,CAAC;YAEH,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxD,QAAQ,GAAG,SAAS,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

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

@@ -0,0 +1,42 @@
+import { type SimHttpApiRoute, type SimHttpApiRouteId } from "./sim-http-api-route.js";
+/**
+ * The routes of one API.
+ *
+ * Routes are keyed by route key signature rather than by id, because the route
+ * key is what makes a route unique on real AWS: an API cannot have two routes
+ * for the same method and path, and the id is only how a route is addressed
+ * afterwards. The signature rather than the text, because a parameter name is
+ * not part of a route's identity, so `GET /pets/{id}` and `GET /pets/{petId}`
+ * are the same route. The ids in use are tracked alongside, so allocating one
+ * can avoid them.
+ */
+export declare class SimHttpApiRouteStore {
+    private readonly routes;
+    private readonly routeIds;
+    /**
+     * Allocate a route id this API is not already using.
+     */
+    allocateId(): SimHttpApiRouteId;
+    /**
+     * Add a route to this API.
+     */
+    add(route: SimHttpApiRoute): void;
+    /**
+     * Find a route by the id the API allocated for it.
+     *
+     * Routes are stored by route key signature rather than by id, so this is a
+     * scan. It is how a route is addressed after creation, which an API has few
+     * enough routes for the scan not to matter.
+     */
+    find(routeId: string): SimHttpApiRoute | undefined;
+    /**
+     * Find the route holding a route key signature, which is what tells whether
+     * the API is already routing a route key.
+     */
+    findBySignature(signature: string): SimHttpApiRoute | undefined;
+    /**
+     * List every route of this API, in the order they were created.
+     */
+    list(): SimHttpApiRoute[];
+}
+//# sourceMappingURL=sim-http-api-route-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-store.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD;;OAEG;IACH,UAAU,IAAI,iBAAiB,CAS9B;IAED;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAGhC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAIjD;IAED;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE9D;IAED;;OAEG;IACH,IAAI,IAAI,eAAe,EAAE,CAExB;CACF"}

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

@@ -0,0 +1,60 @@
+import { makeSimHttpApiRouteId, } from "./sim-http-api-route.js";
+/**
+ * The routes of one API.
+ *
+ * Routes are keyed by route key signature rather than by id, because the route
+ * key is what makes a route unique on real AWS: an API cannot have two routes
+ * for the same method and path, and the id is only how a route is addressed
+ * afterwards. The signature rather than the text, because a parameter name is
+ * not part of a route's identity, so `GET /pets/{id}` and `GET /pets/{petId}`
+ * are the same route. The ids in use are tracked alongside, so allocating one
+ * can avoid them.
+ */
+export class SimHttpApiRouteStore {
+    routes = new Map();
+    routeIds = new Set();
+    /**
+     * Allocate a route id this API is not already using.
+     */
+    allocateId() {
+        let routeId = makeSimHttpApiRouteId();
+        while (this.routeIds.has(routeId)) {
+            /* v8 ignore next -- does not happen in practice */
+            routeId = makeSimHttpApiRouteId();
+        }
+        return routeId;
+    }
+    /**
+     * Add a route to this API.
+     */
+    add(route) {
+        this.routes.set(route.key.signature, route);
+        this.routeIds.add(route.routeId);
+    }
+    /**
+     * Find a route by the id the API allocated for it.
+     *
+     * Routes are stored by route key signature rather than by id, so this is a
+     * scan. It is how a route is addressed after creation, which an API has few
+     * enough routes for the scan not to matter.
+     */
+    find(routeId) {
+        return this.routes
+            .values()
+            .find((route) => route.routeId === routeId);
+    }
+    /**
+     * Find the route holding a route key signature, which is what tells whether
+     * the API is already routing a route key.
+     */
+    findBySignature(signature) {
+        return this.routes.get(signature);
+    }
+    /**
+     * List every route of this API, in the order they were created.
+     */
+    list() {
+        return this.routes.values().toArray();
+    }
+}
+//# sourceMappingURL=sim-http-api-route-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-store.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAGtB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAoB;IACd,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEzD;;OAEG;IACH,UAAU;QACR,IAAI,OAAO,GAAG,qBAAqB,EAAE,CAAC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAClC,mDAAmD;YACnD,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAsB;QACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAe;QAClB,OAAO,IAAI,CAAC,MAAM;aACf,MAAM,EAAE;aACR,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAM,OAA6B,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;CACF"}

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

@@ -0,0 +1,20 @@
+import type { SimHttpApiAuthorizationType, SimHttpApiRoute } from "./sim-http-api-route.js";
+/**
+ * Minimal structural route view, as the Create and Get commands return.
+ *
+ * The two authorization fields are absent on a route that authorizes nobody,
+ * rather than reported as an empty id and an empty list.
+ */
+export interface SimHttpApiRouteView {
+    RouteId: string;
+    RouteKey: string;
+    Target: string;
+    AuthorizationType: SimHttpApiAuthorizationType;
+    AuthorizerId?: string;
+    AuthorizationScopes?: string[];
+}
+/**
+ * Get the AWS-like view of one route.
+ */
+export declare function simHttpApiRouteView(route: SimHttpApiRoute): SimHttpApiRouteView;
+//# sourceMappingURL=sim-http-api-route-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-view.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,2BAA2B,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,GACrB,mBAAmB,CAiBrB"}

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

@@ -0,0 +1,19 @@
+/**
+ * Get the AWS-like view of one route.
+ */
+export function simHttpApiRouteView(route) {
+    const view = {
+        RouteId: route.routeId,
+        RouteKey: route.routeKey,
+        Target: route.target,
+        AuthorizationType: route.authorizationType,
+    };
+    if (route.authorizerId !== undefined) {
+        view.AuthorizerId = route.authorizerId;
+    }
+    if (!route.authorizationScopes.isEmpty) {
+        view.AuthorizationScopes = [...route.authorizationScopes.values];
+    }
+    return view;
+}
+//# sourceMappingURL=sim-http-api-route-view.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route-view.js","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route-view.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAsB;IAEtB,MAAM,IAAI,GAAwB;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;KAC3C,CAAC;IAEF,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;IACzC,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,CAAC,mBAAmB,GAAG,CAAC,GAAG,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,63 @@
+import type { Brand } from "../../../../util/brand.type.js";
+import type { SimHttpApiAuthorizerId } from "../authorizer/sim-http-api-authorizer.js";
+import type { SimHttpApiIntegrationId } from "../integration/sim-http-api-integration.js";
+import type { SimHttpApiRouteKey } from "./key/sim-http-api-route-key.js";
+import { SimHttpApiRouteScopes } from "./sim-http-api-route-scopes.js";
+import { type SimHttpApiRouteView } from "./sim-http-api-route-view.js";
+/**
+ * The id API Gateway allocates for one route.
+ */
+export type SimHttpApiRouteId = Brand<string, "SimHttpApiRouteId">;
+/**
+ * The authorization types a route asks for: none, so anyone may call the
+ * route, a JWT the route's authorizer verifies, a SigV4-signed caller IAM
+ * allows `execute-api:Invoke` on the route being called, or a Lambda
+ * `REQUEST` authorizer that decides for itself.
+ */
+export type SimHttpApiAuthorizationType = "NONE" | "JWT" | "AWS_IAM" | "CUSTOM";
+/**
+ * Allocate a route id, in the same opaque shape as an integration id.
+ */
+export declare function makeSimHttpApiRouteId(): SimHttpApiRouteId;
+interface SimHttpApiRouteProperties {
+    readonly routeId: SimHttpApiRouteId;
+    readonly key: SimHttpApiRouteKey;
+    readonly integrationId: SimHttpApiIntegrationId;
+    readonly authorizationType: SimHttpApiAuthorizationType;
+    readonly authorizerId?: SimHttpApiAuthorizerId | undefined;
+    readonly authorizationScopes?: SimHttpApiRouteScopes | undefined;
+}
+/**
+ * A simulated HTTP API route: which requests reach which integration, and what
+ * a caller has to present to get there.
+ */
+export declare class SimHttpApiRoute {
+    readonly routeId: SimHttpApiRouteId;
+    readonly key: SimHttpApiRouteKey;
+    readonly integrationId: SimHttpApiIntegrationId;
+    readonly authorizationType: SimHttpApiAuthorizationType;
+    /**
+     * The authorizer this route sends requests through, which a `JWT` and a
+     * `CUSTOM` route each have. An `AWS_IAM` route takes no authorizer, since
+     * IAM itself is what decides, and a `NONE` route authorizes nobody.
+     */
+    readonly authorizerId: SimHttpApiAuthorizerId | undefined;
+    readonly authorizationScopes: SimHttpApiRouteScopes;
+    constructor(properties: SimHttpApiRouteProperties);
+    /**
+     * The route key as it was written, which is what the API reports back and
+     * what reaches the handler as `event.routeKey`.
+     */
+    get routeKey(): string;
+    /**
+     * The route's target, in the `integrations/<id>` form the API takes it in
+     * and hands it back.
+     */
+    get target(): string;
+    /**
+     * Get the AWS-like view of this route.
+     */
+    view(): SimHttpApiRouteView;
+}
+export {};
+//# sourceMappingURL=sim-http-api-route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-http-api-route.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigatewayv2/api/route/sim-http-api-route.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAEzD;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAClE;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,SAAgB,OAAO,EAAE,iBAAiB,CAAC;IAC3C,SAAgB,GAAG,EAAE,kBAAkB,CAAC;IACxC,SAAgB,aAAa,EAAE,uBAAuB,CAAC;IACvD,SAAgB,iBAAiB,EAAE,2BAA2B,CAAC;IAE/D;;;;OAIG;IACH,SAAgB,YAAY,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAEjE,SAAgB,mBAAmB,EAAE,qBAAqB,CAAC;IAE3D,YAAY,UAAU,EAAE,yBAAyB,EAQhD;IAED;;;OAGG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,IAAI,mBAAmB,CAE1B;CACF"}