@kensio/yulin 1.6.1 → 1.8.0

package/dist/service/cloudformation/stack/update/sim-cfn-stack-updater.js

@@ -2,6 +2,14 @@ import { SimCloudFormationValidationError } from "../../error/sim-cloudformation
 import { makeSimCfnStackResourceMap } from "../resource-map/sim-cfn-stack-resource-map.js";
 import { SimCfnStackUpdatePlan } from "./sim-cfn-stack-update-plan.js";
 import { simCfnStackTemplateChanged } from "./sim-cfn-stack-template-changes.js";
+/**
+ * What CloudFormation answers an update that would change nothing.
+ *
+ * Named because a template file being watched is written far more often than it
+ * is changed, so telling this apart from a real failure is what makes a save
+ * with nothing in it a no-op rather than something to report.
+ */
+export const simCfnNoUpdatesMessage = "No updates are to be performed.";
 /**
  * Applies a changed template to a Stack that is already deployed.
  *
@@ -40,7 +48,7 @@ export class SimCfnStackUpdater {
         const { current, updated } = this.properties;
         if (!this.plan.changesResources &&
             !simCfnStackTemplateChanged(current, updated)) {
-            throw new SimCloudFormationValidationError("No updates are to be performed.");
+            throw new SimCloudFormationValidationError(simCfnNoUpdatesMessage);
         }
     }
     /**

package/dist/service/cloudformation/stack/update/sim-cfn-stack-updater.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-cfn-stack-updater.js","sourceRoot":"","sources":["../../../../../src/service/cloudformation/stack/update/sim-cfn-stack-updater.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAE3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAWjF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAkB;IACZ,UAAU,CAA+B;IACzC,IAAI,CAAwB;IAE7C,YAAY,UAAwC;QAClD,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;QAE1E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,qBAAqB,CAAC;YACpC,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,0BAA0B,CAAC;gBAClC,kBAAkB;gBAClB,UAAU;gBACV,QAAQ,EAAE,OAAO;aAClB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB;QACd,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAE7C,IACE,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAC3B,CAAC,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,EAC7C,CAAC;YACD,MAAM,IAAI,gCAAgC,CACxC,iCAAiC,CAClC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAClD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,MAAM,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAExB,MAAM,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF"}
+{"version":3,"file":"sim-cfn-stack-updater.js","sourceRoot":"","sources":["../../../../../src/service/cloudformation/stack/update/sim-cfn-stack-updater.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAE3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,iCAAiC,CAAC;AAWxE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,kBAAkB;IACZ,UAAU,CAA+B;IACzC,IAAI,CAAwB;IAE7C,YAAY,UAAwC;QAClD,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;QAE1E,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,qBAAqB,CAAC;YACpC,OAAO,EAAE,SAAS;YAClB,OAAO,EAAE,0BAA0B,CAAC;gBAClC,kBAAkB;gBAClB,UAAU;gBACV,QAAQ,EAAE,OAAO;aAClB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,gBAAgB;QACd,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAE7C,IACE,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB;YAC3B,CAAC,0BAA0B,CAAC,OAAO,EAAE,OAAO,CAAC,EAC7C,CAAC;YACD,MAAM,IAAI,gCAAgC,CAAC,sBAAsB,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAClD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,MAAM,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAExB,MAAM,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/service/cloudformation/watch/sim-cfn-template-file-events.d.ts

@@ -0,0 +1,30 @@
+interface SimCfnTemplateFileEventsProperties {
+    readonly templatePath: string;
+    readonly onEvent: () => void;
+}
+/**
+ * Filesystem events for one template file.
+ *
+ * The directory is what gets watched, not the file. A synthesis writes a
+ * temporary file and renames it over the template, so a watch on the file
+ * itself is left holding the file that was replaced. Events for anything else
+ * in the directory, which for a cloud assembly is every other stack in it and
+ * every staged asset, are dropped by name.
+ */
+export declare class SimCfnTemplateFileEvents {
+    private readonly directoryPath;
+    private readonly fileName;
+    private readonly onEvent;
+    private watcher;
+    constructor(properties: SimCfnTemplateFileEventsProperties);
+    /**
+     * Start listening for writes to the template file.
+     */
+    start(): void;
+    /**
+     * Stop listening.
+     */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=sim-cfn-template-file-events.d.ts.map

package/dist/service/cloudformation/watch/sim-cfn-template-file-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-file-events.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-file-events.ts"],"names":[],"mappings":"AAGA,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,OAAO,CAAwB;IAEvC,YAAY,UAAU,EAAE,kCAAkC,EAIzD;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAmBZ;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;CACF"}

package/dist/service/cloudformation/watch/sim-cfn-template-file-events.js

@@ -0,0 +1,51 @@
+import fs, {} from "node:fs";
+import path from "node:path";
+/**
+ * Filesystem events for one template file.
+ *
+ * The directory is what gets watched, not the file. A synthesis writes a
+ * temporary file and renames it over the template, so a watch on the file
+ * itself is left holding the file that was replaced. Events for anything else
+ * in the directory, which for a cloud assembly is every other stack in it and
+ * every staged asset, are dropped by name.
+ */
+export class SimCfnTemplateFileEvents {
+    directoryPath;
+    fileName;
+    onEvent;
+    watcher;
+    constructor(properties) {
+        this.directoryPath = path.dirname(properties.templatePath);
+        this.fileName = path.basename(properties.templatePath);
+        this.onEvent = properties.onEvent;
+    }
+    /**
+     * Start listening for writes to the template file.
+     */
+    start() {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        const watcher = fs.watch(this.directoryPath, (_event, fileName) => {
+            if (fileName === this.fileName) {
+                this.onEvent();
+            }
+        });
+        // The directory can be deleted or replaced, and a watcher with no error
+        // listener throws. Nothing here can put it back.
+        /* v8 ignore next 4 -- raised where the platform reports a watch going away,
+         * which macOS does not do for a deleted directory, so nothing here can make
+         * it happen on the machine this suite runs on. */
+        watcher.on("error", () => {
+            watcher.close();
+            this.watcher = undefined;
+        });
+        this.watcher = watcher;
+    }
+    /**
+     * Stop listening.
+     */
+    close() {
+        this.watcher?.close();
+        this.watcher = undefined;
+    }
+}
+//# sourceMappingURL=sim-cfn-template-file-events.js.map

package/dist/service/cloudformation/watch/sim-cfn-template-file-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-file-events.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-file-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAkB,MAAM,SAAS,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B;;;;;;;;GAQG;AACH,MAAM,OAAO,wBAAwB;IAClB,aAAa,CAAS;IACtB,QAAQ,CAAS;IACjB,OAAO,CAAa;IAC7B,OAAO,CAAwB;IAEvC,YAAY,UAA8C;QACxD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,mEAAmE;QACnE,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;YAChE,IAAI,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,wEAAwE;QACxE,iDAAiD;QACjD;;0DAEkD;QAClD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;CACF"}

package/dist/service/cloudformation/watch/sim-cfn-template-file-watch.d.ts

@@ -0,0 +1,39 @@
+import { type SimWatchRuntime } from "../../../watch/sim-watch-runtime.js";
+interface SimCfnTemplateFileWatchProperties {
+    readonly templatePath: string;
+    readonly onChanged: () => Promise<void>;
+    readonly settleMs?: number | undefined;
+    readonly watch?: SimWatchRuntime | undefined;
+}
+/**
+ * Watches one deployed template file, and applies it again when it changes.
+ *
+ * Changes are applied one at a time. A save arriving while an update is still
+ * running waits for it, rather than being refused as a second update of a Stack
+ * that is already updating.
+ */
+export declare class SimCfnTemplateFileWatch {
+    private readonly templatePath;
+    private readonly onChanged;
+    private readonly settle;
+    private readonly events;
+    private readonly watch;
+    private applying;
+    constructor(properties: SimCfnTemplateFileWatchProperties);
+    /**
+     * Start watching.
+     *
+     * A `yulin watch` supervisor is told the path is handled here, so a
+     * re-synthesis updates the Stack in place instead of restarting the process
+     * and taking every simulated Bucket and Table with it.
+     */
+    start(): void;
+    /**
+     * Stop watching, and drop a change that was still settling.
+     */
+    close(): void;
+    private apply;
+    private applyAfter;
+}
+export {};
+//# sourceMappingURL=sim-cfn-template-file-watch.d.ts.map

package/dist/service/cloudformation/watch/sim-cfn-template-file-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-file-watch.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-file-watch.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qCAAqC,CAAC;AAI7C,UAAU,iCAAiC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAoC;IAEpD,YAAY,UAAU,EAAE,iCAAiC,EAwBxD;IAED;;;;;;OAMG;IACH,KAAK,IAAI,IAAI,CAGZ;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;IAGD,OAAO,CAAC,KAAK;YAIC,UAAU;CAYzB"}

package/dist/service/cloudformation/watch/sim-cfn-template-file-watch.js

@@ -0,0 +1,74 @@
+import path from "node:path";
+import { SimWatchSettle } from "../../../watch/sim-watch-settle.js";
+import { simWatch, } from "../../../watch/sim-watch-runtime.js";
+import { simWatchConfig } from "../../../watch/sim-watch.config.js";
+import { SimCfnTemplateFileEvents } from "./sim-cfn-template-file-events.js";
+/**
+ * Watches one deployed template file, and applies it again when it changes.
+ *
+ * Changes are applied one at a time. A save arriving while an update is still
+ * running waits for it, rather than being refused as a second update of a Stack
+ * that is already updating.
+ */
+export class SimCfnTemplateFileWatch {
+    templatePath;
+    onChanged;
+    settle;
+    events;
+    watch;
+    applying = Promise.resolve();
+    constructor(properties) {
+        const { templatePath, onChanged, settleMs = simWatchConfig.settleMs, watch = simWatch, } = properties;
+        this.templatePath = path.resolve(templatePath);
+        this.onChanged = onChanged;
+        this.watch = watch;
+        this.settle = new SimWatchSettle({
+            settleMs,
+            maxWaitMs: simWatchConfig.settleMaxWaitMs,
+            onSettled: () => {
+                this.apply();
+            },
+        });
+        this.events = new SimCfnTemplateFileEvents({
+            templatePath: this.templatePath,
+            onEvent: () => {
+                this.settle.record(this.templatePath);
+            },
+        });
+    }
+    /**
+     * Start watching.
+     *
+     * A `yulin watch` supervisor is told the path is handled here, so a
+     * re-synthesis updates the Stack in place instead of restarting the process
+     * and taking every simulated Bucket and Table with it.
+     */
+    start() {
+        this.watch.reportHeldPath(this.templatePath);
+        this.events.start();
+    }
+    /**
+     * Stop watching, and drop a change that was still settling.
+     */
+    close() {
+        this.settle.cancel();
+        this.events.close();
+    }
+    // Queued rather than started, so two saves in a row are two updates in order.
+    apply() {
+        this.applying = this.applyAfter(this.applying);
+    }
+    async applyAfter(applying) {
+        await applying;
+        try {
+            await this.onChanged();
+        }
+        catch {
+            // The change handler answers a failed update and a callback that threw
+            // itself, so anything still thrown here is the watch failing rather than
+            // the update. It is dropped because the queue has to survive it: a
+            // rejected link in it would refuse every save after this one.
+        }
+    }
+}
+//# sourceMappingURL=sim-cfn-template-file-watch.js.map

package/dist/service/cloudformation/watch/sim-cfn-template-file-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-file-watch.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-file-watch.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EACL,QAAQ,GAET,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAS7E;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IACjB,YAAY,CAAS;IACrB,SAAS,CAAsB;IAC/B,MAAM,CAAiB;IACvB,MAAM,CAA2B;IACjC,KAAK,CAAkB;IAChC,QAAQ,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEpD,YAAY,UAA6C;QACvD,MAAM,EACJ,YAAY,EACZ,SAAS,EACT,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAClC,KAAK,GAAG,QAAQ,GACjB,GAAG,UAAU,CAAC;QAEf,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC;YAC/B,QAAQ;YACR,SAAS,EAAE,cAAc,CAAC,eAAe;YACzC,SAAS,EAAE,GAAS,EAAE;gBACpB,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;SACF,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,wBAAwB,CAAC;YACzC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,GAAS,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,8EAA8E;IACtE,KAAK;QACX,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAAuB;QAC9C,MAAM,QAAQ,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,yEAAyE;YACzE,mEAAmE;YACnE,8DAA8D;QAChE,CAAC;IACH,CAAC;CACF"}

package/dist/service/cloudformation/watch/sim-cfn-template-file-watches.d.ts

@@ -0,0 +1,51 @@
+import type { SimCloudFormationDeployTemplateFileProperties } from "../deploy/sim-cfn-template-file-loader.js";
+import type { SimCfnTemplateFileUpdating } from "../deploy/sim-cfn-template-file-updater.js";
+import type { SimCfnTemplateFileWatchOptions } from "./sim-cfn-template-watch.type.js";
+interface SimCfnTemplateFileWatchesProperties {
+    readonly updater: SimCfnTemplateFileUpdating;
+}
+/**
+ * The template files this simulated CloudFormation is watching.
+ *
+ * One watch per deployment rather than per file, so a file deployed as two
+ * Stacks updates both of them. Deploying the same Stack from the same file
+ * again replaces its watch instead, since the deployment that just happened is
+ * the live one and the watch it replaces would be applying the file to the
+ * Stack it deployed before.
+ *
+ * A watch holds an open filesystem handle, which keeps the process alive, so
+ * anything that starts one needs a way to let it go. `stopAll()` is that way,
+ * and a long-running dev process simply never calls it.
+ */
+export declare class SimCfnTemplateFileWatches {
+    private readonly updater;
+    private readonly watches;
+    constructor(properties: SimCfnTemplateFileWatchesProperties);
+    /**
+     * Watch a deployed template file, if the deployment asked to keep reading it.
+     */
+    watchIfAsked(deployment: SimCloudFormationDeployTemplateFileProperties): void;
+    /**
+     * Watch a deployed template file, and update its Stack when it changes.
+     *
+     * A reload target that could never reload, which is a local server serving
+     * without live reload, refuses here. That is the deployment that asked for
+     * it, rather than the first change long after, and nothing is left watching
+     * for a reload that was never going to arrive.
+     */
+    add(deployment: SimCloudFormationDeployTemplateFileProperties, options: SimCfnTemplateFileWatchOptions): void;
+    /**
+     * The template files being watched, as `yulin watch` is told about them.
+     *
+     * A file two Stacks were deployed from is named once. What a supervisor does
+     * with it is the same whether one deployment is reading it or several.
+     */
+    paths(): readonly string[];
+    /**
+     * Stop watching everything, so nothing is left holding the process open.
+     */
+    stopAll(): void;
+    private remove;
+}
+export {};
+//# sourceMappingURL=sim-cfn-template-file-watches.d.ts.map

package/dist/service/cloudformation/watch/sim-cfn-template-file-watches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-file-watches.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-file-watches.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,6CAA6C,EAAE,MAAM,2CAA2C,CAAC;AAC/G,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAG7F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAEvF,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE,YAAY,UAAU,EAAE,mCAAmC,EAE1D;IAED;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,6CAA6C,GACxD,IAAI,CAMN;IAED;;;;;;;OAOG;IACH,GAAG,CACD,UAAU,EAAE,6CAA6C,EACzD,OAAO,EAAE,8BAA8B,GACtC,IAAI,CAwBN;IAED;;;;;OAKG;IACH,KAAK,IAAI,SAAS,MAAM,EAAE,CAIzB;IAED;;OAEG;IACH,OAAO,IAAI,IAAI,CAMd;IAED,OAAO,CAAC,MAAM;CAIf"}

package/dist/service/cloudformation/watch/sim-cfn-template-file-watches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-file-watches.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-file-watches.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAO/E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,yBAAyB;IACnB,OAAO,CAA6B;IACpC,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEhE,YAAY,UAA+C;QACzD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,YAAY,CACV,UAAyD;QAEzD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CACD,UAAyD,EACzD,OAAuC;QAEvC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC;QAEhC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,yBAAyB,CAAC;YAC3C,YAAY;YACZ,UAAU;YACV,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO;SACR,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAE3B,MAAM,KAAK,GAAG,IAAI,uBAAuB,CAAC;YACxC,YAAY;YACZ,SAAS,EAAE,KAAK,IAAmB,EAAE;gBACnC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,OAAO;YACL,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO;QACL,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,MAAM,CAAC,aAAqB;QAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;CACF;AAOD;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,YAAoB,EAAE,SAA6B;IACnE,OAAO,GAAG,YAAY,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CACnB,KAA2D;IAE3D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QAC3C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/service/cloudformation/watch/sim-cfn-template-watch-report.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Says why a watched template could not be applied.
+ *
+ * A failed update leaves the Stack where the update got to, and the process
+ * serving it still up, which is the reason to update in place rather than
+ * restart. That is only useful if the reason it failed is somewhere the person
+ * who saved the file will see it.
+ *
+ * It goes to the console because the simulator has no logger of its own, the
+ * same as every other warning it raises.
+ */
+export declare class SimCfnTemplateWatchReport {
+    /**
+     * Report an update the changed template file did not survive.
+     */
+    failed(templatePath: string, error: Error): void;
+    /**
+     * Report something the watch was given to run afterwards that threw.
+     *
+     * Said separately from a failed update, because what went wrong is whatever
+     * was meant to happen about the update rather than the update itself. The
+     * listener names itself, since a callback and a browser to reload fail for
+     * quite different reasons.
+     */
+    listenerFailed(templatePath: string, listener: string, error: Error): void;
+}
+//# sourceMappingURL=sim-cfn-template-watch-report.d.ts.map

package/dist/service/cloudformation/watch/sim-cfn-template-watch-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-watch-report.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-watch-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAQ/C;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAMzE;CACF"}

package/dist/service/cloudformation/watch/sim-cfn-template-watch-report.js

@@ -0,0 +1,37 @@
+/**
+ * Says why a watched template could not be applied.
+ *
+ * A failed update leaves the Stack where the update got to, and the process
+ * serving it still up, which is the reason to update in place rather than
+ * restart. That is only useful if the reason it failed is somewhere the person
+ * who saved the file will see it.
+ *
+ * It goes to the console because the simulator has no logger of its own, the
+ * same as every other warning it raises.
+ */
+export class SimCfnTemplateWatchReport {
+    /**
+     * Report an update the changed template file did not survive.
+     */
+    failed(templatePath, error) {
+        // eslint-disable-next-line no-console
+        console.warn(`Simulated CloudFormation could not apply the changed template ` +
+            `${templatePath}: ${error.message}. The Stack is left where the ` +
+            `update got to, since there is no rollback to the template it was ` +
+            `deployed from.`);
+    }
+    /**
+     * Report something the watch was given to run afterwards that threw.
+     *
+     * Said separately from a failed update, because what went wrong is whatever
+     * was meant to happen about the update rather than the update itself. The
+     * listener names itself, since a callback and a browser to reload fail for
+     * quite different reasons.
+     */
+    listenerFailed(templatePath, listener, error) {
+        // eslint-disable-next-line no-console
+        console.warn(`Simulated CloudFormation ran the ${listener} for the watched ` +
+            `template ${templatePath}, and it threw: ${error.message}`);
+    }
+}
+//# sourceMappingURL=sim-cfn-template-watch-report.js.map

package/dist/service/cloudformation/watch/sim-cfn-template-watch-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-watch-report.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-watch-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,yBAAyB;IACpC;;OAEG;IACH,MAAM,CAAC,YAAoB,EAAE,KAAY;QACvC,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,gEAAgE;YAC9D,GAAG,YAAY,KAAK,KAAK,CAAC,OAAO,gCAAgC;YACjE,mEAAmE;YACnE,gBAAgB,CACnB,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,YAAoB,EAAE,QAAgB,EAAE,KAAY;QACjE,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,oCAAoC,QAAQ,mBAAmB;YAC7D,YAAY,YAAY,mBAAmB,KAAK,CAAC,OAAO,EAAE,CAC7D,CAAC;IACJ,CAAC;CACF"}

package/dist/service/cloudformation/watch/sim-cfn-template-watch-update.d.ts

@@ -0,0 +1,45 @@
+import type { SimCloudFormationDeployTemplateFileProperties } from "../deploy/sim-cfn-template-file-loader.js";
+import type { SimCfnTemplateFileUpdating } from "../deploy/sim-cfn-template-file-updater.js";
+import { SimCfnTemplateWatchReport } from "./sim-cfn-template-watch-report.js";
+import type { SimCfnTemplateFileWatchOptions } from "./sim-cfn-template-watch.type.js";
+interface SimCfnTemplateWatchUpdateProperties {
+    readonly templatePath: string;
+    readonly deployment: SimCloudFormationDeployTemplateFileProperties;
+    readonly updater: SimCfnTemplateFileUpdating;
+    readonly options: SimCfnTemplateFileWatchOptions;
+    readonly report?: SimCfnTemplateWatchReport | undefined;
+}
+/**
+ * One application of a changed template file, and what to make of how it went.
+ *
+ * Three things can come of a save, and only one of them is an update. A file
+ * written without being changed is refused by the Stack and is a no-op here,
+ * since a template is written far more often than it is changed. An update that
+ * failed is reported and left there: the Stack keeps the Resources it had, and
+ * a browser looking at them is not told anything changed, because nothing did.
+ *
+ * Nothing thrown gets past this, because the watch applies changes one after
+ * another and a rejection would stop it applying any more.
+ */
+export declare class SimCfnTemplateWatchUpdate {
+    private readonly properties;
+    private readonly report;
+    constructor(properties: SimCfnTemplateWatchUpdateProperties);
+    /**
+     * Apply the template file to its Stack, and answer for the result.
+     */
+    apply(): Promise<void>;
+    private refused;
+    private updated;
+    /**
+     * Run something the watch was given, without letting it break the watch.
+     *
+     * A callback that throws, or a server that has since closed, is the caller's
+     * own code failing, and it says so rather than being passed on: a throw from
+     * here would go on to be the rejection that stops every save after it being
+     * applied.
+     */
+    private notify;
+}
+export {};
+//# sourceMappingURL=sim-cfn-template-watch-update.d.ts.map

package/dist/service/cloudformation/watch/sim-cfn-template-watch-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-watch-update.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-watch-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6CAA6C,EAAE,MAAM,2CAA2C,CAAC;AAC/G,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAE7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAEvF,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,6CAA6C,CAAC;IACnE,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,8BAA8B,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,YAAY,UAAU,EAAE,mCAAmC,EAG1D;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3B;IAED,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,OAAO;IAcf;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM;CAWf"}

package/dist/service/cloudformation/watch/sim-cfn-template-watch-update.js

@@ -0,0 +1,84 @@
+import { simCfnNoUpdatesMessage } from "../stack/update/sim-cfn-stack-updater.js";
+import { SimCfnTemplateWatchReport } from "./sim-cfn-template-watch-report.js";
+/**
+ * One application of a changed template file, and what to make of how it went.
+ *
+ * Three things can come of a save, and only one of them is an update. A file
+ * written without being changed is refused by the Stack and is a no-op here,
+ * since a template is written far more often than it is changed. An update that
+ * failed is reported and left there: the Stack keeps the Resources it had, and
+ * a browser looking at them is not told anything changed, because nothing did.
+ *
+ * Nothing thrown gets past this, because the watch applies changes one after
+ * another and a rejection would stop it applying any more.
+ */
+export class SimCfnTemplateWatchUpdate {
+    properties;
+    report;
+    constructor(properties) {
+        this.properties = properties;
+        this.report = properties.report ?? new SimCfnTemplateWatchReport();
+    }
+    /**
+     * Apply the template file to its Stack, and answer for the result.
+     */
+    async apply() {
+        const { deployment, updater } = this.properties;
+        try {
+            await updater.update(deployment);
+        }
+        catch (error) {
+            this.refused(watchUpdateError(error));
+            return;
+        }
+        this.updated();
+    }
+    refused(error) {
+        if (error.message === simCfnNoUpdatesMessage) {
+            return;
+        }
+        const { templatePath, options } = this.properties;
+        if (options.onFailed === undefined) {
+            this.report.failed(templatePath, error);
+            return;
+        }
+        this.notify("onFailed callback", () => {
+            options.onFailed?.(error);
+        });
+    }
+    updated() {
+        const { onUpdated, reload } = this.properties.options;
+        this.notify("onUpdated callback", onUpdated);
+        if (reload !== undefined) {
+            // After the callback, so a browser arrives on the Resources the update
+            // made and on whatever the callback did about them.
+            this.notify("reload", () => {
+                reload.reload();
+            });
+        }
+    }
+    /**
+     * Run something the watch was given, without letting it break the watch.
+     *
+     * A callback that throws, or a server that has since closed, is the caller's
+     * own code failing, and it says so rather than being passed on: a throw from
+     * here would go on to be the rejection that stops every save after it being
+     * applied.
+     */
+    notify(listener, run) {
+        try {
+            run?.();
+        }
+        catch (error) {
+            this.report.listenerFailed(this.properties.templatePath, listener, watchUpdateError(error));
+        }
+    }
+}
+function watchUpdateError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    /* v8 ignore next -- redundant fallback */
+    return new Error(String(error));
+}
+//# sourceMappingURL=sim-cfn-template-watch-update.js.map

