@kensio/yulin 1.17.2 → 1.18.0

package/dist/service/apigateway/command/authorizer/sim-rest-api-authorizer-input.js

@@ -0,0 +1,101 @@
+import { SimRestApiIdentitySourceParser } from "../../api/authorizer/identity/sim-rest-api-identity-source-parser.js";
+import { SimRestApiIdentitySources } from "../../api/authorizer/identity/sim-rest-api-identity-sources.js";
+import { SimRestApiCognitoAuthorizer } from "../../api/authorizer/sim-rest-api-cognito-authorizer.js";
+import { SimRestApiLambdaAuthorizer } from "../../api/authorizer/sim-rest-api-lambda-authorizer.js";
+import { SimRestApiUserPoolProviders } from "../../api/authorizer/sim-rest-api-user-pool-providers.js";
+import { SimRestApiLambdaUri } from "../../api/method/sim-rest-api-lambda-uri.js";
+import { SimApiGatewayBadRequest } from "../../error/sim-api-gateway.error.js";
+import { simRestApiAuthorizerResultTtl } from "./sim-rest-api-authorizer-result-ttl.js";
+/**
+ * Reads the inputs an authorizer is created from.
+ *
+ * The identity source is required by real `CreateAuthorizer` for every type,
+ * and an authorizer naming nowhere to look would read nothing on every
+ * request. What decides then differs: a Lambda authorizer requires the
+ * function it asks, and a `COGNITO_USER_POOLS` one requires the pools it
+ * verifies against. Neither has a value worth guessing.
+ */
+export class SimRestApiAuthorizerInput {
+    input;
+    type;
+    constructor(properties) {
+        this.input = properties.input;
+        this.type = properties.type;
+    }
+    /**
+     * The authorizer this input asks for.
+     */
+    read(authorizerId) {
+        const name = this.input.name ?? "";
+        const resultTtlSeconds = simRestApiAuthorizerResultTtl(this.input, this.type);
+        return this.type === "COGNITO_USER_POOLS"
+            ? new SimRestApiCognitoAuthorizer({
+                authorizerId,
+                name,
+                providers: SimRestApiUserPoolProviders.parse(this.providerArns()),
+                identitySource: new SimRestApiIdentitySourceParser().header(this.identitySource(), this.type),
+            })
+            : new SimRestApiLambdaAuthorizer({
+                authorizerId,
+                name,
+                type: this.type,
+                lambdaUri: this.lambdaUri(),
+                identitySources: this.identitySources(),
+                resultTtlSeconds,
+            });
+    }
+    /**
+     * The function a Lambda authorizer invokes.
+     *
+     * An `authorizerUri` is written in the same wrapped form an integration URI
+     * is, so it is read by the same parser and refused for the same reasons.
+     */
+    lambdaUri() {
+        const uri = this.input.authorizerUri;
+        if (uri === undefined || uri.length === 0) {
+            throw new SimApiGatewayBadRequest(`CreateAuthorizer with type ${this.type} requires authorizerUri`);
+        }
+        if (this.input.providerARNs !== undefined) {
+            throw new SimApiGatewayBadRequest(`CreateAuthorizer providerARNs is set on a ${this.type} authorizer, ` +
+                `which decides by invoking its function rather than by verifying a ` +
+                `user pool token`);
+        }
+        return SimRestApiLambdaUri.parse(uri);
+    }
+    /**
+     * The user pools a `COGNITO_USER_POOLS` authorizer accepts tokens from.
+     */
+    providerArns() {
+        if (this.input.authorizerUri !== undefined) {
+            throw new SimApiGatewayBadRequest("CreateAuthorizer authorizerUri is set on a COGNITO_USER_POOLS " +
+                "authorizer, which verifies the token itself and invokes nothing");
+        }
+        return this.input.providerARNs ?? [];
+    }
+    /**
+     * Where a Lambda authorizer looks for what identifies a caller.
+     *
+     * A `TOKEN` authorizer names one header. A `REQUEST` authorizer names as
+     * many headers and query string parameters as it likes, written as one
+     * comma-separated string.
+     */
+    identitySources() {
+        const identitySource = this.identitySource();
+        return this.type === "TOKEN"
+            ? SimRestApiIdentitySources.token(identitySource)
+            : SimRestApiIdentitySources.request(identitySource);
+    }
+    /**
+     * The identity source as it was written, which real `CreateAuthorizer`
+     * requires for every type.
+     */
+    identitySource() {
+        const identitySource = this.input.identitySource;
+        if (identitySource === undefined || identitySource.length === 0) {
+            throw new SimApiGatewayBadRequest(`CreateAuthorizer with type ${this.type} requires identitySource, ` +
+                `such as method.request.header.Authorization`);
+        }
+        return identitySource;
+    }
+}
+//# sourceMappingURL=sim-rest-api-authorizer-input.js.map

