@kensio/yulin 1.12.1 → 1.14.0

package/dist/service/ecs/sim-ecs.js

@@ -0,0 +1,205 @@
+import { SimEcsCfnResourceFactory } from "./cfn/sim-ecs-cfn-resource-factory.js";
+import { SimEcsSdkCommandRouter } from "./sdk/sim-ecs-sdk-command-router.js";
+import { SimEcsCommands } from "./sim-ecs-commands.js";
+/**
+ * Simulated ECS. Handles SDK commands. Emulates AWS behaviour and state.
+ *
+ * Clusters, task definitions and services are scoped to an account and region,
+ * as they are on real AWS: their ARNs name the region, and a cluster name is
+ * unique within one account and region rather than globally.
+ *
+ * A task runs the handlers bound to the containers its task definition
+ * declares. Nothing else runs: Yulin never looks inside a container image, so
+ * a container with no binding is recorded as not simulated rather than
+ * failing anything.
+ */
+export class SimEcs {
+    commands;
+    sdkRouter = new SimEcsSdkCommandRouter(this);
+    constructor(properties = {}) {
+        this.commands = new SimEcsCommands({
+            ...properties,
+            runAsOwner: properties.runAsOwner ?? this,
+        });
+    }
+    /**
+     * Handle a CreateCluster Command from the SDK.
+     */
+    async createCluster(command, options) {
+        return await this.commands.createCluster.handle(command, options);
+    }
+    /**
+     * Handle a DescribeClusters Command from the SDK.
+     */
+    async describeClusters(command, options) {
+        return await this.commands.describeClusters.handle(command, options);
+    }
+    /**
+     * Handle a DeleteCluster Command from the SDK.
+     */
+    async deleteCluster(command, options) {
+        return await this.commands.deleteCluster.handle(command, options);
+    }
+    /**
+     * Handle a ListClusters Command from the SDK.
+     */
+    async listClusters(command, options) {
+        return await this.commands.listClusters.handle(command, options);
+    }
+    /**
+     * Handle a RegisterTaskDefinition Command from the SDK.
+     */
+    async registerTaskDefinition(command, options) {
+        return await this.commands.registerTaskDefinition.handle(command, options);
+    }
+    /**
+     * Handle a DeregisterTaskDefinition Command from the SDK.
+     */
+    async deregisterTaskDefinition(command, options) {
+        return await this.commands.deregisterTaskDefinition.handle(command, options);
+    }
+    /**
+     * Handle a DescribeTaskDefinition Command from the SDK.
+     */
+    async describeTaskDefinition(command, options) {
+        return await this.commands.describeTaskDefinition.handle(command, options);
+    }
+    /**
+     * Handle a ListTaskDefinitions Command from the SDK.
+     */
+    async listTaskDefinitions(command, options) {
+        return await this.commands.listTaskDefinitions.handle(command, options);
+    }
+    /**
+     * Handle a ListTaskDefinitionFamilies Command from the SDK.
+     */
+    async listTaskDefinitionFamilies(command, options) {
+        return await this.commands.listTaskDefinitionFamilies.handle(command, options);
+    }
+    /**
+     * Handle a RunTask Command from the SDK.
+     */
+    async runTask(command, options) {
+        return await this.commands.runTask.handle(command, options);
+    }
+    /**
+     * Handle a DescribeTasks Command from the SDK.
+     */
+    async describeTasks(command, options) {
+        return await this.commands.describeTasks.handle(command, options);
+    }
+    /**
+     * Handle a ListTasks Command from the SDK.
+     */
+    async listTasks(command, options) {
+        return await this.commands.listTasks.handle(command, options);
+    }
+    /**
+     * Handle a StopTask Command from the SDK.
+     */
+    async stopTask(command, options) {
+        return await this.commands.stopTask.handle(command, options);
+    }
+    /**
+     * Handle a CreateService Command from the SDK.
+     */
+    async createService(command, options) {
+        return await this.commands.createService.handle(command, options);
+    }
+    /**
+     * Handle an UpdateService Command from the SDK.
+     */
+    async updateService(command, options) {
+        return await this.commands.updateService.handle(command, options);
+    }
+    /**
+     * Handle a DescribeServices Command from the SDK.
+     */
+    async describeServices(command, options) {
+        return await this.commands.describeServices.handle(command, options);
+    }
+    /**
+     * Handle a DeleteService Command from the SDK.
+     */
+    async deleteService(command, options) {
+        return await this.commands.deleteService.handle(command, options);
+    }
+    /**
+     * Stop everything the services in this scope are keeping running.
+     *
+     * A service is the one thing simulated ECS keeps running rather than runs and
+     * finishes, so this is what a simulated environment being finished with comes
+     * down to: every service's tasks stop, leaving the target groups they were
+     * registered into, and nothing is left scheduled, while the services stay
+     * describable with the desired count they had.
+     */
+    close() {
+        this.commands.closeServices();
+    }
+    /**
+     * Bind a real in-process handler to a container a task definition declares.
+     *
+     * The container is named either by its family and container name or by the
+     * repository its image comes from, as `SimEcsContainerBinding` shows. A task
+     * run from that definition runs the bound handler in this process, with the
+     * container's environment variables and the task Role.
+     *
+     * A container that consumes a queue declares `consumes` instead of `run`,
+     * with a `queueUrl` and a `handler` for a batch of messages: Yulin drives the
+     * polling loop and the binding supplies its body. One behind a load balancer
+     * declares `http` instead, and its handler answers each request routed to it.
+     * Both are called as the task Role while a service is running the container.
+     *
+     * Bindings belong to the Account and Region they were made in, as the task
+     * definitions they target do, and can be made before or after the task
+     * definition is registered.
+     */
+    bindContainer(binding) {
+        this.commands.bindings.add(binding);
+    }
+    /**
+     * The cluster of this name, whether it is active or deleted.
+     *
+     * A lookup rather than an operation, for a test or a CloudFormation Resource
+     * that needs the thing itself. An identifier nothing holds is refused, here
+     * and in the two lookups below, since the caller asked for the thing rather
+     * than for whether there is one.
+     */
+    cluster(clusterName) {
+        return this.commands.lookup.cluster(clusterName);
+    }
+    /**
+     * The task definition revision a family, `family:revision` or ARN names. A
+     * family on its own means its latest active revision, as it does elsewhere.
+     */
+    taskDefinition(identifier) {
+        return this.commands.lookup.taskDefinition(identifier);
+    }
+    /**
+     * The service a name in a cluster, or a full service ARN, names, active or
+     * deleted. A name given without a cluster is looked for in the `default` one.
+     */
+    service(identifier, clusterName) {
+        return this.commands.lookup.service(identifier, clusterName);
+    }
+    /**
+     * The container of a running service that answers for a target group.
+     *
+     * This is how a request routed to a target group reaches the handler bound to
+     * a service's container. It answers with nothing where nothing can serve the
+     * request: no active service registered into the group, or one whose
+     * containers are none of them bound to an HTTP handler.
+     */
+    servingContainer(targetGroupArn) {
+        return this.commands.servingContainer(targetGroupArn);
+    }
+    /** Get this service's CloudFormation Resource factory. */
+    cfnResourceFactory() {
+        return new SimEcsCfnResourceFactory({ ecs: this });
+    }
+    /** Get this service's SDK Command router for SDK client interception. */
+    sdkCommandRouter() {
+        return this.sdkRouter;
+    }
+}
+//# sourceMappingURL=sim-ecs.js.map