package/dist/service/cloudformation/watch/sim-cfn-template-watch-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-watch-update.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-watch-update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAW/E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,yBAAyB;IACnB,UAAU,CAAsC;IAChD,MAAM,CAA4B;IAEnD,YAAY,UAA+C;QACzD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,IAAI,yBAAyB,EAAE,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAEhD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,OAAO,CAAC,KAAY;QAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,sBAAsB,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QAElD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAExC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,GAAG,EAAE;YACpC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAEtD,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;QAE7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,uEAAuE;YACvE,oDAAoD;YACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACzB,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACK,MAAM,CAAC,QAAgB,EAAE,GAA6B;QAC5D,IAAI,CAAC;YACH,GAAG,EAAE,EAAE,CAAC;QACV,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,cAAc,CACxB,IAAI,CAAC,UAAU,CAAC,YAAY,EAC5B,QAAQ,EACR,gBAAgB,CAAC,KAAK,CAAC,CACxB,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0CAA0C;IAC1C,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAClC,CAAC"}

package/dist/service/cloudformation/watch/sim-cfn-template-watch.type.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Somewhere a reload can be sent, which in practice is a local server.
+ *
+ * Named by the shape rather than the class, so watching a template file does
+ * not drag the serving side of Yulin into a simulated CloudFormation that is
+ * only being asked to update a Stack.
+ */
+export interface SimCfnWatchReloadTarget {
+    reload(): void;
+    /**
+     * Give now the refusal a reload would be given later, if there is one.
+     *
+     * A local server refuses one outright when it was served without live
+     * reload, and saying so here is what moves that refusal to the deployment
+     * that asked for it. A target without it is taken as able to reload.
+     */
+    checkReload?(): void;
+}
+/**
+ * What to do about a deployed template file that changes.
+ */
+export interface SimCfnTemplateFileWatchOptions {
+    /**
+     * Reload connected browsers once the Stack has finished being updated from
+     * the changed file.
+     *
+     * This is the local server, as `{ reload: srv }`. It reloads when the update
+     * is complete rather than when the write lands, so a browser reloads onto the
+     * Resources the new template asked for, and an update that failed is not one
+     * a browser is sent to.
+     */
+    readonly reload?: SimCfnWatchReloadTarget | undefined;
+    /**
+     * Run once the Stack has finished being updated from the changed file.
+     *
+     * For whatever else a change is worth doing, alongside `reload` or in place
+     * of it. It runs before the reload, so a browser arriving on the new
+     * Resources finds whatever this left ready for it.
+     */
+    readonly onUpdated?: (() => void) | undefined;
+    /**
+     * Handle an update the changed template did not survive.
+     *
+     * The Stack is left where the update got to either way, since there is no
+     * rollback. Without this the reason goes to the console, so a failure is not
+     * silent; with it, the reason is yours to deal with and nothing is written.
+     */
+    readonly onFailed?: ((error: Error) => void) | undefined;
+    /**
+     * How long the writes have to stop for before the file counts as changed, in
+     * milliseconds.
+     *
+     * One save is several writes, so a wait is what makes one save one update.
+     * The default suits an editor saving a file and a `cdk synth` writing one.
+     */
+    readonly settleMs?: number | undefined;
+}
+//# sourceMappingURL=sim-cfn-template-watch.type.d.ts.map

