velocious 1.0.726 → 1.0.727

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/build/configuration-types.js +1 -1
  2. package/build/configuration.js +17 -2
  3. package/build/database/advisory-lock-lock-server-backend.js +30 -24
  4. package/build/database/advisory-lock-lock-server-embedded-client.js +74 -0
  5. package/build/database/advisory-lock-lock-server-engine.js +544 -0
  6. package/build/database/advisory-lock-lock-server-local-client.js +260 -0
  7. package/build/database/advisory-lock-lock-server-socket-path.js +17 -0
  8. package/build/database/advisory-lock-lock-server-transport.js +30 -0
  9. package/build/database/record/auditing.js +89 -11
  10. package/build/database/record/index.js +1 -1
  11. package/build/environment-handlers/base.js +50 -9
  12. package/build/environment-handlers/node/advisory-lock-lock-server-local-server.js +206 -0
  13. package/build/environment-handlers/node.js +30 -3
  14. package/build/http-server/server-lock.js +29 -16
  15. package/build/src/configuration-types.d.ts +3 -1
  16. package/build/src/configuration-types.d.ts.map +1 -1
  17. package/build/src/configuration-types.js +2 -2
  18. package/build/src/configuration.d.ts +3 -1
  19. package/build/src/configuration.d.ts.map +1 -1
  20. package/build/src/configuration.js +18 -3
  21. package/build/src/database/advisory-lock-lock-server-backend.d.ts +10 -3
  22. package/build/src/database/advisory-lock-lock-server-backend.d.ts.map +1 -1
  23. package/build/src/database/advisory-lock-lock-server-backend.js +25 -22
  24. package/build/src/database/advisory-lock-lock-server-embedded-client.d.ts +24 -0
  25. package/build/src/database/advisory-lock-lock-server-embedded-client.d.ts.map +1 -0
  26. package/build/src/database/advisory-lock-lock-server-embedded-client.js +64 -0
  27. package/build/src/database/advisory-lock-lock-server-engine.d.ts +285 -0
  28. package/build/src/database/advisory-lock-lock-server-engine.d.ts.map +1 -0
  29. package/build/src/database/advisory-lock-lock-server-engine.js +460 -0
  30. package/build/src/database/advisory-lock-lock-server-local-client.d.ts +114 -0
  31. package/build/src/database/advisory-lock-lock-server-local-client.d.ts.map +1 -0
  32. package/build/src/database/advisory-lock-lock-server-local-client.js +227 -0
  33. package/build/src/database/advisory-lock-lock-server-socket-path.d.ts +9 -0
  34. package/build/src/database/advisory-lock-lock-server-socket-path.d.ts.map +1 -0
  35. package/build/src/database/advisory-lock-lock-server-socket-path.js +16 -0
  36. package/build/src/database/advisory-lock-lock-server-transport.d.ts +18 -0
  37. package/build/src/database/advisory-lock-lock-server-transport.d.ts.map +1 -0
  38. package/build/src/database/advisory-lock-lock-server-transport.js +27 -0
  39. package/build/src/database/record/auditing.d.ts +14 -4
  40. package/build/src/database/record/auditing.d.ts.map +1 -1
  41. package/build/src/database/record/auditing.js +77 -12
  42. package/build/src/database/record/index.d.ts +4 -2
  43. package/build/src/database/record/index.d.ts.map +1 -1
  44. package/build/src/database/record/index.js +2 -2
  45. package/build/src/environment-handlers/base.d.ts +86 -7
  46. package/build/src/environment-handlers/base.d.ts.map +1 -1
  47. package/build/src/environment-handlers/base.js +48 -9
  48. package/build/src/environment-handlers/node/advisory-lock-lock-server-local-server.d.ts +2 -0
  49. package/build/src/environment-handlers/node/advisory-lock-lock-server-local-server.d.ts.map +1 -0
  50. package/build/src/environment-handlers/node/advisory-lock-lock-server-local-server.js +179 -0
  51. package/build/src/environment-handlers/node.d.ts +10 -4
  52. package/build/src/environment-handlers/node.d.ts.map +1 -1
  53. package/build/src/environment-handlers/node.js +30 -4
  54. package/build/src/http-server/server-lock.d.ts +22 -11
  55. package/build/src/http-server/server-lock.d.ts.map +1 -1
  56. package/build/src/http-server/server-lock.js +30 -17
  57. package/package.json +1 -1
  58. package/src/configuration-types.js +1 -1
  59. package/src/configuration.js +17 -2
  60. package/src/database/advisory-lock-lock-server-backend.js +30 -24
  61. package/src/database/advisory-lock-lock-server-embedded-client.js +74 -0
  62. package/src/database/advisory-lock-lock-server-engine.js +544 -0
  63. package/src/database/advisory-lock-lock-server-local-client.js +260 -0
  64. package/src/database/advisory-lock-lock-server-socket-path.js +17 -0
  65. package/src/database/advisory-lock-lock-server-transport.js +30 -0
  66. package/src/database/record/auditing.js +89 -11
  67. package/src/database/record/index.js +1 -1
  68. package/src/environment-handlers/base.js +50 -9
  69. package/src/environment-handlers/node/advisory-lock-lock-server-local-server.js +206 -0
  70. package/src/environment-handlers/node.js +30 -3
  71. package/src/http-server/server-lock.js +29 -16
@@ -1,21 +1,31 @@
1
1
  import AdvisoryLockFileBackend from "../database/advisory-lock-file-backend.js";
2
2
  /**
3
- * Directory-based lock that allows only one HTTP server process per app
4
- * directory. Thin wrapper over the shared file-lock backend
5
- * (`src/database/advisory-lock-file-backend.js` — the STC-210 `file` tier
6
- * primitive generalized from this lock's original hand-rolled directory
7
- * protocol), so the server lock and the advisory-lock file tier share one
8
- * acquisition, owner-metadata, lease-renewal, and staleness implementation.
3
+ * Directory + environment-based lock that allows only one HTTP server process
4
+ * per (app directory, environment) pair. Thin wrapper over the shared
5
+ * file-lock backend (`src/database/advisory-lock-file-backend.js` — the
6
+ * STC-210 `file` tier primitive generalized from this lock's original
7
+ * hand-rolled directory protocol), so the server lock and the advisory-lock
8
+ * file tier share one acquisition, owner-metadata, lease-renewal, and
9
+ * staleness implementation.
10
+ *
11
+ * The lock name is scoped by the configuration's environment
12
+ * (`server.<environment>` → `tmp/server.<environment>.lock`) so a development
13
+ * server and a test-spawned backend in the same app directory coexist, while
14
+ * the single-server-per-(directory, environment) invariant still fails loudly
15
+ * for a duplicate within one environment (STC-697).
9
16
  */