package/dist/service/ecs/sim-ecs.js.map

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

package/dist/service/ecs/target/sim-ecs-target-overrides.d.ts

@@ -0,0 +1,16 @@
+import type { SimEcsTaskOverrideType } from "../task/run/sim-ecs-task-overrides.js";
+/**
+ * Read a target's fixed `Input` as the overrides the task runs with.
+ *
+ * A target that runs a task has nowhere else to say what the container should
+ * read, so its `Input` is the task's overrides rather than a payload handed to
+ * anything. That is what an EventBridge rule does on real AWS, and it is what
+ * the CDK writes when a target is given container overrides. Simulated
+ * Scheduler reads its target the same way, so one thing is true of both.
+ *
+ * A target with no `Input` runs the task with no overrides. The event a rule
+ * matched is deliberately not passed on in its place: a task's overrides are
+ * not an event envelope, and handing one over would refuse every delivery.
+ */
+export declare function simEcsTargetOverrides(input: string | undefined, refuse: (reason: string) => Error): SimEcsTaskOverrideType | undefined;
+//# sourceMappingURL=sim-ecs-target-overrides.d.ts.map

package/dist/service/ecs/target/sim-ecs-target-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-overrides.d.ts","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-overrides.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,GAChC,sBAAsB,GAAG,SAAS,CAepC"}

