@kensio/yulin 1.6.0 → 1.7.0

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

@@ -0,0 +1,39 @@
+/**
+ * Configuration shared by `yulin watch` and the process it supervises.
+ */
+export const simWatchConfig = {
+    // Set on a supervised process, so the runtime in it knows there is a
+    // supervisor to talk to. Absent everywhere else, which is what makes watch
+    // mode inert unless it was asked for.
+    environmentVariableName: "YULIN_WATCH",
+    environmentVariableValue: "1",
+    // How long a burst of writes has to go quiet before it counts as one change.
+    // One save from an editor is several writes, and a rename over the original.
+    settleMs: 120,
+    // How long the supervisor waits for a process to say it has told its browsers
+    // a reload is coming. A process not running Yulin's runtime never answers, so
+    // this is a short wait rather than a requirement.
+    stoppingMs: 250,
+    // How long a process gets to exit on its own before it is killed outright.
+    exitMs: 2000,
+    // A change arriving sooner than this after a start is a change the process
+    // itself is likely to have made.
+    selfInflictedMs: 1500,
+    // How many self-inflicted restarts in a row before the loop is called.
+    loopRestarts: 3,
+};
+/**
+ * The messages the supervisor and the supervised process send each other.
+ */
+export const simWatchMessages = {
+    // Child to parent: a path Yulin is reading that is worth watching.
+    path: "yulin:watch-path",
+    // Child to parent: a path Yulin is watching itself and answering in place, so
+    // a change to it is not something to restart the process for.
+    heldPath: "yulin:watch-held-path",
+    // Parent to child: this process is about to be restarted.
+    stopping: "yulin:watch-stopping",
+    // Child to parent: the browsers have been told, go ahead.
+    stopped: "yulin:watch-stopped",
+};
+//# sourceMappingURL=sim-watch.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-watch.config.js","sourceRoot":"","sources":["../../src/watch/sim-watch.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,qEAAqE;IACrE,2EAA2E;IAC3E,sCAAsC;IACtC,uBAAuB,EAAE,aAAa;IACtC,wBAAwB,EAAE,GAAG;IAC7B,6EAA6E;IAC7E,6EAA6E;IAC7E,QAAQ,EAAE,GAAG;IACb,8EAA8E;IAC9E,8EAA8E;IAC9E,kDAAkD;IAClD,UAAU,EAAE,GAAG;IACf,2EAA2E;IAC3E,MAAM,EAAE,IAAI;IACZ,2EAA2E;IAC3E,iCAAiC;IACjC,eAAe,EAAE,IAAI;IACrB,uEAAuE;IACvE,YAAY,EAAE,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,mEAAmE;IACnE,IAAI,EAAE,kBAAkB;IACxB,8EAA8E;IAC9E,8DAA8D;IAC9D,QAAQ,EAAE,uBAAuB;IACjC,0DAA0D;IAC1D,QAAQ,EAAE,sBAAsB;IAChC,0DAA0D;IAC1D,OAAO,EAAE,qBAAqB;CACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": {
     "type": "git",