package/dist/service/cloudformation/watch/sim-cfn-template-watch.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-watch.type.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-watch.type.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,IAAI,IAAI,CAAC;IAEf;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAEtD;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAE9C;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAEzD;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC"}

package/dist/service/cloudformation/watch/sim-cfn-template-watch.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sim-cfn-template-watch.type.js.map

package/dist/service/cloudformation/watch/sim-cfn-template-watch.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-template-watch.type.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/watch/sim-cfn-template-watch.type.ts"],"names":[],"mappings":""}

package/dist/service/cognito/cfn/user-pool/sim-cfn-cognito-admin-create-user-config.d.ts

@@ -0,0 +1,29 @@
+import type { SimCfnResource } from "../../../cloudformation/resource/sim-cfn-resource.js";
+import type { SimCfnTemplateValue } from "../../../cloudformation/template/value/sim-cfn-template-value.js";
+import type { SimCognitoAdminCreateUserConfigType } from "../../user-pool/sim-cognito-admin-create-user-config.js";
+import type { SimCfnCognitoPropertyParser } from "../sim-cfn-cognito-property-parser.js";
+interface SimCfnCognitoAdminCreateUserConfigProperties {
+    readonly resource: SimCfnResource;
+    readonly propertyParser: SimCfnCognitoPropertyParser;
+}
+/**
+ * Reads the `AdminCreateUserConfig` property of an AWS::Cognito::UserPool
+ * Resource into the shape CreateUserPool takes.
+ *
+ * `AllowAdminCreateUserOnly` is what a CDK `UserPool` sets from
+ * `selfSignUpEnabled`, and is the property that decides whether `SignUp` works
+ * against the deployed pool at all, so it is parsed as a boolean rather than
+ * passed through as whatever the template carried.
+ */
+export declare class SimCfnCognitoAdminCreateUserConfig {
+    private readonly resource;
+    private readonly propertyParser;
+    constructor(properties: SimCfnCognitoAdminCreateUserConfigProperties);
+    /**
+     * The pool's admin creation configuration, or undefined when the template
+     * names none.
+     */
+    parse(value: SimCfnTemplateValue | undefined): SimCognitoAdminCreateUserConfigType | undefined;
+}
+export {};
+//# sourceMappingURL=sim-cfn-cognito-admin-create-user-config.d.ts.map

package/dist/service/cognito/cfn/user-pool/sim-cfn-cognito-admin-create-user-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cfn-cognito-admin-create-user-config.d.ts","sourceRoot":"","sources":["../../../../../src/service/cognito/cfn/user-pool/sim-cfn-cognito-admin-create-user-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sDAAsD,CAAC;AAC3F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AAC5G,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,yDAAyD,CAAC;AACnH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAC;AAgBzF,UAAU,4CAA4C;IACpD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,2BAA2B,CAAC;CACtD;AAED;;;;;;;;GAQG;AACH,qBAAa,kCAAkC;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAE7D,YAAY,UAAU,EAAE,4CAA4C,EAGnE;IAED;;;OAGG;IACH,KAAK,CACH,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,mCAAmC,GAAG,SAAS,CAmCjD;CACF"}