package/dist/service/ecs/target/sim-ecs-target-overrides.js

@@ -0,0 +1,38 @@
+import { isRecord } from "../../../util/type-guard/record.js";
+/**
+ * Read a target's fixed `Input` as the overrides the task runs with.
+ *
+ * A target that runs a task has nowhere else to say what the container should
+ * read, so its `Input` is the task's overrides rather than a payload handed to
+ * anything. That is what an EventBridge rule does on real AWS, and it is what
+ * the CDK writes when a target is given container overrides. Simulated
+ * Scheduler reads its target the same way, so one thing is true of both.
+ *
+ * A target with no `Input` runs the task with no overrides. The event a rule
+ * matched is deliberately not passed on in its place: a task's overrides are
+ * not an event envelope, and handing one over would refuse every delivery.
+ */
+export function simEcsTargetOverrides(input, refuse) {
+    if (input === undefined || input === "") {
+        return undefined;
+    }
+    const document = parsed(input, refuse);
+    if (!isRecord(document)) {
+        throw refuse("Target Input names the overrides an ECS task runs with, so it is a " +
+            "JSON object with taskRoleArn or containerOverrides on it");
+    }
+    return document;
+}
+/**
+ * Read the `Input` text as JSON, saying so where it is not.
+ */
+function parsed(input, refuse) {
+    try {
+        return JSON.parse(input);
+    }
+    catch {
+        throw refuse("Target Input names the overrides an ECS task runs with, and this one " +
+            "is not JSON");
+    }
+}
+//# sourceMappingURL=sim-ecs-target-overrides.js.map

package/dist/service/ecs/target/sim-ecs-target-overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-overrides.js","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAG9D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAyB,EACzB,MAAiC;IAEjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAY,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,CACV,qEAAqE;YACnE,0DAA0D,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,MAAM,CAAC,KAAa,EAAE,MAAiC;IAC9D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,CACV,uEAAuE;YACrE,aAAa,CAChB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/service/ecs/target/sim-ecs-target-parameters.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Minimal structural `EcsParameters`, as an EventBridge rule target and a
+ * Scheduler schedule target both carry it.
+ *
+ * The two services name these the same things and mean the same things by
+ * them, so one shape serves both.
+ *
+ * https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_EcsParameters.html
+ */
+export interface SimEcsTargetParametersType {
+    readonly TaskDefinitionArn?: string | undefined;
+    readonly TaskCount?: number | undefined;
+    readonly LaunchType?: string | undefined;
+    readonly PlatformVersion?: string | undefined;
+    readonly NetworkConfiguration?: unknown;
+    readonly CapacityProviderStrategy?: unknown;
+}
+/**
+ * The `EcsParameters` one target carries.
+ *
+ * Reading them is the same job for both services, and the refusals are the
+ * same refusals, so the only thing either service supplies is the error to
+ * raise. That keeps a message reading as EventBridge's or Scheduler's own
+ * while there is one answer to what a target may ask for.
+ */
+export declare class SimEcsTargetParameters {
+    readonly taskDefinitionArn: string;
+    readonly taskCount: number;
+    /**
+     * The parameters as the request wrote them, for reporting them back.
+     */
+    readonly declared: SimEcsTargetParametersType;
+    private constructor();
+    /**
+     * Read the parameters a target carries, refusing what cannot be run.
+     *
+     * A target naming an ECS cluster and no task definition names nothing to
+     * run, so it is refused where it was written rather than at the first
+     * delivery.
+     */
+    static of(parameters: unknown, refuse: (reason: string) => Error): SimEcsTargetParameters;
+    /**
+     * Refuse anything the parameters carry that this simulation does not hold.
+     *
+     * Working from what is accepted rather than from a list of everything ECS
+     * offers is what makes a parameter nobody thought about refused rather than
+     * dropped, which is the failure mode worth avoiding: a target that looks
+     * configured and behaves as though it is not.
+     */
+    private static refuseUnaccepted;
+    /**
+     * The task definition the target runs, which has to be named as a string.
+     *
+     * The type is checked as well as the value because these arrive as `unknown`:
+     * a target written in a template, or in JavaScript, can carry a number or a
+     * null here, and one of those reaching the task definition reader is a type
+     * error a long way from the target that caused it.
+     */
+    private static taskDefinitionArnIn;
+    private static taskCountIn;
+}
+//# sourceMappingURL=sim-ecs-target-parameters.d.ts.map

