@kensio/yulin 1.6.1 → 1.7.0

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;;OAEG;IACH,GAAG,CACD,UAAU,EAAE,6CAA6C,EACzD,OAAO,EAAE,8BAA8B,GACtC,IAAI,CAsBN;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;;OAEG;IACH,GAAG,CACD,UAAyD,EACzD,OAAuC;QAEvC,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,25 @@
+/**
+ * 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 a callback the watch was given 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.
+     */
+    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;;;;;OAKG;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,35 @@
+/**
+ * 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 a callback the watch was given 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.
+     */
+    listenerFailed(templatePath, listener, error) {
+        // eslint-disable-next-line no-console
+        console.warn(`Simulated CloudFormation ran the ${listener} callback 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;;;;;OAKG;IACH,cAAc,CAAC,YAAoB,EAAE,QAAgB,EAAE,KAAY;QACjE,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,oCAAoC,QAAQ,4BAA4B;YACtE,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,44 @@
+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 a callback the watch was given, without letting it break the watch.
+     *
+     * A callback that throws 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;IAIf;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;CAWf"}

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

@@ -0,0 +1,75 @@
+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", () => {
+            options.onFailed?.(error);
+        });
+    }
+    updated() {
+        this.notify("onUpdated", this.properties.options.onUpdated);
+    }
+    /**
+     * Run a callback the watch was given, without letting it break the watch.
+     *
+     * A callback that throws 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,UAAU,EAAE,GAAG,EAAE;YAC3B,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;OAMG;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,30 @@
+/**
+ * What to do about a deployed template file that changes.
+ */
+export interface SimCfnTemplateFileWatchOptions {
+    /**
+     * Run once the Stack has finished being updated from the changed file.
+     *
+     * This is where a served page gets reloaded, with `srv.reload()`. It runs
+     * when the update is complete rather than when the write lands, so a browser
+     * reloads onto the Resources the new template asked for.
+     */
+    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;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;;;;;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/s3/bucket/sim-s3-bucket-access.d.ts

@@ -30,6 +30,10 @@ export declare class SimS3BucketAccess {
     websiteUrl(bucketName: SimS3BucketName | string): URL;
     /**
      * Have a Bucket use a local filesystem directory for storage.
+     *
+     * The directory is named to a `yulin watch` supervisor, so editing a file the
+     * Bucket serves restarts the process without the directory having been listed
+     * anywhere. Nothing happens outside watch mode.
      */
     mountFilesystem(bucketName: SimS3BucketName | string, directoryPath: string): void;
 }

package/dist/service/s3/bucket/sim-s3-bucket-access.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-s3-bucket-access.d.ts","sourceRoot":"","sources":["../../../../src/service/s3/bucket/sim-s3-bucket-access.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAG1F,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEvE,UAAU,2BAA2B;IACnC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAE9D,YAAY,UAAU,EAAE,2BAA2B,EAGlD;IAED;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,WAAW,CAK1D;IAED;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,GAAG,CAK7C;IAED;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,GAAG,CAEpD;IAED;;OAEG;IACH,eAAe,CACb,UAAU,EAAE,eAAe,GAAG,MAAM,EACpC,aAAa,EAAE,MAAM,GACpB,IAAI,CAIN;CACF"}
+{"version":3,"file":"sim-s3-bucket-access.d.ts","sourceRoot":"","sources":["../../../../src/service/s3/bucket/sim-s3-bucket-access.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAG1F,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGvE,UAAU,2BAA2B;IACnC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IAE9D,YAAY,UAAU,EAAE,2BAA2B,EAGlD;IAED;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,WAAW,CAK1D;IAED;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,GAAG,CAK7C;IAED;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,GAAG,CAEpD;IAED;;;;;;OAMG;IACH,eAAe,CACb,UAAU,EAAE,eAAe,GAAG,MAAM,EACpC,aAAa,EAAE,MAAM,GACpB,IAAI,CAKN;CACF"}

package/dist/service/s3/bucket/sim-s3-bucket-access.js

@@ -1,6 +1,7 @@
 import { assertDefined } from "../../../util/type-guard/defined.js";
 import { FilesystemS3BucketStorage } from "../storage/filesystem/s3-filesystem-storage.js";
 import { simS3BucketUrl } from "./sim-s3-endpoint-url.js";
+import { simWatch } from "../../../watch/sim-watch-runtime.js";
 /**
  * Reaching a Bucket in one simulated S3 scope by name.
  *
@@ -38,9 +39,14 @@ export class SimS3BucketAccess {
     }
     /**
      * Have a Bucket use a local filesystem directory for storage.
+     *
+     * The directory is named to a `yulin watch` supervisor, so editing a file the
+     * Bucket serves restarts the process without the directory having been listed
+     * anywhere. Nothing happens outside watch mode.
      */
     mountFilesystem(bucketName, directoryPath) {
         this.required(bucketName).configureSimStorage(new FilesystemS3BucketStorage({ directoryPath }));
+        simWatch.reportPath(directoryPath);
     }
 }
 //# sourceMappingURL=sim-s3-bucket-access.js.map

package/dist/service/s3/bucket/sim-s3-bucket-access.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-s3-bucket-access.js","sourceRoot":"","sources":["../../../../src/service/s3/bucket/sim-s3-bucket-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAQ1D;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,CAA4C;IACnD,kBAAkB,CAA2B;IAE9D,YAAY,UAAuC;QACjD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAoC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAA6B,CAAC,CAAC;QAC/D,aAAa,CAAC,MAAM,EAAE,uBAAuB,UAAU,EAAE,CAAC,CAAC;QAE3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,UAAoC;QACtC,OAAO,cAAc,CACnB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,UAAU,EACpC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CACnC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAoC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,eAAe,CACb,UAAoC,EACpC,aAAqB;QAErB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,mBAAmB,CAC3C,IAAI,yBAAyB,CAAC,EAAE,aAAa,EAAE,CAAC,CACjD,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"sim-s3-bucket-access.js","sourceRoot":"","sources":["../../../../src/service/s3/bucket/sim-s3-bucket-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAO/D;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,CAA4C;IACnD,kBAAkB,CAA2B;IAE9D,YAAY,UAAuC;QACjD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAoC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAA6B,CAAC,CAAC;QAC/D,aAAa,CAAC,MAAM,EAAE,uBAAuB,UAAU,EAAE,CAAC,CAAC;QAE3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,UAAoC;QACtC,OAAO,cAAc,CACnB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,UAAU,EACpC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CACnC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAoC;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CACb,UAAoC,EACpC,aAAqB;QAErB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,mBAAmB,CAC3C,IAAI,yBAAyB,CAAC,EAAE,aAAa,EAAE,CAAC,CACjD,CAAC;QACF,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/watch/sim-watch-runtime.d.ts

@@ -0,0 +1,76 @@
+type SimWatchStoppingListener = () => void;
+type SimWatchMessageListener = (message: unknown) => void;
+/**
+ * The part of the running process this needs, so a test can stand in for it
+ * without touching the process its own test runner is talking over.
+ */
+export interface SimWatchProcess {
+    readonly env: NodeJS.ProcessEnv;
+    readonly send?: ((message: unknown) => boolean) | undefined;
+    on(event: "message", listener: SimWatchMessageListener): unknown;
+    off(event: "message", listener: SimWatchMessageListener): unknown;
+}
+interface SimWatchRuntimeProperties {
+    readonly host?: SimWatchProcess;
+}
+/**
+ * The half of watch mode that lives in the supervised process.
+ *
+ * It is inert unless `yulin watch` started this process, so nothing here
+ * changes what a test run or an ordinary script does. Under a supervisor it
+ * does two things: it names the paths Yulin is reading, so the supervisor can
+ * watch them without the user listing paths Yulin is already holding, and it
+ * passes on the warning that a restart is coming, so a served page hears about
+ * it before the connection goes.
+ */
+export declare class SimWatchRuntime {
+    private readonly host;
+    private readonly stoppingListeners;
+    private listening;
+    private readonly onMessage;
+    constructor(properties?: SimWatchRuntimeProperties);
+    /**
+     * Whether a `yulin watch` supervisor started this process.
+     */
+    supervised(): boolean;
+    /**
+     * Name a path the supervisor should watch, such as a directory mounted into a
+     * Bucket or a synthesized template being deployed.
+     *
+     * Best effort by design. Nothing depends on the message arriving, and a
+     * process with no supervisor drops it.
+     */
+    reportPath(reportedPath: string): void;
+    /**
+     * Name a path this process is watching itself, and answering without needing
+     * a restart, such as a deployed template being updated in place.
+     *
+     * The supervisor leaves it alone from then on. Being told that a path is
+     * handled here is more specific than any rule the supervisor has about which
+     * paths are worth restarting for, so it wins over having reported the same
+     * path for watching.
+     *
+     * Best effort, as reportPath is: a process with no supervisor drops it.
+     */
+    reportHeldPath(heldPath: string): void;
+    /**
+     * Run something when the supervisor says this process is about to restart.
+     */
+    onStopping(listener: SimWatchStoppingListener): void;
+    /**
+     * Stop running something on a restart.
+     */
+    offStopping(listener: SimWatchStoppingListener): void;
+    private listen;
+    private unlisten;
+}
+/**
+ * The watch runtime for this process.
+ *
+ * One per process rather than one per `SimAws`, because it is about the process
+ * a supervisor started, not about any one simulated environment. Several
+ * simulations in the same process all report to the same supervisor.
+ */
+export declare const simWatch: SimWatchRuntime;
+export {};
+//# sourceMappingURL=sim-watch-runtime.d.ts.map

package/dist/watch/sim-watch-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-watch-runtime.d.ts","sourceRoot":"","sources":["../../src/watch/sim-watch-runtime.ts"],"names":[],"mappings":"AAGA,KAAK,wBAAwB,GAAG,MAAM,IAAI,CAAC;AAC3C,KAAK,uBAAuB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5D,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC;IACjE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC;CACnE;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;CACjC;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAYxB;IAEF,YAAY,UAAU,GAAE,yBAA8B,EAGrD;IAED;;OAEG;IACH,UAAU,IAAI,OAAO,CAMpB;IAED;;;;;;OAMG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CASrC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CASrC;IAED;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAOnD;IAED;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,wBAAwB,GAAG,IAAI,CAMpD;IAED,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,QAAQ;CAQjB;AAWD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,iBAAwB,CAAC"}

package/dist/watch/sim-watch-runtime.js

@@ -0,0 +1,124 @@
+import path from "node:path";
+import { simWatchConfig, simWatchMessages } from "./sim-watch.config.js";
+/**
+ * The half of watch mode that lives in the supervised process.
+ *
+ * It is inert unless `yulin watch` started this process, so nothing here
+ * changes what a test run or an ordinary script does. Under a supervisor it
+ * does two things: it names the paths Yulin is reading, so the supervisor can
+ * watch them without the user listing paths Yulin is already holding, and it
+ * passes on the warning that a restart is coming, so a served page hears about
+ * it before the connection goes.
+ */
+export class SimWatchRuntime {
+    host;
+    stoppingListeners = new Set();
+    listening = false;
+    onMessage = (message) => {
+        if (!isStoppingMessage(message)) {
+            return;
+        }
+        for (const listener of this.stoppingListeners) {
+            listener();
+        }
+        // The supervisor waits for this before killing the process, so whatever the
+        // listeners wrote has left this end first.
+        this.host.send?.({ type: simWatchMessages.stopped });
+    };
+    constructor(properties = {}) {
+        const { host = process } = properties;
+        this.host = host;
+    }
+    /**
+     * Whether a `yulin watch` supervisor started this process.
+     */
+    supervised() {
+        return (this.host.env[simWatchConfig.environmentVariableName] ===
+            simWatchConfig.environmentVariableValue &&
+            typeof this.host.send === "function");
+    }
+    /**
+     * Name a path the supervisor should watch, such as a directory mounted into a
+     * Bucket or a synthesized template being deployed.
+     *
+     * Best effort by design. Nothing depends on the message arriving, and a
+     * process with no supervisor drops it.
+     */
+    reportPath(reportedPath) {
+        if (!this.supervised()) {
+            return;
+        }
+        this.host.send?.({
+            type: simWatchMessages.path,
+            path: path.resolve(reportedPath),
+        });
+    }
+    /**
+     * Name a path this process is watching itself, and answering without needing
+     * a restart, such as a deployed template being updated in place.
+     *
+     * The supervisor leaves it alone from then on. Being told that a path is
+     * handled here is more specific than any rule the supervisor has about which
+     * paths are worth restarting for, so it wins over having reported the same
+     * path for watching.
+     *
+     * Best effort, as reportPath is: a process with no supervisor drops it.
+     */
+    reportHeldPath(heldPath) {
+        if (!this.supervised()) {
+            return;
+        }
+        this.host.send?.({
+            type: simWatchMessages.heldPath,
+            path: path.resolve(heldPath),
+        });
+    }
+    /**
+     * Run something when the supervisor says this process is about to restart.
+     */
+    onStopping(listener) {
+        if (!this.supervised()) {
+            return;
+        }
+        this.stoppingListeners.add(listener);
+        this.listen();
+    }
+    /**
+     * Stop running something on a restart.
+     */
+    offStopping(listener) {
+        this.stoppingListeners.delete(listener);
+        if (this.stoppingListeners.size === 0) {
+            this.unlisten();
+        }
+    }
+    listen() {
+        if (this.listening) {
+            return;
+        }
+        this.listening = true;
+        this.host.on("message", this.onMessage);
+    }
+    unlisten() {
+        if (!this.listening) {
+            return;
+        }
+        this.listening = false;
+        this.host.off("message", this.onMessage);
+    }
+}
+function isStoppingMessage(message) {
+    return (typeof message === "object" &&
+        message !== null &&
+        "type" in message &&
+        message.type === simWatchMessages.stopping);
+}
+/**
+ * The watch runtime for this process.
+ *
+ * One per process rather than one per `SimAws`, because it is about the process
+ * a supervisor started, not about any one simulated environment. Several
+ * simulations in the same process all report to the same supervisor.
+ */
+export const simWatch = new SimWatchRuntime();
+//# sourceMappingURL=sim-watch-runtime.js.map

package/dist/watch/sim-watch-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-watch-runtime.js","sourceRoot":"","sources":["../../src/watch/sim-watch-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAoBzE;;;;;;;;;GASG;AACH,MAAM,OAAO,eAAe;IACT,IAAI,CAAkB;IACtB,iBAAiB,GAAG,IAAI,GAAG,EAA4B,CAAC;IACjE,SAAS,GAAG,KAAK,CAAC;IAET,SAAS,GAAG,CAAC,OAAgB,EAAQ,EAAE;QACtD,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC9C,QAAQ,EAAE,CAAC;QACb,CAAC;QAED,4EAA4E;QAC5E,2CAA2C;QAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC;IAEF,YAAY,UAAU,GAA8B,EAAE;QACpD,MAAM,EAAE,IAAI,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CACL,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,uBAAuB,CAAC;YACnD,cAAc,CAAC,wBAAwB;YACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CACrC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,YAAoB;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,EAAE,gBAAgB,CAAC,IAAI;YAC3B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,cAAc,CAAC,QAAgB;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAkC;QAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAkC;QAC5C,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,MAAM;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,OAAgB;IACzC,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,MAAM,IAAI,OAAO;QACjB,OAAO,CAAC,IAAI,KAAK,gBAAgB,CAAC,QAAQ,CAC3C,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/watch/sim-watch-settle.d.ts

@@ -0,0 +1,32 @@
+interface SimWatchSettleProperties {
+    readonly settleMs: number;
+    readonly onSettled: (changedPath: string) => void;
+}
+/**
+ * Turns a burst of writes into one change.
+ *
+ * Saving one file in an editor is several filesystem events: a temporary file
+ * written, renamed over the original, and often the directory touched as well.
+ * Acting on each of those would be several restarts, or several Stack updates,
+ * for one save, so the changes are held until they stop arriving.
+ *
+ * The path reported is the first of the burst, which is the one that actually
+ * changed rather than whatever the editor did around it.
+ */
+export declare class SimWatchSettle {
+    private readonly settleMs;
+    private readonly onSettled;
+    private pendingPath;
+    private timer;
+    constructor(properties: SimWatchSettleProperties);
+    /**
+     * Note a change, and wait to see whether more are coming.
+     */
+    record(changedPath: string): void;
+    /**
+     * Drop anything waiting, for a watcher that is shutting down.
+     */
+    cancel(): void;
+}
+export {};
+//# sourceMappingURL=sim-watch-settle.d.ts.map

package/dist/watch/sim-watch-settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-watch-settle.d.ts","sourceRoot":"","sources":["../../src/watch/sim-watch-settle.ts"],"names":[],"mappings":"AAAA,UAAU,wBAAwB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,KAAK,CAA6B;IAE1C,YAAY,UAAU,EAAE,wBAAwB,EAI/C;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAShC;IAED;;OAEG;IACH,MAAM,IAAI,IAAI,CAIb;CACF"}

package/dist/watch/sim-watch-settle.js

@@ -0,0 +1,43 @@
+/**
+ * Turns a burst of writes into one change.
+ *
+ * Saving one file in an editor is several filesystem events: a temporary file
+ * written, renamed over the original, and often the directory touched as well.
+ * Acting on each of those would be several restarts, or several Stack updates,
+ * for one save, so the changes are held until they stop arriving.
+ *
+ * The path reported is the first of the burst, which is the one that actually
+ * changed rather than whatever the editor did around it.
+ */
+export class SimWatchSettle {
+    settleMs;
+    onSettled;
+    pendingPath;
+    timer;
+    constructor(properties) {
+        const { settleMs, onSettled } = properties;
+        this.settleMs = settleMs;
+        this.onSettled = onSettled;
+    }
+    /**
+     * Note a change, and wait to see whether more are coming.
+     */
+    record(changedPath) {
+        this.pendingPath ??= changedPath;
+        const burstPath = this.pendingPath;
+        clearTimeout(this.timer);
+        this.timer = setTimeout(() => {
+            this.pendingPath = undefined;
+            this.onSettled(burstPath);
+        }, this.settleMs);
+    }
+    /**
+     * Drop anything waiting, for a watcher that is shutting down.
+     */
+    cancel() {
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        this.pendingPath = undefined;
+    }
+}
+//# sourceMappingURL=sim-watch-settle.js.map

package/dist/watch/sim-watch-settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-watch-settle.js","sourceRoot":"","sources":["../../src/watch/sim-watch-settle.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IACR,QAAQ,CAAS;IACjB,SAAS,CAAgC;IAClD,WAAW,CAAqB;IAChC,KAAK,CAA6B;IAE1C,YAAY,UAAoC;QAC9C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAmB;QACxB,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC;QAEnC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;CACF"}

package/dist/watch/sim-watch.config.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Configuration shared by `yulin watch` and the process it supervises.
+ */
+export declare const simWatchConfig: {
+    environmentVariableName: string;
+    environmentVariableValue: string;
+    settleMs: number;
+    stoppingMs: number;
+    exitMs: number;
+    selfInflictedMs: number;
+    loopRestarts: number;
+};
+/**
+ * The messages the supervisor and the supervised process send each other.
+ */
+export declare const simWatchMessages: {
+    readonly path: "yulin:watch-path";
+    readonly heldPath: "yulin:watch-held-path";
+    readonly stopping: "yulin:watch-stopping";
+    readonly stopped: "yulin:watch-stopped";
+};
+//# sourceMappingURL=sim-watch.config.d.ts.map

package/dist/watch/sim-watch.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-watch.config.d.ts","sourceRoot":"","sources":["../../src/watch/sim-watch.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,cAAc;IAIzB,uBAAuB;IACvB,wBAAwB;IAGxB,QAAQ;IAIR,UAAU;IAEV,MAAM;IAGN,eAAe;IAEf,YAAY;CACb,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;aAE3B,IAAI,EAAE,kBAAkB;aAGxB,QAAQ,EAAE,uBAAuB;aAEjC,QAAQ,EAAE,sBAAsB;aAEhC,OAAO,EAAE,qBAAqB;CACtB,CAAC"}