velocious 1.0.699 → 1.0.700

package/build/src/http-server/server-lock.d.ts

@@ -1,11 +1,18 @@
+import AdvisoryLockFileBackend from "../database/advisory-lock-file-backend.js";
 /**
- * Directory-based lock that allows only one HTTP server process per app directory.
+ * Directory-based lock that allows only one HTTP server process per app
+ * directory. Thin wrapper over the shared file-lock backend
+ * (`src/database/advisory-lock-file-backend.js` — the STC-210 `file` tier
+ * primitive generalized from this lock's original hand-rolled directory
+ * protocol), so the server lock and the advisory-lock file tier share one
+ * acquisition, owner-metadata, lease-renewal, and staleness implementation.
  */
 export default class VelociousHttpServerLock {
     configuration: import("../configuration.js").default;
     host: string;
     port: number;
     lockPath: string;
+    backend: AdvisoryLockFileBackend;
     acquired: boolean;
     /**
      * Build a lock for the configured application directory and server endpoint.
@@ -20,53 +27,22 @@ export default class VelociousHttpServerLock {
         port: number;
     });
     /**
-     * Acquires the app-directory HTTP server lock before startup side effects run.
+     * Acquires the app-directory HTTP server lock before startup side effects
+     * run. A stale lock (dead local owner or expired lease) is reclaimed by the
+     * backend; a live foreign owner fails loudly with the owner details.
      * @returns {Promise<void>} - Resolves after the lock has been acquired.
      */
     acquire(): Promise<void>;
-    /**
-     * Tries to create the lock directory and write owner metadata.
-     * @returns {Promise<boolean>} - Whether the lock was acquired.
-     */
-    tryAcquire(): Promise<boolean>;
     /**
      * Releases the held HTTP server lock directory.
      * @returns {Promise<void>} - Resolves after best-effort lock release.
      */
     release(): Promise<void>;
-    /**
-     * Writes metadata used to explain or reclaim an existing server lock.
-     * @returns {Promise<void>} - Resolves after owner metadata has been written.
-     */
-    writeOwnerMetadata(): Promise<void>;
-    /**
-     * Checks whether the current lock owner is a dead process on this host.
-     * @returns {Promise<boolean>} - Whether the existing lock belongs to a dead process.
-     */
-    isStale(): Promise<boolean>;
-    /**
-     * Runs is local process owner.
-     * @param {Record<string, ReturnType<typeof JSON.parse>> | null} owner - Existing lock owner metadata.
-     * @returns {boolean} - Whether owner metadata names a local process.
-     */
-    isLocalProcessOwner(owner: Record<string, ReturnType<typeof JSON.parse>> | null): boolean;
-    /**
-     * Runs owner hostname matches.
-     * @param {Record<string, ReturnType<typeof JSON.parse>>} owner - Existing lock owner metadata.
-     * @returns {boolean} - Whether the owner hostname is local or absent.
-     */
-    ownerHostnameMatches(owner: Record<string, ReturnType<typeof JSON.parse>>): boolean;
-    /**
-     * Runs process is dead.
-     * @param {number} pid - Process id.
-     * @returns {boolean} - Whether the process no longer exists.
-     */
-    processIsDead(pid: number): boolean;
     /**
      * Reads owner metadata from an existing server lock directory.
-     * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>> | null>} - Parsed owner metadata, when readable.
+     * @returns {Promise<import("../database/advisory-lock-file-backend.js").AdvisoryLockFileOwner | null>} - Parsed owner metadata, when readable.
      */
-    readOwnerMetadata(): Promise<Record<string, ReturnType<typeof JSON.parse>> | null>;
+    readOwnerMetadata(): Promise<import("../database/advisory-lock-file-backend.js").AdvisoryLockFileOwner | null>;
     /**
      * Builds a duplicate-server error message with owner details when available.
      * @returns {Promise<string>} - Error message explaining which server owns the lock.

package/build/src/http-server/server-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-lock.d.ts","sourceRoot":"","sources":["../../../src/http-server/server-lock.js"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IASnC,aAAa;IACb,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,QAAQ;IAZf;;;;;;OAMG;IACH,YAAY,EAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAC,EAJpC;QAAoD,aAAa,EAAzD,OAAO,qBAAqB,EAAE,OAAO,CAC7C;QAAqB,IAAI,EAAjB,MAAM,CACd;QAAqB,IAAI,EAAjB,MAAM,CAChB;KACsC,EAMtC;IAED;;;OAGG;IACG,OAAO,IAFA,OAAO,CAAC,IAAI,CAAC,CAmBzB;IAED;;;OAGG;IACG,UAAU,IAFH,OAAO,CAAC,OAAO,CAAC,CAmB5B;IAED;;;OAGG;IACG,OAAO,IAFA,OAAO,CAAC,IAAI,CAAC,CAOzB;IAED;;;OAGG;IACG,kBAAkB,IAFX,OAAO,CAAC,IAAI,CAAC,CAUzB;IAED;;;OAGG;IACG,OAAO,IAFA,OAAO,CAAC,OAAO,CAAC,CAQ5B;IAED;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAHd,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAGlC,GAFZ,OAAO,CAOnB;IAED;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAHf,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAG7B,GAFb,OAAO,CAOnB;IAED;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAHN,MAGM,GAFJ,OAAO,CAUnB;IAED;;;OAGG;IACG,iBAAiB,IAFV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAUzE;IAED;;;OAGG;IACG,eAAe,IAFR,OAAO,CAAC,MAAM,CAAC,CAS3B;CACF"}
+{"version":3,"file":"server-lock.d.ts","sourceRoot":"","sources":["../../../src/http-server/server-lock.js"],"names":[],"mappings":"AAEA,OAAO,uBAAuB,MAAM,2CAA2C,CAAA;AAG/E;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IASnC,aAAa;IACb,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,OAAO;IAKP,QAAQ;IAjBf;;;;;;OAMG;IACH,YAAY,EAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAC,EAJpC;QAAoD,aAAa,EAAzD,OAAO,qBAAqB,EAAE,OAAO,CAC7C;QAAqB,IAAI,EAAjB,MAAM,CACd;QAAqB,IAAI,EAAjB,MAAM,CAChB;KACsC,EAWtC;IAED;;;;;OAKG;IACG,OAAO,IAFA,OAAO,CAAC,IAAI,CAAC,CAQzB;IAED;;;OAGG;IACG,OAAO,IAFA,OAAO,CAAC,IAAI,CAAC,CAOzB;IAED;;;OAGG;IACG,iBAAiB,IAFV,OAAO,CAAC,OAAO,2CAA2C,EAAE,qBAAqB,GAAG,IAAI,CAAC,CAIrG;IAED;;;OAGG;IACG,eAAe,IAFR,OAAO,CAAC,MAAM,CAAC,CAS3B;CACF"}

package/build/src/http-server/server-lock.js

@@ -1,9 +1,13 @@
 // @ts-check
-import fs from "node:fs/promises";
-import os from "node:os";
+import AdvisoryLockFileBackend from "../database/advisory-lock-file-backend.js";
 import path from "node:path";
 /**
- * Directory-based lock that allows only one HTTP server process per app directory.
+ * Directory-based lock that allows only one HTTP server process per app
+ * directory. Thin wrapper over the shared file-lock backend
+ * (`src/database/advisory-lock-file-backend.js` — the STC-210 `file` tier
+ * primitive generalized from this lock's original hand-rolled directory
+ * protocol), so the server lock and the advisory-lock file tier share one
+ * acquisition, owner-metadata, lease-renewal, and staleness implementation.
  */
 export default class VelociousHttpServerLock {
     /**
@@ -18,48 +22,24 @@ export default class VelociousHttpServerLock {
         this.host = host;
         this.port = port;
         this.lockPath = path.join(configuration.getDirectory(), "tmp", "server.lock");
+        this.backend = new AdvisoryLockFileBackend({
+            directory: path.join(configuration.getDirectory(), "tmp"),
+            extraOwnerFields: { host: this.host, port: this.port },
+            pathStyle: "plain"
+        });
         this.acquired = false;
     }
     /**
-     * Acquires the app-directory HTTP server lock before startup side effects run.
+     * Acquires the app-directory HTTP server lock before startup side effects
+     * run. A stale lock (dead local owner or expired lease) is reclaimed by the
+     * backend; a live foreign owner fails loudly with the owner details.
      * @returns {Promise<void>} - Resolves after the lock has been acquired.
      */
     async acquire() {
-        await fs.mkdir(path.dirname(this.lockPath), { recursive: true });
-        while (true) {
-            const acquired = await this.tryAcquire();
-            if (acquired) {
-                return;
-            }
-            if (await this.isStale()) {
-                await fs.rm(this.lockPath, { recursive: true, force: true });
-                continue;
-            }
+        const acquired = await this.backend.acquire("server", { timeoutMs: 0 });
+        if (!acquired)
             throw new Error(await this.lockHeldMessage());
-        }
-    }
-    /**
-     * Tries to create the lock directory and write owner metadata.
-     * @returns {Promise<boolean>} - Whether the lock was acquired.
-     */
-    async tryAcquire() {
-        try {
-            await fs.mkdir(this.lockPath);
-        }
-        catch (error) {
-            if ( /** @type {{code?: string}} */(error).code === "EEXIST")
-                return false;
-            throw error;
-        }
-        try {
-            await this.writeOwnerMetadata();
-            this.acquired = true;
-            return true;
-        }
-        catch (error) {
-            await fs.rm(this.lockPath, { recursive: true, force: true });
-            throw error;
-        }
+        this.acquired = true;
     }
     /**
      * Releases the held HTTP server lock directory.
@@ -69,81 +49,14 @@ export default class VelociousHttpServerLock {
         if (!this.acquired)
             return;
         this.acquired = false;
-        await fs.rm(this.lockPath, { recursive: true, force: true });
-    }
-    /**
-     * Writes metadata used to explain or reclaim an existing server lock.
-     * @returns {Promise<void>} - Resolves after owner metadata has been written.
-     */
-    async writeOwnerMetadata() {
-        await fs.writeFile(path.join(this.lockPath, "owner.json"), JSON.stringify({
-            acquiredAt: new Date().toISOString(),
-            host: this.host,
-            hostname: os.hostname(),
-            pid: process.pid,
-            port: this.port
-        }));
-    }
-    /**
-     * Checks whether the current lock owner is a dead process on this host.
-     * @returns {Promise<boolean>} - Whether the existing lock belongs to a dead process.
-     */
-    async isStale() {
-        const owner = await this.readOwnerMetadata();
-        if (!this.isLocalProcessOwner(owner))
-            return false;
-        return this.processIsDead(/** @type {{pid: number}} */ (owner).pid);
-    }
-    /**
-     * Runs is local process owner.
-     * @param {Record<string, ReturnType<typeof JSON.parse>> | null} owner - Existing lock owner metadata.
-     * @returns {boolean} - Whether owner metadata names a local process.
-     */
-    isLocalProcessOwner(owner) {
-        if (!owner)
-            return false;
-        if (typeof owner.pid !== "number")
-            return false;
-        return this.ownerHostnameMatches(owner);
-    }
-    /**
-     * Runs owner hostname matches.
-     * @param {Record<string, ReturnType<typeof JSON.parse>>} owner - Existing lock owner metadata.
-     * @returns {boolean} - Whether the owner hostname is local or absent.
-     */
-    ownerHostnameMatches(owner) {
-        if (!owner.hostname)
-            return true;
-        if (owner.hostname === os.hostname())
-            return true;
-        return false;
-    }
-    /**
-     * Runs process is dead.
-     * @param {number} pid - Process id.
-     * @returns {boolean} - Whether the process no longer exists.
-     */
-    processIsDead(pid) {
-        try {
-            process.kill(pid, 0);
-            return false;
-        }
-        catch (error) {
-            return /** @type {{code?: string}} */ (error).code === "ESRCH";
-        }
+        await this.backend.release("server");
     }
     /**
      * Reads owner metadata from an existing server lock directory.
-     * @returns {Promise<Record<string, ReturnType<typeof JSON.parse>> | null>} - Parsed owner metadata, when readable.
+     * @returns {Promise<import("../database/advisory-lock-file-backend.js").AdvisoryLockFileOwner | null>} - Parsed owner metadata, when readable.
      */
     async readOwnerMetadata() {
-        try {
-            const rawOwner = await fs.readFile(path.join(this.lockPath, "owner.json"), "utf8");
-            return /** @type {Record<string, ReturnType<typeof JSON.parse>>} */ (JSON.parse(rawOwner));
-        }
-        catch {
-            return null;
-        }
+        return await this.backend.holderInfo("server");
     }
     /**
      * Builds a duplicate-server error message with owner details when available.
@@ -157,4 +70,4 @@ export default class VelociousHttpServerLock {
         return `A Velocious HTTP server is already running for this application (${details}). Remove ${this.lockPath} if the server is no longer running.`;
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmVyLWxvY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaHR0cC1zZXJ2ZXIvc2VydmVyLWxvY2suanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBRSxNQUFNLGtCQUFrQixDQUFBO0FBQ2pDLE9BQU8sRUFBRSxNQUFNLFNBQVMsQ0FBQTtBQUN4QixPQUFPLElBQUksTUFBTSxXQUFXLENBQUE7QUFFNUI7O0dBRUc7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLHVCQUF1QjtJQUMxQzs7Ozs7O09BTUc7SUFDSCxZQUFZLEVBQUMsYUFBYSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUM7UUFDckMsSUFBSSxDQUFDLGFBQWEsR0FBRyxhQUFhLENBQUE7UUFDbEMsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxZQUFZLEVBQUUsRUFBRSxLQUFLLEVBQUUsYUFBYSxDQUFDLENBQUE7UUFDN0UsSUFBSSxDQUFDLFFBQVEsR0FBRyxLQUFLLENBQUE7SUFDdkIsQ0FBQztJQUVEOzs7T0FHRztJQUNILEtBQUssQ0FBQyxPQUFPO1FBQ1gsTUFBTSxFQUFFLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxFQUFFLEVBQUMsU0FBUyxFQUFFLElBQUksRUFBQyxDQUFDLENBQUE7UUFFOUQsT0FBTyxJQUFJLEVBQUUsQ0FBQztZQUNaLE1BQU0sUUFBUSxHQUFHLE1BQU0sSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFBO1lBRXhDLElBQUksUUFBUSxFQUFFLENBQUM7Z0JBQ2IsT0FBTTtZQUNSLENBQUM7WUFFRCxJQUFJLE1BQU0sSUFBSSxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUM7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Q0FBQyxJQUFJLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUc7WUFDdkcsQ0FBQyxDQUFDLGtCQUFrQixJQUFJLENBQUMsUUFBUSxFQUFFLENBQUE7UUFFckMsT0FBTyxvRUFBb0UsT0FBTyxhQUFhLElBQUksQ0FBQyxRQUFRLHNDQUFzQyxDQUFBO0lBQ3BKLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgZnMgZnJvbSBcIm5vZGU6ZnMvcHJvbWlzZXNcIlxuaW1wb3J0IG9zIGZyb20gXCJub2RlOm9zXCJcbmltcG9ydCBwYXRoIGZyb20gXCJub2RlOnBhdGhcIlxuXG4vKipcbiAqIERpcmVjdG9yeS1iYXNlZCBsb2NrIHRoYXQgYWxsb3dzIG9ubHkgb25lIEhUVFAgc2VydmVyIHByb2Nlc3MgcGVyIGFwcCBkaXJlY3RvcnkuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFZlbG9jaW91c0h0dHBTZXJ2ZXJMb2NrIHtcbiAgLyoqXG4gICAqIEJ1aWxkIGEgbG9jayBmb3IgdGhlIGNvbmZpZ3VyZWQgYXBwbGljYXRpb24gZGlyZWN0b3J5IGFuZCBzZXJ2ZXIgZW5kcG9pbnQuXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gT3B0aW9ucyBvYmplY3QuXG4gICAqIEBwYXJhbSB7aW1wb3J0KFwiLi4vY29uZmlndXJhdGlvbi5qc1wiKS5kZWZhdWx0fSBhcmdzLmNvbmZpZ3VyYXRpb24gLSBDb25maWd1cmF0aW9uIHRoYXQgb3ducyB0aGUgYXBwbGljYXRpb24gZGlyZWN0b3J5LlxuICAgKiBAcGFyYW0ge3N0cmluZ30gYXJncy5ob3N0IC0gQ29uZmlndXJlZCBIVFRQIGhvc3QuXG4gICAqIEBwYXJhbSB7bnVtYmVyfSBhcmdzLnBvcnQgLSBDb25maWd1cmVkIEhUVFAgcG9ydC5cbiAgICovXG4gIGNvbnN0cnVjdG9yKHtjb25maWd1cmF0aW9uLCBob3N0LCBwb3J0fSkge1xuICAgIHRoaXMuY29uZmlndXJhdGlvbiA9IGNvbmZpZ3VyYXRpb25cbiAgICB0aGlzLmhvc3QgPSBob3N0XG4gICAgdGhpcy5wb3J0ID0gcG9ydFxuICAgIHRoaXMubG9ja1BhdGggPSBwYXRoLmpvaW4oY29uZmlndXJhdGlvbi5nZXREaXJlY3RvcnkoKSwgXCJ0bXBcIiwgXCJzZXJ2ZXIubG9ja1wiKVxuICAgIHRoaXMuYWNxdWlyZWQgPSBmYWxzZVxuICB9XG5cbiAgLyoqXG4gICAqIEFjcXVpcmVzIHRoZSBhcHAtZGlyZWN0b3J5IEhUVFAgc2VydmVyIGxvY2sgYmVmb3JlIHN0YXJ0dXAgc2lkZSBlZmZlY3RzIHJ1bi5cbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgYWZ0ZXIgdGhlIGxvY2sgaGFzIGJlZW4gYWNxdWlyZWQuXG4gICAqL1xuICBhc3luYyBhY3F1aXJlKCkge1xuICAgIGF3YWl0IGZzLm1rZGlyKHBhdGguZGlybmFtZSh0aGlzLmxvY2tQYXRoKSwge3JlY3Vyc2l2ZTogdHJ1ZX0pXG5cbiAgICB3aGlsZSAodHJ1ZSkge1xuICAgICAgY29uc3QgYWNxdWlyZWQgPSBhd2FpdCB0aGlzLnRyeUFjcXVpcmUoKVxuXG4gICAgICBpZiAoYWNxdWlyZWQpIHtcbiAgICAgICAgcmV0dXJuXG4gICAgICB9XG5cbiAgICAgIGlmIChhd2FpdCB0aGlzLmlzU3RhbGUoKSkge1xuICAgICAgICBhd2FpdCBmcy5ybSh0aGlzLmxvY2tQYXRoLCB7cmVjdXJzaXZlOiB0cnVlLCBmb3JjZTogdHJ1ZX0pXG4gICAgICAgIGNvbnRpbnVlXG4gICAgICB9XG5cbiAgICAgIHRocm93IG5ldyBFcnJvcihhd2FpdCB0aGlzLmxvY2tIZWxkTWVzc2FnZSgpKVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBUcmllcyB0byBjcmVhdGUgdGhlIGxvY2sgZGlyZWN0b3J5IGFuZCB3cml0ZSBvd25lciBtZXRhZGF0YS5cbiAgICogQHJldHVybnMge1Byb21pc2U8Ym9vbGVhbj59IC0gV2hldGhlciB0aGUgbG9jayB3YXMgYWNxdWlyZWQuXG4gICAqL1xuICBhc3luYyB0cnlBY3F1aXJlKCkge1xuICAgIHRyeSB7XG4gICAgICBhd2FpdCBmcy5ta2Rpcih0aGlzLmxvY2tQYXRoKVxuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICBpZiAoLyoqIEB0eXBlIHt7Y29kZT86IHN0cmluZ319ICovIChlcnJvcikuY29kZSA9PT0gXCJFRVhJU1RcIikgcmV0dXJuIGZhbHNlXG4gICAgICB0aHJvdyBlcnJvclxuICAgIH1cblxuICAgIHRyeSB7XG4gICAgICBhd2FpdCB0aGlzLndyaXRlT3duZXJNZXRhZGF0YSgpXG4gICAgICB0aGlzLmFjcXVpcmVkID0gdHJ1ZVxuXG4gICAgICByZXR1cm4gdHJ1ZVxuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICBhd2FpdCBmcy5ybSh0aGlzLmxvY2tQYXRoLCB7cmVjdXJzaXZlOiB0cnVlLCBmb3JjZTogdHJ1ZX0pXG4gICAgICB0aHJvdyBlcnJvclxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZWxlYXNlcyB0aGUgaGVsZCBIVFRQIHNlcnZlciBsb2NrIGRpcmVjdG9yeS5cbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgYWZ0ZXIgYmVzdC1lZmZvcnQgbG9jayByZWxlYXNlLlxuICAgKi9cbiAgYXN5bmMgcmVsZWFzZSgpIHtcbiAgICBpZiAoIXRoaXMuYWNxdWlyZWQpIHJldHVyblxuXG4gICAgdGhpcy5hY3F1aXJlZCA9IGZhbHNlXG4gICAgYXdhaXQgZnMucm0odGhpcy5sb2NrUGF0aCwge3JlY3Vyc2l2ZTogdHJ1ZSwgZm9yY2U6IHRydWV9KVxuICB9XG5cbiAgLyoqXG4gICAqIFdyaXRlcyBtZXRhZGF0YSB1c2VkIHRvIGV4cGxhaW4gb3IgcmVjbGFpbSBhbiBleGlzdGluZyBzZXJ2ZXIgbG9jay5cbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgYWZ0ZXIgb3duZXIgbWV0YWRhdGEgaGFzIGJlZW4gd3JpdHRlbi5cbiAgICovXG4gIGFzeW5jIHdyaXRlT3duZXJNZXRhZGF0YSgpIHtcbiAgICBhd2FpdCBmcy53cml0ZUZpbGUocGF0aC5qb2luKHRoaXMubG9ja1BhdGgsIFwib3duZXIuanNvblwiKSwgSlNPTi5zdHJpbmdpZnkoe1xuICAgICAgYWNxdWlyZWRBdDogbmV3IERhdGUoKS50b0lTT1N0cmluZygpLFxuICAgICAgaG9zdDogdGhpcy5ob3N0LFxuICAgICAgaG9zdG5hbWU6IG9zLmhvc3RuYW1lKCksXG4gICAgICBwaWQ6IHByb2Nlc3MucGlkLFxuICAgICAgcG9ydDogdGhpcy5wb3J0XG4gICAgfSkpXG4gIH1cblxuICAvKipcbiAgICogQ2hlY2tzIHdoZXRoZXIgdGhlIGN1cnJlbnQgbG9jayBvd25lciBpcyBhIGRlYWQgcHJvY2VzcyBvbiB0aGlzIGhvc3QuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPGJvb2xlYW4+fSAtIFdoZXRoZXIgdGhlIGV4aXN0aW5nIGxvY2sgYmVsb25ncyB0byBhIGRlYWQgcHJvY2Vzcy5cbiAgICovXG4gIGFzeW5jIGlzU3RhbGUoKSB7XG4gICAgY29uc3Qgb3duZXIgPSBhd2FpdCB0aGlzLnJlYWRPd25lck1ldGFkYXRhKClcblxuICAgIGlmICghdGhpcy5pc0xvY2FsUHJvY2Vzc093bmVyKG93bmVyKSkgcmV0dXJuIGZhbHNlXG5cbiAgICByZXR1cm4gdGhpcy5wcm9jZXNzSXNEZWFkKC8qKiBAdHlwZSB7e3BpZDogbnVtYmVyfX0gKi8gKG93bmVyKS5waWQpXG4gIH1cblxuICAvKipcbiAgICogUnVucyBpcyBsb2NhbCBwcm9jZXNzIG93bmVyLlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIFJldHVyblR5cGU8dHlwZW9mIEpTT04ucGFyc2U+PiB8IG51bGx9IG93bmVyIC0gRXhpc3RpbmcgbG9jayBvd25lciBtZXRhZGF0YS5cbiAgICogQHJldHVybnMge2Jvb2xlYW59IC0gV2hldGhlciBvd25lciBtZXRhZGF0YSBuYW1lcyBhIGxvY2FsIHByb2Nlc3MuXG4gICAqL1xuICBpc0xvY2FsUHJvY2Vzc093bmVyKG93bmVyKSB7XG4gICAgaWYgKCFvd25lcikgcmV0dXJuIGZhbHNlXG4gICAgaWYgKHR5cGVvZiBvd25lci5waWQgIT09IFwibnVtYmVyXCIpIHJldHVybiBmYWxzZVxuXG4gICAgcmV0dXJuIHRoaXMub3duZXJIb3N0bmFtZU1hdGNoZXMob3duZXIpXG4gIH1cblxuICAvKipcbiAgICogUnVucyBvd25lciBob3N0bmFtZSBtYXRjaGVzLlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIFJldHVyblR5cGU8dHlwZW9mIEpTT04ucGFyc2U+Pn0gb3duZXIgLSBFeGlzdGluZyBsb2NrIG93bmVyIG1ldGFkYXRhLlxuICAgKiBAcmV0dXJucyB7Ym9vbGVhbn0gLSBXaGV0aGVyIHRoZSBvd25lciBob3N0bmFtZSBpcyBsb2NhbCBvciBhYnNlbnQuXG4gICAqL1xuICBvd25lckhvc3RuYW1lTWF0Y2hlcyhvd25lcikge1xuICAgIGlmICghb3duZXIuaG9zdG5hbWUpIHJldHVybiB0cnVlXG4gICAgaWYgKG93bmVyLmhvc3RuYW1lID09PSBvcy5ob3N0bmFtZSgpKSByZXR1cm4gdHJ1ZVxuXG4gICAgcmV0dXJuIGZhbHNlXG4gIH1cblxuICAvKipcbiAgICogUnVucyBwcm9jZXNzIGlzIGRlYWQuXG4gICAqIEBwYXJhbSB7bnVtYmVyfSBwaWQgLSBQcm9jZXNzIGlkLlxuICAgKiBAcmV0dXJucyB7Ym9vbGVhbn0gLSBXaGV0aGVyIHRoZSBwcm9jZXNzIG5vIGxvbmdlciBleGlzdHMuXG4gICAqL1xuICBwcm9jZXNzSXNEZWFkKHBpZCkge1xuICAgIHRyeSB7XG4gICAgICBwcm9jZXNzLmtpbGwocGlkLCAwKVxuXG4gICAgICByZXR1cm4gZmFsc2VcbiAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgcmV0dXJuIC8qKiBAdHlwZSB7e2NvZGU/OiBzdHJpbmd9fSAqLyAoZXJyb3IpLmNvZGUgPT09IFwiRVNSQ0hcIlxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZWFkcyBvd25lciBtZXRhZGF0YSBmcm9tIGFuIGV4aXN0aW5nIHNlcnZlciBsb2NrIGRpcmVjdG9yeS5cbiAgICogQHJldHVybnMge1Byb21pc2U8UmVjb3JkPHN0cmluZywgUmV0dXJuVHlwZTx0eXBlb2YgSlNPTi5wYXJzZT4+IHwgbnVsbD59IC0gUGFyc2VkIG93bmVyIG1ldGFkYXRhLCB3aGVuIHJlYWRhYmxlLlxuICAgKi9cbiAgYXN5bmMgcmVhZE93bmVyTWV0YWRhdGEoKSB7XG4gICAgdHJ5IHtcbiAgICAgIGNvbnN0IHJhd093bmVyID0gYXdhaXQgZnMucmVhZEZpbGUocGF0aC5qb2luKHRoaXMubG9ja1BhdGgsIFwib3duZXIuanNvblwiKSwgXCJ1dGY4XCIpXG5cbiAgICAgIHJldHVybiAvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsIFJldHVyblR5cGU8dHlwZW9mIEpTT04ucGFyc2U+Pn0gKi8gKEpTT04ucGFyc2UocmF3T3duZXIpKVxuICAgIH0gY2F0Y2gge1xuICAgICAgcmV0dXJuIG51bGxcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogQnVpbGRzIGEgZHVwbGljYXRlLXNlcnZlciBlcnJvciBtZXNzYWdlIHdpdGggb3duZXIgZGV0YWlscyB3aGVuIGF2YWlsYWJsZS5cbiAgICogQHJldHVybnMge1Byb21pc2U8c3RyaW5nPn0gLSBFcnJvciBtZXNzYWdlIGV4cGxhaW5pbmcgd2hpY2ggc2VydmVyIG93bnMgdGhlIGxvY2suXG4gICAqL1xuICBhc3luYyBsb2NrSGVsZE1lc3NhZ2UoKSB7XG4gICAgY29uc3Qgb3duZXIgPSBhd2FpdCB0aGlzLnJlYWRPd25lck1ldGFkYXRhKClcbiAgICBjb25zdCBkZXRhaWxzID0gb3duZXJcbiAgICAgID8gYFBJRCAke1N0cmluZyhvd25lci5waWQpfSBvbiAke1N0cmluZyhvd25lci5ob3N0bmFtZSl9ICgke1N0cmluZyhvd25lci5ob3N0KX06JHtTdHJpbmcob3duZXIucG9ydCl9KWBcbiAgICAgIDogYGxvY2sgZGlyZWN0b3J5ICR7dGhpcy5sb2NrUGF0aH1gXG5cbiAgICByZXR1cm4gYEEgVmVsb2Npb3VzIEhUVFAgc2VydmVyIGlzIGFscmVhZHkgcnVubmluZyBmb3IgdGhpcyBhcHBsaWNhdGlvbiAoJHtkZXRhaWxzfSkuIFJlbW92ZSAke3RoaXMubG9ja1BhdGh9IGlmIHRoZSBzZXJ2ZXIgaXMgbm8gbG9uZ2VyIHJ1bm5pbmcuYFxuICB9XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmVyLWxvY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaHR0cC1zZXJ2ZXIvc2VydmVyLWxvY2suanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sdUJBQXVCLE1BQU0sMkNBQTJDLENBQUE7QUFDL0UsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFBO0FBRTVCOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLHVCQUF1QjtJQUMxQzs7Ozs7O09BTUc7SUFDSCxZQUFZLEVBQUMsYUFBYSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUM7UUFDckMsSUFBSSxDQUFDLGFBQWEsR0FBRyxhQUFhLENBQUE7UUFDbEMsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxZQUFZLEVBQUUsRUFBRSxLQUFLLEVBQUUsYUFBYSxDQUFDLENBQUE7UUFDN0UsSUFBSSxDQUFDLE9BQU8sR0FBRyxJQUFJLHVCQUF1QixDQUFDO1lBQ3pDLFNBQVMsRUFBRSxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxZQUFZLEVBQUUsRUFBRSxLQUFLLENBQUM7WUFDekQsZ0JBQWdCLEVBQUUsRUFBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBQztZQUNwRCxTQUFTLEVBQUUsT0FBTztTQUNuQixDQUFDLENBQUE7UUFDRixJQUFJLENBQUMsUUFBUSxHQUFHLEtBQUssQ0FBQTtJQUN2QixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxLQUFLLENBQUMsT0FBTztRQUNYLE1BQU0sUUFBUSxHQUFHLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsUUFBUSxFQUFFLEVBQUMsU0FBUyxFQUFFLENBQUMsRUFBQyxDQUFDLENBQUE7UUFFckUsSUFBSSxDQUFDLFFBQVE7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLE1BQU0sSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDLENBQUE7UUFFNUQsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUE7SUFDdEIsQ0FBQztJQUVEOzs7T0FHRztJQUNILEtBQUssQ0FBQyxPQUFPO1FBQ1gsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRO1lBQUUsT0FBTTtRQUUxQixJQUFJLENBQUMsUUFBUSxHQUFHLEtBQUssQ0FBQTtRQUNyQixNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFBO0lBQ3RDLENBQUM7SUFFRDs7O09BR0c7SUFDSCxLQUFLLENBQUMsaUJBQWlCO1FBQ3JCLE9BQU8sTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsQ0FBQTtJQUNoRCxDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLGVBQWU7UUFDbkIsTUFBTSxLQUFLLEdBQUcsTUFBTSxJQUFJLENBQUMsaUJBQWlCLEVBQUUsQ0FBQTtRQUM1QyxNQUFNLE9BQU8sR0FBRyxLQUFLO1lBQ25CLENBQUMsQ0FBQyxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sTUFBTSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsS0FBSyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUc7WUFDdkcsQ0FBQyxDQUFDLGtCQUFrQixJQUFJLENBQUMsUUFBUSxFQUFFLENBQUE7UUFFckMsT0FBTyxvRUFBb0UsT0FBTyxhQUFhLElBQUksQ0FBQyxRQUFRLHNDQUFzQyxDQUFBO0lBQ3BKLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgQWR2aXNvcnlMb2NrRmlsZUJhY2tlbmQgZnJvbSBcIi4uL2RhdGFiYXNlL2Fkdmlzb3J5LWxvY2stZmlsZS1iYWNrZW5kLmpzXCJcbmltcG9ydCBwYXRoIGZyb20gXCJub2RlOnBhdGhcIlxuXG4vKipcbiAqIERpcmVjdG9yeS1iYXNlZCBsb2NrIHRoYXQgYWxsb3dzIG9ubHkgb25lIEhUVFAgc2VydmVyIHByb2Nlc3MgcGVyIGFwcFxuICogZGlyZWN0b3J5LiBUaGluIHdyYXBwZXIgb3ZlciB0aGUgc2hhcmVkIGZpbGUtbG9jayBiYWNrZW5kXG4gKiAoYHNyYy9kYXRhYmFzZS9hZHZpc29yeS1sb2NrLWZpbGUtYmFja2VuZC5qc2Ag4oCUIHRoZSBTVEMtMjEwIGBmaWxlYCB0aWVyXG4gKiBwcmltaXRpdmUgZ2VuZXJhbGl6ZWQgZnJvbSB0aGlzIGxvY2sncyBvcmlnaW5hbCBoYW5kLXJvbGxlZCBkaXJlY3RvcnlcbiAqIHByb3RvY29sKSwgc28gdGhlIHNlcnZlciBsb2NrIGFuZCB0aGUgYWR2aXNvcnktbG9jayBmaWxlIHRpZXIgc2hhcmUgb25lXG4gKiBhY3F1aXNpdGlvbiwgb3duZXItbWV0YWRhdGEsIGxlYXNlLXJlbmV3YWwsIGFuZCBzdGFsZW5lc3MgaW1wbGVtZW50YXRpb24uXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFZlbG9jaW91c0h0dHBTZXJ2ZXJMb2NrIHtcbiAgLyoqXG4gICAqIEJ1aWxkIGEgbG9jayBmb3IgdGhlIGNvbmZpZ3VyZWQgYXBwbGljYXRpb24gZGlyZWN0b3J5IGFuZCBzZXJ2ZXIgZW5kcG9pbnQuXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gT3B0aW9ucyBvYmplY3QuXG4gICAqIEBwYXJhbSB7aW1wb3J0KFwiLi4vY29uZmlndXJhdGlvbi5qc1wiKS5kZWZhdWx0fSBhcmdzLmNvbmZpZ3VyYXRpb24gLSBDb25maWd1cmF0aW9uIHRoYXQgb3ducyB0aGUgYXBwbGljYXRpb24gZGlyZWN0b3J5LlxuICAgKiBAcGFyYW0ge3N0cmluZ30gYXJncy5ob3N0IC0gQ29uZmlndXJlZCBIVFRQIGhvc3QuXG4gICAqIEBwYXJhbSB7bnVtYmVyfSBhcmdzLnBvcnQgLSBDb25maWd1cmVkIEhUVFAgcG9ydC5cbiAgICovXG4gIGNvbnN0cnVjdG9yKHtjb25maWd1cmF0aW9uLCBob3N0LCBwb3J0fSkge1xuICAgIHRoaXMuY29uZmlndXJhdGlvbiA9IGNvbmZpZ3VyYXRpb25cbiAgICB0aGlzLmhvc3QgPSBob3N0XG4gICAgdGhpcy5wb3J0ID0gcG9ydFxuICAgIHRoaXMubG9ja1BhdGggPSBwYXRoLmpvaW4oY29uZmlndXJhdGlvbi5nZXREaXJlY3RvcnkoKSwgXCJ0bXBcIiwgXCJzZXJ2ZXIubG9ja1wiKVxuICAgIHRoaXMuYmFja2VuZCA9IG5ldyBBZHZpc29yeUxvY2tGaWxlQmFja2VuZCh7XG4gICAgICBkaXJlY3Rvcnk6IHBhdGguam9pbihjb25maWd1cmF0aW9uLmdldERpcmVjdG9yeSgpLCBcInRtcFwiKSxcbiAgICAgIGV4dHJhT3duZXJGaWVsZHM6IHtob3N0OiB0aGlzLmhvc3QsIHBvcnQ6IHRoaXMucG9ydH0sXG4gICAgICBwYXRoU3R5bGU6IFwicGxhaW5cIlxuICAgIH0pXG4gICAgdGhpcy5hY3F1aXJlZCA9IGZhbHNlXG4gIH1cblxuICAvKipcbiAgICogQWNxdWlyZXMgdGhlIGFwcC1kaXJlY3RvcnkgSFRUUCBzZXJ2ZXIgbG9jayBiZWZvcmUgc3RhcnR1cCBzaWRlIGVmZmVjdHNcbiAgICogcnVuLiBBIHN0YWxlIGxvY2sgKGRlYWQgbG9jYWwgb3duZXIgb3IgZXhwaXJlZCBsZWFzZSkgaXMgcmVjbGFpbWVkIGJ5IHRoZVxuICAgKiBiYWNrZW5kOyBhIGxpdmUgZm9yZWlnbiBvd25lciBmYWlscyBsb3VkbHkgd2l0aCB0aGUgb3duZXIgZGV0YWlscy5cbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgYWZ0ZXIgdGhlIGxvY2sgaGFzIGJlZW4gYWNxdWlyZWQuXG4gICAqL1xuICBhc3luYyBhY3F1aXJlKCkge1xuICAgIGNvbnN0IGFjcXVpcmVkID0gYXdhaXQgdGhpcy5iYWNrZW5kLmFjcXVpcmUoXCJzZXJ2ZXJcIiwge3RpbWVvdXRNczogMH0pXG5cbiAgICBpZiAoIWFjcXVpcmVkKSB0aHJvdyBuZXcgRXJyb3IoYXdhaXQgdGhpcy5sb2NrSGVsZE1lc3NhZ2UoKSlcblxuICAgIHRoaXMuYWNxdWlyZWQgPSB0cnVlXG4gIH1cblxuICAvKipcbiAgICogUmVsZWFzZXMgdGhlIGhlbGQgSFRUUCBzZXJ2ZXIgbG9jayBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fSAtIFJlc29sdmVzIGFmdGVyIGJlc3QtZWZmb3J0IGxvY2sgcmVsZWFzZS5cbiAgICovXG4gIGFzeW5jIHJlbGVhc2UoKSB7XG4gICAgaWYgKCF0aGlzLmFjcXVpcmVkKSByZXR1cm5cblxuICAgIHRoaXMuYWNxdWlyZWQgPSBmYWxzZVxuICAgIGF3YWl0IHRoaXMuYmFja2VuZC5yZWxlYXNlKFwic2VydmVyXCIpXG4gIH1cblxuICAvKipcbiAgICogUmVhZHMgb3duZXIgbWV0YWRhdGEgZnJvbSBhbiBleGlzdGluZyBzZXJ2ZXIgbG9jayBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPGltcG9ydChcIi4uL2RhdGFiYXNlL2Fkdmlzb3J5LWxvY2stZmlsZS1iYWNrZW5kLmpzXCIpLkFkdmlzb3J5TG9ja0ZpbGVPd25lciB8IG51bGw+fSAtIFBhcnNlZCBvd25lciBtZXRhZGF0YSwgd2hlbiByZWFkYWJsZS5cbiAgICovXG4gIGFzeW5jIHJlYWRPd25lck1ldGFkYXRhKCkge1xuICAgIHJldHVybiBhd2FpdCB0aGlzLmJhY2tlbmQuaG9sZGVySW5mbyhcInNlcnZlclwiKVxuICB9XG5cbiAgLyoqXG4gICAqIEJ1aWxkcyBhIGR1cGxpY2F0ZS1zZXJ2ZXIgZXJyb3IgbWVzc2FnZSB3aXRoIG93bmVyIGRldGFpbHMgd2hlbiBhdmFpbGFibGUuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHN0cmluZz59IC0gRXJyb3IgbWVzc2FnZSBleHBsYWluaW5nIHdoaWNoIHNlcnZlciBvd25zIHRoZSBsb2NrLlxuICAgKi9cbiAgYXN5bmMgbG9ja0hlbGRNZXNzYWdlKCkge1xuICAgIGNvbnN0IG93bmVyID0gYXdhaXQgdGhpcy5yZWFkT3duZXJNZXRhZGF0YSgpXG4gICAgY29uc3QgZGV0YWlscyA9IG93bmVyXG4gICAgICA/IGBQSUQgJHtTdHJpbmcob3duZXIucGlkKX0gb24gJHtTdHJpbmcob3duZXIuaG9zdG5hbWUpfSAoJHtTdHJpbmcob3duZXIuaG9zdCl9OiR7U3RyaW5nKG93bmVyLnBvcnQpfSlgXG4gICAgICA6IGBsb2NrIGRpcmVjdG9yeSAke3RoaXMubG9ja1BhdGh9YFxuXG4gICAgcmV0dXJuIGBBIFZlbG9jaW91cyBIVFRQIHNlcnZlciBpcyBhbHJlYWR5IHJ1bm5pbmcgZm9yIHRoaXMgYXBwbGljYXRpb24gKCR7ZGV0YWlsc30pLiBSZW1vdmUgJHt0aGlzLmxvY2tQYXRofSBpZiB0aGUgc2VydmVyIGlzIG5vIGxvbmdlciBydW5uaW5nLmBcbiAgfVxufVxuIl19

package/package.json

@@ -3,7 +3,7 @@
     "velocious": "build/bin/velocious.js"
   },
   "name": "velocious",
-  "version": "1.0.699",
+  "version": "1.0.700",
   "main": "build/index.js",
   "types": "build/index.d.ts",
   "files": [

package/src/configuration-types.js

@@ -780,6 +780,16 @@
  * @property {(args: {configuration: import("./configuration.js").default, databaseConfiguration: DatabaseConfigurationType, identifier: string, migrationsApplied: number, tenant: ReturnType<typeof JSON.parse>}) => void | Promise<void>} [afterMigrateTenant] - Runs app-owned tenant work after generic migrations for one tenant. `migrationsApplied` is how many migrations actually ran (0 when the tenant was already up to date), so the app can skip expensive per-tenant work on no-op deploys.
  */
 
+/**
+ * Advisory-lock backend chain configuration (STC-210 design §10, file tier
+ * implemented by STC-213). Everything defaults to today's driver-native-only
+ * behavior; the file backend is disabled by default and only selectable by
+ * explicit configuration.
+ * @typedef {object} AdvisoryLocksConfiguration
+ * @property {{file?: {directory?: string, enabled?: boolean, leaseMs?: number, renewIntervalMs?: number}}} [backends] - Backend enablement. `file.enabled` defaults to false; enabling it is the deployment's explicit single-host declaration.
+ * @property {import("./database/advisory-lock-backend-policy.js").AdvisoryLockBackendPolicyEntry[]} [policy] - Per-lock-name minimum/allowed/preferred tier rules (design §5).
+ */
+
 /**
  * @typedef {object} ConfigurationArgsType
  * @property {boolean} [autoload] - Globally enable auto-batch-preload of relationships on lazy access. Default true.
@@ -787,6 +797,7 @@
  * @property {string} [cookieSecret] - Secret for encrypting cookies.
  * @property {AbilityResourceClassType[]} [abilityResources] - Resource classes used to define abilities per model.
  * @property {AbilityResolverType} [abilityResolver] - Resolver for creating request-scoped ability instances.
+ * @property {AdvisoryLocksConfiguration} [advisoryLocks] - Advisory-lock backend chain configuration (backends + per-lock-name tier policy). Defaults to today's driver-native-only behavior.
  * @property {AttachmentsConfiguration} [attachments] - Attachment storage configuration.
  * @property {BackendProjectConfiguration[]} [backendProjects] - Backend project definitions used for frontend model generation.
  * @property {VelociousPackageConfiguration[]} [packages] - External Velocious packages that contribute models, frontend-model resources and migrations.

package/src/configuration.js

@@ -45,6 +45,7 @@ import VelociousPackage from "./packages/velocious-package.js"
 import FrontendTenantSqliteLifecycle from "./tenants/frontend-tenant-sqlite-lifecycle.js"
 import { resolveGenerationId, resolveInitialGenerationState, resolveLifecycleSocketPath } from "./background-jobs/generation-identity.js"
 import { runShutdownSteps } from "./utils/shutdown-lifecycle.js"
+import { resolveAdvisoryLockBackendPolicy } from "./database/advisory-lock-backend-policy.js"
 
 export { CurrentConfigurationNotSetError }
 
@@ -245,6 +246,20 @@ export default class VelociousConfiguration {
    * @type {Set<import("./database/drivers/base.js").default>} */
   _advisoryLockConnections = new Set()
 
+  /**
+   * Lazily created file-tier advisory-lock backend (STC-213). Stays `undefined`
+   * unless `advisoryLocks.backends.file.enabled: true` is explicitly configured —
+   * the file tier is never auto-enabled, and a non-Node environment handler
+   * (browser/Expo, no `fs`) cannot create one at all.
+   * @type {import("./database/advisory-lock-file-backend.js").default | undefined} */
+  _advisoryLockFileBackend = undefined
+
+  /**
+   * Most recent advisory-lock acquisition per lock name — the "which backend
+   * served this lock" surface (design §3).
+   * @type {Map<string, {backend: import("./database/advisory-lock-backend-policy.js").AdvisoryLockTier, fencingSupported: boolean, servedAt: string}>} */
+  _advisoryLockAcquisitions = new Map()
+
   /** @type {Map<string, number>} */
   _schemaCacheGenerationsByReuseKey = new Map()
 
@@ -260,11 +275,12 @@ export default class VelociousConfiguration {
    * Runs constructor.
    * @param {import("./configuration-types.js").ConfigurationArgsType} args - Configuration arguments.
    */
-  constructor({abilityResolver, abilityResources, attachments, autoload = true, backgroundJobs, backendProjects, beacon, cookieSecret, cors, database, debug = false, debugEndpoint = false, apiManifest = false, directory, enforceTenantDatabaseScopes = true, environment, environmentHandler, exposeInternalErrorsToClients, frontendTenantSqlite, httpServer, initializeModels, initializers, locale, localeFallbacks, locales, logging, mailerBackend, mcp = false, packages, requestTimeoutMs, routeResolverHooks, scheduledBackgroundJobs, secureFrontendModelErrors, structureSql, sync, tenantDatabaseProviders, tenantDatabaseResolver, tenantResolver, testTenantPools, testing, timeZone, timezoneOffsetMinutes, trustedProxies, websocketChannelResolver, websocketMessageHandlerResolver, ...restArgs}) {
+  constructor({abilityResolver, abilityResources, advisoryLocks, attachments, autoload = true, backgroundJobs, backendProjects, beacon, cookieSecret, cors, database, debug = false, debugEndpoint = false, apiManifest = false, directory, enforceTenantDatabaseScopes = true, environment, environmentHandler, exposeInternalErrorsToClients, frontendTenantSqlite, httpServer, initializeModels, initializers, locale, localeFallbacks, locales, logging, mailerBackend, mcp = false, packages, requestTimeoutMs, routeResolverHooks, scheduledBackgroundJobs, secureFrontendModelErrors, structureSql, sync, tenantDatabaseProviders, tenantDatabaseResolver, tenantResolver, testTenantPools, testing, timeZone, timezoneOffsetMinutes, trustedProxies, websocketChannelResolver, websocketMessageHandlerResolver, ...restArgs}) {
     restArgsError(restArgs)
 
     this._abilityResolver = abilityResolver
     this._abilityResources = abilityResources || []
+    this._advisoryLocks = advisoryLocks
     this._autoload = autoload
     this._backgroundJobs = backgroundJobs
     this._beacon = beacon
@@ -4076,6 +4092,102 @@ export default class VelociousConfiguration {
     })
   }
 
+  /**
+   * Resolves the `advisoryLocks` configuration block (STC-210 design §10).
+   * Full backward compatibility: an app that configures nothing gets today's
+   * driver-native-only behavior — the file backend is **disabled by default**
+   * and only ever selectable by explicit configuration.
+   * @returns {{backends: {file: {directory?: string, enabled: boolean, leaseMs: number, renewIntervalMs: number}}, policy: import("./database/advisory-lock-backend-policy.js").AdvisoryLockBackendPolicyEntry[]}} - Advisory-lock configuration with defaults applied.
+   */
+  getAdvisoryLockConfig() {
+    const configured = this._advisoryLocks || {}
+    const fileConfigured = configured.backends?.file || {}
+
+    return {
+      backends: {
+        file: {
+          directory: fileConfigured.directory,
+          enabled: fileConfigured.enabled === true,
+          leaseMs: typeof fileConfigured.leaseMs === "number" ? fileConfigured.leaseMs : 30_000,
+          renewIntervalMs: typeof fileConfigured.renewIntervalMs === "number" ? fileConfigured.renewIntervalMs : 10_000
+        }
+      },
+      policy: Array.isArray(configured.policy) ? configured.policy : []
+    }
+  }
+
+  /**
+   * Runs get advisory lock policy.
+   * @returns {import("./database/advisory-lock-backend-policy.js").AdvisoryLockBackendPolicyEntry[]} - Per-lock-name backend policy entries.
+   */
+  getAdvisoryLockPolicy() {
+    return this.getAdvisoryLockConfig().policy
+  }
+
+  /**
+   * Resolves the effective backend policy for one lock name (design §5).
+   * @param {string} lockName - Concrete lock name.
+   * @returns {import("./database/advisory-lock-backend-policy.js").ResolvedAdvisoryLockBackendPolicy} - Resolved policy.
+   */
+  resolveAdvisoryLockPolicy(lockName) {
+    return resolveAdvisoryLockBackendPolicy(lockName, this.getAdvisoryLockPolicy())
+  }
+
+  /**
+   * Returns the file-tier advisory-lock backend when this deployment has
+   * explicitly enabled it (`advisoryLocks.backends.file.enabled: true`),
+   * creating it on first use. Returns `undefined` when the tier is disabled
+   * (the default) — callers must never fall back to it implicitly. Creation
+   * goes through the environment handler so browser/Expo configurations
+   * without `fs` fail loudly instead of half-working.
+   * @returns {Promise<import("./database/advisory-lock-file-backend.js").default | undefined>} - Resolves with the enabled file backend, or undefined.
+   */
+  async getAdvisoryLockFileBackend() {
+    const config = this.getAdvisoryLockConfig()
+
+    if (!config.backends.file.enabled) return undefined
+    if (this._advisoryLockFileBackend) return this._advisoryLockFileBackend
+
+    const directory = config.backends.file.directory || `${this.getDirectory()}/tmp/advisory-locks`
+
+    this._advisoryLockFileBackend = await this.getEnvironmentHandler().createAdvisoryLockFileBackend({
+      directory,
+      leaseMs: config.backends.file.leaseMs,
+      renewIntervalMs: config.backends.file.renewIntervalMs
+    })
+
+    return this._advisoryLockFileBackend
+  }
+
+  /**
+   * Records which backend tier served one advisory-lock acquisition so
+   * `getAdvisoryLockBackendStatus()` can answer "which backend served this
+   * lock" (design §3).
+   * @param {object} args - Acquisition record.
+   * @param {string} args.lockName - Lock name.
+   * @param {import("./database/advisory-lock-backend-policy.js").AdvisoryLockTier} args.backend - Tier that served the acquisition.
+   * @param {boolean} args.fencingSupported - Whether the serving tier carries fencing tokens.
+   * @returns {void}
+   */
+  recordAdvisoryLockAcquisition({lockName, backend, fencingSupported}) {
+    this._advisoryLockAcquisitions.set(lockName, {backend, fencingSupported, servedAt: new Date().toISOString()})
+  }
+
+  /**
+   * The "which backend served this lock" diagnostics surface (design §3):
+   * per lock name, the tier of the most recent acquisition, whether that tier
+   * carries fencing tokens, and the resolved policy (minimum/allowed/preferred
+   * tiers) for the name.
+   * @param {string} lockName - Lock name.
+   * @returns {{acquisition: {backend: import("./database/advisory-lock-backend-policy.js").AdvisoryLockTier, fencingSupported: boolean, servedAt: string} | null, policy: import("./database/advisory-lock-backend-policy.js").ResolvedAdvisoryLockBackendPolicy}} - Backend status for the name.
+   */
+  getAdvisoryLockBackendStatus(lockName) {
+    return {
+      acquisition: this._advisoryLockAcquisitions.get(lockName) ?? null,
+      policy: this.resolveAdvisoryLockPolicy(lockName)
+    }
+  }
+
   /**
    * Registers a dedicated connection that currently holds an advisory lock, so a
    * shutdown can close it and release the lock. See `_advisoryLockConnections`.
@@ -4155,6 +4267,15 @@ export default class VelociousConfiguration {
           // leave the rest of the connections open.
           await this._closeAdvisoryLockConnections()
         } finally {
+          try {
+            // Release file-tier advisory-lock holds explicitly (STC-213): the
+            // lease would make them reclaimable anyway, but a clean shutdown
+            // should not leave lock directories behind for the staleness path.
+            await this._advisoryLockFileBackend?.releaseAllHeld()
+          } catch (error) {
+            closeErrors.push(error instanceof Error ? error : new Error(String(error)))
+          }
+
           for (const pool of Object.values(this.databasePools)) {
             if (!pool) continue