package/dist/service/ecs/target/sim-ecs-target-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-parameters.d.ts","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-parameters.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAC7C;AA8BD;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,SAAgB,iBAAiB,EAAE,MAAM,CAAC;IAC1C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,SAAgB,QAAQ,EAAE,0BAA0B,CAAC;IAErD,OAAO,eAQN;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CACP,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,GAChC,sBAAsB,CAoBxB;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAc/B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAelC,OAAO,CAAC,MAAM,CAAC,WAAW;CAuB3B"}

package/dist/service/ecs/target/sim-ecs-target-parameters.js

@@ -0,0 +1,111 @@
+import { isRecord } from "../../../util/type-guard/record.js";
+/**
+ * What a target may say about the task it runs.
+ *
+ * The first two decide what runs and how many of it. The other four describe
+ * where a real task would be placed and what it would be attached to, and there
+ * is no placement and no network here, so they are taken and ignored rather
+ * than refused: a target written for real AWS carries them, and refusing one
+ * would make an otherwise workable target unusable.
+ */
+const accepted = new Set([
+    "TaskDefinitionArn",
+    "TaskCount",
+    "LaunchType",
+    "PlatformVersion",
+    "NetworkConfiguration",
+    "CapacityProviderStrategy",
+]);
+/**
+ * The most tasks one target may run, as both services limit it.
+ */
+const maximumTaskCount = 10;
+/**
+ * How many tasks a target with no `TaskCount` runs.
+ */
+const defaultTaskCount = 1;
+/**
+ * The `EcsParameters` one target carries.
+ *
+ * Reading them is the same job for both services, and the refusals are the
+ * same refusals, so the only thing either service supplies is the error to
+ * raise. That keeps a message reading as EventBridge's or Scheduler's own
+ * while there is one answer to what a target may ask for.
+ */
+export class SimEcsTargetParameters {
+    taskDefinitionArn;
+    taskCount;
+    /**
+     * The parameters as the request wrote them, for reporting them back.
+     */
+    declared;
+    constructor(declared, taskDefinitionArn, taskCount) {
+        this.declared = declared;
+        this.taskDefinitionArn = taskDefinitionArn;
+        this.taskCount = taskCount;
+    }
+    /**
+     * Read the parameters a target carries, refusing what cannot be run.
+     *
+     * A target naming an ECS cluster and no task definition names nothing to
+     * run, so it is refused where it was written rather than at the first
+     * delivery.
+     */
+    static of(parameters, refuse) {
+        if (!isRecord(parameters)) {
+            throw refuse("EcsParameters is required on a target that runs an ECS task, and " +
+                "names at least a TaskDefinitionArn");
+        }
+        this.refuseUnaccepted(parameters, refuse);
+        // Copied rather than held by reference, the way a `RunTask` override is,
+        // since the caller owns what it passed in and this is read again every
+        // time the target runs and every time it is reported back.
+        const declared = structuredClone(parameters);
+        return new this(declared, this.taskDefinitionArnIn(declared["TaskDefinitionArn"], refuse), this.taskCountIn(declared["TaskCount"], refuse));
+    }
+    /**
+     * Refuse anything the parameters carry that this simulation does not hold.
+     *
+     * Working from what is accepted rather than from a list of everything ECS
+     * offers is what makes a parameter nobody thought about refused rather than
+     * dropped, which is the failure mode worth avoiding: a target that looks
+     * configured and behaves as though it is not.
+     */
+    static refuseUnaccepted(parameters, refuse) {
+        for (const [name, value] of Object.entries(parameters)) {
+            if (value !== undefined && !accepted.has(name)) {
+                throw refuse(`EcsParameters ${name} is not simulated, so a target carrying one ` +
+                    `is refused rather than taken with it dropped`);
+            }
+        }
+    }
+    /**
+     * The task definition the target runs, which has to be named as a string.
+     *
+     * The type is checked as well as the value because these arrive as `unknown`:
+     * a target written in a template, or in JavaScript, can carry a number or a
+     * null here, and one of those reaching the task definition reader is a type
+     * error a long way from the target that caused it.
+     */
+    static taskDefinitionArnIn(value, refuse) {
+        if (typeof value !== "string" || value === "") {
+            throw refuse("EcsParameters TaskDefinitionArn is required, as a family, a " +
+                "family:revision or an ARN: a target that runs a task says which " +
+                "task definition it runs");
+        }
+        return value;
+    }
+    static taskCountIn(value, refuse) {
+        if (value === undefined) {
+            return defaultTaskCount;
+        }
+        if (typeof value !== "number" ||
+            !Number.isSafeInteger(value) ||
+            value < 1 ||
+            value > maximumTaskCount) {
+            throw refuse(`EcsParameters TaskCount is a whole number from 1 to ${String(maximumTaskCount)}`);
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=sim-ecs-target-parameters.js.map

package/dist/service/ecs/target/sim-ecs-target-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-parameters.js","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAoB9D;;;;;;;;GAQG;AACH,MAAM,QAAQ,GAAwB,IAAI,GAAG,CAAC;IAC5C,mBAAmB;IACnB,WAAW;IACX,YAAY;IACZ,iBAAiB;IACjB,sBAAsB;IACtB,0BAA0B;CAC3B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B;;GAEG;AACH,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IACjB,iBAAiB,CAAS;IAC1B,SAAS,CAAS;IAElC;;OAEG;IACa,QAAQ,CAA6B;IAErD,YACE,QAAoC,EACpC,iBAAyB,EACzB,SAAiB;QAEjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CACP,UAAmB,EACnB,MAAiC;QAEjC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,CACV,mEAAmE;gBACjE,oCAAoC,CACvC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAE1C,yEAAyE;QACzE,uEAAuE;QACvE,2DAA2D;QAC3D,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAE7C,OAAO,IAAI,IAAI,CACb,QAAQ,EACR,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,EAC/D,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAChD,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,gBAAgB,CAC7B,UAAmC,EACnC,MAAiC;QAEjC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,MAAM,MAAM,CACV,iBAAiB,IAAI,8CAA8C;oBACjE,8CAA8C,CACjD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,mBAAmB,CAChC,KAAc,EACd,MAAiC;QAEjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC9C,MAAM,MAAM,CACV,8DAA8D;gBAC5D,kEAAkE;gBAClE,yBAAyB,CAC5B,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,WAAW,CACxB,KAAc,EACd,MAAiC;QAEjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,gBAAgB,CAAC;QAC1B,CAAC;QAED,IACE,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;YAC5B,KAAK,GAAG,CAAC;YACT,KAAK,GAAG,gBAAgB,EACxB,CAAC;YACD,MAAM,MAAM,CACV,uDAAuD,MAAM,CAC3D,gBAAgB,CACjB,EAAE,CACJ,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/service/ecs/target/sim-ecs-target-run.d.ts

@@ -0,0 +1,44 @@
+import type { SimAwsCaller } from "../../aws/caller/sim-aws-caller.js";
+import type { SimAwsAccountRegionContainer } from "../../aws/sim-aws-account-region-scope.js";
+import type { SimEcsTargetTask } from "./sim-ecs-target-task.js";
+interface SimEcsTargetRunProperties {
+    readonly scope: SimAwsAccountRegionContainer;
+}
+/**
+ * One task an event target or a schedule target is asking for.
+ */
+export interface SimEcsTargetRunRequest {
+    /**
+     * The cluster, as the target ARN names it.
+     */
+    readonly cluster: string;
+    readonly task: SimEcsTargetTask;
+    /**
+     * The session of the target's role, which is who runs the task.
+     */
+    readonly caller: SimAwsCaller;
+}
+/**
+ * Runs the task an EventBridge or Scheduler target names.
+ *
+ * It goes through `RunTask` rather than through the runner behind it, so a
+ * task started by a rule or a schedule is the same task as one started by a
+ * caller: the same cluster and revision lookups, the same refusals, the same
+ * IAM decision against `ecs:RunTask`, and the same task state afterwards. The
+ * role's permission to run the task is therefore ECS's own answer rather than
+ * a second one kept here.
+ *
+ * `RunTask` answers before the containers run, as real ECS does. That is the
+ * right moment to return to: the delivery has been made, and what the task
+ * does happens on the simulator's background work like the rest of it.
+ */
+export declare class SimEcsTargetRun {
+    private readonly scope;
+    constructor(properties: SimEcsTargetRunProperties);
+    /**
+     * Run the target's task as the target's role.
+     */
+    run(request: SimEcsTargetRunRequest): Promise<void>;
+}
+export {};
+//# sourceMappingURL=sim-ecs-target-run.d.ts.map

package/dist/service/ecs/target/sim-ecs-target-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-run.d.ts","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,UAAU,yBAAyB;IACjC,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IAErD,YAAY,UAAU,EAAE,yBAAyB,EAEhD;IAED;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAcxD;CACF"}

package/dist/service/ecs/target/sim-ecs-target-run.js

@@ -0,0 +1,35 @@
+/**
+ * Runs the task an EventBridge or Scheduler target names.
+ *
+ * It goes through `RunTask` rather than through the runner behind it, so a
+ * task started by a rule or a schedule is the same task as one started by a
+ * caller: the same cluster and revision lookups, the same refusals, the same
+ * IAM decision against `ecs:RunTask`, and the same task state afterwards. The
+ * role's permission to run the task is therefore ECS's own answer rather than
+ * a second one kept here.
+ *
+ * `RunTask` answers before the containers run, as real ECS does. That is the
+ * right moment to return to: the delivery has been made, and what the task
+ * does happens on the simulator's background work like the rest of it.
+ */
+export class SimEcsTargetRun {
+    scope;
+    constructor(properties) {
+        this.scope = properties.scope;
+    }
+    /**
+     * Run the target's task as the target's role.
+     */
+    async run(request) {
+        const { parameters, overrides } = request.task;
+        await this.scope.ecs().runTask({
+            input: {
+                cluster: request.cluster,
+                taskDefinition: parameters.taskDefinitionArn,
+                count: parameters.taskCount,
+                overrides,
+            },
+        }, { caller: request.caller });
+    }
+}
+//# sourceMappingURL=sim-ecs-target-run.js.map

package/dist/service/ecs/target/sim-ecs-target-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-run.js","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-run.ts"],"names":[],"mappings":"AAyBA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,eAAe;IACT,KAAK,CAA+B;IAErD,YAAY,UAAqC;QAC/C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,OAA+B;QACvC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;QAE/C,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAC5B;YACE,KAAK,EAAE;gBACL,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,cAAc,EAAE,UAAU,CAAC,iBAAiB;gBAC5C,KAAK,EAAE,UAAU,CAAC,SAAS;gBAC3B,SAAS;aACV;SACF,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;IACJ,CAAC;CACF"}

package/dist/service/ecs/target/sim-ecs-target-task.d.ts

@@ -0,0 +1,34 @@
+import type { SimEcsTaskOverrideType } from "../task/run/sim-ecs-task-overrides.js";
+import { SimEcsTargetParameters } from "./sim-ecs-target-parameters.js";
+/**
+ * What a target request says about the task it runs.
+ */
+export interface SimEcsTargetTaskProperties {
+    readonly EcsParameters?: unknown;
+    readonly Input?: string | undefined;
+}
+/**
+ * The task one EventBridge rule target or Scheduler schedule target runs.
+ *
+ * Both services describe it the same way, in `EcsParameters` and an `Input`,
+ * so both read it here. What they do not share is who runs it: a rule carries
+ * the role on the target itself, and a schedule already has an execution role
+ * for every target it has.
+ */
+export declare class SimEcsTargetTask {
+    readonly parameters: SimEcsTargetParameters;
+    /**
+     * What the target's `Input` overrides on the task, where it had one.
+     */
+    readonly overrides: SimEcsTaskOverrideType | undefined;
+    private constructor();
+    /**
+     * Read the task a target runs, refusing one that could not be run.
+     *
+     * The refusals happen where the target was written rather than at the first
+     * delivery, so a target that names no task definition, or an `Input` that is
+     * not the overrides it has to be, is reported to whoever wrote it.
+     */
+    static of(target: SimEcsTargetTaskProperties, refuse: (reason: string) => Error): SimEcsTargetTask;
+}
+//# sourceMappingURL=sim-ecs-target-task.d.ts.map

package/dist/service/ecs/target/sim-ecs-target-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-task.d.ts","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAC3B,SAAgB,UAAU,EAAE,sBAAsB,CAAC;IAEnD;;OAEG;IACH,SAAgB,SAAS,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAE9D,OAAO,eAMN;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CACP,MAAM,EAAE,0BAA0B,EAClC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,GAChC,gBAAgB,CAKlB;CACF"}

package/dist/service/ecs/target/sim-ecs-target-task.js

@@ -0,0 +1,32 @@
+import { simEcsTargetOverrides } from "./sim-ecs-target-overrides.js";
+import { SimEcsTargetParameters } from "./sim-ecs-target-parameters.js";
+/**
+ * The task one EventBridge rule target or Scheduler schedule target runs.
+ *
+ * Both services describe it the same way, in `EcsParameters` and an `Input`,
+ * so both read it here. What they do not share is who runs it: a rule carries
+ * the role on the target itself, and a schedule already has an execution role
+ * for every target it has.
+ */
+export class SimEcsTargetTask {
+    parameters;
+    /**
+     * What the target's `Input` overrides on the task, where it had one.
+     */
+    overrides;
+    constructor(parameters, overrides) {
+        this.parameters = parameters;
+        this.overrides = overrides;
+    }
+    /**
+     * Read the task a target runs, refusing one that could not be run.
+     *
+     * The refusals happen where the target was written rather than at the first
+     * delivery, so a target that names no task definition, or an `Input` that is
+     * not the overrides it has to be, is reported to whoever wrote it.
+     */
+    static of(target, refuse) {
+        return new this(SimEcsTargetParameters.of(target.EcsParameters, refuse), simEcsTargetOverrides(target.Input, refuse));
+    }
+}
+//# sourceMappingURL=sim-ecs-target-task.js.map

package/dist/service/ecs/target/sim-ecs-target-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-target-task.js","sourceRoot":"","sources":["../../../../src/service/ecs/target/sim-ecs-target-task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAUxE;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAgB;IACX,UAAU,CAAyB;IAEnD;;OAEG;IACa,SAAS,CAAqC;IAE9D,YACE,UAAkC,EAClC,SAA6C;QAE7C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CACP,MAAkC,EAClC,MAAiC;QAEjC,OAAO,IAAI,IAAI,CACb,sBAAsB,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,EACvD,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAC5C,CAAC;IACJ,CAAC;CACF"}