10
17
  export default class VelociousHttpServerLock {
11
18
  configuration: import("../configuration.js").default;
12
19
  host: string;
13
20
  port: number;
21
+ environment: string;
22
+ lockName: string;
14
23
  lockPath: string;
15
24
  backend: AdvisoryLockFileBackend;
16
25
  acquired: boolean;
17
26
  /**
18
- * Build a lock for the configured application directory and server endpoint.
27
+ * Build a lock for the configured application directory, environment and
28
+ * server endpoint.
19
29
  * @param {object} args - Options object.
20
30
  * @param {import("../configuration.js").default} args.configuration - Configuration that owns the application directory.
21
31
  * @param {string} args.host - Configured HTTP host.
@@ -27,14 +37,15 @@ export default class VelociousHttpServerLock {
27
37
  port: number;
28
38
  });
29
39
  /**
30
- * Acquires the app-directory HTTP server lock before startup side effects
31
- * run. A stale lock (dead local owner or expired lease) is reclaimed by the
32
- * backend; a live foreign owner fails loudly with the owner details.
40
+ * Acquires the app-directory + environment HTTP server lock before startup
41
+ * side effects run. A stale lock (dead local owner or expired lease) is
42
+ * reclaimed by the backend; a live foreign owner in the same environment
43
+ * fails loudly with the owner details.
33
44
  * @returns {Promise<void>} - Resolves after the lock has been acquired.
34
45
  */
35
46
  acquire(): Promise<void>;
36
47
  /**
37
- * Releases the held HTTP server lock directory.
48
+ * Releases the held environment-scoped HTTP server lock directory.
38
49
  * @returns {Promise<void>} - Resolves after best-effort lock release.
39
50
  */
40
51
  release(): Promise<void>;
@@ -1 +1 @@
1
- {"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"}
1
+ {"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;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAUnC,aAAa;IACb,IAAI;IACJ,IAAI;IACJ,WAAW;IAGX,QAAQ;IACR,QAAQ;IACR,OAAO;IAKP,QAAQ;IAtBf;;;;;;;OAOG;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,EAetC;IAED;;;;;;OAMG;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"}
@@ -2,16 +2,24 @@
2
2
  import AdvisoryLockFileBackend from "../database/advisory-lock-file-backend.js";
3
3
  import path from "node:path";
4
4
  /**
5
- * Directory-based lock that allows only one HTTP server process per app
6
- * directory. Thin wrapper over the shared file-lock backend
7
- * (`src/database/advisory-lock-file-backend.js` — the STC-210 `file` tier
8
- * primitive generalized from this lock's original hand-rolled directory
9
- * protocol), so the server lock and the advisory-lock file tier share one
10
- * acquisition, owner-metadata, lease-renewal, and staleness implementation.
5
+ * Directory + environment-based lock that allows only one HTTP server process
6
+ * per (app directory, environment) pair. Thin wrapper over the shared
7
+ * file-lock backend (`src/database/advisory-lock-file-backend.js` — the
8
+ * STC-210 `file` tier primitive generalized from this lock's original
9
+ * hand-rolled directory protocol), so the server lock and the advisory-lock
10
+ * file tier share one acquisition, owner-metadata, lease-renewal, and
11
+ * staleness implementation.
12
+ *
13
+ * The lock name is scoped by the configuration's environment
14
+ * (`server.<environment>` → `tmp/server.<environment>.lock`) so a development
15
+ * server and a test-spawned backend in the same app directory coexist, while
16
+ * the single-server-per-(directory, environment) invariant still fails loudly
17
+ * for a duplicate within one environment (STC-697).
11
18
  */
12
19
  export default class VelociousHttpServerLock {
13
20
  /**
14
- * Build a lock for the configured application directory and server endpoint.
21
+ * Build a lock for the configured application directory, environment and
22
+ * server endpoint.
15
23
  * @param {object} args - Options object.
16
24
  * @param {import("../configuration.js").default} args.configuration - Configuration that owns the application directory.
17
25
  * @param {string} args.host - Configured HTTP host.
@@ -21,7 +29,11 @@ export default class VelociousHttpServerLock {
21
29
  this.configuration = configuration;
22
30
  this.host = host;
23
31
  this.port = port;
24
- this.lockPath = path.join(configuration.getDirectory(), "tmp", "server.lock");
32
+ this.environment = String(configuration.getEnvironment());
33
+ // Scope the lock name by environment and keep the segment filesystem-safe,
34
+ // so odd environment names can never escape tmp/ or collide with each other.
35
+ this.lockName = `server.${this.environment.replace(/[^a-zA-Z0-9._-]/g, "_")}`;
36
+ this.lockPath = path.join(configuration.getDirectory(), "tmp", `${this.lockName}.lock`);
25
37
  this.backend = new AdvisoryLockFileBackend({
26
38
  directory: path.join(configuration.getDirectory(), "tmp"),
27
39
  extraOwnerFields: { host: this.host, port: this.port },
@@ -30,33 +42,34 @@ export default class VelociousHttpServerLock {
30
42
  this.acquired = false;
31
43
  }
32
44
  /**
33
- * Acquires the app-directory HTTP server lock before startup side effects
34
- * run. A stale lock (dead local owner or expired lease) is reclaimed by the
35
- * backend; a live foreign owner fails loudly with the owner details.
45
+ * Acquires the app-directory + environment HTTP server lock before startup
46
+ * side effects run. A stale lock (dead local owner or expired lease) is
47
+ * reclaimed by the backend; a live foreign owner in the same environment
48
+ * fails loudly with the owner details.
36
49
  * @returns {Promise<void>} - Resolves after the lock has been acquired.
37
50
  */
38
51
  async acquire() {
39
- const acquired = await this.backend.acquire("server", { timeoutMs: 0 });
52
+ const acquired = await this.backend.acquire(this.lockName, { timeoutMs: 0 });
40
53
  if (!acquired)
41
54
  throw new Error(await this.lockHeldMessage());
42
55
  this.acquired = true;
43
56
  }
44
57
  /**
45
- * Releases the held HTTP server lock directory.
58
+ * Releases the held environment-scoped HTTP server lock directory.
46
59
  * @returns {Promise<void>} - Resolves after best-effort lock release.
47
60
  */
48
61
  async release() {
49
62
  if (!this.acquired)
50
63
  return;
51
64
  this.acquired = false;
52
- await this.backend.release("server");
65
+ await this.backend.release(this.lockName);
53
66
  }
54
67
  /**
55
68
  * Reads owner metadata from an existing server lock directory.
56
69
  * @returns {Promise<import("../database/advisory-lock-file-backend.js").AdvisoryLockFileOwner | null>} - Parsed owner metadata, when readable.
57
70
  */
58
71
  async readOwnerMetadata() {
59
- return await this.backend.holderInfo("server");
72
+ return await this.backend.holderInfo(this.lockName);
60
73
  }
61
74
  /**
62
75
  * Builds a duplicate-server error message with owner details when available.
@@ -67,7 +80,7 @@ export default class VelociousHttpServerLock {
67
80
  const details = owner
68
81
  ? `PID ${String(owner.pid)} on ${String(owner.hostname)} (${String(owner.host)}:${String(owner.port)})`
69
82
  : `lock directory ${this.lockPath}`;
70
- return `A Velocious HTTP server is already running for this application (${details}). Remove ${this.lockPath} if the server is no longer running.`;
83
+ return `A Velocious HTTP server is already running for this application in the ${this.environment} environment (${details}). Remove ${this.lockPath} if the server is no longer running.`;
71
84
  }
72
85
  }
73
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmVyLWxvY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaHR0cC1zZXJ2ZXIvc2VydmVyLWxvY2suanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sdUJBQXVCLE1BQU0sMkNBQTJDLENBQUE7QUFDL0UsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFBO0FBRTVCOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLHVCQUF1QjtJQUMxQzs7Ozs7O09BTUc7SUFDSCxZQUFZLEVBQUMsYUFBYSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUM7UUFDckMsSUFBSSxDQUFDLGFBQWEsR0FBRyxhQUFhLENBQUE7UUFDbEMsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFDaEIsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxZQUFZLEVBQUUsRUFBRSxLQUFLLEVBQUUsYUFBYSxDQUFDLENBQUE7UUFDN0UsSUFBSSxDQUFDLE9BQU8sR0FBRyxJQUFJLHVCQUF1QixDQUFDO1lBQ3pDLFNBQVMsRUFBRSxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxZQUFZLEVBQUUsRUFBRSxLQUFLLENBQUM7WUFDekQsZ0JBQWdCLEVBQUUsRUFBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBQztZQUNwRCxTQUFTLEVBQUUsT0FBTztTQUNuQixDQUFDLENBQUE7UUFDRixJQUFJLENBQUMsUUFBUSxHQUFHLEtBQUssQ0FBQTtJQUN2QixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxLQUFLLENBQUMsT0FBTztRQUNYLE1BQU0sUUFBUSxHQUFHLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsUUFBUSxFQUFFLEVBQUMsU0FBUyxFQUFFLENBQUMsRUFBQyxDQUFDLENBQUE7UUFFckUsSUFBSSxDQUFDLFFBQVE7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLE1BQU0sSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDLENBQUE7UUFFNUQsSUFBSSxDQUFDLFFBQVEsR0FBRyxJQUFJLENBQUE7SUFDdEIsQ0FBQztJQUVEOzs7T0FHRztJQUNILEtBQUssQ0FBQyxPQUFPO1FBQ1gsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRO1lBQUUsT0FBTTtRQUUxQixJQUFJLENBQUMsUUFBUSxHQUFHLEtBQUssQ0FBQTtRQUNyQixNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFBO0lBQ3RDLENBQUM7SUFFRDs7O09BR0c7SUFDSCxLQUFLLENBQUMsaUJBQWlCO1FBQ3JCLE9BQU8sTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsQ0FBQTtJQUNoRCxDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLGVBQWU7UUFDbkIsTUFBTSxLQUFLLEdBQUcsTUFBTSxJQUFJLENBQUMsaUJBQWlCLEVBQUUsQ0FBQTtRQUM1QyxNQUFNLE9BQU8sR0FBRyxLQUFLO1lBQ25CLENBQUMsQ0FBQyxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sTUFBTSxDQUFDLEtBQUssQ0FBQyxRQUFRLENBQUMsS0FBSyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUc7WUFDdkcsQ0FBQyxDQUFDLGtCQUFrQixJQUFJLENBQUMsUUFBUSxFQUFFLENBQUE7UUFFckMsT0FBTyxvRUFBb0UsT0FBTyxhQUFhLElBQUksQ0FBQyxRQUFRLHNDQUFzQyxDQUFBO0lBQ3BKLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgQWR2aXNvcnlMb2NrRmlsZUJhY2tlbmQgZnJvbSBcIi4uL2RhdGFiYXNlL2Fkdmlzb3J5LWxvY2stZmlsZS1iYWNrZW5kLmpzXCJcbmltcG9ydCBwYXRoIGZyb20gXCJub2RlOnBhdGhcIlxuXG4vKipcbiAqIERpcmVjdG9yeS1iYXNlZCBsb2NrIHRoYXQgYWxsb3dzIG9ubHkgb25lIEhUVFAgc2VydmVyIHByb2Nlc3MgcGVyIGFwcFxuICogZGlyZWN0b3J5LiBUaGluIHdyYXBwZXIgb3ZlciB0aGUgc2hhcmVkIGZpbGUtbG9jayBiYWNrZW5kXG4gKiAoYHNyYy9kYXRhYmFzZS9hZHZpc29yeS1sb2NrLWZpbGUtYmFja2VuZC5qc2Ag4oCUIHRoZSBTVEMtMjEwIGBmaWxlYCB0aWVyXG4gKiBwcmltaXRpdmUgZ2VuZXJhbGl6ZWQgZnJvbSB0aGlzIGxvY2sncyBvcmlnaW5hbCBoYW5kLXJvbGxlZCBkaXJlY3RvcnlcbiAqIHByb3RvY29sKSwgc28gdGhlIHNlcnZlciBsb2NrIGFuZCB0aGUgYWR2aXNvcnktbG9jayBmaWxlIHRpZXIgc2hhcmUgb25lXG4gKiBhY3F1aXNpdGlvbiwgb3duZXItbWV0YWRhdGEsIGxlYXNlLXJlbmV3YWwsIGFuZCBzdGFsZW5lc3MgaW1wbGVtZW50YXRpb24uXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFZlbG9jaW91c0h0dHBTZXJ2ZXJMb2NrIHtcbiAgLyoqXG4gICAqIEJ1aWxkIGEgbG9jayBmb3IgdGhlIGNvbmZpZ3VyZWQgYXBwbGljYXRpb24gZGlyZWN0b3J5IGFuZCBzZXJ2ZXIgZW5kcG9pbnQuXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBhcmdzIC0gT3B0aW9ucyBvYmplY3QuXG4gICAqIEBwYXJhbSB7aW1wb3J0KFwiLi4vY29uZmlndXJhdGlvbi5qc1wiKS5kZWZhdWx0fSBhcmdzLmNvbmZpZ3VyYXRpb24gLSBDb25maWd1cmF0aW9uIHRoYXQgb3ducyB0aGUgYXBwbGljYXRpb24gZGlyZWN0b3J5LlxuICAgKiBAcGFyYW0ge3N0cmluZ30gYXJncy5ob3N0IC0gQ29uZmlndXJlZCBIVFRQIGhvc3QuXG4gICAqIEBwYXJhbSB7bnVtYmVyfSBhcmdzLnBvcnQgLSBDb25maWd1cmVkIEhUVFAgcG9ydC5cbiAgICovXG4gIGNvbnN0cnVjdG9yKHtjb25maWd1cmF0aW9uLCBob3N0LCBwb3J0fSkge1xuICAgIHRoaXMuY29uZmlndXJhdGlvbiA9IGNvbmZpZ3VyYXRpb25cbiAgICB0aGlzLmhvc3QgPSBob3N0XG4gICAgdGhpcy5wb3J0ID0gcG9ydFxuICAgIHRoaXMubG9ja1BhdGggPSBwYXRoLmpvaW4oY29uZmlndXJhdGlvbi5nZXREaXJlY3RvcnkoKSwgXCJ0bXBcIiwgXCJzZXJ2ZXIubG9ja1wiKVxuICAgIHRoaXMuYmFja2VuZCA9IG5ldyBBZHZpc29yeUxvY2tGaWxlQmFja2VuZCh7XG4gICAgICBkaXJlY3Rvcnk6IHBhdGguam9pbihjb25maWd1cmF0aW9uLmdldERpcmVjdG9yeSgpLCBcInRtcFwiKSxcbiAgICAgIGV4dHJhT3duZXJGaWVsZHM6IHtob3N0OiB0aGlzLmhvc3QsIHBvcnQ6IHRoaXMucG9ydH0sXG4gICAgICBwYXRoU3R5bGU6IFwicGxhaW5cIlxuICAgIH0pXG4gICAgdGhpcy5hY3F1aXJlZCA9IGZhbHNlXG4gIH1cblxuICAvKipcbiAgICogQWNxdWlyZXMgdGhlIGFwcC1kaXJlY3RvcnkgSFRUUCBzZXJ2ZXIgbG9jayBiZWZvcmUgc3RhcnR1cCBzaWRlIGVmZmVjdHNcbiAgICogcnVuLiBBIHN0YWxlIGxvY2sgKGRlYWQgbG9jYWwgb3duZXIgb3IgZXhwaXJlZCBsZWFzZSkgaXMgcmVjbGFpbWVkIGJ5IHRoZVxuICAgKiBiYWNrZW5kOyBhIGxpdmUgZm9yZWlnbiBvd25lciBmYWlscyBsb3VkbHkgd2l0aCB0aGUgb3duZXIgZGV0YWlscy5cbiAgICogQHJldHVybnMge1Byb21pc2U8dm9pZD59IC0gUmVzb2x2ZXMgYWZ0ZXIgdGhlIGxvY2sgaGFzIGJlZW4gYWNxdWlyZWQuXG4gICAqL1xuICBhc3luYyBhY3F1aXJlKCkge1xuICAgIGNvbnN0IGFjcXVpcmVkID0gYXdhaXQgdGhpcy5iYWNrZW5kLmFjcXVpcmUoXCJzZXJ2ZXJcIiwge3RpbWVvdXRNczogMH0pXG5cbiAgICBpZiAoIWFjcXVpcmVkKSB0aHJvdyBuZXcgRXJyb3IoYXdhaXQgdGhpcy5sb2NrSGVsZE1lc3NhZ2UoKSlcblxuICAgIHRoaXMuYWNxdWlyZWQgPSB0cnVlXG4gIH1cblxuICAvKipcbiAgICogUmVsZWFzZXMgdGhlIGhlbGQgSFRUUCBzZXJ2ZXIgbG9jayBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fSAtIFJlc29sdmVzIGFmdGVyIGJlc3QtZWZmb3J0IGxvY2sgcmVsZWFzZS5cbiAgICovXG4gIGFzeW5jIHJlbGVhc2UoKSB7XG4gICAgaWYgKCF0aGlzLmFjcXVpcmVkKSByZXR1cm5cblxuICAgIHRoaXMuYWNxdWlyZWQgPSBmYWxzZVxuICAgIGF3YWl0IHRoaXMuYmFja2VuZC5yZWxlYXNlKFwic2VydmVyXCIpXG4gIH1cblxuICAvKipcbiAgICogUmVhZHMgb3duZXIgbWV0YWRhdGEgZnJvbSBhbiBleGlzdGluZyBzZXJ2ZXIgbG9jayBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPGltcG9ydChcIi4uL2RhdGFiYXNlL2Fkdmlzb3J5LWxvY2stZmlsZS1iYWNrZW5kLmpzXCIpLkFkdmlzb3J5TG9ja0ZpbGVPd25lciB8IG51bGw+fSAtIFBhcnNlZCBvd25lciBtZXRhZGF0YSwgd2hlbiByZWFkYWJsZS5cbiAgICovXG4gIGFzeW5jIHJlYWRPd25lck1ldGFkYXRhKCkge1xuICAgIHJldHVybiBhd2FpdCB0aGlzLmJhY2tlbmQuaG9sZGVySW5mbyhcInNlcnZlclwiKVxuICB9XG5cbiAgLyoqXG4gICAqIEJ1aWxkcyBhIGR1cGxpY2F0ZS1zZXJ2ZXIgZXJyb3IgbWVzc2FnZSB3aXRoIG93bmVyIGRldGFpbHMgd2hlbiBhdmFpbGFibGUuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHN0cmluZz59IC0gRXJyb3IgbWVzc2FnZSBleHBsYWluaW5nIHdoaWNoIHNlcnZlciBvd25zIHRoZSBsb2NrLlxuICAgKi9cbiAgYXN5bmMgbG9ja0hlbGRNZXNzYWdlKCkge1xuICAgIGNvbnN0IG93bmVyID0gYXdhaXQgdGhpcy5yZWFkT3duZXJNZXRhZGF0YSgpXG4gICAgY29uc3QgZGV0YWlscyA9IG93bmVyXG4gICAgICA/IGBQSUQgJHtTdHJpbmcob3duZXIucGlkKX0gb24gJHtTdHJpbmcob3duZXIuaG9zdG5hbWUpfSAoJHtTdHJpbmcob3duZXIuaG9zdCl9OiR7U3RyaW5nKG93bmVyLnBvcnQpfSlgXG4gICAgICA6IGBsb2NrIGRpcmVjdG9yeSAke3RoaXMubG9ja1BhdGh9YFxuXG4gICAgcmV0dXJuIGBBIFZlbG9jaW91cyBIVFRQIHNlcnZlciBpcyBhbHJlYWR5IHJ1bm5pbmcgZm9yIHRoaXMgYXBwbGljYXRpb24gKCR7ZGV0YWlsc30pLiBSZW1vdmUgJHt0aGlzLmxvY2tQYXRofSBpZiB0aGUgc2VydmVyIGlzIG5vIGxvbmdlciBydW5uaW5nLmBcbiAgfVxufVxuIl19
86
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmVyLWxvY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvaHR0cC1zZXJ2ZXIvc2VydmVyLWxvY2suanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sdUJBQXVCLE1BQU0sMkNBQTJDLENBQUE7QUFDL0UsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFBO0FBRTVCOzs7Ozs7Ozs7Ozs7OztHQWNHO0FBQ0gsTUFBTSxDQUFDLE9BQU8sT0FBTyx1QkFBdUI7SUFDMUM7Ozs7Ozs7T0FPRztJQUNILFlBQVksRUFBQyxhQUFhLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBQztRQUNyQyxJQUFJLENBQUMsYUFBYSxHQUFHLGFBQWEsQ0FBQTtRQUNsQyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQTtRQUNoQixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQTtRQUNoQixJQUFJLENBQUMsV0FBVyxHQUFHLE1BQU0sQ0FBQyxhQUFhLENBQUMsY0FBYyxFQUFFLENBQUMsQ0FBQTtRQUN6RCwyRUFBMkU7UUFDM0UsNkVBQTZFO1FBQzdFLElBQUksQ0FBQyxRQUFRLEdBQUcsVUFBVSxJQUFJLENBQUMsV0FBVyxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsRUFBRSxHQUFHLENBQUMsRUFBRSxDQUFBO1FBQzdFLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxhQUFhLENBQUMsWUFBWSxFQUFFLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDLFFBQVEsT0FBTyxDQUFDLENBQUE7UUFDdkYsSUFBSSxDQUFDLE9BQU8sR0FBRyxJQUFJLHVCQUF1QixDQUFDO1lBQ3pDLFNBQVMsRUFBRSxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxZQUFZLEVBQUUsRUFBRSxLQUFLLENBQUM7WUFDekQsZ0JBQWdCLEVBQUUsRUFBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBQztZQUNwRCxTQUFTLEVBQUUsT0FBTztTQUNuQixDQUFDLENBQUE7UUFDRixJQUFJLENBQUMsUUFBUSxHQUFHLEtBQUssQ0FBQTtJQUN2QixDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsS0FBSyxDQUFDLE9BQU87UUFDWCxNQUFNLFFBQVEsR0FBRyxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUUsRUFBQyxTQUFTLEVBQUUsQ0FBQyxFQUFDLENBQUMsQ0FBQTtRQUUxRSxJQUFJLENBQUMsUUFBUTtZQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsTUFBTSxJQUFJLENBQUMsZUFBZSxFQUFFLENBQUMsQ0FBQTtRQUU1RCxJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksQ0FBQTtJQUN0QixDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLE9BQU87UUFDWCxJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVE7WUFBRSxPQUFNO1FBRTFCLElBQUksQ0FBQyxRQUFRLEdBQUcsS0FBSyxDQUFBO1FBQ3JCLE1BQU0sSUFBSSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFBO0lBQzNDLENBQUM7SUFFRDs7O09BR0c7SUFDSCxLQUFLLENBQUMsaUJBQWlCO1FBQ3JCLE9BQU8sTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUE7SUFDckQsQ0FBQztJQUVEOzs7T0FHRztJQUNILEtBQUssQ0FBQyxlQUFlO1FBQ25CLE1BQU0sS0FBSyxHQUFHLE1BQU0sSUFBSSxDQUFDLGlCQUFpQixFQUFFLENBQUE7UUFDNUMsTUFBTSxPQUFPLEdBQUcsS0FBSztZQUNuQixDQUFDLENBQUMsT0FBTyxNQUFNLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLE1BQU0sQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDLEtBQUssTUFBTSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHO1lBQ3ZHLENBQUMsQ0FBQyxrQkFBa0IsSUFBSSxDQUFDLFFBQVEsRUFBRSxDQUFBO1FBRXJDLE9BQU8sMEVBQTBFLElBQUksQ0FBQyxXQUFXLGlCQUFpQixPQUFPLGFBQWEsSUFBSSxDQUFDLFFBQVEsc0NBQXNDLENBQUE7SUFDM0wsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbmltcG9ydCBBZHZpc29yeUxvY2tGaWxlQmFja2VuZCBmcm9tIFwiLi4vZGF0YWJhc2UvYWR2aXNvcnktbG9jay1maWxlLWJhY2tlbmQuanNcIlxuaW1wb3J0IHBhdGggZnJvbSBcIm5vZGU6cGF0aFwiXG5cbi8qKlxuICogRGlyZWN0b3J5ICsgZW52aXJvbm1lbnQtYmFzZWQgbG9jayB0aGF0IGFsbG93cyBvbmx5IG9uZSBIVFRQIHNlcnZlciBwcm9jZXNzXG4gKiBwZXIgKGFwcCBkaXJlY3RvcnksIGVudmlyb25tZW50KSBwYWlyLiBUaGluIHdyYXBwZXIgb3ZlciB0aGUgc2hhcmVkXG4gKiBmaWxlLWxvY2sgYmFja2VuZCAoYHNyYy9kYXRhYmFzZS9hZHZpc29yeS1sb2NrLWZpbGUtYmFja2VuZC5qc2Ag4oCUIHRoZVxuICogU1RDLTIxMCBgZmlsZWAgdGllciBwcmltaXRpdmUgZ2VuZXJhbGl6ZWQgZnJvbSB0aGlzIGxvY2sncyBvcmlnaW5hbFxuICogaGFuZC1yb2xsZWQgZGlyZWN0b3J5IHByb3RvY29sKSwgc28gdGhlIHNlcnZlciBsb2NrIGFuZCB0aGUgYWR2aXNvcnktbG9ja1xuICogZmlsZSB0aWVyIHNoYXJlIG9uZSBhY3F1aXNpdGlvbiwgb3duZXItbWV0YWRhdGEsIGxlYXNlLXJlbmV3YWwsIGFuZFxuICogc3RhbGVuZXNzIGltcGxlbWVudGF0aW9uLlxuICpcbiAqIFRoZSBsb2NrIG5hbWUgaXMgc2NvcGVkIGJ5IHRoZSBjb25maWd1cmF0aW9uJ3MgZW52aXJvbm1lbnRcbiAqIChgc2VydmVyLjxlbnZpcm9ubWVudD5gIOKGkiBgdG1wL3NlcnZlci48ZW52aXJvbm1lbnQ+LmxvY2tgKSBzbyBhIGRldmVsb3BtZW50XG4gKiBzZXJ2ZXIgYW5kIGEgdGVzdC1zcGF3bmVkIGJhY2tlbmQgaW4gdGhlIHNhbWUgYXBwIGRpcmVjdG9yeSBjb2V4aXN0LCB3aGlsZVxuICogdGhlIHNpbmdsZS1zZXJ2ZXItcGVyLShkaXJlY3RvcnksIGVudmlyb25tZW50KSBpbnZhcmlhbnQgc3RpbGwgZmFpbHMgbG91ZGx5XG4gKiBmb3IgYSBkdXBsaWNhdGUgd2l0aGluIG9uZSBlbnZpcm9ubWVudCAoU1RDLTY5NykuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIFZlbG9jaW91c0h0dHBTZXJ2ZXJMb2NrIHtcbiAgLyoqXG4gICAqIEJ1aWxkIGEgbG9jayBmb3IgdGhlIGNvbmZpZ3VyZWQgYXBwbGljYXRpb24gZGlyZWN0b3J5LCBlbnZpcm9ubWVudCBhbmRcbiAgICogc2VydmVyIGVuZHBvaW50LlxuICAgKiBAcGFyYW0ge29iamVjdH0gYXJncyAtIE9wdGlvbnMgb2JqZWN0LlxuICAgKiBAcGFyYW0ge2ltcG9ydChcIi4uL2NvbmZpZ3VyYXRpb24uanNcIikuZGVmYXVsdH0gYXJncy5jb25maWd1cmF0aW9uIC0gQ29uZmlndXJhdGlvbiB0aGF0IG93bnMgdGhlIGFwcGxpY2F0aW9uIGRpcmVjdG9yeS5cbiAgICogQHBhcmFtIHtzdHJpbmd9IGFyZ3MuaG9zdCAtIENvbmZpZ3VyZWQgSFRUUCBob3N0LlxuICAgKiBAcGFyYW0ge251bWJlcn0gYXJncy5wb3J0IC0gQ29uZmlndXJlZCBIVFRQIHBvcnQuXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih7Y29uZmlndXJhdGlvbiwgaG9zdCwgcG9ydH0pIHtcbiAgICB0aGlzLmNvbmZpZ3VyYXRpb24gPSBjb25maWd1cmF0aW9uXG4gICAgdGhpcy5ob3N0ID0gaG9zdFxuICAgIHRoaXMucG9ydCA9IHBvcnRcbiAgICB0aGlzLmVudmlyb25tZW50ID0gU3RyaW5nKGNvbmZpZ3VyYXRpb24uZ2V0RW52aXJvbm1lbnQoKSlcbiAgICAvLyBTY29wZSB0aGUgbG9jayBuYW1lIGJ5IGVudmlyb25tZW50IGFuZCBrZWVwIHRoZSBzZWdtZW50IGZpbGVzeXN0ZW0tc2FmZSxcbiAgICAvLyBzbyBvZGQgZW52aXJvbm1lbnQgbmFtZXMgY2FuIG5ldmVyIGVzY2FwZSB0bXAvIG9yIGNvbGxpZGUgd2l0aCBlYWNoIG90aGVyLlxuICAgIHRoaXMubG9ja05hbWUgPSBgc2VydmVyLiR7dGhpcy5lbnZpcm9ubWVudC5yZXBsYWNlKC9bXmEtekEtWjAtOS5fLV0vZywgXCJfXCIpfWBcbiAgICB0aGlzLmxvY2tQYXRoID0gcGF0aC5qb2luKGNvbmZpZ3VyYXRpb24uZ2V0RGlyZWN0b3J5KCksIFwidG1wXCIsIGAke3RoaXMubG9ja05hbWV9LmxvY2tgKVxuICAgIHRoaXMuYmFja2VuZCA9IG5ldyBBZHZpc29yeUxvY2tGaWxlQmFja2VuZCh7XG4gICAgICBkaXJlY3Rvcnk6IHBhdGguam9pbihjb25maWd1cmF0aW9uLmdldERpcmVjdG9yeSgpLCBcInRtcFwiKSxcbiAgICAgIGV4dHJhT3duZXJGaWVsZHM6IHtob3N0OiB0aGlzLmhvc3QsIHBvcnQ6IHRoaXMucG9ydH0sXG4gICAgICBwYXRoU3R5bGU6IFwicGxhaW5cIlxuICAgIH0pXG4gICAgdGhpcy5hY3F1aXJlZCA9IGZhbHNlXG4gIH1cblxuICAvKipcbiAgICogQWNxdWlyZXMgdGhlIGFwcC1kaXJlY3RvcnkgKyBlbnZpcm9ubWVudCBIVFRQIHNlcnZlciBsb2NrIGJlZm9yZSBzdGFydHVwXG4gICAqIHNpZGUgZWZmZWN0cyBydW4uIEEgc3RhbGUgbG9jayAoZGVhZCBsb2NhbCBvd25lciBvciBleHBpcmVkIGxlYXNlKSBpc1xuICAgKiByZWNsYWltZWQgYnkgdGhlIGJhY2tlbmQ7IGEgbGl2ZSBmb3JlaWduIG93bmVyIGluIHRoZSBzYW1lIGVudmlyb25tZW50XG4gICAqIGZhaWxzIGxvdWRseSB3aXRoIHRoZSBvd25lciBkZXRhaWxzLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBhZnRlciB0aGUgbG9jayBoYXMgYmVlbiBhY3F1aXJlZC5cbiAgICovXG4gIGFzeW5jIGFjcXVpcmUoKSB7XG4gICAgY29uc3QgYWNxdWlyZWQgPSBhd2FpdCB0aGlzLmJhY2tlbmQuYWNxdWlyZSh0aGlzLmxvY2tOYW1lLCB7dGltZW91dE1zOiAwfSlcblxuICAgIGlmICghYWNxdWlyZWQpIHRocm93IG5ldyBFcnJvcihhd2FpdCB0aGlzLmxvY2tIZWxkTWVzc2FnZSgpKVxuXG4gICAgdGhpcy5hY3F1aXJlZCA9IHRydWVcbiAgfVxuXG4gIC8qKlxuICAgKiBSZWxlYXNlcyB0aGUgaGVsZCBlbnZpcm9ubWVudC1zY29wZWQgSFRUUCBzZXJ2ZXIgbG9jayBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHZvaWQ+fSAtIFJlc29sdmVzIGFmdGVyIGJlc3QtZWZmb3J0IGxvY2sgcmVsZWFzZS5cbiAgICovXG4gIGFzeW5jIHJlbGVhc2UoKSB7XG4gICAgaWYgKCF0aGlzLmFjcXVpcmVkKSByZXR1cm5cblxuICAgIHRoaXMuYWNxdWlyZWQgPSBmYWxzZVxuICAgIGF3YWl0IHRoaXMuYmFja2VuZC5yZWxlYXNlKHRoaXMubG9ja05hbWUpXG4gIH1cblxuICAvKipcbiAgICogUmVhZHMgb3duZXIgbWV0YWRhdGEgZnJvbSBhbiBleGlzdGluZyBzZXJ2ZXIgbG9jayBkaXJlY3RvcnkuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPGltcG9ydChcIi4uL2RhdGFiYXNlL2Fkdmlzb3J5LWxvY2stZmlsZS1iYWNrZW5kLmpzXCIpLkFkdmlzb3J5TG9ja0ZpbGVPd25lciB8IG51bGw+fSAtIFBhcnNlZCBvd25lciBtZXRhZGF0YSwgd2hlbiByZWFkYWJsZS5cbiAgICovXG4gIGFzeW5jIHJlYWRPd25lck1ldGFkYXRhKCkge1xuICAgIHJldHVybiBhd2FpdCB0aGlzLmJhY2tlbmQuaG9sZGVySW5mbyh0aGlzLmxvY2tOYW1lKVxuICB9XG5cbiAgLyoqXG4gICAqIEJ1aWxkcyBhIGR1cGxpY2F0ZS1zZXJ2ZXIgZXJyb3IgbWVzc2FnZSB3aXRoIG93bmVyIGRldGFpbHMgd2hlbiBhdmFpbGFibGUuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPHN0cmluZz59IC0gRXJyb3IgbWVzc2FnZSBleHBsYWluaW5nIHdoaWNoIHNlcnZlciBvd25zIHRoZSBsb2NrLlxuICAgKi9cbiAgYXN5bmMgbG9ja0hlbGRNZXNzYWdlKCkge1xuICAgIGNvbnN0IG93bmVyID0gYXdhaXQgdGhpcy5yZWFkT3duZXJNZXRhZGF0YSgpXG4gICAgY29uc3QgZGV0YWlscyA9IG93bmVyXG4gICAgICA/IGBQSUQgJHtTdHJpbmcob3duZXIucGlkKX0gb24gJHtTdHJpbmcob3duZXIuaG9zdG5hbWUpfSAoJHtTdHJpbmcob3duZXIuaG9zdCl9OiR7U3RyaW5nKG93bmVyLnBvcnQpfSlgXG4gICAgICA6IGBsb2NrIGRpcmVjdG9yeSAke3RoaXMubG9ja1BhdGh9YFxuXG4gICAgcmV0dXJuIGBBIFZlbG9jaW91cyBIVFRQIHNlcnZlciBpcyBhbHJlYWR5IHJ1bm5pbmcgZm9yIHRoaXMgYXBwbGljYXRpb24gaW4gdGhlICR7dGhpcy5lbnZpcm9ubWVudH0gZW52aXJvbm1lbnQgKCR7ZGV0YWlsc30pLiBSZW1vdmUgJHt0aGlzLmxvY2tQYXRofSBpZiB0aGUgc2VydmVyIGlzIG5vIGxvbmdlciBydW5uaW5nLmBcbiAgfVxufVxuIl19
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "velocious": "build/bin/velocious.js"
4
4
  },
5
5
  "name": "velocious",
6
- "version": "1.0.726",
6
+ "version": "1.0.727",
7
7
  "main": "build/index.js",
8
8
  "types": "build/index.d.ts",
9
9
  "files": [
@@ -882,7 +882,7 @@
882
882
  * behavior; the file backend is disabled by default and only selectable by
883
883
  * explicit configuration.
884
884
  * @typedef {object} AdvisoryLocksConfiguration
885
- * @property {{file?: {directory?: string, enabled?: boolean, leaseMs?: number, renewIntervalMs?: number}, lockServer?: {authToken?: string, connectTimeoutMs?: number, enabled?: boolean, host?: string, leaseMs?: number, port?: number, reprobeCooldownMs?: number, url?: string}}} [backends] - Backend enablement. `file.enabled` defaults to false; enabling it is the deployment's explicit single-host declaration. `lockServer` defaults to enabled when a host/port/url or the `VELOCIOUS_LOCK_SERVER_HOST`/`_PORT` env pair is configured.
885
+ * @property {{file?: {directory?: string, enabled?: boolean, leaseMs?: number, renewIntervalMs?: number}, lockServer?: {authToken?: string, connectTimeoutMs?: number, enabled?: boolean, host?: string, leaseMs?: number, mode?: "embedded" | "external" | "local", port?: number, reprobeCooldownMs?: number, socketPath?: string, url?: string}}} [backends] - Backend enablement. `file.enabled` defaults to false; enabling it is the deployment's explicit single-host declaration. `lockServer` defaults to enabled when a host/port/url or the `VELOCIOUS_LOCK_SERVER_HOST`/`_PORT` env pair is configured.
886
886
  * @property {import("./database/advisory-lock-backend-policy.js").AdvisoryLockBackendPolicyEntry[]} [policy] - Per-lock-name minimum/allowed/preferred tier rules (design §5).
887
887
  */
888
888
 
@@ -4234,7 +4234,7 @@ export default class VelociousConfiguration {
4234
4234
  * Full backward compatibility: an app that configures nothing gets today's
4235
4235
  * driver-native-only behavior — the file backend is **disabled by default**
4236
4236
  * and only ever selectable by explicit configuration.
4237
- * @returns {{backends: {file: {directory?: string, enabled: boolean, leaseMs: number, renewIntervalMs: number}, lockServer: {authToken: string, connectTimeoutMs: number, enabled: boolean, leaseMs: number, reprobeCooldownMs: number, url: string}}, policy: import("./database/advisory-lock-backend-policy.js").AdvisoryLockBackendPolicyEntry[]}} - Advisory-lock configuration with defaults applied.
4237
+ * @returns {{backends: {file: {directory?: string, enabled: boolean, leaseMs: number, renewIntervalMs: number}, lockServer: {authToken: string, connectTimeoutMs: number, enabled: boolean, leaseMs: number, mode: "embedded" | "external" | "local", reprobeCooldownMs: number, socketPath: string, url: string}}, policy: import("./database/advisory-lock-backend-policy.js").AdvisoryLockBackendPolicyEntry[]}} - Advisory-lock configuration with defaults applied.
4238
4238
  */
4239
4239
  getAdvisoryLockConfig() {
4240
4240
  const configured = this._advisoryLocks || {}
@@ -4249,6 +4249,15 @@ export default class VelociousConfiguration {
4249
4249
  : (typeof envPort === "number" && Number.isFinite(envPort) ? envPort : 3006)
4250
4250
  const lockServerUrl = lockServerConfigured.url
4251
4251
  || `ws://${lockServerHost || "127.0.0.1"}:${lockServerPort}/websocket`
4252
+ // STC-715: `embedded` runs the lock-server engine in this process, `local`
4253
+ // spawns it as a child over stdio JSON-lines. Both default `enabled` to true
4254
+ // when the mode is named explicitly — no host/port/url required. `external`
4255
+ // (the default) keeps today's rule: enabled only via url/host/port config
4256
+ // or the env pair, so an app that configures nothing is unchanged.
4257
+ const configuredMode = lockServerConfigured.mode
4258
+ const lockServerMode = configuredMode === "embedded" || configuredMode === "local" || configuredMode === "external"
4259
+ ? configuredMode
4260
+ : "external"
4252
4261
 
4253
4262
  return {
4254
4263
  backends: {
@@ -4265,9 +4274,13 @@ export default class VelociousConfiguration {
4265
4274
  connectTimeoutMs: typeof lockServerConfigured.connectTimeoutMs === "number" ? lockServerConfigured.connectTimeoutMs : 3000,
4266
4275
  enabled: typeof lockServerConfigured.enabled === "boolean"
4267
4276
  ? lockServerConfigured.enabled
4268
- : Boolean(lockServerConfigured.url || lockServerConfigured.host || envHost || typeof lockServerConfigured.port === "number" || envPortRaw),
4277
+ : lockServerMode === "external"
4278
+ ? Boolean(lockServerConfigured.url || lockServerConfigured.host || envHost || typeof lockServerConfigured.port === "number" || envPortRaw)
4279
+ : true,
4269
4280
  leaseMs: typeof lockServerConfigured.leaseMs === "number" ? lockServerConfigured.leaseMs : 30_000,
4281
+ mode: lockServerMode,
4270
4282
  reprobeCooldownMs: typeof lockServerConfigured.reprobeCooldownMs === "number" ? lockServerConfigured.reprobeCooldownMs : 5000,
4283
+ socketPath: typeof lockServerConfigured.socketPath === "string" ? lockServerConfigured.socketPath : "",
4271
4284
  url: lockServerUrl
4272
4285
  }
4273
4286
  },
@@ -4337,11 +4350,13 @@ export default class VelociousConfiguration {
4337
4350
  authToken: config.backends.lockServer.authToken,
4338
4351
  connectTimeoutMs: config.backends.lockServer.connectTimeoutMs,
4339
4352
  leaseMs: config.backends.lockServer.leaseMs,
4353
+ mode: config.backends.lockServer.mode,
4340
4354
  onError: (/** @type {Error} */ error) => {
4341
4355
  this.getErrorEvents().emit("framework-error", {context: "advisory-lock-lock-server", error})
4342
4356
  this.getErrorEvents().emit("all-error", {context: "advisory-lock-lock-server", error, errorType: "framework-error"})
4343
4357
  },
4344
4358
  reprobeCooldownMs: config.backends.lockServer.reprobeCooldownMs,
4359
+ socketPath: config.backends.lockServer.socketPath,
4345
4360
  url: config.backends.lockServer.url
4346
4361
  })
4347
4362
 
@@ -1,8 +1,5 @@
1
1
  // @ts-check
2
2
 
3
- import WebSocket from "ws"
4
-
5
- import VelociousWebsocketClient from "../http-client/websocket-client.js"
6
3
  import {AdvisoryLockServiceUnavailableError} from "./advisory-lock-errors.js"
7
4
 
8
5
  /**
@@ -40,6 +37,13 @@ const LOCK_SERVER_CONNECTION_TYPE = "lock"
40
37
  *
41
38
  * Unavailability is cached for `reprobeCooldownMs` so a flapping server cannot
42
39
  * turn every waiting caller into a connection attempt (design §2).
40
+ *
41
+ * The transport is injected through `clientFactory` (STC-715): this module no
42
+ * longer imports `ws` itself, so it is safe for browser/Expo bundles. The Node
43
+ * handler injects the websocket transport for `external` mode, the spawned
44
+ * stdio/UDS client for `local` mode, and the in-process engine client for
45
+ * `embedded` mode — all three speak the same protocol surface through this
46
+ * adapter.
43
47
  */
44
48
  export default class AdvisoryLockLockServerBackend {
45
49
  /**
@@ -47,14 +51,14 @@ export default class AdvisoryLockLockServerBackend {
47
51
  * constructing this object never performs I/O.
48
52
  * @param {object} args - Backend options.
49
53
  * @param {string} [args.authToken] - Shared secret; the server fails closed without a matching token.
50
- * @param {(args: {authToken: string, url: string}) => LockServerClientLike} [args.clientFactory] - Transport factory (tests inject a fake).
54
+ * @param {(args: {authToken: string, url: string}) => LockServerClientLike} args.clientFactory - Transport factory injected by the environment handler (websocket for external mode, spawned child for local mode, in-process engine for embedded mode).
51
55
  * @param {number} [args.connectTimeoutMs] - Handshake timeout.
52
56
  * @param {number} [args.leaseMs] - Lease duration used until the server advertises its own.
53
57
  * @param {(error: Error) => void} [args.onError] - Async error reporter.
54
58
  * @param {number} [args.reprobeCooldownMs] - How long an unavailable server is not re-probed.
55
- * @param {string} args.url - Lock-server websocket URL.
59
+ * @param {string} args.url - Lock-server endpoint (websocket URL for external mode; informational for embedded/local modes).
56
60
  */
57
- constructor({authToken = "", clientFactory = defaultClientFactory, connectTimeoutMs = 3000, leaseMs = 30_000, onError, reprobeCooldownMs = 5000, url}) {
61
+ constructor({authToken = "", clientFactory, connectTimeoutMs = 3000, leaseMs = 30_000, onError, reprobeCooldownMs = 5000, url}) {
58
62
  this.url = url
59
63
  this.authToken = authToken
60
64
  this.clientFactory = clientFactory
@@ -117,6 +121,8 @@ export default class AdvisoryLockLockServerBackend {
117
121
  this.status.lastProbeAt = new Date().toISOString()
118
122
 
119
123
  try {
124
+ if (typeof this.clientFactory !== "function") throw new Error("The lock-server backend requires a clientFactory transport from the environment handler")
125
+
120
126
  const client = this.clientFactory({authToken: this.authToken, url: this.url})
121
127
 
122
128
  this.client = client
@@ -350,6 +356,24 @@ export default class AdvisoryLockLockServerBackend {
350
356
  return
351
357
  }
352
358
 
359
+ // Transport-side death (spawned child exited, embedded engine closed):
360
+ // fail every pending request now and start the re-probe cooldown instead
361
+ // of letting each request burn its own timeout. This is the crash-detection
362
+ // half of the local-mode lifecycle (STC-715); the cooldown is the restart
363
+ // backoff and the next acquisition spawns the child again.
364
+ if (body.type === "response" && body.transportClosed === true) {
365
+ const error = new AdvisoryLockServiceUnavailableError(
366
+ `Lock server ${this.url} transport closed: ${String(body.error || "transport closed")}`,
367
+ {lockName: "", reason: "transport-closed"}
368
+ )
369
+
370
+ this.markUnavailable(error)
371
+ this.teardown()
372
+ this.reportError(error)
373
+
374
+ return
375
+ }
376
+
353
377
  if (body.type === "lost") {
354
378
  const name = String(body.name ?? "")
355
379
  const hold = this.holds.get(name)
@@ -547,21 +571,3 @@ export default class AdvisoryLockLockServerBackend {
547
571
  if (this.onError) this.onError(normalized)
548
572
  }
549
573
  }
550
-
551
- /**
552
- * Default transport factory: the framework websocket client with the Node
553
- * `ws` implementation bound explicitly (no global mutation).
554
- * @param {{authToken: string, url: string}} args - Connection args.
555
- * @returns {LockServerClientLike} - Websocket client.
556
- */
557
- function defaultClientFactory({url}) {
558
- // Node's global WebSocket is not guaranteed to exist, so the implementation is
559
- // bound explicitly instead of mutating `globalThis`.
560
- const webSocketImplementation = /** @type {typeof globalThis.WebSocket} */ (/** @type {unknown} */ (WebSocket))
561
-
562
- return /** @type {LockServerClientLike} */ (/** @type {unknown} */ (new VelociousWebsocketClient({
563
- heartbeatIntervalMs: 10_000,
564
- url,
565
- webSocketImplementation
566
- })))
567
- }
@@ -0,0 +1,74 @@
1
+ // @ts-check
2
+
3
+ import AdvisoryLockLockServerEngine from "./advisory-lock-lock-server-engine.js"
4
+
5
+ /**
6
+ * @typedef {import("./advisory-lock-lock-server-backend.js").LockServerClientLike} LockServerClientLike
7
+ * @typedef {import("./advisory-lock-lock-server-backend.js").LockServerConnectionLike} LockServerConnectionLike
8
+ */
9
+
10
+ /**
11
+ * In-process transport factory for the `embedded` lock-server mode (STC-715).
12
+ * It wires the lock-server backend adapter to an `AdvisoryLockLockServerEngine`
13
+ * living in the same process over plain function calls — no sockets, no `ws`,
14
+ * no Node builtins — so browser/Expo bundles can run the lock-server tier.
15
+ *
16
+ * The engine mints the holder id for the connection exactly like the external
17
+ * daemon does over the websocket transport, so the adapter's lease/epoch/
18
+ * fencing behavior is identical across modes.
19
+ * @param {AdvisoryLockLockServerEngine} engine - Engine this transport connects to.
20
+ * @returns {(args: {authToken: string, url: string}) => LockServerClientLike} - Client factory for the backend adapter.
21
+ */
22
+ export function createEmbeddedLockServerClientFactory(engine) {
23
+ return () => {
24
+ /** @type {string | null} */
25
+ let connectionId = null
26
+ /** @type {((body: Record<string, unknown>) => void) | null} */
27
+ let onMessage = null
28
+
29
+ /** @type {LockServerClientLike} */
30
+ const client = {
31
+ async connect() {},
32
+
33
+ close() {
34
+ if (connectionId !== null) engine.connectionClose(connectionId)
35
+
36
+ connectionId = null
37
+ },
38
+
39
+ openConnection(_type, {onMessage: messageHandler}) {
40
+ onMessage = messageHandler
41
+
42
+ connectionId = engine.openConnection({
43
+ onClose: () => {
44
+ onMessage?.({error: "Embedded lock server engine is closed", status: "transport-closed", transportClosed: true, type: "response"})
45
+ },
46
+ send: (/** @type {Record<string, unknown>} */ body) => messageHandler(body)
47
+ })
48
+
49
+ // The engine answers the connection-open frame with a hello-ack, just
50
+ // like the external daemon does after verifying auth and protocol.
51
+ queueMicrotask(() => messageHandler({leaseMs: engine.leaseMs, protocolVersion: 2, type: "hello-ack"}))
52
+
53
+ /** @type {LockServerConnectionLike} */
54
+ const connection = {
55
+ close: () => {
56
+ if (connectionId !== null) engine.connectionClose(connectionId)
57
+
58
+ connectionId = null
59
+ },
60
+ ready: Promise.resolve(),
61
+ sendMessage: (/** @type {Record<string, unknown>} */ body) => {
62
+ if (connectionId === null) throw new Error("Embedded lock server connection is not open")
63
+
64
+ engine.handleMessage(connectionId, body)
65
+ }
66
+ }
67
+
68
+ return connection
69
+ }
70
+ }
71
+
72
+ return client
73
+ }
74
+ }