@@ -10,6 +10,9 @@
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "yulin": "./dist/cli/yulin.js"
+  },
   "keywords": [
     "aws",
     "test",

package/dist/service/cloudformation/error/sim-cloudfront.error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sim-cloudfront.error.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudformation/error/sim-cloudfront.error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAK7B,SAAS,EAAE,8BAA8B;IAJ3D,SAAgB,MAAM,YAAY;IAElC,YACE,OAAO,EAAE,MAAM,EACC,SAAS,GAAE,8BAAmC,EAG/D;CACF;AAED;;GAEG;AACH,qBAAa,uCAAwC,SAAQ,sBAAsB;IACjF,SAAyB,IAAI,4BAA4B;IAEzD,YAAY,OAAO,EAAE,MAAM,EAE1B;CACF"}

package/dist/service/cloudformation/error/sim-cloudfront.error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sim-cloudfront.error.js","sourceRoot":"","sources":["../../../../src/service/cloudformation/error/sim-cloudfront.error.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAK7B,SAAS;IAJX,MAAM,GAAG,QAAQ,CAAC;IAElC,YACE,OAAe,EACC,SAAS,GAAmC,EAAE;QAE9D,KAAK,CAAC,OAAO,CAAC,CAAC;yBAFC,SAAS;IAG3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uCAAwC,SAAQ,sBAAsB;IACxD,IAAI,GAAG,wBAAwB,CAAC;IAEzD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/service/cloudformation/stack/deploy/sim-cfn-stack-deployment-scheduler.d.ts

@@ -1,47 +0,0 @@
-import type { BackgroundScheduler } from "../../../../util/background/background.js";
-interface SimCfnStackDeploymentSchedulerProperties {
-    readonly background: BackgroundScheduler;
-    readonly failureMessage: string;
-}
-interface ScheduleDeploymentProperties {
-    readonly deploy: () => Promise<void>;
-    readonly onSuccess: () => void;
-    readonly onFailure: (error: Error) => void;
-}
-/**
- * Coordinates when Stack deployment work runs on the background scheduler.
- *
- * This class does not create CloudFormation resources, resolve resource
- * dependencies, or update Stack lifecycle state. SimCfnStackResourceCreator
- * owns dependency-ordered Resource creation, while
- * SimCfnStackDeploymentLifecycle owns Stack status, completion tracking, and
- * captured deployment errors.
- *
- * This scheduler only wraps a deployment task with background scheduling,
- * completion notification callbacks, and consistent non-Error conversion.
- */
-export declare class SimCfnStackDeploymentScheduler {
-    private readonly background;
-    private readonly failureMessage;
-    constructor(properties: SimCfnStackDeploymentSchedulerProperties);
-    /**
-     * Wait for already-scheduled background work before starting this deployment.
-     *
-     * Simulated Stack deployment should begin only after previously queued
-     * background tasks have had a chance to run, matching the broader simulator's
-     * deterministic sequencing model.
-     */
-    sequence(): Promise<void>;
-    /**
-     * Schedule the supplied deployment task and return a promise for its
-     * completion.
-     *
-     * The supplied `deploy` callback performs the actual Stack deployment work.
-     * This scheduler only decides when that callback runs, then reports the
-     * outcome via onSuccess or onFailure so the Stack can update its own status.
-     */
-    schedule(properties: ScheduleDeploymentProperties): Promise<void>;
-    private deploymentError;
-}
-export {};
-//# sourceMappingURL=sim-cfn-stack-deployment-scheduler.d.ts.map

package/dist/service/cloudformation/stack/deploy/sim-cfn-stack-deployment-scheduler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sim-cfn-stack-deployment-scheduler.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudformation/stack/deploy/sim-cfn-stack-deployment-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,UAAU,wCAAwC;IAChD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC5C;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,YAAY,UAAU,EAAE,wCAAwC,EAK/D;IAED;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAehE;IAED,OAAO,CAAC,eAAe;CAQxB"}

package/dist/service/cloudformation/stack/deploy/sim-cfn-stack-deployment-scheduler.js

@@ -1,64 +0,0 @@
-/**
- * Coordinates when Stack deployment work runs on the background scheduler.
- *
- * This class does not create CloudFormation resources, resolve resource
- * dependencies, or update Stack lifecycle state. SimCfnStackResourceCreator
- * owns dependency-ordered Resource creation, while
- * SimCfnStackDeploymentLifecycle owns Stack status, completion tracking, and
- * captured deployment errors.
- *
- * This scheduler only wraps a deployment task with background scheduling,
- * completion notification callbacks, and consistent non-Error conversion.
- */
-export class SimCfnStackDeploymentScheduler {
-    background;
-    failureMessage;
-    constructor(properties) {
-        const { background, failureMessage } = properties;
-        this.background = background;
-        this.failureMessage = failureMessage;
-    }
-    /**
-     * Wait for already-scheduled background work before starting this deployment.
-     *
-     * Simulated Stack deployment should begin only after previously queued
-     * background tasks have had a chance to run, matching the broader simulator's
-     * deterministic sequencing model.
-     */
-    async sequence() {
-        await this.background.sequence();
-    }
-    /**
-     * Schedule the supplied deployment task and return a promise for its
-     * completion.
-     *
-     * The supplied `deploy` callback performs the actual Stack deployment work.
-     * This scheduler only decides when that callback runs, then reports the
-     * outcome via onSuccess or onFailure so the Stack can update its own status.
-     */
-    schedule(properties) {
-        const { deploy, onSuccess, onFailure } = properties;
-        return new Promise((resolve) => {
-            this.background.schedule(async () => {
-                try {
-                    await deploy();
-                    onSuccess();
-                }
-                catch (error) {
-                    onFailure(this.deploymentError(error));
-                }
-                finally {
-                    resolve();
-                }
-            });
-        });
-    }
-    deploymentError(error) {
-        if (error instanceof Error) {
-            return error;
-        }
-        /* v8 ignore next -- redundant fallback */
-        return new Error(`${this.failureMessage}: ${String(error)}`);
-    }
-}
-//# sourceMappingURL=sim-cfn-stack-deployment-scheduler.js.map

package/dist/service/cloudformation/stack/deploy/sim-cfn-stack-deployment-scheduler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sim-cfn-stack-deployment-scheduler.js","sourceRoot":"","sources":["../../../../../src/service/cloudformation/stack/deploy/sim-cfn-stack-deployment-scheduler.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,8BAA8B;IACxB,UAAU,CAAsB;IAChC,cAAc,CAAS;IAExC,YAAY,UAAoD;QAC9D,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC;QAElD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAwC;QAC/C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;QAEpD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;gBAClC,IAAI,CAAC;oBACH,MAAM,MAAM,EAAE,CAAC;oBACf,SAAS,EAAE,CAAC;gBACd,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzC,CAAC;wBAAS,CAAC;oBACT,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,KAAc;QACpC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,0CAA0C;QAC1C,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,cAAc,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF"}