package/dist/service/apigateway/command/authorizer/sim-rest-api-authorizer-input.js.map

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

package/dist/service/apigateway/command/authorizer/sim-rest-api-authorizer-result-ttl.d.ts

@@ -0,0 +1,19 @@
+import type { SimRestApiAuthorizerType } from "../../api/authorizer/sim-rest-api-authorizer.js";
+import type { SimCreateAuthorizerCommandInput } from "./authorizer.command.js";
+/**
+ * How long an authorizer's decisions are held for.
+ *
+ * Zero, and saying nothing, both mean no caching, which is what AWS defaults
+ * an authorizer to. AWS accepts a whole number of seconds up to an hour, so
+ * anything else is refused rather than held for a period no deployed
+ * authorizer could be configured with. That includes `NaN`, which no
+ * comparison refuses and which would otherwise hold a decision for ever.
+ *
+ * A `COGNITO_USER_POOLS` authorizer asking for a period is refused. Real API
+ * Gateway holds its decision too, and holding one here would mean a token that
+ * expired during the period was still accepted. Nothing is invoked either way,
+ * so the only thing caching changes for that kind of authorizer is the answer
+ * a test would get.
+ */
+export declare function simRestApiAuthorizerResultTtl(input: SimCreateAuthorizerCommandInput, type: SimRestApiAuthorizerType): number;
+//# sourceMappingURL=sim-rest-api-authorizer-result-ttl.d.ts.map

package/dist/service/apigateway/command/authorizer/sim-rest-api-authorizer-result-ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-authorizer-result-ttl.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/authorizer/sim-rest-api-authorizer-result-ttl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAEhG,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAO/E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,+BAA+B,EACtC,IAAI,EAAE,wBAAwB,GAC7B,MAAM,CAoBR"}

package/dist/service/apigateway/command/authorizer/sim-rest-api-authorizer-result-ttl.js

@@ -0,0 +1,35 @@
+import { SimApiGatewayBadRequest } from "../../error/sim-api-gateway.error.js";
+/**
+ * The longest AWS holds a REST API authorizer's decision for.
+ */
+const maximumResultTtlSeconds = 3600;
+/**
+ * How long an authorizer's decisions are held for.
+ *
+ * Zero, and saying nothing, both mean no caching, which is what AWS defaults
+ * an authorizer to. AWS accepts a whole number of seconds up to an hour, so
+ * anything else is refused rather than held for a period no deployed
+ * authorizer could be configured with. That includes `NaN`, which no
+ * comparison refuses and which would otherwise hold a decision for ever.
+ *
+ * A `COGNITO_USER_POOLS` authorizer asking for a period is refused. Real API
+ * Gateway holds its decision too, and holding one here would mean a token that
+ * expired during the period was still accepted. Nothing is invoked either way,
+ * so the only thing caching changes for that kind of authorizer is the answer
+ * a test would get.
+ */
+export function simRestApiAuthorizerResultTtl(input, type) {
+    const ttl = input.authorizerResultTtlInSeconds ?? 0;
+    if (!Number.isSafeInteger(ttl) || ttl < 0 || ttl > maximumResultTtlSeconds) {
+        throw new SimApiGatewayBadRequest(`CreateAuthorizer authorizerResultTtlInSeconds is ${String(ttl)}: AWS ` +
+            `holds an authorizer's decision for a whole number of seconds ` +
+            `between 0 and ${String(maximumResultTtlSeconds)}`);
+    }
+    if (type === "COGNITO_USER_POOLS" && ttl > 0) {
+        throw new SimApiGatewayBadRequest("CreateAuthorizer authorizerResultTtlInSeconds is set on a " +
+            "COGNITO_USER_POOLS authorizer, which invokes nothing and verifies " +
+            "each token as it arrives: holding that decision is not simulated");
+    }
+    return ttl;
+}
+//# sourceMappingURL=sim-rest-api-authorizer-result-ttl.js.map

