@kensio/yulin 1.17.2 → 1.18.1

package/dist/service/apigateway/openapi/sim-rest-api-openapi-object.js

@@ -0,0 +1,63 @@
+import { simRestApiOpenApiRefusal } from "./sim-rest-api-openapi-refusal.js";
+import { SimRestApiOpenApiValue } from "./sim-rest-api-openapi-value.js";
+/**
+ * One object of the document being imported, and the members under it.
+ *
+ * Members are held as a Map rather than read off the parsed record, so a
+ * document carrying a member called `constructor` or `__proto__` is read as
+ * the data it is.
+ */
+export class SimRestApiOpenApiObject {
+    pointer;
+    members;
+    constructor(properties) {
+        this.pointer = properties.pointer;
+        this.members = properties.members;
+    }
+    /**
+     * The member under a name, whether or not the document carries it.
+     */
+    member(name) {
+        return new SimRestApiOpenApiValue({
+            pointer: this.pointer.child(name),
+            value: this.members.get(name),
+        });
+    }
+    /**
+     * The names this object carries, in the order the document wrote them.
+     */
+    memberNames() {
+        return this.members.keys().toArray();
+    }
+    /**
+     * Whether this object carries a member under a name.
+     */
+    has(name) {
+        return this.members.has(name);
+    }
+    /**
+     * Refuse this object, naming where it is in the document.
+     */
+    refusal(reason) {
+        return simRestApiOpenApiRefusal(this.pointer, reason);
+    }
+    /**
+     * Refuse a member this simulation would ignore rather than apply, with the
+     * reason it is not applied.
+     */
+    refuseMember(name, reason) {
+        if (!this.has(name)) {
+            return;
+        }
+        throw this.member(name).refusal(reason);
+    }
+    /**
+     * Refuse every one of a set of members that share a reason.
+     */
+    refuseMembers(names, reason) {
+        for (const name of names) {
+            this.refuseMember(name, reason);
+        }
+    }
+}
+//# sourceMappingURL=sim-rest-api-openapi-object.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-object.js","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-object.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAOzE;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IAClB,OAAO,CAA2B;IACjC,OAAO,CAAiC;IAEzD,YAAY,UAA6C;QACvD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,sBAAsB,CAAC;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YACjC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,MAAc;QACpB,OAAO,wBAAwB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,IAAY,EAAE,MAAc;QACvC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAwB,EAAE,MAAc;QACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,59 @@
+import type { SimRestApiOpenApiPointer } from "./sim-rest-api-openapi-pointer.js";
+import type { SimRestApiOpenApiValue } from "./sim-rest-api-openapi-value.js";
+interface SimRestApiOpenApiOperationProperties {
+    readonly httpMethod: string;
+    readonly value: SimRestApiOpenApiValue;
+}
+/**
+ * What one operation says about who may call the method it becomes.
+ */
+export interface SimRestApiOpenApiSecurityRequirement {
+    /** The `components.securitySchemes` member the requirement names. */
+    readonly schemeName: string;
+    /** The scopes the method asks the presented token for. */
+    readonly scopes: readonly string[];
+    /** The requirement itself, so a refusal about it names where it is. */
+    readonly value: SimRestApiOpenApiValue;
+}
+/**
+ * One operation of the document being imported: the method it becomes, the
+ * integration behind it, and who may call it.
+ *
+ * `requestBody`, the content schemas under `responses`, `parameters`,
+ * `summary`, `description` and `tags` are all ignored, which is what AWS does
+ * with them where no request validator names them. `operationId` is ignored
+ * too, since it only supplies the `OperationName` a method carries for
+ * documentation.
+ */
+export declare class SimRestApiOpenApiOperation {
+    readonly httpMethod: string;
+    private readonly value;
+    constructor(properties: SimRestApiOpenApiOperationProperties);
+    /**
+     * Where in the document this operation is, for a refusal about the method it
+     * becomes.
+     */
+    pointer(): SimRestApiOpenApiPointer;
+    /**
+     * The integration this method routes to.
+     */
+    integration(): SimRestApiOpenApiValue;
+    /**
+     * The one security requirement this operation carries, if it carries any.
+     *
+     * More than one is refused. One authorizer decides a method, and a second
+     * requirement would be dropped here and refused by AWS.
+     */
+    security(): SimRestApiOpenApiSecurityRequirement | undefined;
+    /**
+     * Whether this operation asks for the method to be decided by IAM, which a
+     * document writes as `x-amazon-apigateway-auth`.
+     */
+    iamAuthorization(): boolean;
+    /**
+     * The scheme and scopes one security requirement names.
+     */
+    private requirement;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-openapi-operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-operation.d.ts","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-operation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAkB9E,UAAU,oCAAoC;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,qBAAa,0BAA0B;IACrC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,UAAU,EAAE,oCAAoC,EAG3D;IAED;;;OAGG;IACH,OAAO,IAAI,wBAAwB,CAElC;IAED;;OAEG;IACH,WAAW,IAAI,sBAAsB,CAkBpC;IAED;;;;;OAKG;IACH,QAAQ,IAAI,oCAAoC,GAAG,SAAS,CAoB3D;IAED;;;OAGG;IACH,gBAAgB,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,OAAO,CAAC,WAAW;CAuBpB"}

package/dist/service/apigateway/openapi/sim-rest-api-openapi-operation.js

@@ -0,0 +1,106 @@
+import { assertDefined } from "../../../util/type-guard/defined.js";
+import { simRestApiOpenApiIamAuthorization } from "./sim-rest-api-openapi-iam-authorization.js";
+/**
+ * The operation members that decide who may call the method and are not read
+ * out of a document.
+ */
+const refusedOperationMembers = [
+    [
+        "x-amazon-apigateway-api-key-source",
+        "API keys and usage plans are not simulated",
+    ],
+    [
+        "x-amazon-apigateway-request-validator",
+        "request validation is not simulated, so a request the document declares " +
+            "as invalid still reaches the handler",
+    ],
+];
+/**
+ * One operation of the document being imported: the method it becomes, the
+ * integration behind it, and who may call it.
+ *
+ * `requestBody`, the content schemas under `responses`, `parameters`,
+ * `summary`, `description` and `tags` are all ignored, which is what AWS does
+ * with them where no request validator names them. `operationId` is ignored
+ * too, since it only supplies the `OperationName` a method carries for
+ * documentation.
+ */
+export class SimRestApiOpenApiOperation {
+    httpMethod;
+    value;
+    constructor(properties) {
+        this.httpMethod = properties.httpMethod;
+        this.value = properties.value;
+    }
+    /**
+     * Where in the document this operation is, for a refusal about the method it
+     * becomes.
+     */
+    pointer() {
+        return this.value.pointer;
+    }
+    /**
+     * The integration this method routes to.
+     */
+    integration() {
+        const operation = this.value.object();
+        for (const [name, reason] of refusedOperationMembers) {
+            operation.refuseMember(name, reason);
+        }
+        const integration = operation.member("x-amazon-apigateway-integration");
+        if (integration.absent()) {
+            throw integration.refusal("is required: an operation with no integration would become a method " +
+                "answering 500, because API Gateway has nothing to send the " +
+                "request to");
+        }
+        return integration;
+    }
+    /**
+     * The one security requirement this operation carries, if it carries any.
+     *
+     * More than one is refused. One authorizer decides a method, and a second
+     * requirement would be dropped here and refused by AWS.
+     */
+    security() {
+        const security = this.value.object().member("security");
+        const requirements = security.optionalArray();
+        if (requirements === undefined || requirements.length === 0) {
+            return undefined;
+        }
+        if (requirements.length > 1) {
+            throw security.refusal(`carries ${String(requirements.length)} security requirements, and a ` +
+                `method is decided by one authorizer, so only the first would be ` +
+                `applied here`);
+        }
+        const [requirement] = requirements;
+        assertDefined(requirement, "the security requirement just counted");
+        return this.requirement(requirement);
+    }
+    /**
+     * Whether this operation asks for the method to be decided by IAM, which a
+     * document writes as `x-amazon-apigateway-auth`.
+     */
+    iamAuthorization() {
+        return simRestApiOpenApiIamAuthorization(this.value.object());
+    }
+    /**
+     * The scheme and scopes one security requirement names.
+     */
+    requirement(value) {
+        const requirement = value.object();
+        const schemeNames = requirement.memberNames();
+        if (schemeNames.length !== 1) {
+            throw requirement.refusal(`names ${String(schemeNames.length)} security schemes, and a method ` +
+                `is decided by one authorizer, so only one scheme can be applied ` +
+                `to it`);
+        }
+        const [schemeName] = schemeNames;
+        assertDefined(schemeName, "the security scheme name just counted");
+        // A member the document carries is never absent, so the scopes are the
+        // list it wrote or a refusal about the shape it wrote instead.
+        const scopes = requirement.member(schemeName).optionalStringList();
+        assertDefined(scopes, `the scopes of the ${schemeName} requirement`);
+        return { schemeName, scopes, value };
+    }
+}
+//# sourceMappingURL=sim-rest-api-openapi-operation.js.map

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

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

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-item.d.ts

@@ -0,0 +1,40 @@
+import type { SimRestApiOpenApiPointer } from "./sim-rest-api-openapi-pointer.js";
+import { SimRestApiOpenApiOperation } from "./sim-rest-api-openapi-operation.js";
+import type { SimRestApiOpenApiValue } from "./sim-rest-api-openapi-value.js";
+interface SimRestApiOpenApiPathItemProperties {
+    readonly path: string;
+    readonly value: SimRestApiOpenApiValue;
+}
+/**
+ * One path of the document being imported, and the operations under it.
+ *
+ * `parameters`, `summary`, `description` and `tags` are skipped with no
+ * effect, which is what AWS does with them without a request validator. A
+ * declared parameter configures validation, and validation is refused at the
+ * root of the document.
+ */
+export declare class SimRestApiOpenApiPathItem {
+    readonly path: string;
+    private readonly value;
+    constructor(properties: SimRestApiOpenApiPathItemProperties);
+    /**
+     * Where in the document this path is, for a refusal about the resources it
+     * becomes.
+     */
+    pointer(): SimRestApiOpenApiPointer;
+    /**
+     * The segments of this path, one resource of the tree each.
+     *
+     * An empty segment is refused rather than dropped. `/pets/` and `/pets` are
+     * two paths of one document and one resource of one API, and dropping the
+     * empty segment would leave the second operation declared on a resource the
+     * first one already holds.
+     */
+    segments(): readonly string[];
+    /**
+     * The operations under this path, one method each.
+     */
+    operations(): readonly SimRestApiOpenApiOperation[];
+}
+export {};
+//# sourceMappingURL=sim-rest-api-openapi-path-item.d.ts.map

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-path-item.d.ts","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-path-item.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AA6C9E,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,qBAAa,yBAAyB;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,UAAU,EAAE,mCAAmC,EAG1D;IAED;;;OAGG;IACH,OAAO,IAAI,wBAAwB,CAElC;IAED;;;;;;;OAOG;IACH,QAAQ,IAAI,SAAS,MAAM,EAAE,CAsB5B;IAED;;OAEG;IACH,UAAU,IAAI,SAAS,0BAA0B,EAAE,CAmBlD;CACF"}

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-item.js

@@ -0,0 +1,110 @@
+import { simRestApiAnyMethod } from "../api/method/sim-rest-api-method.js";
+import { simRestApiRootPath } from "../api/resource/sim-rest-api-resource.js";
+import { SimRestApiOpenApiOperation } from "./sim-rest-api-openapi-operation.js";
+/**
+ * The catch-all operation key, which becomes an `ANY` method.
+ *
+ * API Gateway defines it for REST APIs because OpenAPI itself has no way to
+ * write one operation covering every HTTP method.
+ */
+const anyMethodKey = "x-amazon-apigateway-any-method";
+/**
+ * The operation keys a method is declared for, and the HTTP method each one
+ * becomes.
+ *
+ * These are handled by name rather than by uppercasing whatever a path item
+ * carries, so `parameters` never becomes a method called `PARAMETERS`.
+ */
+const operationKeys = new Map([
+    ["get", "GET"],
+    ["put", "PUT"],
+    ["post", "POST"],
+    ["delete", "DELETE"],
+    ["options", "OPTIONS"],
+    ["head", "HEAD"],
+    ["patch", "PATCH"],
+    [anyMethodKey, simRestApiAnyMethod],
+]);
+/**
+ * The path item members that would change what the API serves and are not
+ * simulated.
+ */
+const refusedPathItemMembers = [
+    [
+        "trace",
+        "a REST API method cannot be declared for TRACE, so a trace operation is " +
+            "refused rather than turned into a method AWS would reject",
+    ],
+    [
+        "$ref",
+        "a path item reference is not resolved. Write the operations under the " +
+            "path itself.",
+    ],
+];
+/**
+ * One path of the document being imported, and the operations under it.
+ *
+ * `parameters`, `summary`, `description` and `tags` are skipped with no
+ * effect, which is what AWS does with them without a request validator. A
+ * declared parameter configures validation, and validation is refused at the
+ * root of the document.
+ */
+export class SimRestApiOpenApiPathItem {
+    path;
+    value;
+    constructor(properties) {
+        this.path = properties.path;
+        this.value = properties.value;
+    }
+    /**
+     * Where in the document this path is, for a refusal about the resources it
+     * becomes.
+     */
+    pointer() {
+        return this.value.pointer;
+    }
+    /**
+     * The segments of this path, one resource of the tree each.
+     *
+     * An empty segment is refused rather than dropped. `/pets/` and `/pets` are
+     * two paths of one document and one resource of one API, and dropping the
+     * empty segment would leave the second operation declared on a resource the
+     * first one already holds.
+     */
+    segments() {
+        if (!this.path.startsWith(simRestApiRootPath)) {
+            throw this.value.refusal(`is '${this.path}', and a path is written from the root of the ` +
+                "API, such as '/pets/{petId}'");
+        }
+        if (this.path === simRestApiRootPath) {
+            return [];
+        }
+        const segments = this.path.split(simRestApiRootPath).slice(1);
+        if (segments.includes("")) {
+            throw this.value.refusal(`is '${this.path}', which has an empty segment. A path carries one ` +
+                `segment between each pair of separators and none at the end.`);
+        }
+        return segments;
+    }
+    /**
+     * The operations under this path, one method each.
+     */
+    operations() {
+        const item = this.value.object();
+        for (const [name, reason] of refusedPathItemMembers) {
+            item.refuseMember(name, reason);
+        }
+        return item.memberNames().flatMap((key) => {
+            const httpMethod = operationKeys.get(key);
+            return httpMethod === undefined
+                ? []
+                : [
+                    new SimRestApiOpenApiOperation({
+                        httpMethod,
+                        value: item.member(key),
+                    }),
+                ];
+        });
+    }
+}
+//# sourceMappingURL=sim-rest-api-openapi-path-item.js.map

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-path-item.js","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-path-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAE9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAGjF;;;;;GAKG;AACH,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,KAAK,EAAE,KAAK,CAAC;IACd,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,YAAY,EAAE,mBAAmB,CAAC;CACpC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,sBAAsB,GAA2C;IACrE;QACE,OAAO;QACP,0EAA0E;YACxE,2DAA2D;KAC9D;IACD;QACE,MAAM;QACN,wEAAwE;YACtE,cAAc;KACjB;CACF,CAAC;AAOF;;;;;;;GAOG;AACH,MAAM,OAAO,yBAAyB;IACpB,IAAI,CAAS;IACZ,KAAK,CAAyB;IAE/C,YAAY,UAA+C;QACzD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtB,OAAO,IAAI,CAAC,IAAI,gDAAgD;gBAC9D,8BAA8B,CACjC,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACrC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE9D,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CACtB,OAAO,IAAI,CAAC,IAAI,oDAAoD;gBAClE,8DAA8D,CACjE,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEjC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,sBAAsB,EAAE,CAAC;YACpD,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACxC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAE1C,OAAO,UAAU,KAAK,SAAS;gBAC7B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,IAAI,0BAA0B,CAAC;wBAC7B,UAAU;wBACV,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxB,CAAC;iBACH,CAAC;QACR,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-tree.d.ts

@@ -0,0 +1,38 @@
+import type { SimRestApiResourceCommands } from "../command/resource/sim-rest-api-resource-commands.js";
+import type { SimRestApiOpenApiCommand } from "./sim-rest-api-openapi-command.js";
+import type { SimRestApiOpenApiPathItem } from "./sim-rest-api-openapi-path-item.js";
+interface SimRestApiOpenApiPathTreeProperties {
+    readonly restApiId: string;
+    readonly rootResourceId: string;
+    readonly resourceCommands: SimRestApiResourceCommands;
+    readonly command: SimRestApiOpenApiCommand;
+}
+/**
+ * Builds the path tree one document declares, one resource per segment.
+ *
+ * A REST API holds a path as a tree of resources rather than as the whole
+ * string, so `/pets` and `/pets/{petId}` share the `pets` node. Each node
+ * created is remembered under its full path, which is what lets the second
+ * path find the first one's node whichever order the document wrote them in.
+ *
+ * This is per-import, because the paths of one document build one tree.
+ */
+export declare class SimRestApiOpenApiPathTree {
+    private readonly restApiId;
+    private readonly rootResourceId;
+    private readonly resourceCommands;
+    private readonly command;
+    private readonly resourceIds;
+    constructor(properties: SimRestApiOpenApiPathTreeProperties);
+    /**
+     * The resource one path is served by, creating the nodes it needs.
+     */
+    resourceIdFor(item: SimRestApiOpenApiPathItem): string;
+    /**
+     * The resource at one path, created under its parent unless this import
+     * already created it for an earlier path.
+     */
+    private node;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-openapi-path-tree.d.ts.map

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-path-tree.d.ts","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-path-tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uDAAuD,CAAC;AACxG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAErF,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;IACtD,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD,YAAY,UAAU,EAAE,mCAAmC,EAK1D;IAED;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAUrD;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI;CAqBb"}

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-tree.js

@@ -0,0 +1,52 @@
+import { simRestApiRootPath } from "../api/resource/sim-rest-api-resource.js";
+/**
+ * Builds the path tree one document declares, one resource per segment.
+ *
+ * A REST API holds a path as a tree of resources rather than as the whole
+ * string, so `/pets` and `/pets/{petId}` share the `pets` node. Each node
+ * created is remembered under its full path, which is what lets the second
+ * path find the first one's node whichever order the document wrote them in.
+ *
+ * This is per-import, because the paths of one document build one tree.
+ */
+export class SimRestApiOpenApiPathTree {
+    restApiId;
+    rootResourceId;
+    resourceCommands;
+    command;
+    resourceIds = new Map();
+    constructor(properties) {
+        this.restApiId = properties.restApiId;
+        this.rootResourceId = properties.rootResourceId;
+        this.resourceCommands = properties.resourceCommands;
+        this.command = properties.command;
+    }
+    /**
+     * The resource one path is served by, creating the nodes it needs.
+     */
+    resourceIdFor(item) {
+        let resourceId = this.rootResourceId;
+        let path = "";
+        for (const segment of item.segments()) {
+            path += `${simRestApiRootPath}${segment}`;
+            resourceId = this.node(item, path, resourceId, segment);
+        }
+        return resourceId;
+    }
+    /**
+     * The resource at one path, created under its parent unless this import
+     * already created it for an earlier path.
+     */
+    node(item, path, parentId, pathPart) {
+        const known = this.resourceIds.get(path);
+        if (known !== undefined) {
+            return known;
+        }
+        const created = this.command.run(item.pointer(), () => this.resourceCommands.createResource({
+            input: { restApiId: this.restApiId, parentId, pathPart },
+        }));
+        this.resourceIds.set(path, created.id);
+        return created.id;
+    }
+}
+//# sourceMappingURL=sim-rest-api-openapi-path-tree.js.map

package/dist/service/apigateway/openapi/sim-rest-api-openapi-path-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-path-tree.js","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-path-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAY9E;;;;;;;;;GASG;AACH,MAAM,OAAO,yBAAyB;IACnB,SAAS,CAAS;IAClB,cAAc,CAAS;IACvB,gBAAgB,CAA6B;IAC7C,OAAO,CAA2B;IAClC,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzD,YAAY,UAA+C;QACzD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;QAChD,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC,gBAAgB,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAA+B;QAC3C,IAAI,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACtC,IAAI,IAAI,GAAG,kBAAkB,GAAG,OAAO,EAAE,CAAC;YAC1C,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACK,IAAI,CACV,IAA+B,EAC/B,IAAY,EACZ,QAAgB,EAChB,QAAgB;QAEhB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,CACpD,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;YACnC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;SACzD,CAAC,CACH,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAEvC,OAAO,OAAO,CAAC,EAAE,CAAC;IACpB,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+import { SimRestApiOpenApiPathItem } from "./sim-rest-api-openapi-path-item.js";
+import type { SimRestApiOpenApiValue } from "./sim-rest-api-openapi-value.js";
+/**
+ * The `paths` map of the document being imported.
+ *
+ * A path is taken verbatim: OpenAPI path templating is already API Gateway's
+ * path parameter syntax, so `/pets/{petId}` needs no translation on its way to
+ * a resource per segment.
+ */
+export declare class SimRestApiOpenApiPaths {
+    private readonly value;
+    constructor(value: SimRestApiOpenApiValue);
+    /**
+     * The path items this document declares, in the order it wrote them.
+     */
+    items(): readonly SimRestApiOpenApiPathItem[];
+}
+//# sourceMappingURL=sim-rest-api-openapi-paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-paths.d.ts","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAE9E;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,YAAY,KAAK,EAAE,sBAAsB,EAExC;IAED;;OAEG;IACH,KAAK,IAAI,SAAS,yBAAyB,EAAE,CAS5C;CACF"}

package/dist/service/apigateway/openapi/sim-rest-api-openapi-paths.js

@@ -0,0 +1,24 @@
+import { SimRestApiOpenApiPathItem } from "./sim-rest-api-openapi-path-item.js";
+/**
+ * The `paths` map of the document being imported.
+ *
+ * A path is taken verbatim: OpenAPI path templating is already API Gateway's
+ * path parameter syntax, so `/pets/{petId}` needs no translation on its way to
+ * a resource per segment.
+ */
+export class SimRestApiOpenApiPaths {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * The path items this document declares, in the order it wrote them.
+     */
+    items() {
+        const paths = this.value.object();
+        return paths
+            .memberNames()
+            .map((path) => new SimRestApiOpenApiPathItem({ path, value: paths.member(path) }));
+    }
+}
+//# sourceMappingURL=sim-rest-api-openapi-paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-paths.js","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAGhF;;;;;;GAMG;AACH,MAAM,OAAO,sBAAsB;IAChB,KAAK,CAAyB;IAE/C,YAAY,KAA6B;QACvC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAElC,OAAO,KAAK;aACT,WAAW,EAAE;aACb,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,yBAAyB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CACrE,CAAC;IACN,CAAC;CACF"}

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

@@ -0,0 +1,29 @@
+/**
+ * An RFC 6901 JSON pointer into the document being imported.
+ *
+ * Every refusal names one, so a reader can find the member in their own
+ * document rather than in a paraphrase of it. Pointers are built up as the
+ * readers descend, so a member inside an operation carries the whole route to
+ * itself:
+ *
+ *   #/paths/~1pets~1{petId}/get/x-amazon-apigateway-integration/uri
+ */
+export declare class SimRestApiOpenApiPointer {
+    private readonly tokens;
+    private constructor();
+    /**
+     * The pointer to the document itself.
+     */
+    static root(): SimRestApiOpenApiPointer;
+    /**
+     * The pointer to a member of whatever this one points at.
+     */
+    child(token: string): SimRestApiOpenApiPointer;
+    /**
+     * The pointer written as RFC 6901 writes it, in the URI fragment form, with
+     * `~` escaped as `~0` and `/` as `~1`. A path template is therefore
+     * `~1pets~1{petId}` rather than the path itself.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=sim-rest-api-openapi-pointer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-pointer.d.ts","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,OAAO,eAEN;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,wBAAwB,CAEtC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAE7C;IAED;;;;OAIG;IACH,QAAQ,IAAI,MAAM,CAEjB;CACF"}

package/dist/service/apigateway/openapi/sim-rest-api-openapi-pointer.js

@@ -0,0 +1,43 @@
+/**
+ * An RFC 6901 JSON pointer into the document being imported.
+ *
+ * Every refusal names one, so a reader can find the member in their own
+ * document rather than in a paraphrase of it. Pointers are built up as the
+ * readers descend, so a member inside an operation carries the whole route to
+ * itself:
+ *
+ *   #/paths/~1pets~1{petId}/get/x-amazon-apigateway-integration/uri
+ */
+export class SimRestApiOpenApiPointer {
+    tokens;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    /**
+     * The pointer to the document itself.
+     */
+    static root() {
+        return new SimRestApiOpenApiPointer([]);
+    }
+    /**
+     * The pointer to a member of whatever this one points at.
+     */
+    child(token) {
+        return new SimRestApiOpenApiPointer([...this.tokens, token]);
+    }
+    /**
+     * The pointer written as RFC 6901 writes it, in the URI fragment form, with
+     * `~` escaped as `~0` and `/` as `~1`. A path template is therefore
+     * `~1pets~1{petId}` rather than the path itself.
+     */
+    toString() {
+        return ["#", ...this.tokens.map((token) => escapeToken(token))].join("/");
+    }
+}
+/**
+ * Escape the two characters RFC 6901 gives a meaning to inside a token.
+ */
+function escapeToken(token) {
+    return token.replaceAll("~", "~0").replaceAll("/", "~1");
+}
+//# sourceMappingURL=sim-rest-api-openapi-pointer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-openapi-pointer.js","sourceRoot":"","sources":["../../../../src/service/apigateway/openapi/sim-rest-api-openapi-pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,OAAO,wBAAwB;IAClB,MAAM,CAAoB;IAE3C,YAAoB,MAAyB;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI;QACT,OAAO,IAAI,wBAAwB,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAa;QACjB,OAAO,IAAI,wBAAwB,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5E,CAAC;CACF;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC"}