@kensio/yulin 0.44.0 → 0.47.0

package/dist/service/dynamodb/time-to-live/sim-dynamodb-table-time-to-live.d.ts

@@ -0,0 +1,74 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+import type { SimDynamoDbTimeToLiveDescription } from "../command/time-to-live/time-to-live.types.js";
+import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
+import type { SimDynamoDbTableItems } from "../table/sim-dynamodb-table-items.js";
+import type { SimDynamoDbTimeToLiveSpecification } from "./sim-dynamodb-time-to-live-specification.js";
+interface SimDynamoDbTableTimeToLiveProperties {
+    readonly tableName: string;
+    readonly items: SimDynamoDbTableItems;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * One table's time to live, and the item removals it drives.
+ *
+ * The setting and what acts on it are held together, because switching the
+ * setting on is what gives the items already on the table a deletion window.
+ *
+ * A removal is scheduled on the simulation's clock rather than the host's, so
+ * moving simulated time past an item's deletion window is what takes it away.
+ * That is what lets one `advanceBy` expire a table's sessions alongside
+ * whatever else the same advance causes elsewhere in the simulation, rather
+ * than the test having to ask for the expiry separately.
+ */
+export declare class SimDynamoDbTableTimeToLive {
+    private readonly items;
+    private readonly timeToLive;
+    private readonly background;
+    constructor(properties: SimDynamoDbTableTimeToLiveProperties);
+    /**
+     * Take an UpdateTimeToLive on this table.
+     *
+     * Switching it on reaches the items already there as well as the ones written
+     * afterwards, since their TTL attributes were only inert while it was off.
+     */
+    update(specification: SimDynamoDbTimeToLiveSpecification, at: Date): void;
+    /**
+     * Finish an UpdateTimeToLive, moving it off ENABLING or DISABLING.
+     */
+    settle(): Promise<void>;
+    /**
+     * Describe this table's time to live the way DynamoDB reports it.
+     */
+    description(): SimDynamoDbTimeToLiveDescription;
+    /**
+     * Arrange for an item to be gone once its deletion window runs out.
+     *
+     * An item whose window has already passed is scheduled for an instant behind
+     * the clock, which nothing dispatches until the clock next moves. So a read
+     * straight after writing an already expired item still finds it, as it would
+     * on AWS.
+     *
+     * The five year eligibility rule is read against the time of the write, which
+     * is when real DynamoDB would first look at the item.
+     */
+    scheduleFor(key: string, item: SimDynamoDbItem): void;
+    /**
+     * Arrange for every item already on the table to expire.
+     *
+     * Switching time to live on gives meaning to TTL attributes that were inert
+     * while it was off, so the items that already carry one are scheduled too.
+     */
+    private scheduleForAll;
+    /**
+     * Remove an item, if it is still the expired item that was scheduled.
+     *
+     * The deletion instant is worked out again from whatever is under the key
+     * now, against the time to live the table has now. One re-check covers
+     * everything that should call the removal off: the item was deleted,
+     * overwritten with a later TTL, or had its TTL attribute removed or changed
+     * to something that is not a Number, or time to live was switched off.
+     */
+    private removeIfExpired;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-table-time-to-live.d.ts.map

package/dist/service/dynamodb/time-to-live/sim-dynamodb-table-time-to-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-table-time-to-live.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/time-to-live/sim-dynamodb-table-time-to-live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAGlF,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAEvG,UAAU,oCAAoC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IAEjD,YAAY,UAAU,EAAE,oCAAoC,EAI3D;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAa,EAAE,kCAAkC,EAAE,EAAE,EAAE,IAAI,GAAG,IAAI,CAGxE;IAED;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAItB;IAED;;OAEG;IACH,WAAW,IAAI,gCAAgC,CAE9C;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAsBpD;IAED;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAMtB;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;CAsBxB"}

package/dist/service/dynamodb/time-to-live/sim-dynamodb-table-time-to-live.js

@@ -0,0 +1,109 @@
+import { simDynamoDbItemDeletionInstant } from "./sim-dynamodb-item-expiry.js";
+import { SimDynamoDbTimeToLive } from "./sim-dynamodb-time-to-live.js";
+/**
+ * One table's time to live, and the item removals it drives.
+ *
+ * The setting and what acts on it are held together, because switching the
+ * setting on is what gives the items already on the table a deletion window.
+ *
+ * A removal is scheduled on the simulation's clock rather than the host's, so
+ * moving simulated time past an item's deletion window is what takes it away.
+ * That is what lets one `advanceBy` expire a table's sessions alongside
+ * whatever else the same advance causes elsewhere in the simulation, rather
+ * than the test having to ask for the expiry separately.
+ */
+export class SimDynamoDbTableTimeToLive {
+    items;
+    timeToLive;
+    background;
+    constructor(properties) {
+        this.items = properties.items;
+        this.timeToLive = new SimDynamoDbTimeToLive(properties.tableName);
+        this.background = properties.background;
+    }
+    /**
+     * Take an UpdateTimeToLive on this table.
+     *
+     * Switching it on reaches the items already there as well as the ones written
+     * afterwards, since their TTL attributes were only inert while it was off.
+     */
+    update(specification, at) {
+        this.timeToLive.update(specification, at);
+        this.scheduleForAll();
+    }
+    /**
+     * Finish an UpdateTimeToLive, moving it off ENABLING or DISABLING.
+     */
+    settle() {
+        this.timeToLive.settle();
+        return Promise.resolve();
+    }
+    /**
+     * Describe this table's time to live the way DynamoDB reports it.
+     */
+    description() {
+        return this.timeToLive.description();
+    }
+    /**
+     * Arrange for an item to be gone once its deletion window runs out.
+     *
+     * An item whose window has already passed is scheduled for an instant behind
+     * the clock, which nothing dispatches until the clock next moves. So a read
+     * straight after writing an already expired item still finds it, as it would
+     * on AWS.
+     *
+     * The five year eligibility rule is read against the time of the write, which
+     * is when real DynamoDB would first look at the item.
+     */
+    scheduleFor(key, item) {
+        const attributeName = this.timeToLive.enabledAttributeName();
+        if (attributeName === undefined) {
+            return;
+        }
+        const at = simDynamoDbItemDeletionInstant(item, attributeName, this.background.now());
+        if (at === undefined) {
+            return;
+        }
+        this.background.scheduleAt(at, () => {
+            this.removeIfExpired(key);
+            return Promise.resolve();
+        });
+    }
+    /**
+     * Arrange for every item already on the table to expire.
+     *
+     * Switching time to live on gives meaning to TTL attributes that were inert
+     * while it was off, so the items that already carry one are scheduled too.
+     */
+    scheduleForAll() {
+        for (const [key, item] of this.items.entries()) {
+            this.scheduleFor(key, item);
+        }
+    }
+    /**
+     * Remove an item, if it is still the expired item that was scheduled.
+     *
+     * The deletion instant is worked out again from whatever is under the key
+     * now, against the time to live the table has now. One re-check covers
+     * everything that should call the removal off: the item was deleted,
+     * overwritten with a later TTL, or had its TTL attribute removed or changed
+     * to something that is not a Number, or time to live was switched off.
+     */
+    removeIfExpired(key) {
+        const attributeName = this.timeToLive.enabledAttributeName();
+        if (attributeName === undefined) {
+            return;
+        }
+        const item = this.items.get(key);
+        if (item === undefined) {
+            return;
+        }
+        const now = this.background.now();
+        const at = simDynamoDbItemDeletionInstant(item, attributeName, now);
+        if (at === undefined || at.getTime() > now.getTime()) {
+            return;
+        }
+        this.items.remove(key);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-table-time-to-live.js.map

package/dist/service/dynamodb/time-to-live/sim-dynamodb-table-time-to-live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-table-time-to-live.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/time-to-live/sim-dynamodb-table-time-to-live.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AASvE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,0BAA0B;IACpB,KAAK,CAAwB;IAC7B,UAAU,CAAwB;IAClC,UAAU,CAAsB;IAEjD,YAAY,UAAgD;QAC1D,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,qBAAqB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,aAAiD,EAAE,EAAQ;QAChE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;QAEzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,GAAW,EAAE,IAAqB;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;QAE7D,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,8BAA8B,CACvC,IAAI,EACJ,aAAa,EACb,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CACtB,CAAC;QAEF,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,GAAkB,EAAE;YACjD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAE1B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,cAAc;QACpB,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACK,eAAe,CAAC,GAAW;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;QAE7D,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,8BAA8B,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC;QAEpE,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACrD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live-specification.d.ts

@@ -0,0 +1,26 @@
+import type { SimDynamoDbTimeToLiveSpecificationInput } from "../command/time-to-live/time-to-live.types.js";
+/**
+ * What an UpdateTimeToLive request asks for, once it has been checked.
+ *
+ * Real DynamoDB requires both fields, including when switching time to live
+ * off, so a request naming no attribute is refused rather than read as one
+ * asking to leave the attribute as it was.
+ */
+export declare class SimDynamoDbTimeToLiveSpecification {
+    readonly attributeName: string;
+    readonly enabled: boolean;
+    private constructor();
+    /**
+     * Read the specification a request carries.
+     */
+    static fromInput(input: SimDynamoDbTimeToLiveSpecificationInput | undefined): SimDynamoDbTimeToLiveSpecification;
+    /**
+     * The attribute items are expired by.
+     */
+    private static readAttributeName;
+    /**
+     * Whether the request is switching time to live on or off.
+     */
+    private static readEnabled;
+}
+//# sourceMappingURL=sim-dynamodb-time-to-live-specification.d.ts.map

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live-specification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-time-to-live-specification.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/time-to-live/sim-dynamodb-time-to-live-specification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uCAAuC,EAAE,MAAM,+CAA+C,CAAC;AAQ7G;;;;;;GAMG;AACH,qBAAa,kCAAkC;IAC7C,SAAgB,aAAa,EAAE,MAAM,CAAC;IACtC,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC,OAAO,eAGN;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAAK,EAAE,uCAAuC,GAAG,SAAS,GACzD,kCAAkC,CAWpC;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAoBhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAU3B"}

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live-specification.js

@@ -0,0 +1,56 @@
+import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
+/**
+ * DynamoDB attribute names run from 1 to 255 characters.
+ */
+const greatestAttributeNameLength = 255;
+/**
+ * What an UpdateTimeToLive request asks for, once it has been checked.
+ *
+ * Real DynamoDB requires both fields, including when switching time to live
+ * off, so a request naming no attribute is refused rather than read as one
+ * asking to leave the attribute as it was.
+ */
+export class SimDynamoDbTimeToLiveSpecification {
+    attributeName;
+    enabled;
+    constructor(attributeName, enabled) {
+        this.attributeName = attributeName;
+        this.enabled = enabled;
+    }
+    /**
+     * Read the specification a request carries.
+     */
+    static fromInput(input) {
+        if (input === undefined) {
+            throw new SimDynamoDbValidationException(`TimeToLiveSpecification is required to update time to live`);
+        }
+        return new this(this.readAttributeName(input.AttributeName), this.readEnabled(input.Enabled));
+    }
+    /**
+     * The attribute items are expired by.
+     */
+    static readAttributeName(attributeName) {
+        if (attributeName === undefined || attributeName.length === 0) {
+            throw new SimDynamoDbValidationException(`TimeToLiveSpecification.AttributeName is required, naming the ` +
+                `attribute items expire by`);
+        }
+        if (attributeName.length > greatestAttributeNameLength) {
+            throw new SimDynamoDbValidationException(`TimeToLiveSpecification.AttributeName has a length of ` +
+                `${attributeName.length.toString()}, where 1 to ` +
+                `${greatestAttributeNameLength.toString()} characters is what ` +
+                `DynamoDB takes`);
+        }
+        return attributeName;
+    }
+    /**
+     * Whether the request is switching time to live on or off.
+     */
+    static readEnabled(enabled) {
+        if (typeof enabled !== "boolean") {
+            throw new SimDynamoDbValidationException(`TimeToLiveSpecification.Enabled is required, and must be true or ` +
+                `false`);
+        }
+        return enabled;
+    }
+}
+//# sourceMappingURL=sim-dynamodb-time-to-live-specification.js.map

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live-specification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-time-to-live-specification.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/time-to-live/sim-dynamodb-time-to-live-specification.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAE5E;;GAEG;AACH,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,OAAO,kCAAkC;IAC7B,aAAa,CAAS;IACtB,OAAO,CAAU;IAEjC,YAAoB,aAAqB,EAAE,OAAgB;QACzD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,CACd,KAA0D;QAE1D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,8BAA8B,CACtC,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,IAAI,CACb,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,aAAa,CAAC,EAC3C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,iBAAiB,CAAC,aAAiC;QAChE,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,8BAA8B,CACtC,gEAAgE;gBAC9D,2BAA2B,CAC9B,CAAC;QACJ,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,GAAG,2BAA2B,EAAE,CAAC;YACvD,MAAM,IAAI,8BAA8B,CACtC,wDAAwD;gBACtD,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe;gBACjD,GAAG,2BAA2B,CAAC,QAAQ,EAAE,sBAAsB;gBAC/D,gBAAgB,CACnB,CAAC;QACJ,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,WAAW,CAAC,OAA4B;QACrD,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,8BAA8B,CACtC,mEAAmE;gBACjE,OAAO,CACV,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live.d.ts

@@ -0,0 +1,70 @@
+import type { SimDynamoDbTimeToLiveDescription, SimDynamoDbTimeToLiveStatus } from "../command/time-to-live/time-to-live.types.js";
+import type { SimDynamoDbTimeToLiveSpecification } from "./sim-dynamodb-time-to-live-specification.js";
+/**
+ * One table's time to live setting.
+ *
+ * An update moves the status to ENABLING or DISABLING and the scheduled work
+ * settles it on ENABLED or DISABLED, which is the same two-step the table's own
+ * status goes through. Nothing here expires anything: this is what a table
+ * expires items by, and `SimDynamoDbTableTimeToLive` is what holds it and acts
+ * on it.
+ */
+export declare class SimDynamoDbTimeToLive {
+    #private;
+    private readonly tableName;
+    constructor(tableName: string);
+    /**
+     * Where this table's time to live is now.
+     */
+    get status(): SimDynamoDbTimeToLiveStatus;
+    /**
+     * The attribute items expire by, while time to live is on.
+     *
+     * ENABLING counts as on and DISABLING as off, since each is on its way to
+     * that state and the scheduled work settles it within the same turn.
+     */
+    enabledAttributeName(): string | undefined;
+    /**
+     * Take an update, refusing one that asks for the state it is already in or
+     * that comes too soon after the last.
+     */
+    update(specification: SimDynamoDbTimeToLiveSpecification, at: Date): void;
+    /**
+     * Finish an update that was scheduled.
+     *
+     * A DISABLED table reports no attribute name, as real DynamoDB reports none,
+     * so the attribute is forgotten rather than left describing a table that no
+     * longer expires anything.
+     */
+    settle(): void;
+    /**
+     * Describe this time to live the way DynamoDB reports it.
+     */
+    description(): SimDynamoDbTimeToLiveDescription;
+    /**
+     * Where an update is heading.
+     */
+    private statusFor;
+    /**
+     * Refuse an update asking for the state the table is already in.
+     *
+     * Real DynamoDB refuses this rather than treating it as a no-op, which is why
+     * code that has to be idempotent reads DescribeTimeToLive first. Changing the
+     * attribute an enabled table expires by means switching time to live off and
+     * on again, since an update that leaves it enabled is refused whatever
+     * attribute it names.
+     */
+    private assertChanges;
+    /**
+     * Whether time to live is on, or on its way to being on.
+     */
+    private get isOn();
+    /**
+     * Refuse a second update inside the hour.
+     *
+     * The hour is measured on the simulation's clock, so a test moves past it
+     * with `simAws.clock().advanceBy({ hours: 1 })` rather than by waiting.
+     */
+    private assertUpdatable;
+}
+//# sourceMappingURL=sim-dynamodb-time-to-live.d.ts.map

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-time-to-live.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/time-to-live/sim-dynamodb-time-to-live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gCAAgC,EAChC,2BAA2B,EAC5B,MAAM,+CAA+C,CAAC;AAEvD,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,8CAA8C,CAAC;AAOvG;;;;;;;;GAQG;AACH,qBAAa,qBAAqB;;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAKnC,YAAY,SAAS,EAAE,MAAM,EAE5B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,2BAA2B,CAExC;IAED;;;;;OAKG;IACH,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAMzC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa,EAAE,kCAAkC,EAAE,EAAE,EAAE,IAAI,GAAG,IAAI,CAOxE;IAED;;;;;;OAMG;IACH,MAAM,IAAI,IAAI,CAWb;IAED;;OAEG;IACH,WAAW,IAAI,gCAAgC,CAK9C;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,KAAK,IAAI,GAEf;IAED;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live.js

@@ -0,0 +1,129 @@
+import { SimDynamoDbValidationException } from "../error/dynamodb.error.js";
+/**
+ * Real DynamoDB takes one UpdateTimeToLive per table per hour.
+ */
+const updateWindowMilliseconds = 60 * 60 * 1000;
+/**
+ * One table's time to live setting.
+ *
+ * An update moves the status to ENABLING or DISABLING and the scheduled work
+ * settles it on ENABLED or DISABLED, which is the same two-step the table's own
+ * status goes through. Nothing here expires anything: this is what a table
+ * expires items by, and `SimDynamoDbTableTimeToLive` is what holds it and acts
+ * on it.
+ */
+export class SimDynamoDbTimeToLive {
+    tableName;
+    #status = "DISABLED";
+    #attributeName;
+    #updatedAt;
+    constructor(tableName) {
+        this.tableName = tableName;
+    }
+    /**
+     * Where this table's time to live is now.
+     */
+    get status() {
+        return this.#status;
+    }
+    /**
+     * The attribute items expire by, while time to live is on.
+     *
+     * ENABLING counts as on and DISABLING as off, since each is on its way to
+     * that state and the scheduled work settles it within the same turn.
+     */
+    enabledAttributeName() {
+        if (this.isOn) {
+            return this.#attributeName;
+        }
+        return undefined;
+    }
+    /**
+     * Take an update, refusing one that asks for the state it is already in or
+     * that comes too soon after the last.
+     */
+    update(specification, at) {
+        this.assertChanges(specification.enabled);
+        this.assertUpdatable(at);
+        this.#attributeName = specification.attributeName;
+        this.#updatedAt = at;
+        this.#status = this.statusFor(specification.enabled);
+    }
+    /**
+     * Finish an update that was scheduled.
+     *
+     * A DISABLED table reports no attribute name, as real DynamoDB reports none,
+     * so the attribute is forgotten rather than left describing a table that no
+     * longer expires anything.
+     */
+    settle() {
+        if (this.#status === "ENABLING") {
+            this.#status = "ENABLED";
+            return;
+        }
+        if (this.#status === "DISABLING") {
+            this.#status = "DISABLED";
+            this.#attributeName = undefined;
+        }
+    }
+    /**
+     * Describe this time to live the way DynamoDB reports it.
+     */
+    description() {
+        return {
+            TimeToLiveStatus: this.#status,
+            AttributeName: this.#attributeName,
+        };
+    }
+    /**
+     * Where an update is heading.
+     */
+    statusFor(enabled) {
+        if (enabled) {
+            return "ENABLING";
+        }
+        return "DISABLING";
+    }
+    /**
+     * Refuse an update asking for the state the table is already in.
+     *
+     * Real DynamoDB refuses this rather than treating it as a no-op, which is why
+     * code that has to be idempotent reads DescribeTimeToLive first. Changing the
+     * attribute an enabled table expires by means switching time to live off and
+     * on again, since an update that leaves it enabled is refused whatever
+     * attribute it names.
+     */
+    assertChanges(enabled) {
+        if (enabled !== this.isOn) {
+            return;
+        }
+        throw new SimDynamoDbValidationException(`Time to live on Table ${this.tableName} is already ` +
+            `${this.#status}, and DynamoDB refuses an UpdateTimeToLive asking ` +
+            `for the state it is already in`);
+    }
+    /**
+     * Whether time to live is on, or on its way to being on.
+     */
+    get isOn() {
+        return this.#status === "ENABLED" || this.#status === "ENABLING";
+    }
+    /**
+     * Refuse a second update inside the hour.
+     *
+     * The hour is measured on the simulation's clock, so a test moves past it
+     * with `simAws.clock().advanceBy({ hours: 1 })` rather than by waiting.
+     */
+    assertUpdatable(at) {
+        if (this.#updatedAt === undefined) {
+            return;
+        }
+        const elapsed = at.getTime() - this.#updatedAt.getTime();
+        if (elapsed >= updateWindowMilliseconds) {
+            return;
+        }
+        throw new SimDynamoDbValidationException(`Time to live on Table ${this.tableName} was last updated at ` +
+            `${this.#updatedAt.toISOString()}, and DynamoDB takes one ` +
+            `UpdateTimeToLive per table per hour`);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-time-to-live.js.map

package/dist/service/dynamodb/time-to-live/sim-dynamodb-time-to-live.js.map

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

package/dist/service/iam/role/sim-iam-role-with-policy.factory.d.ts

@@ -0,0 +1,49 @@
+import { AsyncMappedFactory } from "@kensio/part-factory";
+import type { SimAws } from "../../aws/sim-aws.js";
+import type { SimCreateRoleCommandOutput } from "../command/role/create-role/create-role.command.js";
+/**
+ * What a test asks for when it wants a Role that may do something.
+ *
+ * The actions and the resource are what the test is about. The trust policy,
+ * the policy name and the two commands it takes to get there are the same every
+ * time, so they are not asked for.
+ */
+export interface SimIamRoleWithPolicyInput {
+    readonly roleName: string;
+    readonly policyName: string;
+    readonly actions: readonly string[];
+    readonly resource: string;
+}
+/**
+ * The Role a CreateRole request answers with.
+ */
+export type SimIamCreatedRole = SimCreateRoleCommandOutput["Role"];
+/**
+ * Creates a Role allowed the actions it is given, and nothing else.
+ *
+ * This is the caller an authorization test needs: something to pass as
+ * `{ caller: { kind: "arn", arn: role.Arn } }` that IAM will allow one thing
+ * and refuse another.
+ *
+ * ```typescript
+ * const role = await simIamRoleWithPolicyFactory.make(
+ *   { roleName: "OrderWriter", actions: ["dynamodb:PutItem"] },
+ *   simAws,
+ * );
+ * ```
+ *
+ * The Role is assumable by the Account root of the simulated AWS it is given,
+ * which is the trust every test here wants and none of them is about. A Role
+ * trusted by a service, or one allowed several resources, is two ordinary
+ * commands with `simIamPolicyDocumentFactory` supplying the documents.
+ */
+export declare const simIamRoleWithPolicyFactory: AsyncMappedFactory<SimIamRoleWithPolicyInput, {
+    readonly Path: string;
+    readonly RoleName: string;
+    readonly RoleId: string;
+    readonly Arn: import("../../aws/arn.js").SimArn;
+    readonly CreateDate: Date;
+    readonly AssumeRolePolicyDocument?: string | undefined;
+    readonly Description?: string | undefined;
+}, SimAws>;
+//# sourceMappingURL=sim-iam-role-with-policy.factory.d.ts.map

package/dist/service/iam/role/sim-iam-role-with-policy.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-role-with-policy.factory.d.ts","sourceRoot":"","sources":["../../../../src/service/iam/role/sim-iam-role-with-policy.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oDAAoD,CAAC;AAGrG;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;UAwCvC,CAAC"}

package/dist/service/iam/role/sim-iam-role-with-policy.factory.js

@@ -0,0 +1,53 @@
+import { AsyncMappedFactory } from "@kensio/part-factory";
+import { simIamPolicyDocumentFactory } from "../policy/sim-iam-policy-document.factory.js";
+/**
+ * Creates a Role allowed the actions it is given, and nothing else.
+ *
+ * This is the caller an authorization test needs: something to pass as
+ * `{ caller: { kind: "arn", arn: role.Arn } }` that IAM will allow one thing
+ * and refuse another.
+ *
+ * ```typescript
+ * const role = await simIamRoleWithPolicyFactory.make(
+ *   { roleName: "OrderWriter", actions: ["dynamodb:PutItem"] },
+ *   simAws,
+ * );
+ * ```
+ *
+ * The Role is assumable by the Account root of the simulated AWS it is given,
+ * which is the trust every test here wants and none of them is about. A Role
+ * trusted by a service, or one allowed several resources, is two ordinary
+ * commands with `simIamPolicyDocumentFactory` supplying the documents.
+ */
+export const simIamRoleWithPolicyFactory = new AsyncMappedFactory(() => ({
+    roleName: "ApplicationRole",
+    policyName: "ApplicationPolicy",
+    actions: [],
+    resource: "*",
+}), async (input, simAws) => {
+    const simIam = simAws.iam();
+    const creation = await simIam.createRole({
+        input: {
+            RoleName: input.roleName,
+            AssumeRolePolicyDocument: simIamPolicyDocumentFactory.make({
+                Statement: {
+                    Principal: {
+                        AWS: `arn:aws:iam::${simAws.defaultAccountId}:root`,
+                    },
+                    Action: "sts:AssumeRole",
+                },
+            }),
+        },
+    });
+    await simIam.putRolePolicy({
+        input: {
+            RoleName: input.roleName,
+            PolicyName: input.policyName,
+            PolicyDocument: simIamPolicyDocumentFactory.make({
+                Statement: { Action: input.actions, Resource: input.resource },
+            }),
+        },
+    });
+    return creation.Role;
+});
+//# sourceMappingURL=sim-iam-role-with-policy.factory.js.map

package/dist/service/iam/role/sim-iam-role-with-policy.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-iam-role-with-policy.factory.js","sourceRoot":"","sources":["../../../../src/service/iam/role/sim-iam-role-with-policy.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAqB3F;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,kBAAkB,CAK/D,GAAG,EAAE,CAAC,CAAC;IACL,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,mBAAmB;IAC/B,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,GAAG;CACd,CAAC,EACF,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IACtB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IAE5B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;QACvC,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,wBAAwB,EAAE,2BAA2B,CAAC,IAAI,CAAC;gBACzD,SAAS,EAAE;oBACT,SAAS,EAAE;wBACT,GAAG,EAAE,gBAAgB,MAAM,CAAC,gBAAgB,OAAO;qBACpD;oBACD,MAAM,EAAE,gBAAgB;iBACzB;aACF,CAAC;SACH;KACF,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,aAAa,CAAC;QACzB,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,cAAc,EAAE,2BAA2B,CAAC,IAAI,CAAC;gBAC/C,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;aAC/D,CAAC;SACH;KACF,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/service/sqs/cfn/queue/sim-cfn-sqs-queue-name.d.ts

@@ -5,41 +5,18 @@ interface SimCfnSqsQueueNameProperties {
 /**
  * The name CloudFormation gives a queue whose template does not name it.
  *
- * Real CloudFormation generates `<stack name>-<logical ID>-<random>`. The
- * random part is left out here so a test can predict the name, which is the one
- * thing a template cannot rely on for real. Everything else follows AWS: two
- * stacks deploying the same template get different queue names, because the
- * stack name is part of it.
- *
  * A queue name is at most 80 characters, so a long stack name and logical ID
- * together are trimmed to fit. The start is kept, since that is where the stack
- * name is, and the trimmed name ends in a hash of the untrimmed one. CDK puts
- * its own disambiguating hash at the end of a logical ID, which is exactly what
- * trimming cuts off, so without that two queues in one stack could end up
- * asking for the same name.
+ * together are trimmed to fit. How a generated name is put together and
+ * trimmed is the same for every service, and lives in
+ * {@link SimCfnGeneratedResourceName}.
  */
 export declare class SimCfnSqsQueueName {
-    private readonly stackName;
-    private readonly logicalId;
+    private readonly generated;
     constructor(properties: SimCfnSqsQueueNameProperties);
     /**
      * The generated queue name.
      */
     get value(): string;
-    /**
-     * The tail a trimmed name ends with, derived from the whole untrimmed name.
-     *
-     * It is a hash rather than the random characters real CloudFormation uses, so
-     * the name stays the same between deployments of the same template.
-     */
-    private distinguisher;
-    /**
-     * The name before it is trimmed to the length SQS allows.
-     *
-     * A Resource created outside a stack has no stack name to derive one from, so
-     * it falls back to the logical ID on its own.
-     */
-    private composed;
 }
 export {};
 //# sourceMappingURL=sim-cfn-sqs-queue-name.d.ts.map