@kensio/yulin 1.13.0 → 1.14.1

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

@@ -0,0 +1,87 @@
+/**
+ * Where one simulated ECS task has got to.
+ *
+ * Stopping is recorded once. A task asked to stop keeps the reason the request
+ * gave rather than having it replaced by whatever the run would have said, so
+ * a test can tell a task it stopped from one that finished on its own.
+ */
+export class SimEcsTaskLifecycle {
+    #lastStatus = "PROVISIONING";
+    #desiredStatus = "RUNNING";
+    #startedAt;
+    #stoppedAt;
+    #stopCode;
+    #stoppedReason;
+    /**
+     * The state the task is being kept in.
+     */
+    get desiredStatus() {
+        return this.#desiredStatus;
+    }
+    /**
+     * Where the task has actually got to.
+     */
+    get lastStatus() {
+        return this.#lastStatus;
+    }
+    /**
+     * Whether the task has already finished.
+     */
+    get isStopped() {
+        return this.#lastStatus === "STOPPED";
+    }
+    /**
+     * Whether something has asked the task to stop.
+     */
+    get isStopRequested() {
+        return this.#desiredStatus === "STOPPED";
+    }
+    /**
+     * Mark the task as running its containers.
+     */
+    start(at) {
+        this.#lastStatus = "RUNNING";
+        this.#startedAt = at;
+    }
+    /**
+     * Record that something asked the task to stop.
+     *
+     * Only the desired status changes here. The task reaches `STOPPED` when the
+     * run gets to it, as it does on real ECS, where the desired status is what
+     * the request sets and the last status follows.
+     */
+    requestStop(reason) {
+        if (this.isStopped) {
+            return;
+        }
+        this.#desiredStatus = "STOPPED";
+        this.#stopCode = "UserInitiated";
+        this.#stoppedReason = reason;
+    }
+    /**
+     * Mark the task stopped, keeping any reason already recorded for it.
+     */
+    stop(stopped) {
+        this.#lastStatus = "STOPPED";
+        this.#desiredStatus = "STOPPED";
+        this.#stoppedAt = stopped.at;
+        this.#stopCode ??= stopped.stopCode;
+        this.#stoppedReason ??= stopped.reason;
+    }
+    /**
+     * This part of the task as `DescribeTasks` reports it.
+     */
+    toOutput() {
+        return {
+            lastStatus: this.#lastStatus,
+            desiredStatus: this.#desiredStatus,
+            ...(this.#startedAt !== undefined && { startedAt: this.#startedAt }),
+            ...(this.#stoppedAt !== undefined && { stoppedAt: this.#stoppedAt }),
+            ...(this.#stopCode !== undefined && { stopCode: this.#stopCode }),
+            ...(this.#stoppedReason !== undefined && {
+                stoppedReason: this.#stoppedReason,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=sim-ecs-task-lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-task-lifecycle.js","sourceRoot":"","sources":["../../../../src/service/ecs/task/sim-ecs-task-lifecycle.ts"],"names":[],"mappings":"AA6BA;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAC9B,WAAW,GAAqB,cAAc,CAAC;IAC/C,cAAc,GAA4B,SAAS,CAAC;IACpD,UAAU,CAAmB;IAC7B,UAAU,CAAmB;IAC7B,SAAS,CAAiC;IAC1C,cAAc,CAAqB;IAEnC;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,EAAQ;QACZ,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,MAAc;QACxB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC;QACjC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAuB;QAC1B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;YACjE,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,IAAI;gBACvC,aAAa,EAAE,IAAI,CAAC,cAAc;aACnC,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,46 @@
+import type { SimEcsTaskDesiredStatus } from "./sim-ecs-task-detail.js";
+import type { SimEcsTask } from "./sim-ecs-task.js";
+/**
+ * What a `ListTasks` request asked to be listed.
+ *
+ * The desired status is always set, because real ECS filters on `RUNNING` when
+ * a request says nothing. A task that has finished is therefore not in a
+ * listing unless the request asked for the stopped ones.
+ */
+export interface SimEcsTaskListing {
+    readonly clusterName: string;
+    readonly desiredStatus: SimEcsTaskDesiredStatus;
+    readonly family?: string | undefined;
+    readonly startedBy?: string | undefined;
+    readonly launchType?: string | undefined;
+    readonly serviceName?: string | undefined;
+}
+/**
+ * The simulated ECS tasks one Account and Region holds.
+ *
+ * Tasks are kept once they stop rather than removed, because a stopped task is
+ * what a test reads to find out what ran. Real ECS keeps one for about an hour
+ * after it stops; nothing here expires, so a stopped task lasts as long as the
+ * simulation does.
+ */
+export declare class SimEcsTaskStore {
+    private readonly tasksById;
+    private static matches;
+    /**
+     * Whether a filter the request left out, or matched, holds for a task.
+     */
+    private static matchesOptional;
+    /**
+     * Hold a task that has just been started.
+     */
+    put(task: SimEcsTask): void;
+    /**
+     * Find a task by its id, whether it is running or stopped.
+     */
+    find(taskId: string): SimEcsTask | undefined;
+    /**
+     * The tasks of one cluster a listing asked for, oldest first.
+     */
+    list(listing: SimEcsTaskListing): readonly SimEcsTask[];
+}
+//# sourceMappingURL=sim-ecs-task-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-task-store.d.ts","sourceRoot":"","sources":["../../../../src/service/ecs/task/sim-ecs-task-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,MAAM,CAAC,OAAO;IActB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAO9B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE1B;IAED;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,UAAU,EAAE,CAKtD;CACF"}

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

@@ -0,0 +1,47 @@
+/**
+ * The simulated ECS tasks one Account and Region holds.
+ *
+ * Tasks are kept once they stop rather than removed, because a stopped task is
+ * what a test reads to find out what ran. Real ECS keeps one for about an hour
+ * after it stops; nothing here expires, so a stopped task lasts as long as the
+ * simulation does.
+ */
+export class SimEcsTaskStore {
+    tasksById = new Map();
+    static matches(task, listing) {
+        return (task.clusterName === listing.clusterName &&
+            task.desiredStatus === listing.desiredStatus &&
+            this.matchesOptional(task.family, listing.family) &&
+            this.matchesOptional(task.startedBy, listing.startedBy) &&
+            this.matchesOptional(task.launchType, listing.launchType) &&
+            this.matchesOptional(task.serviceName, listing.serviceName));
+    }
+    /**
+     * Whether a filter the request left out, or matched, holds for a task.
+     */
+    static matchesOptional(value, filter) {
+        return filter === undefined || filter === value;
+    }
+    /**
+     * Hold a task that has just been started.
+     */
+    put(task) {
+        this.tasksById.set(task.taskId, task);
+    }
+    /**
+     * Find a task by its id, whether it is running or stopped.
+     */
+    find(taskId) {
+        return this.tasksById.get(taskId);
+    }
+    /**
+     * The tasks of one cluster a listing asked for, oldest first.
+     */
+    list(listing) {
+        return this.tasksById
+            .values()
+            .filter((task) => SimEcsTaskStore.matches(task, listing))
+            .toArray();
+    }
+}
+//# sourceMappingURL=sim-ecs-task-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-task-store.js","sourceRoot":"","sources":["../../../../src/service/ecs/task/sim-ecs-task-store.ts"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IACT,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEnD,MAAM,CAAC,OAAO,CACpB,IAAgB,EAChB,OAA0B;QAE1B,OAAO,CACL,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,WAAW;YACxC,IAAI,CAAC,aAAa,KAAK,OAAO,CAAC,aAAa;YAC5C,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC;YACjD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC;YACvD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC;YACzD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAC5D,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,eAAe,CAC5B,KAAyB,EACzB,MAA0B;QAE1B,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAgB;QAClB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAA0B;QAC7B,OAAO,IAAI,CAAC,SAAS;aAClB,MAAM,EAAE;aACR,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;aACxD,OAAO,EAAE,CAAC;IACf,CAAC;CACF"}

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

@@ -0,0 +1,81 @@
+import type { SimArn } from "../../aws/arn.js";
+import type { SimEcsTaskContainer } from "./sim-ecs-task-container.js";
+import type { SimEcsTaskDesiredStatus, SimEcsTaskDetail, SimEcsTaskStatus } from "./sim-ecs-task-detail.js";
+import { type SimEcsTaskIdentityProperties } from "./sim-ecs-task-identity.js";
+import { type SimEcsTaskStop } from "./sim-ecs-task-lifecycle.js";
+interface SimEcsTaskProperties extends SimEcsTaskIdentityProperties {
+    readonly containers: readonly SimEcsTaskContainer[];
+}
+/**
+ * One simulated ECS task.
+ *
+ * A task holds what ran and what came of it. It is created by `RunTask`,
+ * starts once the simulator's background work reaches it, and stops when its
+ * containers have finished or when `StopTask` asks it to.
+ *
+ * What a task is and where it has got to are kept apart, in its identity and
+ * its lifecycle, because only the second of them ever changes.
+ */
+export declare class SimEcsTask {
+    readonly containers: readonly SimEcsTaskContainer[];
+    private readonly identity;
+    private readonly lifecycle;
+    constructor(properties: SimEcsTaskProperties);
+    /** The id this task is named by, without its ARN around it. */
+    get taskId(): string;
+    /** The ARN this task is named by. */
+    get taskArn(): SimArn;
+    /** The cluster this task runs in. */
+    get clusterName(): string;
+    /** The task definition family this task was started from. */
+    get family(): string;
+    /** What started this task, where the request said. */
+    get startedBy(): string | undefined;
+    /** The launch type this task was started with, where the request said. */
+    get launchType(): string | undefined;
+    /** The service keeping this task running, where one is. */
+    get serviceName(): string | undefined;
+    /** The state this task is being kept in. */
+    get desiredStatus(): SimEcsTaskDesiredStatus;
+    /** Where this task has actually got to. */
+    get lastStatus(): SimEcsTaskStatus;
+    /**
+     * Whether something has asked this task to stop.
+     *
+     * The run checks this before each container, so a task stopped before its
+     * containers reach it runs none of them, and one stopped part way through
+     * runs no more.
+     */
+    get isStopRequested(): boolean;
+    /**
+     * This task's record of one of the containers its definition declared.
+     */
+    container(name: string): SimEcsTaskContainer;
+    /**
+     * Mark this task as running its containers.
+     */
+    start(at: Date): void;
+    /**
+     * Record that something asked this task to stop.
+     */
+    requestStop(reason: string): void;
+    /**
+     * Stop this task without it ever having started its containers.
+     *
+     * A secret the task could not pull is what does this. The whole task carries
+     * the reason and so does every container, because a real resource
+     * initialization error happens while the task is still provisioning rather
+     * than to one container of it.
+     */
+    failToStart(at: Date, reason: string): void;
+    /**
+     * Mark this task stopped, keeping any reason already recorded for it.
+     */
+    stop(stopped: SimEcsTaskStop): void;
+    /**
+     * This task as `DescribeTasks` reports it.
+     */
+    toOutput(): SimEcsTaskDetail;
+}
+export {};
+//# sourceMappingURL=sim-ecs-task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-task.d.ts","sourceRoot":"","sources":["../../../../src/service/ecs/task/sim-ecs-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAErC,UAAU,oBAAqB,SAAQ,4BAA4B;IACjE,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACrD;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,SAAgB,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAE3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,YAAY,UAAU,EAAE,oBAAoB,EAG3C;IAED,+DAA+D;IAC/D,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,qCAAqC;IACrC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,qCAAqC;IACrC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,6DAA6D;IAC7D,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sDAAsD;IACtD,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,0EAA0E;IAC1E,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAED,2DAA2D;IAC3D,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,4CAA4C;IAC5C,IAAI,aAAa,IAAI,uBAAuB,CAE3C;IAED,2CAA2C;IAC3C,IAAI,UAAU,IAAI,gBAAgB,CAEjC;IAED;;;;;;OAMG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAQ3C;IAED;;OAEG;IACH,KAAK,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAEpB;IAED;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEhC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAM1C;IAED;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAElC;IAED;;OAEG;IACH,QAAQ,IAAI,gBAAgB,CAM3B;CACF"}

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

@@ -0,0 +1,119 @@
+import { assertDefined } from "../../../util/type-guard/defined.js";
+import { SimEcsTaskIdentity, } from "./sim-ecs-task-identity.js";
+import { SimEcsTaskLifecycle, } from "./sim-ecs-task-lifecycle.js";
+/**
+ * One simulated ECS task.
+ *
+ * A task holds what ran and what came of it. It is created by `RunTask`,
+ * starts once the simulator's background work reaches it, and stops when its
+ * containers have finished or when `StopTask` asks it to.
+ *
+ * What a task is and where it has got to are kept apart, in its identity and
+ * its lifecycle, because only the second of them ever changes.
+ */
+export class SimEcsTask {
+    containers;
+    identity;
+    lifecycle = new SimEcsTaskLifecycle();
+    constructor(properties) {
+        this.identity = new SimEcsTaskIdentity(properties);
+        this.containers = properties.containers;
+    }
+    /** The id this task is named by, without its ARN around it. */
+    get taskId() {
+        return this.identity.taskId;
+    }
+    /** The ARN this task is named by. */
+    get taskArn() {
+        return this.identity.taskArn;
+    }
+    /** The cluster this task runs in. */
+    get clusterName() {
+        return this.identity.clusterName;
+    }
+    /** The task definition family this task was started from. */
+    get family() {
+        return this.identity.family;
+    }
+    /** What started this task, where the request said. */
+    get startedBy() {
+        return this.identity.startedBy;
+    }
+    /** The launch type this task was started with, where the request said. */
+    get launchType() {
+        return this.identity.launchType;
+    }
+    /** The service keeping this task running, where one is. */
+    get serviceName() {
+        return this.identity.serviceName;
+    }
+    /** The state this task is being kept in. */
+    get desiredStatus() {
+        return this.lifecycle.desiredStatus;
+    }
+    /** Where this task has actually got to. */
+    get lastStatus() {
+        return this.lifecycle.lastStatus;
+    }
+    /**
+     * Whether something has asked this task to stop.
+     *
+     * The run checks this before each container, so a task stopped before its
+     * containers reach it runs none of them, and one stopped part way through
+     * runs no more.
+     */
+    get isStopRequested() {
+        return this.lifecycle.isStopRequested;
+    }
+    /**
+     * This task's record of one of the containers its definition declared.
+     */
+    container(name) {
+        const container = this.containers.find((candidate) => candidate.name === name);
+        assertDefined(container, `Task ${this.taskId} holds no container ${name}`);
+        return container;
+    }
+    /**
+     * Mark this task as running its containers.
+     */
+    start(at) {
+        this.lifecycle.start(at);
+    }
+    /**
+     * Record that something asked this task to stop.
+     */
+    requestStop(reason) {
+        this.lifecycle.requestStop(reason);
+    }
+    /**
+     * Stop this task without it ever having started its containers.
+     *
+     * A secret the task could not pull is what does this. The whole task carries
+     * the reason and so does every container, because a real resource
+     * initialization error happens while the task is still provisioning rather
+     * than to one container of it.
+     */
+    failToStart(at, reason) {
+        for (const container of this.containers) {
+            container.neverStarted(reason);
+        }
+        this.stop({ at, stopCode: "TaskFailedToStart", reason });
+    }
+    /**
+     * Mark this task stopped, keeping any reason already recorded for it.
+     */
+    stop(stopped) {
+        this.lifecycle.stop(stopped);
+    }
+    /**
+     * This task as `DescribeTasks` reports it.
+     */
+    toOutput() {
+        return {
+            ...this.identity.toOutput(),
+            ...this.lifecycle.toOutput(),
+            containers: this.containers.map((container) => container.toOutput()),
+        };
+    }
+}
+//# sourceMappingURL=sim-ecs-task.js.map

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

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

package/dist/service/ecs/task-definition/container/sim-ecs-container-definition.d.ts

@@ -48,15 +48,30 @@ export declare class SimEcsContainerDefinition {
     readonly image: string;
     private readonly declared;
     constructor(declared: SimEcsContainerDefinitionType);
-    private static requiredName;
     /**
-     * The image URI the container declared.
+     * The environment variables this container declared.
      *
-     * It is required here as it is on real ECS. Nothing pulls it or reads it,
-     * but it is the identifier a simulated task run matches an executable
-     * binding against, so a definition without one could never run.
+     * These are what a bound handler sees in `process.env` while the container
+     * runs, before any override the `RunTask` request made.
      */
-    private static requiredImage;
+    get environment(): readonly SimEcsKeyValuePair[];
+    /**
+     * The secrets this container declared.
+     *
+     * Each one names a store to read a value from when the task starts, and the
+     * variable that value becomes. They are resolved as the task execution Role
+     * before any container runs, so a container reads them through `process.env`
+     * alongside its declared `environment`.
+     */
+    get secrets(): readonly SimEcsSecret[];
+    /**
+     * The ports this container declared it listens on.
+     *
+     * This is the one part of a container definition beyond its name and image
+     * whose meaning anything here reads, and what reads it is a load balancer
+     * working out which container of a task its registration meant.
+     */
+    get containerPorts(): readonly number[];
     /**
      * This container as a described task definition reports it.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"sim-ecs-container-definition.d.ts","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,qBAAa,yBAAyB;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD,YAAY,QAAQ,EAAE,6BAA6B,EAMlD;IAED,OAAO,CAAC,MAAM,CAAC,YAAY;IAY3B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAe5B;;OAEG;IACH,QAAQ,IAAI,6BAA6B,CAExC;CACF"}
+{"version":3,"file":"sim-ecs-container-definition.d.ts","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definition.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;;GASG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,kBAAkB,EAAE,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,yBAAyB,EAAE,GAAG,SAAS,CAAC;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,qBAAa,yBAAyB;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD,YAAY,QAAQ,EAAE,6BAA6B,EAMlD;IAED;;;;;OAKG;IACH,IAAI,WAAW,IAAI,SAAS,kBAAkB,EAAE,CAE/C;IAED;;;;;;;OAOG;IACH,IAAI,OAAO,IAAI,SAAS,YAAY,EAAE,CAErC;IAED;;;;;;OAMG;IACH,IAAI,cAAc,IAAI,SAAS,MAAM,EAAE,CAEtC;IAED;;OAEG;IACH,QAAQ,IAAI,6BAA6B,CAExC;CACF"}

package/dist/service/ecs/task-definition/container/sim-ecs-container-definition.js

@@ -1,4 +1,5 @@
-import { SimEcsClientException } from "../../error/sim-ecs.error.js";
+import { requiredSimEcsContainerImage, requiredSimEcsContainerName, } from "./sim-ecs-container-identity.js";
+import { simEcsContainerPorts } from "./sim-ecs-container-ports.js";
 /**
  * One container declared by a simulated ECS task definition.
  *
@@ -13,32 +14,41 @@ export class SimEcsContainerDefinition {
     image;
     declared;
     constructor(declared) {
-        this.name = SimEcsContainerDefinition.requiredName(declared);
-        this.image = SimEcsContainerDefinition.requiredImage(declared, this.name);
+        this.name = requiredSimEcsContainerName(declared.name);
+        this.image = requiredSimEcsContainerImage(declared.image, this.name);
         // Copied rather than held by reference, since the caller owns the object
         // it passed in and may reuse it for the next registration.
         this.declared = structuredClone(declared);
     }
-    static requiredName(declared) {
-        const { name } = declared;
-        if (name === undefined || name === "") {
-            throw new SimEcsClientException("Container.name should not be null or empty.");
-        }
-        return name;
+    /**
+     * The environment variables this container declared.
+     *
+     * These are what a bound handler sees in `process.env` while the container
+     * runs, before any override the `RunTask` request made.
+     */
+    get environment() {
+        return this.declared.environment ?? [];
+    }
+    /**
+     * The secrets this container declared.
+     *
+     * Each one names a store to read a value from when the task starts, and the
+     * variable that value becomes. They are resolved as the task execution Role
+     * before any container runs, so a container reads them through `process.env`
+     * alongside its declared `environment`.
+     */
+    get secrets() {
+        return this.declared.secrets ?? [];
     }
     /**
-     * The image URI the container declared.
+     * The ports this container declared it listens on.
      *
-     * It is required here as it is on real ECS. Nothing pulls it or reads it,
-     * but it is the identifier a simulated task run matches an executable
-     * binding against, so a definition without one could never run.
+     * This is the one part of a container definition beyond its name and image
+     * whose meaning anything here reads, and what reads it is a load balancer
+     * working out which container of a task its registration meant.
      */
-    static requiredImage(declared, name) {
-        const { image } = declared;
-        if (image === undefined || image === "") {
-            throw new SimEcsClientException(`Container.image should not be null or empty for container ${name}.`);
-        }
-        return image;
+    get containerPorts() {
+        return simEcsContainerPorts(this.declared.portMappings);
     }
     /**
      * This container as a described task definition reports it.

package/dist/service/ecs/task-definition/container/sim-ecs-container-definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-ecs-container-definition.js","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAgDrE;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAAyB;IACpB,IAAI,CAAS;IACb,KAAK,CAAS;IAEb,QAAQ,CAAgC;IAEzD,YAAY,QAAuC;QACjD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,GAAG,yBAAyB,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,yEAAyE;QACzE,2DAA2D;QAC3D,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAEO,MAAM,CAAC,YAAY,CAAC,QAAuC;QACjE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QAE1B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,qBAAqB,CAC7B,6CAA6C,CAC9C,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,aAAa,CAC1B,QAAuC,EACvC,IAAY;QAEZ,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;QAE3B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,qBAAqB,CAC7B,6DAA6D,IAAI,GAAG,CACrE,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"sim-ecs-container-definition.js","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AAWzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAsCpE;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAAyB;IACpB,IAAI,CAAS;IACb,KAAK,CAAS;IAEb,QAAQ,CAAgC;IAEzD,YAAY,QAAuC;QACjD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,4BAA4B,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,yEAAyE;QACzE,2DAA2D;QAC3D,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,cAAc;QAChB,OAAO,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/service/ecs/task-definition/container/sim-ecs-container-definitions.d.ts

@@ -1,4 +1,4 @@
-import { type SimEcsContainerDefinitionType } from "./sim-ecs-container-definition.js";
+import { SimEcsContainerDefinition, type SimEcsContainerDefinitionType } from "./sim-ecs-container-definition.js";
 /**
  * The containers one simulated ECS task definition declares.
  *
@@ -11,6 +11,14 @@ export declare class SimEcsContainerDefinitions {
     private readonly containers;
     constructor(declared: readonly SimEcsContainerDefinitionType[] | undefined);
     private static declaredContainers;
+    /**
+     * The containers this task definition declares, in declaration order.
+     */
+    all(): readonly SimEcsContainerDefinition[];
+    /**
+     * Whether a container of this name is one of them.
+     */
+    has(name: string): boolean;
     /**
      * These containers as a described task definition reports them.
      */

package/dist/service/ecs/task-definition/container/sim-ecs-container-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-ecs-container-definitions.d.ts","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAElE,YAAY,QAAQ,EAAE,SAAS,6BAA6B,EAAE,GAAG,SAAS,EAGzE;IAED,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAcjC;;OAEG;IACH,QAAQ,IAAI,SAAS,6BAA6B,EAAE,CAEnD;IAED,OAAO,CAAC,mBAAmB;CAc5B"}
+{"version":3,"file":"sim-ecs-container-definitions.d.ts","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definitions.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,KAAK,6BAA6B,EACnC,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuC;IAElE,YAAY,QAAQ,EAAE,SAAS,6BAA6B,EAAE,GAAG,SAAS,EAGzE;IAED,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAcjC;;OAEG;IACH,GAAG,IAAI,SAAS,yBAAyB,EAAE,CAE1C;IAED;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED;;OAEG;IACH,QAAQ,IAAI,SAAS,6BAA6B,EAAE,CAEnD;IAED,OAAO,CAAC,mBAAmB;CAc5B"}

package/dist/service/ecs/task-definition/container/sim-ecs-container-definitions.js

@@ -20,6 +20,18 @@ export class SimEcsContainerDefinitions {
         }
         return declared.map((container) => new SimEcsContainerDefinition(container));
     }
+    /**
+     * The containers this task definition declares, in declaration order.
+     */
+    all() {
+        return this.containers;
+    }
+    /**
+     * Whether a container of this name is one of them.
+     */
+    has(name) {
+        return this.containers.some((container) => container.name === name);
+    }
     /**
      * These containers as a described task definition reports them.
      */

package/dist/service/ecs/task-definition/container/sim-ecs-container-definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-ecs-container-definitions.js","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,yBAAyB,GAE1B,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA0B;IACpB,UAAU,CAAuC;IAElE,YAAY,QAA8D;QACxE,IAAI,CAAC,UAAU,GAAG,0BAA0B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAC/B,QAA8D;QAE9D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,qBAAqB,CAC7B,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,GAAG,CACjB,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,yBAAyB,CAAC,SAAS,CAAC,CACxD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IAEO,mBAAmB;QACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,qBAAqB,CAC7B,2DAA2D;oBACzD,GAAG,SAAS,CAAC,IAAI,8BAA8B,CAClD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"sim-ecs-container-definitions.js","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,yBAAyB,GAE1B,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;GAOG;AACH,MAAM,OAAO,0BAA0B;IACpB,UAAU,CAAuC;IAElE,YAAY,QAA8D;QACxE,IAAI,CAAC,UAAU,GAAG,0BAA0B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAC/B,QAA8D;QAE9D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,qBAAqB,CAC7B,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,GAAG,CACjB,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,yBAAyB,CAAC,SAAS,CAAC,CACxD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClE,CAAC;IAEO,mBAAmB;QACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,qBAAqB,CAC7B,2DAA2D;oBACzD,GAAG,SAAS,CAAC,IAAI,8BAA8B,CAClD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;CACF"}

package/dist/service/ecs/task-definition/container/sim-ecs-container-identity.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The name a container definition is referred to by everywhere else.
+ *
+ * Required here as it is on real ECS: a task's containers are recorded by name,
+ * an override names one, and a binding matches one, so a definition without a
+ * name could not take part in any of it.
+ */
+export declare function requiredSimEcsContainerName(name: string | undefined): string;
+/**
+ * The image URI a container definition declared.
+ *
+ * Required here as it is on real ECS. Nothing pulls it or reads it, but it is
+ * the identifier a simulated task run matches an executable binding against, so
+ * a definition without one could never run.
+ */
+export declare function requiredSimEcsContainerImage(image: string | undefined, name: string): string;
+//# sourceMappingURL=sim-ecs-container-identity.d.ts.map

package/dist/service/ecs/task-definition/container/sim-ecs-container-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-ecs-container-identity.d.ts","sourceRoot":"","sources":["../../../../../src/service/ecs/task-definition/container/sim-ecs-container-identity.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ5E;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GACX,MAAM,CAQR"}

package/dist/service/ecs/task-definition/container/sim-ecs-container-identity.js

@@ -0,0 +1,28 @@
+import { SimEcsClientException } from "../../error/sim-ecs.error.js";
+/**
+ * The name a container definition is referred to by everywhere else.
+ *
+ * Required here as it is on real ECS: a task's containers are recorded by name,
+ * an override names one, and a binding matches one, so a definition without a
+ * name could not take part in any of it.
+ */
+export function requiredSimEcsContainerName(name) {
+    if (name === undefined || name === "") {
+        throw new SimEcsClientException("Container.name should not be null or empty.");
+    }
+    return name;
+}
+/**
+ * The image URI a container definition declared.
+ *
+ * Required here as it is on real ECS. Nothing pulls it or reads it, but it is
+ * the identifier a simulated task run matches an executable binding against, so
+ * a definition without one could never run.
+ */
+export function requiredSimEcsContainerImage(image, name) {
+    if (image === undefined || image === "") {
+        throw new SimEcsClientException(`Container.image should not be null or empty for container ${name}.`);
+    }
+    return image;
+}
+//# sourceMappingURL=sim-ecs-container-identity.js.map