package/dist/service/apigateway/command/authorizer/sim-rest-api-authorizer-result-ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-authorizer-result-ttl.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/authorizer/sim-rest-api-authorizer-result-ttl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAG/E;;GAEG;AACH,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAsC,EACtC,IAA8B;IAE9B,MAAM,GAAG,GAAG,KAAK,CAAC,4BAA4B,IAAI,CAAC,CAAC;IAEpD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,uBAAuB,EAAE,CAAC;QAC3E,MAAM,IAAI,uBAAuB,CAC/B,oDAAoD,MAAM,CAAC,GAAG,CAAC,QAAQ;YACrE,+DAA+D;YAC/D,iBAAiB,MAAM,CAAC,uBAAuB,CAAC,EAAE,CACrD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,oBAAoB,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,uBAAuB,CAC/B,4DAA4D;YAC1D,oEAAoE;YACpE,kEAAkE,CACrE,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/service/apigateway/command/deployment/sim-rest-api-deployment-commands.d.ts

@@ -0,0 +1,34 @@
+import type { SimClock } from "../../../../util/clock/sim-clock.js";
+import type { SimApiGatewayRequestOptions } from "../sim-api-gateway-request-options.js";
+import type { SimRestApiAccess } from "../sim-rest-api-access.js";
+import type { SimCreateDeploymentCommand, SimCreateDeploymentCommandOutput } from "../stage/stage.command.js";
+interface SimRestApiDeploymentCommandsProperties {
+    readonly access: SimRestApiAccess;
+    readonly clock: SimClock;
+}
+/**
+ * The commands addressing the deployments of a REST API.
+ */
+export declare class SimRestApiDeploymentCommands {
+    private readonly access;
+    private readonly clock;
+    private readonly publisher;
+    constructor(properties: SimRestApiDeploymentCommandsProperties);
+    /**
+     * Handle a CreateDeployment command.
+     *
+     * A `stageName` publishes the deployment to a new stage of that name, which
+     * is the one-call form. Left out, the deployment is created and nothing
+     * serves it until a stage points at it.
+     */
+    createDeployment(command: SimCreateDeploymentCommand, options?: SimApiGatewayRequestOptions): SimCreateDeploymentCommandOutput;
+    /**
+     * Serve the deployment from the stage the request named, where it named one.
+     *
+     * A stage of that name already there is repointed at this deployment, since
+     * that is what redeploying an API does.
+     */
+    private publishStage;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-deployment-commands.d.ts.map

package/dist/service/apigateway/command/deployment/sim-rest-api-deployment-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-deployment-commands.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/deployment/sim-rest-api-deployment-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAOpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EACV,0BAA0B,EAC1B,gCAAgC,EACjC,MAAM,2BAA2B,CAAC;AAYnC,UAAU,sCAAsC;IAC9C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IAErD,YAAY,UAAU,EAAE,sCAAsC,EAI7D;IAED;;;;;;OAMG;IACH,gBAAgB,CACd,OAAO,EAAE,0BAA0B,EACnC,OAAO,CAAC,EAAE,2BAA2B,GACpC,gCAAgC,CAsBlC;IAED;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAkBrB"}

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

@@ -0,0 +1,70 @@
+import { makeSimRestApiDeploymentId, SimRestApiDeployment, } from "../../api/deployment/sim-rest-api-deployment.js";
+import { SimApiGatewayUnsimulatedInput } from "../sim-api-gateway-unsimulated-input.js";
+import { SimRestApiStagePublisher } from "../stage/sim-rest-api-stage-publisher.js";
+const deploymentsPath = "/deployments";
+const acceptedCreateOptions = [
+    "restApiId",
+    "stageName",
+    "description",
+    "stageDescription",
+    "variables",
+];
+/**
+ * The commands addressing the deployments of a REST API.
+ */
+export class SimRestApiDeploymentCommands {
+    access;
+    clock;
+    publisher;
+    constructor(properties) {
+        this.access = properties.access;
+        this.clock = properties.clock;
+        this.publisher = new SimRestApiStagePublisher({ clock: properties.clock });
+    }
+    /**
+     * Handle a CreateDeployment command.
+     *
+     * A `stageName` publishes the deployment to a new stage of that name, which
+     * is the one-call form. Left out, the deployment is created and nothing
+     * serves it until a stage points at it.
+     */
+    createDeployment(command, options) {
+        const { input } = command;
+        const unsimulated = new SimApiGatewayUnsimulatedInput("CreateDeployment");
+        unsimulated.refuseUnaccepted(input, acceptedCreateOptions);
+        const restApiId = unsimulated.require("restApiId", input.restApiId);
+        const restApi = this.access.api({
+            method: "POST",
+            restApiId,
+            childPath: deploymentsPath,
+            caller: options?.caller,
+        });
+        const deployment = new SimRestApiDeployment({
+            deploymentId: makeSimRestApiDeploymentId(),
+            createdDate: this.clock.now(),
+            description: input.description,
+        });
+        restApi.deployments.add(deployment);
+        this.publishStage(restApi, deployment.deploymentId, input);
+        return { ...deployment.view(), $metadata: {} };
+    }
+    /**
+     * Serve the deployment from the stage the request named, where it named one.
+     *
+     * A stage of that name already there is repointed at this deployment, since
+     * that is what redeploying an API does.
+     */
+    publishStage(restApi, deploymentId, input) {
+        const { stageName } = input;
+        if (stageName === undefined) {
+            return;
+        }
+        this.publisher.deployTo(restApi, {
+            stageName,
+            deploymentId,
+            description: input.stageDescription,
+            variables: input.variables,
+        });
+    }
+}
+//# sourceMappingURL=sim-rest-api-deployment-commands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-deployment-commands.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/deployment/sim-rest-api-deployment-commands.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GAErB,MAAM,iDAAiD,CAAC;AAGzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AAExF,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AAMpF,MAAM,eAAe,GAAG,cAAc,CAAC;AAEvC,MAAM,qBAAqB,GAAG;IAC5B,WAAW;IACX,WAAW;IACX,aAAa;IACb,kBAAkB;IAClB,WAAW;CACZ,CAAC;AAOF;;GAEG;AACH,MAAM,OAAO,4BAA4B;IACtB,MAAM,CAAmB;IACzB,KAAK,CAAW;IAChB,SAAS,CAA2B;IAErD,YAAY,UAAkD;QAC5D,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAwB,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB,CACd,OAAmC,EACnC,OAAqC;QAErC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,6BAA6B,CAAC,kBAAkB,CAAC,CAAC;QAC1E,WAAW,CAAC,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAEpE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YAC9B,MAAM,EAAE,MAAM;YACd,SAAS;YACT,SAAS,EAAE,eAAe;YAC1B,MAAM,EAAE,OAAO,EAAE,MAAM;SACxB,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,IAAI,oBAAoB,CAAC;YAC1C,YAAY,EAAE,0BAA0B,EAAE;YAC1C,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAC;QACH,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAE3D,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAClB,OAAmB,EACnB,YAAoC,EACpC,KAA0C;QAE1C,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;QAE5B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE;YAC/B,SAAS;YACT,YAAY;YACZ,WAAW,EAAE,KAAK,CAAC,gBAAgB;YACnC,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,32 @@
+import type { SimApiGatewayRequestOptions } from "../sim-api-gateway-request-options.js";
+import type { SimRestApiAccess } from "../sim-rest-api-access.js";
+import type { SimGetIntegrationCommand, SimGetIntegrationCommandOutput, SimPutIntegrationCommand, SimPutIntegrationCommandOutput } from "../method/method.command.js";
+interface SimRestApiIntegrationCommandsProperties {
+    readonly access: SimRestApiAccess;
+}
+/**
+ * The commands addressing what a REST API method does with a request.
+ *
+ * A REST API integration is part of its method rather than a resource of its
+ * own, so these address the same API, resource and HTTP method the method
+ * commands do.
+ */
+export declare class SimRestApiIntegrationCommands {
+    private readonly address;
+    private readonly rules;
+    constructor(properties: SimRestApiIntegrationCommandsProperties);
+    /**
+     * Handle a PutIntegration command.
+     *
+     * The method has to be declared first, as it does on real AWS. An
+     * integration behind no method would be unreachable, because a request is
+     * matched to a method before anything looks at what is behind it.
+     */
+    putIntegration(command: SimPutIntegrationCommand, options?: SimApiGatewayRequestOptions): SimPutIntegrationCommandOutput;
+    /**
+     * Handle a GetIntegration command.
+     */
+    getIntegration(command: SimGetIntegrationCommand, options?: SimApiGatewayRequestOptions): SimGetIntegrationCommandOutput;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-integration-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-integration-commands.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/integration/sim-rest-api-integration-commands.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,8BAA8B,EAC9B,wBAAwB,EACxB,8BAA8B,EAC/B,MAAM,6BAA6B,CAAC;AAoBrC,UAAU,uCAAuC;IAC/C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;;GAMG;AACH,qBAAa,6BAA6B;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IAErD,YAAY,UAAU,EAAE,uCAAuC,EAE9D;IAED;;;;;;OAMG;IACH,cAAc,CACZ,OAAO,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,2BAA2B,GACpC,8BAA8B,CAiChC;IAED;;OAEG;IACH,cAAc,CACZ,OAAO,EAAE,wBAAwB,EACjC,OAAO,CAAC,EAAE,2BAA2B,GACpC,8BAA8B,CAWhC;CACF"}

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

@@ -0,0 +1,63 @@
+import { SimRestApiIntegration, simRestApiLambdaIntegrationHttpMethod, } from "../../api/method/sim-rest-api-integration.js";
+import { SimRestApiLambdaUri } from "../../api/method/sim-rest-api-lambda-uri.js";
+import { SimRestApiMethodAddress, simRestApiMethodOptions, } from "../method/sim-rest-api-method-address.js";
+import { SimRestApiMethodRules } from "../method/sim-rest-api-method-rules.js";
+import { SimApiGatewayUnsimulatedInput } from "../sim-api-gateway-unsimulated-input.js";
+const simulatedIntegrationType = "AWS_PROXY";
+const acceptedPutOptions = [
+    ...simRestApiMethodOptions,
+    "type",
+    "integrationHttpMethod",
+    "uri",
+];
+const integrationTypeRefusal = "only a Lambda proxy integration is simulated, and a MOCK, HTTP, " +
+    "HTTP_PROXY or non-proxy AWS integration answers a request from somewhere " +
+    "this cannot reach";
+const integrationMethodRefusal = "API Gateway always calls a Lambda integration with POST, whatever method " +
+    "the client used";
+/**
+ * The commands addressing what a REST API method does with a request.
+ *
+ * A REST API integration is part of its method rather than a resource of its
+ * own, so these address the same API, resource and HTTP method the method
+ * commands do.
+ */
+export class SimRestApiIntegrationCommands {
+    address;
+    rules = new SimRestApiMethodRules();
+    constructor(properties) {
+        this.address = new SimRestApiMethodAddress({ access: properties.access });
+    }
+    /**
+     * Handle a PutIntegration command.
+     *
+     * The method has to be declared first, as it does on real AWS. An
+     * integration behind no method would be unreachable, because a request is
+     * matched to a method before anything looks at what is behind it.
+     */
+    putIntegration(command, options) {
+        const { input } = command;
+        const unsimulated = new SimApiGatewayUnsimulatedInput("PutIntegration");
+        unsimulated.refuseUnaccepted(input, acceptedPutOptions);
+        unsimulated.refuseUnless("type", input.type, simulatedIntegrationType, integrationTypeRefusal);
+        unsimulated.refuseUnless("integrationHttpMethod", input.integrationHttpMethod, simRestApiLambdaIntegrationHttpMethod, integrationMethodRefusal);
+        const uri = SimRestApiLambdaUri.parse(unsimulated.require("uri", input.uri));
+        const { method } = this.address.declared("PUT", "PutIntegration", input, options);
+        method.integration = new SimRestApiIntegration({
+            integrationType: simulatedIntegrationType,
+            lambdaUri: uri,
+            integrationHttpMethod: simRestApiLambdaIntegrationHttpMethod,
+        });
+        return { ...method.integration.view(), $metadata: {} };
+    }
+    /**
+     * Handle a GetIntegration command.
+     */
+    getIntegration(command, options) {
+        const unsimulated = new SimApiGatewayUnsimulatedInput("GetIntegration");
+        unsimulated.refuseUnaccepted(command.input, simRestApiMethodOptions);
+        const { method } = this.address.declared("GET", "GetIntegration", command.input, options);
+        return { ...this.rules.requireIntegration(method).view(), $metadata: {} };
+    }
+}
+//# sourceMappingURL=sim-rest-api-integration-commands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-integration-commands.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/integration/sim-rest-api-integration-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qCAAqC,GACtC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EACL,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AASxF,MAAM,wBAAwB,GAAG,WAAW,CAAC;AAE7C,MAAM,kBAAkB,GAAG;IACzB,GAAG,uBAAuB;IAC1B,MAAM;IACN,uBAAuB;IACvB,KAAK;CACN,CAAC;AAEF,MAAM,sBAAsB,GAC1B,kEAAkE;IAClE,2EAA2E;IAC3E,mBAAmB,CAAC;AAEtB,MAAM,wBAAwB,GAC5B,2EAA2E;IAC3E,iBAAiB,CAAC;AAMpB;;;;;;GAMG;AACH,MAAM,OAAO,6BAA6B;IACvB,OAAO,CAA0B;IACjC,KAAK,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAErD,YAAY,UAAmD;QAC7D,IAAI,CAAC,OAAO,GAAG,IAAI,uBAAuB,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CACZ,OAAiC,EACjC,OAAqC;QAErC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,WAAW,GAAG,IAAI,6BAA6B,CAAC,gBAAgB,CAAC,CAAC;QACxE,WAAW,CAAC,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;QACxD,WAAW,CAAC,YAAY,CACtB,MAAM,EACN,KAAK,CAAC,IAAI,EACV,wBAAwB,EACxB,sBAAsB,CACvB,CAAC;QACF,WAAW,CAAC,YAAY,CACtB,uBAAuB,EACvB,KAAK,CAAC,qBAAqB,EAC3B,qCAAqC,EACrC,wBAAwB,CACzB,CAAC;QACF,MAAM,GAAG,GAAG,mBAAmB,CAAC,KAAK,CACnC,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CACtC,CAAC;QAEF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CACtC,KAAK,EACL,gBAAgB,EAChB,KAAK,EACL,OAAO,CACR,CAAC;QACF,MAAM,CAAC,WAAW,GAAG,IAAI,qBAAqB,CAAC;YAC7C,eAAe,EAAE,wBAAwB;YACzC,SAAS,EAAE,GAAG;YACd,qBAAqB,EAAE,qCAAqC;SAC7D,CAAC,CAAC;QAEH,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,OAAiC,EACjC,OAAqC;QAErC,MAAM,WAAW,GAAG,IAAI,6BAA6B,CAAC,gBAAgB,CAAC,CAAC;QACxE,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;QACrE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CACtC,KAAK,EACL,gBAAgB,EAChB,OAAO,CAAC,KAAK,EACb,OAAO,CACR,CAAC;QAEF,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC5E,CAAC;CACF"}

package/dist/service/apigateway/command/method/method.command.d.ts

@@ -0,0 +1,92 @@
+import type { SimResponseMetadata } from "../../../aws/metadata/response-metadata.type.js";
+import type { SimRestApiIntegrationView } from "../../api/method/sim-rest-api-integration.js";
+import type { SimRestApiMethodView } from "../../api/method/sim-rest-api-method.js";
+/**
+ * Minimal structural sim API Gateway PutMethod command.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/api-gateway/command/PutMethodCommand/
+ */
+export interface SimPutMethodCommand {
+    readonly input: SimPutMethodCommandInput;
+}
+export interface SimPutMethodCommandInput {
+    readonly restApiId?: string | undefined;
+    readonly resourceId?: string | undefined;
+    readonly httpMethod?: string | undefined;
+    readonly authorizationType?: string | undefined;
+    readonly authorizerId?: string | undefined;
+    readonly authorizationScopes?: readonly string[] | undefined;
+    readonly apiKeyRequired?: boolean | undefined;
+    readonly operationName?: string | undefined;
+}
+export interface SimPutMethodCommandOutput extends SimRestApiMethodView {
+    readonly $metadata: SimResponseMetadata;
+}
+/**
+ * Minimal structural sim API Gateway GetMethod command.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/api-gateway/command/GetMethodCommand/
+ */
+export interface SimGetMethodCommand {
+    readonly input: SimGetMethodCommandInput;
+}
+export interface SimGetMethodCommandInput {
+    readonly restApiId?: string | undefined;
+    readonly resourceId?: string | undefined;
+    readonly httpMethod?: string | undefined;
+}
+export interface SimGetMethodCommandOutput extends SimRestApiMethodView {
+    readonly $metadata: SimResponseMetadata;
+}
+/**
+ * Minimal structural sim API Gateway DeleteMethod command.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/api-gateway/command/DeleteMethodCommand/
+ */
+export interface SimDeleteMethodCommand {
+    readonly input: SimDeleteMethodCommandInput;
+}
+export interface SimDeleteMethodCommandInput {
+    readonly restApiId?: string | undefined;
+    readonly resourceId?: string | undefined;
+    readonly httpMethod?: string | undefined;
+}
+export interface SimDeleteMethodCommandOutput {
+    readonly $metadata: SimResponseMetadata;
+}
+/**
+ * Minimal structural sim API Gateway PutIntegration command.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/api-gateway/command/PutIntegrationCommand/
+ */
+export interface SimPutIntegrationCommand {
+    readonly input: SimPutIntegrationCommandInput;
+}
+export interface SimPutIntegrationCommandInput {
+    readonly restApiId?: string | undefined;
+    readonly resourceId?: string | undefined;
+    readonly httpMethod?: string | undefined;
+    readonly type?: string | undefined;
+    readonly integrationHttpMethod?: string | undefined;
+    readonly uri?: string | undefined;
+}
+export interface SimPutIntegrationCommandOutput extends SimRestApiIntegrationView {
+    readonly $metadata: SimResponseMetadata;
+}
+/**
+ * Minimal structural sim API Gateway GetIntegration command.
+ *
+ * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/api-gateway/command/GetIntegrationCommand/
+ */
+export interface SimGetIntegrationCommand {
+    readonly input: SimGetIntegrationCommandInput;
+}
+export interface SimGetIntegrationCommandInput {
+    readonly restApiId?: string | undefined;
+    readonly resourceId?: string | undefined;
+    readonly httpMethod?: string | undefined;
+}
+export interface SimGetIntegrationCommandOutput extends SimRestApiIntegrationView {
+    readonly $metadata: SimResponseMetadata;
+}
+//# sourceMappingURL=method.command.d.ts.map

package/dist/service/apigateway/command/method/method.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.command.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/method/method.command.ts"],"names":[],"mappings":"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"}

package/dist/service/apigateway/command/method/method.command.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=method.command.js.map

package/dist/service/apigateway/command/method/method.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.command.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/method/method.command.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,9 @@
+/**
+ * Read the HTTP method a command declares or addresses.
+ *
+ * Real API Gateway takes the method uppercased, and refuses one it does not
+ * recognise. Accepting a lowercase spelling here would leave a method nothing
+ * routes to, since a served request is matched against the uppercase form.
+ */
+export declare function simRestApiHttpMethodOf(operation: string, httpMethod: string): string;
+//# sourceMappingURL=sim-rest-api-http-method.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-http-method.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/method/sim-rest-api-http-method.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CASR"}

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

@@ -0,0 +1,31 @@
+import { SimApiGatewayBadRequest } from "../../error/sim-api-gateway.error.js";
+import { simRestApiAnyMethod } from "../../api/method/sim-rest-api-method.js";
+/**
+ * The HTTP methods a REST API method can be declared for, plus `ANY`, which
+ * covers every method the resource declares no method of its own for.
+ */
+const declarableMethods = [
+    "GET",
+    "POST",
+    "PUT",
+    "PATCH",
+    "DELETE",
+    "HEAD",
+    "OPTIONS",
+    simRestApiAnyMethod,
+];
+/**
+ * Read the HTTP method a command declares or addresses.
+ *
+ * Real API Gateway takes the method uppercased, and refuses one it does not
+ * recognise. Accepting a lowercase spelling here would leave a method nothing
+ * routes to, since a served request is matched against the uppercase form.
+ */
+export function simRestApiHttpMethodOf(operation, httpMethod) {
+    if (declarableMethods.includes(httpMethod)) {
+        return httpMethod;
+    }
+    throw new SimApiGatewayBadRequest(`${operation} httpMethod '${httpMethod}' is invalid. It must be one of ` +
+        `${declarableMethods.join(", ")}.`);
+}
+//# sourceMappingURL=sim-rest-api-http-method.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-http-method.js","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/method/sim-rest-api-http-method.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E;;;GAGG;AACH,MAAM,iBAAiB,GAAG;IACxB,KAAK;IACL,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;IACT,mBAAmB;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,UAAkB;IAElB,IAAI,iBAAiB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,IAAI,uBAAuB,CAC/B,GAAG,SAAS,gBAAgB,UAAU,kCAAkC;QACtE,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,58 @@
+import type { SimRestApiMethod } from "../../api/method/sim-rest-api-method.js";
+import type { SimRestApiResource } from "../../api/resource/sim-rest-api-resource.js";
+import type { SimRestApi } from "../../api/sim-rest-api.js";
+import type { SimApiGatewayRequestOptions } from "../sim-api-gateway-request-options.js";
+import type { SimRestApiAccess } from "../sim-rest-api-access.js";
+/**
+ * The three inputs every command addressing one method takes.
+ */
+export declare const simRestApiMethodOptions: string[];
+/**
+ * What a command names when it addresses one method.
+ */
+export interface SimRestApiMethodAddressInput {
+    readonly restApiId?: string | undefined;
+    readonly resourceId?: string | undefined;
+    readonly httpMethod?: string | undefined;
+}
+/**
+ * The resource and HTTP method a command addressed.
+ */
+export interface SimRestApiMethodTarget {
+    readonly restApi: SimRestApi;
+    readonly resource: SimRestApiResource;
+    readonly httpMethod: string;
+}
+/**
+ * A target whose method is declared, which is what every command other than
+ * `PutMethod` needs.
+ */
+export interface SimRestApiDeclaredMethod extends SimRestApiMethodTarget {
+    readonly method: SimRestApiMethod;
+}
+interface SimRestApiMethodAddressProperties {
+    readonly access: SimRestApiAccess;
+}
+/**
+ * Resolves the resource and HTTP method a command addresses.
+ *
+ * The method commands and the integration commands address a method the same
+ * way, by API, resource id and HTTP method, so both reach it through here.
+ */
+export declare class SimRestApiMethodAddress {
+    private readonly access;
+    private readonly rules;
+    constructor(properties: SimRestApiMethodAddressProperties);
+    /**
+     * The resource and HTTP method a command addresses, once the caller is
+     * allowed to address them. The method itself need not be declared yet, which
+     * is the case `PutMethod` is in.
+     */
+    target(accessMethod: "GET" | "PUT" | "DELETE", operation: string, input: SimRestApiMethodAddressInput, options?: SimApiGatewayRequestOptions): SimRestApiMethodTarget;
+    /**
+     * The method a command addresses, refusing one that is not declared.
+     */
+    declared(accessMethod: "GET" | "PUT" | "DELETE", operation: string, input: SimRestApiMethodAddressInput, options?: SimApiGatewayRequestOptions): SimRestApiDeclaredMethod;
+}
+export {};
+//# sourceMappingURL=sim-rest-api-method-address.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-rest-api-method-address.d.ts","sourceRoot":"","sources":["../../../../../src/service/apigateway/command/method/sim-rest-api-method-address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAIlE;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAInC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,UAAU,iCAAiC;IACzC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IAErD,YAAY,UAAU,EAAE,iCAAiC,EAExD;IAED;;;;OAIG;IACH,MAAM,CACJ,YAAY,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,EACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B,EACnC,OAAO,CAAC,EAAE,2BAA2B,GACpC,sBAAsB,CAqBxB;IAED;;OAEG;IACH,QAAQ,CACN,YAAY,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,EACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,4BAA4B,EACnC,OAAO,CAAC,EAAE,2BAA2B,GACpC,wBAAwB,CAO1B;CACF"}