velocious 1.0.726 → 1.0.728
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.
- package/README.md +2 -2
- package/bin/velocious.js +2 -19
- package/build/application.js +32 -3
- package/build/background-jobs/main.js +9 -1
- package/build/background-jobs/worker.js +69 -6
- package/build/bin/velocious.js +2 -19
- package/build/cli/process-args.js +34 -0
- package/build/configuration-types.js +1 -1
- package/build/configuration.js +43 -2
- package/build/database/advisory-lock-lock-server-backend.js +30 -24
- package/build/database/advisory-lock-lock-server-embedded-client.js +74 -0
- package/build/database/advisory-lock-lock-server-engine.js +544 -0
- package/build/database/advisory-lock-lock-server-local-client.js +260 -0
- package/build/database/advisory-lock-lock-server-socket-path.js +17 -0
- package/build/database/advisory-lock-lock-server-transport.js +30 -0
- package/build/database/drivers/base.js +34 -12
- package/build/database/drivers/mssql/index.js +17 -18
- package/build/database/drivers/mssql/table.js +28 -25
- package/build/database/drivers/mysql/index.js +15 -18
- package/build/database/drivers/mysql/table.js +31 -23
- package/build/database/drivers/pgsql/index.js +15 -18
- package/build/database/drivers/pgsql/table.js +28 -26
- package/build/database/drivers/sqlite/base.js +7 -9
- package/build/database/drivers/sqlite/table.js +32 -26
- package/build/database/pool/async-tracked-multi-connection.js +1 -0
- package/build/database/pool/base.js +14 -4
- package/build/database/pool/single-multi-use.js +1 -0
- package/build/database/record/auditing.js +89 -11
- package/build/database/record/index.js +1 -1
- package/build/environment-handlers/base.js +50 -9
- package/build/environment-handlers/node/advisory-lock-lock-server-local-server.js +206 -0
- package/build/environment-handlers/node/cli/commands/server.js +1 -0
- package/build/environment-handlers/node.js +30 -3
- package/build/http-server/server-lock.js +55 -18
- package/build/src/application.d.ts +7 -4
- package/build/src/application.d.ts.map +1 -1
- package/build/src/application.js +27 -4
- package/build/src/background-jobs/main.d.ts +2 -1
- package/build/src/background-jobs/main.d.ts.map +1 -1
- package/build/src/background-jobs/main.js +10 -2
- package/build/src/background-jobs/worker.d.ts +42 -0
- package/build/src/background-jobs/worker.d.ts.map +1 -1
- package/build/src/background-jobs/worker.js +61 -5
- package/build/src/cli/process-args.d.ts +11 -0
- package/build/src/cli/process-args.d.ts.map +1 -0
- package/build/src/cli/process-args.js +34 -0
- package/build/src/configuration-types.d.ts +3 -1
- package/build/src/configuration-types.d.ts.map +1 -1
- package/build/src/configuration-types.js +2 -2
- package/build/src/configuration.d.ts +16 -1
- package/build/src/configuration.d.ts.map +1 -1
- package/build/src/configuration.js +39 -3
- package/build/src/database/advisory-lock-lock-server-backend.d.ts +10 -3
- package/build/src/database/advisory-lock-lock-server-backend.d.ts.map +1 -1
- package/build/src/database/advisory-lock-lock-server-backend.js +25 -22
- package/build/src/database/advisory-lock-lock-server-embedded-client.d.ts +24 -0
- package/build/src/database/advisory-lock-lock-server-embedded-client.d.ts.map +1 -0
- package/build/src/database/advisory-lock-lock-server-embedded-client.js +64 -0
- package/build/src/database/advisory-lock-lock-server-engine.d.ts +285 -0
- package/build/src/database/advisory-lock-lock-server-engine.d.ts.map +1 -0
- package/build/src/database/advisory-lock-lock-server-engine.js +460 -0
- package/build/src/database/advisory-lock-lock-server-local-client.d.ts +114 -0
- package/build/src/database/advisory-lock-lock-server-local-client.d.ts.map +1 -0
- package/build/src/database/advisory-lock-lock-server-local-client.js +227 -0
- package/build/src/database/advisory-lock-lock-server-socket-path.d.ts +9 -0
- package/build/src/database/advisory-lock-lock-server-socket-path.d.ts.map +1 -0
- package/build/src/database/advisory-lock-lock-server-socket-path.js +16 -0
- package/build/src/database/advisory-lock-lock-server-transport.d.ts +18 -0
- package/build/src/database/advisory-lock-lock-server-transport.d.ts.map +1 -0
- package/build/src/database/advisory-lock-lock-server-transport.js +27 -0
- package/build/src/database/drivers/base.d.ts +15 -2
- package/build/src/database/drivers/base.d.ts.map +1 -1
- package/build/src/database/drivers/base.js +33 -13
- package/build/src/database/drivers/mssql/index.d.ts +2 -2
- package/build/src/database/drivers/mssql/index.d.ts.map +1 -1
- package/build/src/database/drivers/mssql/index.js +17 -18
- package/build/src/database/drivers/mssql/table.d.ts.map +1 -1
- package/build/src/database/drivers/mssql/table.js +25 -23
- package/build/src/database/drivers/mysql/index.d.ts +2 -2
- package/build/src/database/drivers/mysql/index.d.ts.map +1 -1
- package/build/src/database/drivers/mysql/index.js +16 -19
- package/build/src/database/drivers/mysql/table.d.ts.map +1 -1
- package/build/src/database/drivers/mysql/table.js +27 -22
- package/build/src/database/drivers/pgsql/index.d.ts +2 -2
- package/build/src/database/drivers/pgsql/index.d.ts.map +1 -1
- package/build/src/database/drivers/pgsql/index.js +16 -19
- package/build/src/database/drivers/pgsql/table.d.ts.map +1 -1
- package/build/src/database/drivers/pgsql/table.js +25 -23
- package/build/src/database/drivers/sqlite/base.d.ts.map +1 -1
- package/build/src/database/drivers/sqlite/base.js +8 -10
- package/build/src/database/drivers/sqlite/table.d.ts.map +1 -1
- package/build/src/database/drivers/sqlite/table.js +29 -25
- package/build/src/database/pool/async-tracked-multi-connection.d.ts.map +1 -1
- package/build/src/database/pool/async-tracked-multi-connection.js +2 -1
- package/build/src/database/pool/base.d.ts +6 -0
- package/build/src/database/pool/base.d.ts.map +1 -1
- package/build/src/database/pool/base.js +14 -5
- package/build/src/database/pool/single-multi-use.d.ts.map +1 -1
- package/build/src/database/pool/single-multi-use.js +2 -1
- package/build/src/database/record/auditing.d.ts +14 -4
- package/build/src/database/record/auditing.d.ts.map +1 -1
- package/build/src/database/record/auditing.js +77 -12
- package/build/src/database/record/index.d.ts +4 -2
- package/build/src/database/record/index.d.ts.map +1 -1
- package/build/src/database/record/index.js +2 -2
- package/build/src/environment-handlers/base.d.ts +86 -7
- package/build/src/environment-handlers/base.d.ts.map +1 -1
- package/build/src/environment-handlers/base.js +48 -9
- package/build/src/environment-handlers/node/advisory-lock-lock-server-local-server.d.ts +2 -0
- package/build/src/environment-handlers/node/advisory-lock-lock-server-local-server.d.ts.map +1 -0
- package/build/src/environment-handlers/node/advisory-lock-lock-server-local-server.js +179 -0
- package/build/src/environment-handlers/node/cli/commands/server.d.ts.map +1 -1
- package/build/src/environment-handlers/node/cli/commands/server.js +2 -1
- package/build/src/environment-handlers/node.d.ts +10 -4
- package/build/src/environment-handlers/node.d.ts.map +1 -1
- package/build/src/environment-handlers/node.js +30 -4
- package/build/src/http-server/server-lock.d.ts +43 -14
- package/build/src/http-server/server-lock.d.ts.map +1 -1
- package/build/src/http-server/server-lock.js +54 -19
- package/build/src/tenants/default-tenant-database-provisioning.d.ts.map +1 -1
- package/build/src/tenants/default-tenant-database-provisioning.js +7 -1
- package/build/tenants/default-tenant-database-provisioning.js +8 -0
- package/package.json +2 -2
- package/src/application.js +32 -3
- package/src/background-jobs/main.js +9 -1
- package/src/background-jobs/worker.js +69 -6
- package/src/cli/process-args.js +34 -0
- package/src/configuration-types.js +1 -1
- package/src/configuration.js +43 -2
- package/src/database/advisory-lock-lock-server-backend.js +30 -24
- package/src/database/advisory-lock-lock-server-embedded-client.js +74 -0
- package/src/database/advisory-lock-lock-server-engine.js +544 -0
- package/src/database/advisory-lock-lock-server-local-client.js +260 -0
- package/src/database/advisory-lock-lock-server-socket-path.js +17 -0
- package/src/database/advisory-lock-lock-server-transport.js +30 -0
- package/src/database/drivers/base.js +34 -12
- package/src/database/drivers/mssql/index.js +17 -18
- package/src/database/drivers/mssql/table.js +28 -25
- package/src/database/drivers/mysql/index.js +15 -18
- package/src/database/drivers/mysql/table.js +31 -23
- package/src/database/drivers/pgsql/index.js +15 -18
- package/src/database/drivers/pgsql/table.js +28 -26
- package/src/database/drivers/sqlite/base.js +7 -9
- package/src/database/drivers/sqlite/table.js +32 -26
- package/src/database/pool/async-tracked-multi-connection.js +1 -0
- package/src/database/pool/base.js +14 -4
- package/src/database/pool/single-multi-use.js +1 -0
- package/src/database/record/auditing.js +89 -11
- package/src/database/record/index.js +1 -1
- package/src/environment-handlers/base.js +50 -9
- package/src/environment-handlers/node/advisory-lock-lock-server-local-server.js +206 -0
- package/src/environment-handlers/node/cli/commands/server.js +1 -0
- package/src/environment-handlers/node.js +30 -3
- package/src/http-server/server-lock.js +55 -18
- package/src/tenants/default-tenant-database-provisioning.js +8 -0
|
@@ -0,0 +1,460 @@
|
|
|
1
|
+
// @ts-check
|
|
2
|
+
/**
|
|
3
|
+
* One engine connection: the transport-side view of a lock client. `send`
|
|
4
|
+
* delivers engine messages (responses and `lost` pushes) back to the client.
|
|
5
|
+
* @typedef {object} LockServerEngineConnection
|
|
6
|
+
* @property {(body: Record<string, unknown>) => void} send - Delivers one engine message to this connection.
|
|
7
|
+
* @property {() => void} [onClose] - Engine-side close hook (transport teardown).
|
|
8
|
+
*/
|
|
9
|
+
/**
|
|
10
|
+
* One registered engine connection with its held lock names.
|
|
11
|
+
* @typedef {object} LockServerEngineRegisteredConnection
|
|
12
|
+
* @property {Map<string, number>} held - Lock names this connection holds, mapped to their granted epoch.
|
|
13
|
+
* @property {LockServerEngineConnection} connection - Transport-side connection.
|
|
14
|
+
* @property {string} id - Server-minted holder id.
|
|
15
|
+
* @property {boolean} open - False once the connection was closed.
|
|
16
|
+
*/
|
|
17
|
+
/**
|
|
18
|
+
* One queued acquire request waiting on the FIFO queue.
|
|
19
|
+
* @typedef {object} LockServerEngineWaiter
|
|
20
|
+
* @property {LockServerEngineRegisteredConnection} connection - Waiting connection.
|
|
21
|
+
* @property {string} correlationId - Request correlation echoed on the response.
|
|
22
|
+
* @property {number} [deadline] - Absolute deadline; absent waits indefinitely.
|
|
23
|
+
* @property {string} name - Lock name.
|
|
24
|
+
* @property {ReturnType<typeof setTimeout> | null} timer - Bounded-wait timeout timer.
|
|
25
|
+
*/
|
|
26
|
+
/**
|
|
27
|
+
* One lock name's live state in the engine.
|
|
28
|
+
* @typedef {object} LockServerEngineLockRecord
|
|
29
|
+
* @property {LockServerEngineRegisteredConnection | null} holder - Current lease holder, null when free.
|
|
30
|
+
* @property {number} epoch - Last granted fencing epoch (0 before the first grant).
|
|
31
|
+
* @property {number} leaseExpiresAt - When the current lease expires without renewal.
|
|
32
|
+
* @property {string} name - Lock name.
|
|
33
|
+
* @property {LockServerEngineWaiter[]} waiters - FIFO queue of pending acquires.
|
|
34
|
+
*/
|
|
35
|
+
/**
|
|
36
|
+
* One engine request message.
|
|
37
|
+
* @typedef {object} LockServerEngineRequest
|
|
38
|
+
* @property {string} correlationId - Client-generated id echoed on the response.
|
|
39
|
+
* @property {number} [epoch] - Holder epoch for `renew`/`release`.
|
|
40
|
+
* @property {string} name - Lock name.
|
|
41
|
+
* @property {number} [timeoutMs] - Bounded wait for `acquire`.
|
|
42
|
+
*/
|
|
43
|
+
/**
|
|
44
|
+
* Registers one engine connection with its server-minted holder id — exactly
|
|
45
|
+
* like the consens-lock daemon mints the holder id from the transport, so a
|
|
46
|
+
* client can only renew or release its own leases.
|
|
47
|
+
* @param {LockServerEngineConnection} connection - Transport-side connection.
|
|
48
|
+
* @param {string} id - Holder id.
|
|
49
|
+
* @returns {LockServerEngineRegisteredConnection} - Registered connection.
|
|
50
|
+
*/
|
|
51
|
+
function registeredConnection(connection, id) {
|
|
52
|
+
return { connection, held: new Map(), id, open: true };
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Shared lock-server engine implementing the consens-lock protocol v2 semantics
|
|
56
|
+
* in plain JS with no Node builtins and no sockets (STC-715). It is the single
|
|
57
|
+
* lease/epoch/fencing authority reused by every lock-server mode:
|
|
58
|
+
*
|
|
59
|
+
* - `embedded` mode runs it directly inside the environment process (the
|
|
60
|
+
* in-process transport feeds this same message surface over function calls),
|
|
61
|
+
* so browser/Expo bundles can use the lock-server tier without `ws`.
|
|
62
|
+
* - `local` mode runs it in a spawned child process over stdio JSON-lines
|
|
63
|
+
* (`src/environment-handlers/node/advisory-lock-lock-server-server.js`).
|
|
64
|
+
*
|
|
65
|
+
* Semantics mirror the external daemon (`docs/protocol.md` in
|
|
66
|
+
* `diestoeckels/consens-lock`): server-minted holder ids bound to the
|
|
67
|
+
* connection, leases renewed per third of `leaseMs`, a monotonic fencing epoch
|
|
68
|
+
* per lock name bumped on every grant and on every invalidation, a FIFO waiter
|
|
69
|
+
* queue per name, an expired-lease sweeper, and an asynchronous `lost` push so
|
|
70
|
+
* a fenced holder learns without waiting for its next renew.
|
|
71
|
+
*
|
|
72
|
+
* Grant decisions run synchronously in the engine's single event loop: the
|
|
73
|
+
* check-and-set on the holder map has no `await` between read and write, so
|
|
74
|
+
* two concurrent acquires can never both be granted.
|
|
75
|
+
*/
|
|
76
|
+
export default class AdvisoryLockLockServerEngine {
|
|
77
|
+
/**
|
|
78
|
+
* Creates one engine instance. No I/O happens here.
|
|
79
|
+
* @param {object} [args] - Engine options.
|
|
80
|
+
* @param {number} [args.leaseMs] - Lease duration per grant. Defaults to 30000.
|
|
81
|
+
* @param {number} [args.sweepIntervalMs] - Expired-lease sweep interval. Defaults to 200.
|
|
82
|
+
*/
|
|
83
|
+
constructor({ leaseMs = 30_000, sweepIntervalMs = 200 } = {}) {
|
|
84
|
+
this.leaseMs = leaseMs;
|
|
85
|
+
this.sweepIntervalMs = sweepIntervalMs;
|
|
86
|
+
/** @type {Map<string, LockServerEngineLockRecord>} */
|
|
87
|
+
this.locks = new Map();
|
|
88
|
+
/** @type {Map<string, number>} */
|
|
89
|
+
this.epochByLock = new Map();
|
|
90
|
+
/** @type {Map<string, LockServerEngineRegisteredConnection>} */
|
|
91
|
+
this.connections = new Map();
|
|
92
|
+
this.connectionCounter = 0;
|
|
93
|
+
this.closed = false;
|
|
94
|
+
/** @type {ReturnType<typeof setInterval> | null} */
|
|
95
|
+
this.sweepTimer = null;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* Starts the expired-lease sweeper (idempotent). Long-lived transports call
|
|
99
|
+
* this; the sweeper is the backstop for holders whose transport died without
|
|
100
|
+
* a close event.
|
|
101
|
+
* @returns {void}
|
|
102
|
+
*/
|
|
103
|
+
startSweeper() {
|
|
104
|
+
if (this.closed || this.sweepTimer)
|
|
105
|
+
return;
|
|
106
|
+
const timer = setInterval(() => this.sweep(), this.sweepIntervalMs);
|
|
107
|
+
timer.unref?.();
|
|
108
|
+
this.sweepTimer = timer;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Registers one connection (the transport opened it) and returns its
|
|
112
|
+
* server-minted holder id.
|
|
113
|
+
* @param {LockServerEngineConnection} connection - Transport-side connection.
|
|
114
|
+
* @returns {string} - Holder id bound to this connection.
|
|
115
|
+
*/
|
|
116
|
+
openConnection(connection) {
|
|
117
|
+
if (this.closed)
|
|
118
|
+
throw new Error("Lock server engine is closed");
|
|
119
|
+
const id = `engine-holder-${++this.connectionCounter}`;
|
|
120
|
+
const registered = registeredConnection(connection, id);
|
|
121
|
+
this.connections.set(id, registered);
|
|
122
|
+
this.connectionCounter = Math.max(this.connectionCounter, this.connections.size);
|
|
123
|
+
return id;
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Returns the registered connection for one transport connection id,
|
|
127
|
+
* auto-registering the given transport view when the first message arrives
|
|
128
|
+
* before an explicit open (the stdio server has no separate connection-open
|
|
129
|
+
* frame per client).
|
|
130
|
+
* @param {string} connectionId - Transport connection id.
|
|
131
|
+
* @param {LockServerEngineConnection} [transport] - Transport view to register when the id is new.
|
|
132
|
+
* @returns {LockServerEngineRegisteredConnection | null} - Registered connection, or null when the engine is closed.
|
|
133
|
+
*/
|
|
134
|
+
ensureConnection(connectionId, transport) {
|
|
135
|
+
if (this.closed)
|
|
136
|
+
return null;
|
|
137
|
+
const existing = this.connections.get(connectionId);
|
|
138
|
+
if (existing)
|
|
139
|
+
return existing;
|
|
140
|
+
const registered = registeredConnection(transport || { send: () => { } }, connectionId);
|
|
141
|
+
this.connections.set(connectionId, registered);
|
|
142
|
+
this.connectionCounter = Math.max(this.connectionCounter, this.connections.size);
|
|
143
|
+
return registered;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Handles one request message from a connection and answers it (or queues
|
|
147
|
+
* the wait) through the connection's `send`.
|
|
148
|
+
* @param {string} connectionId - Connection the message arrived on.
|
|
149
|
+
* @param {Record<string, unknown>} body - Request message.
|
|
150
|
+
* @returns {void}
|
|
151
|
+
*/
|
|
152
|
+
handleMessage(connectionId, body) {
|
|
153
|
+
const registered = this.ensureConnection(connectionId);
|
|
154
|
+
if (this.closed || !registered || !registered.open || !body || typeof body !== "object")
|
|
155
|
+
return;
|
|
156
|
+
// Transport-level frames (the connection-open params carrying auth and
|
|
157
|
+
// protocol version) are answered by the transport's hello-ack, not here;
|
|
158
|
+
// only request/response traffic with a correlationId reaches the engine.
|
|
159
|
+
if (body.type === "hello" || typeof body.correlationId !== "string")
|
|
160
|
+
return;
|
|
161
|
+
const correlationId = typeof body.correlationId === "string" ? body.correlationId : "";
|
|
162
|
+
const name = typeof body.name === "string" ? body.name : "";
|
|
163
|
+
switch (body.type) {
|
|
164
|
+
case "acquire":
|
|
165
|
+
this.handleAcquire(registered, { correlationId, name, timeoutMs: typeof body.timeoutMs === "number" ? body.timeoutMs : undefined });
|
|
166
|
+
return;
|
|
167
|
+
case "try-acquire":
|
|
168
|
+
this.handleTryAcquire(registered, { correlationId, name });
|
|
169
|
+
return;
|
|
170
|
+
case "renew":
|
|
171
|
+
this.handleRenew(registered, { correlationId, epoch: typeof body.epoch === "number" ? body.epoch : -1, name });
|
|
172
|
+
return;
|
|
173
|
+
case "release":
|
|
174
|
+
this.handleRelease(registered, { correlationId, epoch: typeof body.epoch === "number" ? body.epoch : undefined, name });
|
|
175
|
+
return;
|
|
176
|
+
case "who-holds":
|
|
177
|
+
this.respond(registered, correlationId, { holder: this.holderInfo(name), type: "response" });
|
|
178
|
+
return;
|
|
179
|
+
case "list":
|
|
180
|
+
this.respond(registered, correlationId, { holders: this.listHolders(), type: "response" });
|
|
181
|
+
return;
|
|
182
|
+
default:
|
|
183
|
+
this.respond(registered, correlationId, { error: `Unknown lock-server request type: ${String(body.type)}`, status: "error", type: "response" });
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
/**
|
|
187
|
+
* Removes a connection and releases every lease it holds immediately — the
|
|
188
|
+
* same transport-close semantics the external daemon has.
|
|
189
|
+
* @param {string} connectionId - Registered connection id.
|
|
190
|
+
* @returns {void}
|
|
191
|
+
*/
|
|
192
|
+
connectionClose(connectionId) {
|
|
193
|
+
const registered = this.connections.get(connectionId);
|
|
194
|
+
if (!registered)
|
|
195
|
+
return;
|
|
196
|
+
this.connections.delete(connectionId);
|
|
197
|
+
registered.open = false;
|
|
198
|
+
for (const name of [...registered.held.keys()]) {
|
|
199
|
+
const record = this.locks.get(name);
|
|
200
|
+
if (!record || record.holder !== registered)
|
|
201
|
+
continue;
|
|
202
|
+
record.holder = null;
|
|
203
|
+
registered.held.delete(name);
|
|
204
|
+
this.grantNext(record);
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* Stops the sweeper and closes every connection (shutdown path).
|
|
209
|
+
* @returns {void}
|
|
210
|
+
*/
|
|
211
|
+
close() {
|
|
212
|
+
this.closed = true;
|
|
213
|
+
if (this.sweepTimer) {
|
|
214
|
+
clearInterval(this.sweepTimer);
|
|
215
|
+
this.sweepTimer = null;
|
|
216
|
+
}
|
|
217
|
+
for (const registered of [...this.connections.values()]) {
|
|
218
|
+
try {
|
|
219
|
+
registered.connection.onClose?.();
|
|
220
|
+
}
|
|
221
|
+
catch {
|
|
222
|
+
// A failing transport close hook must not block the shutdown of the
|
|
223
|
+
// remaining connections.
|
|
224
|
+
}
|
|
225
|
+
this.connections.delete(registered.id);
|
|
226
|
+
registered.open = false;
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
/**
|
|
230
|
+
* Handles `acquire`: grants immediately, answers `already-held` for a
|
|
231
|
+
* re-entrant acquisition, or joins the name's FIFO waiter queue with a
|
|
232
|
+
* bounded timeout.
|
|
233
|
+
* @param {LockServerEngineRegisteredConnection} registered - Requesting connection.
|
|
234
|
+
* @param {LockServerEngineRequest & {timeoutMs?: number}} request - Request fields.
|
|
235
|
+
* @returns {void}
|
|
236
|
+
*/
|
|
237
|
+
handleAcquire(registered, request) {
|
|
238
|
+
const { correlationId, name, timeoutMs } = request;
|
|
239
|
+
if (!name) {
|
|
240
|
+
this.respond(registered, correlationId, { error: "acquire requires a lock name", status: "error", type: "response" });
|
|
241
|
+
return;
|
|
242
|
+
}
|
|
243
|
+
const record = this.lockRecord(name);
|
|
244
|
+
const heldEpoch = registered.held.get(name);
|
|
245
|
+
if (record.holder === registered && typeof heldEpoch === "number") {
|
|
246
|
+
this.respond(registered, correlationId, { epoch: heldEpoch, leaseExpiresAt: record.leaseExpiresAt, status: "already-held", type: "response" });
|
|
247
|
+
return;
|
|
248
|
+
}
|
|
249
|
+
if (!record.holder) {
|
|
250
|
+
this.grant(registered, record, correlationId);
|
|
251
|
+
return;
|
|
252
|
+
}
|
|
253
|
+
const waiter = /** @type {LockServerEngineWaiter} */ ({ connection: registered, correlationId, name });
|
|
254
|
+
if (typeof timeoutMs === "number" && timeoutMs >= 0) {
|
|
255
|
+
waiter.deadline = Date.now() + timeoutMs;
|
|
256
|
+
const timer = setTimeout(() => this.expireWaiter(record, waiter), timeoutMs);
|
|
257
|
+
timer.unref?.();
|
|
258
|
+
waiter.timer = timer;
|
|
259
|
+
}
|
|
260
|
+
record.waiters.push(waiter);
|
|
261
|
+
}
|
|
262
|
+
/**
|
|
263
|
+
* Handles `try-acquire`: grants when free, answers `busy` when held.
|
|
264
|
+
* @param {LockServerEngineRegisteredConnection} registered - Requesting connection.
|
|
265
|
+
* @param {LockServerEngineRequest} request - Request fields.
|
|
266
|
+
* @returns {void}
|
|
267
|
+
*/
|
|
268
|
+
handleTryAcquire(registered, request) {
|
|
269
|
+
const { correlationId, name } = request;
|
|
270
|
+
if (!name) {
|
|
271
|
+
this.respond(registered, correlationId, { error: "try-acquire requires a lock name", status: "error", type: "response" });
|
|
272
|
+
return;
|
|
273
|
+
}
|
|
274
|
+
const record = this.lockRecord(name);
|
|
275
|
+
const heldEpoch = registered.held.get(name);
|
|
276
|
+
if (record.holder === registered && typeof heldEpoch === "number") {
|
|
277
|
+
this.respond(registered, correlationId, { epoch: heldEpoch, leaseExpiresAt: record.leaseExpiresAt, status: "already-held", type: "response" });
|
|
278
|
+
return;
|
|
279
|
+
}
|
|
280
|
+
if (record.holder) {
|
|
281
|
+
this.respond(registered, correlationId, { ownerId: record.holder.id, status: "busy", type: "response" });
|
|
282
|
+
return;
|
|
283
|
+
}
|
|
284
|
+
this.grant(registered, record, correlationId);
|
|
285
|
+
}
|
|
286
|
+
/**
|
|
287
|
+
* Handles `renew` with the fencing check: only the current holder with the
|
|
288
|
+
* matching epoch may extend the lease; a superseded holder gets `lost` with
|
|
289
|
+
* the current epoch.
|
|
290
|
+
* @param {LockServerEngineRegisteredConnection} registered - Renewing connection.
|
|
291
|
+
* @param {LockServerEngineRequest & {epoch: number}} request - Request fields.
|
|
292
|
+
* @returns {void}
|
|
293
|
+
*/
|
|
294
|
+
handleRenew(registered, request) {
|
|
295
|
+
const { correlationId, epoch, name } = request;
|
|
296
|
+
const record = this.locks.get(name);
|
|
297
|
+
if (!record) {
|
|
298
|
+
this.respond(registered, correlationId, { status: "not-found", type: "response" });
|
|
299
|
+
return;
|
|
300
|
+
}
|
|
301
|
+
if (record.holder !== registered || record.epoch !== epoch) {
|
|
302
|
+
const status = registered.held.has(name) ? "lost" : "not-found";
|
|
303
|
+
this.respond(registered, correlationId, { currentEpoch: record.epoch, status, type: "response" });
|
|
304
|
+
return;
|
|
305
|
+
}
|
|
306
|
+
record.leaseExpiresAt = Date.now() + this.leaseMs;
|
|
307
|
+
this.respond(registered, correlationId, { leaseExpiresAt: record.leaseExpiresAt, status: "renewed", type: "response" });
|
|
308
|
+
}
|
|
309
|
+
/**
|
|
310
|
+
* Handles `release`: idempotent for the holder; `not-holder` after an epoch
|
|
311
|
+
* bump is the expected answer for a superseded holder.
|
|
312
|
+
* @param {LockServerEngineRegisteredConnection} registered - Releasing connection.
|
|
313
|
+
* @param {LockServerEngineRequest & {epoch?: number}} request - Request fields.
|
|
314
|
+
* @returns {void}
|
|
315
|
+
*/
|
|
316
|
+
handleRelease(registered, request) {
|
|
317
|
+
const { correlationId, epoch, name } = request;
|
|
318
|
+
const record = this.locks.get(name);
|
|
319
|
+
if (!record) {
|
|
320
|
+
this.respond(registered, correlationId, { status: "not-found", type: "response" });
|
|
321
|
+
return;
|
|
322
|
+
}
|
|
323
|
+
if (record.holder !== registered) {
|
|
324
|
+
const status = registered.held.has(name) ? "not-holder" : "not-found";
|
|
325
|
+
this.respond(registered, correlationId, { currentEpoch: record.epoch, status, type: "response" });
|
|
326
|
+
return;
|
|
327
|
+
}
|
|
328
|
+
if (typeof epoch === "number" && epoch !== record.epoch) {
|
|
329
|
+
this.respond(registered, correlationId, { currentEpoch: record.epoch, status: "not-holder", type: "response" });
|
|
330
|
+
return;
|
|
331
|
+
}
|
|
332
|
+
record.holder = null;
|
|
333
|
+
registered.held.delete(name);
|
|
334
|
+
this.respond(registered, correlationId, { status: "released", type: "response" });
|
|
335
|
+
this.grantNext(record);
|
|
336
|
+
}
|
|
337
|
+
/**
|
|
338
|
+
* Grants the lock to a connection: bumps the monotonic per-name epoch,
|
|
339
|
+
* installs the holder, and answers `acquired` echoing the correlation.
|
|
340
|
+
* @param {LockServerEngineRegisteredConnection} registered - Granted connection.
|
|
341
|
+
* @param {LockServerEngineLockRecord} record - Lock record.
|
|
342
|
+
* @param {string} correlationId - Correlation to echo.
|
|
343
|
+
* @returns {void}
|
|
344
|
+
*/
|
|
345
|
+
grant(registered, record, correlationId) {
|
|
346
|
+
const epoch = (this.epochByLock.get(record.name) ?? 0) + 1;
|
|
347
|
+
this.epochByLock.set(record.name, epoch);
|
|
348
|
+
record.epoch = epoch;
|
|
349
|
+
record.holder = registered;
|
|
350
|
+
record.leaseExpiresAt = Date.now() + this.leaseMs;
|
|
351
|
+
registered.held.set(record.name, epoch);
|
|
352
|
+
this.respond(registered, correlationId, { epoch, leaseExpiresAt: record.leaseExpiresAt, status: "acquired", type: "response" });
|
|
353
|
+
}
|
|
354
|
+
/**
|
|
355
|
+
* Moves the FIFO queue's first live waiter into the grant path.
|
|
356
|
+
* @param {LockServerEngineLockRecord} record - Freed lock record.
|
|
357
|
+
* @returns {void}
|
|
358
|
+
*/
|
|
359
|
+
grantNext(record) {
|
|
360
|
+
while (record.waiters.length > 0) {
|
|
361
|
+
const waiter = /** @type {LockServerEngineWaiter} */ (record.waiters.shift());
|
|
362
|
+
if (waiter.timer)
|
|
363
|
+
clearTimeout(waiter.timer);
|
|
364
|
+
if (!waiter.connection.open)
|
|
365
|
+
continue;
|
|
366
|
+
this.grant(waiter.connection, record, waiter.correlationId);
|
|
367
|
+
return;
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
/**
|
|
371
|
+
* Removes a waiter whose bounded wait elapsed and answers `timeout`.
|
|
372
|
+
* @param {LockServerEngineLockRecord} record - Lock record the waiter queued on.
|
|
373
|
+
* @param {LockServerEngineWaiter} waiter - Expired waiter.
|
|
374
|
+
* @returns {void}
|
|
375
|
+
*/
|
|
376
|
+
expireWaiter(record, waiter) {
|
|
377
|
+
const index = record.waiters.indexOf(waiter);
|
|
378
|
+
if (index >= 0)
|
|
379
|
+
record.waiters.splice(index, 1);
|
|
380
|
+
if (!waiter.connection.open)
|
|
381
|
+
return;
|
|
382
|
+
this.respond(waiter.connection, waiter.correlationId, { status: "timeout", type: "response" });
|
|
383
|
+
}
|
|
384
|
+
/**
|
|
385
|
+
* Sweeps expired leases: bumps the epoch (the old holder is fenced), pushes
|
|
386
|
+
* `lost` to the old holder, and grants the next waiter.
|
|
387
|
+
* @returns {void}
|
|
388
|
+
*/
|
|
389
|
+
sweep() {
|
|
390
|
+
if (this.closed)
|
|
391
|
+
return;
|
|
392
|
+
const now = Date.now();
|
|
393
|
+
for (const record of this.locks.values()) {
|
|
394
|
+
const holder = record.holder;
|
|
395
|
+
if (!holder || record.leaseExpiresAt > now)
|
|
396
|
+
continue;
|
|
397
|
+
const fencedEpoch = record.epoch;
|
|
398
|
+
record.holder = null;
|
|
399
|
+
holder.held.delete(record.name);
|
|
400
|
+
this.epochByLock.set(record.name, fencedEpoch + 1);
|
|
401
|
+
record.epoch = fencedEpoch + 1;
|
|
402
|
+
try {
|
|
403
|
+
holder.connection.send({ epoch: record.epoch, name: record.name, type: "lost" });
|
|
404
|
+
}
|
|
405
|
+
catch {
|
|
406
|
+
// A dead transport cannot receive the push; the lease is already gone.
|
|
407
|
+
}
|
|
408
|
+
this.grantNext(record);
|
|
409
|
+
}
|
|
410
|
+
}
|
|
411
|
+
/**
|
|
412
|
+
* Returns (creating when needed) the live record for one lock name.
|
|
413
|
+
* @param {string} name - Lock name.
|
|
414
|
+
* @returns {LockServerEngineLockRecord} - Live record.
|
|
415
|
+
*/
|
|
416
|
+
lockRecord(name) {
|
|
417
|
+
const existing = this.locks.get(name);
|
|
418
|
+
if (existing)
|
|
419
|
+
return existing;
|
|
420
|
+
/** @type {LockServerEngineLockRecord} */
|
|
421
|
+
const record = { epoch: this.epochByLock.get(name) ?? 0, holder: null, leaseExpiresAt: 0, name, waiters: [] };
|
|
422
|
+
this.locks.set(name, record);
|
|
423
|
+
return record;
|
|
424
|
+
}
|
|
425
|
+
/**
|
|
426
|
+
* Current holder info for one name (diagnostics).
|
|
427
|
+
* @param {string} name - Lock name.
|
|
428
|
+
* @returns {{epoch: number, holderId: string, leaseExpiresAt: number, name: string, waiterCount: number} | null} - Holder info, or null when free.
|
|
429
|
+
*/
|
|
430
|
+
holderInfo(name) {
|
|
431
|
+
const record = this.locks.get(name);
|
|
432
|
+
if (!record || !record.holder)
|
|
433
|
+
return null;
|
|
434
|
+
return { epoch: record.epoch, holderId: record.holder.id, leaseExpiresAt: record.leaseExpiresAt, name, waiterCount: record.waiters.length };
|
|
435
|
+
}
|
|
436
|
+
/**
|
|
437
|
+
* Live holder list (diagnostics).
|
|
438
|
+
* @returns {{epoch: number, holderId: string, leaseExpiresAt: number, name: string, waiterCount: number}[]} - Live holders.
|
|
439
|
+
*/
|
|
440
|
+
listHolders() {
|
|
441
|
+
const holders = [];
|
|
442
|
+
for (const record of this.locks.values()) {
|
|
443
|
+
if (!record.holder)
|
|
444
|
+
continue;
|
|
445
|
+
holders.push({ epoch: record.epoch, holderId: record.holder.id, leaseExpiresAt: record.leaseExpiresAt, name: record.name, waiterCount: record.waiters.length });
|
|
446
|
+
}
|
|
447
|
+
return holders;
|
|
448
|
+
}
|
|
449
|
+
/**
|
|
450
|
+
* Sends one response to a connection.
|
|
451
|
+
* @param {LockServerEngineRegisteredConnection} registered - Target connection.
|
|
452
|
+
* @param {string} correlationId - Correlation to echo.
|
|
453
|
+
* @param {Record<string, unknown>} body - Response fields.
|
|
454
|
+
* @returns {void}
|
|
455
|
+
*/
|
|
456
|
+
respond(registered, correlationId, body) {
|
|
457
|
+
registered.connection.send({ ...body, correlationId });
|
|
458
|
+
}
|
|
459
|
+
}
|
|
460
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1lbmdpbmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGF0YWJhc2UvYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1lbmdpbmUuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaOzs7Ozs7R0FNRztBQUNIOzs7Ozs7O0dBT0c7QUFDSDs7Ozs7Ozs7R0FRRztBQUNIOzs7Ozs7OztHQVFHO0FBQ0g7Ozs7Ozs7R0FPRztBQUNIOzs7Ozs7O0dBT0c7QUFDSCxTQUFTLG9CQUFvQixDQUFDLFVBQVUsRUFBRSxFQUFFO0lBQzFDLE9BQU8sRUFBQyxVQUFVLEVBQUUsSUFBSSxFQUFFLElBQUksR0FBRyxFQUFFLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUMsQ0FBQTtBQUN0RCxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXFCRztBQUNILE1BQU0sQ0FBQyxPQUFPLE9BQU8sNEJBQTRCO0lBQy9DOzs7OztPQUtHO0lBQ0gsWUFBWSxFQUFDLE9BQU8sR0FBRyxNQUFNLEVBQUUsZUFBZSxHQUFHLEdBQUcsRUFBQyxHQUFHLEVBQUU7UUFDeEQsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUE7UUFDdEIsSUFBSSxDQUFDLGVBQWUsR0FBRyxlQUFlLENBQUE7UUFDdEMsc0RBQXNEO1FBQ3RELElBQUksQ0FBQyxLQUFLLEdBQUcsSUFBSSxHQUFHLEVBQUUsQ0FBQTtRQUN0QixrQ0FBa0M7UUFDbEMsSUFBSSxDQUFDLFdBQVcsR0FBRyxJQUFJLEdBQUcsRUFBRSxDQUFBO1FBQzVCLGdFQUFnRTtRQUNoRSxJQUFJLENBQUMsV0FBVyxHQUFHLElBQUksR0FBRyxFQUFFLENBQUE7UUFDNUIsSUFBSSxDQUFDLGlCQUFpQixHQUFHLENBQUMsQ0FBQTtRQUMxQixJQUFJLENBQUMsTUFBTSxHQUFHLEtBQUssQ0FBQTtRQUNuQixvREFBb0Q7UUFDcEQs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SSxDQUFDLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNO1lBQUUsT0FBTyxJQUFJLENBQUE7UUFFMUMsT0FBTyxFQUFDLEtBQUssRUFBRSxNQUFNLENBQUMsS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsRUFBRSxjQUFjLEVBQUUsTUFBTSxDQUFDLGNBQWMsRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLE1BQU0sQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFDLENBQUE7SUFDM0ksQ0FBQztJQUVEOzs7T0FHRztJQUNILFdBQVc7UUFDVCxNQUFNLE9BQU8sR0FBRyxFQUFFLENBQUE7UUFFbEIsS0FBSyxNQUFNLE1BQU0sSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUM7WUFDekMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNO2dCQUFFLFNBQVE7WUFFNUIsT0FBTyxDQUFDLElBQUksQ0FBQyxFQUFDLEtBQUssRUFBRSxNQUFNLENBQUMsS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsRUFBRSxjQUFjLEVBQUUsTUFBTSxDQUFDLGNBQWMsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLElBQUksRUFBRSxXQUFXLEVBQUUsTUFBTSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUMsQ0FBQyxDQUFBO1FBQy9KLENBQUM7UUFFRCxPQUFPLE9BQU8sQ0FBQTtJQUNoQixDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0gsT0FBTyxDQUFDLFVBQVUsRUFBRSxhQUFhLEVBQUUsSUFBSTtRQUNyQyxVQUFVLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxFQUFDLEdBQUcsSUFBSSxFQUFFLGFBQWEsRUFBQyxDQUFDLENBQUE7SUFDdEQsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbi8qKlxuICogT25lIGVuZ2luZSBjb25uZWN0aW9uOiB0aGUgdHJhbnNwb3J0LXNpZGUgdmlldyBvZiBhIGxvY2sgY2xpZW50LiBgc2VuZGBcbiAqIGRlbGl2ZXJzIGVuZ2luZSBtZXNzYWdlcyAocmVzcG9uc2VzIGFuZCBgbG9zdGAgcHVzaGVzKSBiYWNrIHRvIHRoZSBjbGllbnQuXG4gKiBAdHlwZWRlZiB7b2JqZWN0fSBMb2NrU2VydmVyRW5naW5lQ29ubmVjdGlvblxuICogQHByb3BlcnR5IHsoYm9keTogUmVjb3JkPHN0cmluZywgdW5rbm93bj4pID0+IHZvaWR9IHNlbmQgLSBEZWxpdmVycyBvbmUgZW5naW5lIG1lc3NhZ2UgdG8gdGhpcyBjb25uZWN0aW9uLlxuICogQHByb3BlcnR5IHsoKSA9PiB2b2lkfSBbb25DbG9zZV0gLSBFbmdpbmUtc2lkZSBjbG9zZSBob29rICh0cmFuc3BvcnQgdGVhcmRvd24pLlxuICovXG4vKipcbiAqIE9uZSByZWdpc3RlcmVkIGVuZ2luZSBjb25uZWN0aW9uIHdpdGggaXRzIGhlbGQgbG9jayBuYW1lcy5cbiAqIEB0eXBlZGVmIHtvYmplY3R9IExvY2tTZXJ2ZXJFbmdpbmVSZWdpc3RlcmVkQ29ubmVjdGlvblxuICogQHByb3BlcnR5IHtNYXA8c3RyaW5nLCBudW1iZXI+fSBoZWxkIC0gTG9jayBuYW1lcyB0aGlzIGNvbm5lY3Rpb24gaG9sZHMsIG1hcHBlZCB0byB0aGVpciBncmFudGVkIGVwb2NoLlxuICogQHByb3BlcnR5IHtMb2NrU2VydmVyRW5naW5lQ29ubmVjdGlvbn0gY29ubmVjdGlvbiAtIFRyYW5zcG9ydC1zaWRlIGNvbm5lY3Rpb24uXG4gKiBAcHJvcGVydHkge3N0cmluZ30gaWQgLSBTZXJ2ZXItbWludGVkIGhvbGRlciBpZC5cbiAqIEBwcm9wZXJ0eSB7Ym9vbGVhbn0gb3BlbiAtIEZhbHNlIG9uY2UgdGhlIGNvbm5lY3Rpb24gd2FzIGNsb3NlZC5cbiAqL1xuLyoqXG4gKiBPbmUgcXVldWVkIGFjcXVpcmUgcmVxdWVzdCB3YWl0aW5nIG9uIHRoZSBGSUZPIHF1ZXVlLlxuICogQHR5cGVkZWYge29iamVjdH0gTG9ja1NlcnZlckVuZ2luZVdhaXRlclxuICogQHByb3BlcnR5IHtMb2NrU2VydmVyRW5naW5lUmVnaXN0ZXJlZENvbm5lY3Rpb259IGNvbm5lY3Rpb24gLSBXYWl0aW5nIGNvbm5lY3Rpb24uXG4gKiBAcHJvcGVydHkge3N0cmluZ30gY29ycmVsYXRpb25JZCAtIFJlcXVlc3QgY29ycmVsYXRpb24gZWNob2VkIG9uIHRoZSByZXNwb25zZS5cbiAqIEBwcm9wZXJ0eSB7bnVtYmVyfSBbZGVhZGxpbmVdIC0gQWJzb2x1dGUgZGVhZGxpbmU7IGFic2VudCB3YWl0cyBpbmRlZmluaXRlbHkuXG4gKiBAcHJvcGVydHkge3N0cmluZ30gbmFtZSAtIExvY2sgbmFtZS5cbiAqIEBwcm9wZXJ0eSB7UmV0dXJuVHlwZTx0eXBlb2Ygc2V0VGltZW91dD4gfCBudWxsfSB0aW1lciAtIEJvdW5kZWQtd2FpdCB0aW1lb3V0IHRpbWVyLlxuICovXG4vKipcbiAqIE9uZSBsb2NrIG5hbWUncyBsaXZlIHN0YXRlIGluIHRoZSBlbmdpbmUuXG4gKiBAdHlwZWRlZiB7b2JqZWN0fSBMb2NrU2VydmVyRW5naW5lTG9ja1JlY29yZFxuICogQHByb3BlcnR5IHtMb2NrU2VydmVyRW5naW5lUmVnaXN0ZXJlZENvbm5lY3Rpb24gfCBudWxsfSBob2xkZXIgLSBDdXJyZW50IGxlYXNlIGhvbGRlciwgbnVsbCB3aGVuIGZyZWUuXG4gKiBAcHJvcGVydHkge251bWJlcn0gZXBvY2ggLSBMYXN0IGdyYW50ZWQgZmVuY2luZyBlcG9jaCAoMCBiZWZvcmUgdGhlIGZpcnN0IGdyYW50KS5cbiAqIEBwcm9wZXJ0eSB7bnVtYmVyfSBsZWFzZUV4cGlyZXNBdCAtIFdoZW4gdGhlIGN1cnJlbnQgbGVhc2UgZXhwaXJlcyB3aXRob3V0IHJlbmV3YWwuXG4gKiBAcHJvcGVydHkge3N0cmluZ30gbmFtZSAtIExvY2sgbmFtZS5cbiAqIEBwcm9wZXJ0eSB7TG9ja1NlcnZlckVuZ2luZVdhaXRlcltdfSB3YWl0ZXJzIC0gRklGTyBxdWV1ZSBvZiBwZW5kaW5nIGFjcXVpcmVzLlxuICovXG4vKipcbiAqIE9uZSBlbmdpbmUgcmVxdWVzdCBtZXNzYWdlLlxuICogQHR5cGVkZWYge29iamVjdH0gTG9ja1NlcnZlckVuZ2luZVJlcXVlc3RcbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBjb3JyZWxhdGlvbklkIC0gQ2xpZW50LWdlbmVyYXRlZCBpZCBlY2hvZWQgb24gdGhlIHJlc3BvbnNlLlxuICogQHByb3BlcnR5IHtudW1iZXJ9IFtlcG9jaF0gLSBIb2xkZXIgZXBvY2ggZm9yIGByZW5ld2AvYHJlbGVhc2VgLlxuICogQHByb3BlcnR5IHtzdHJpbmd9IG5hbWUgLSBMb2NrIG5hbWUuXG4gKiBAcHJvcGVydHkge251bWJlcn0gW3RpbWVvdXRNc10gLSBCb3VuZGVkIHdhaXQgZm9yIGBhY3F1aXJlYC5cbiAqL1xuLyoqXG4gKiBSZWdpc3RlcnMgb25lIGVuZ2luZSBjb25uZWN0aW9uIHdpdGggaXRzIHNlcnZlci1taW50ZWQgaG9sZGVyIGlkIOKAlCBleGFjdGx5XG4gKiBsaWtlIHRoZSBjb25zZW5zLWxvY2sgZGFlbW9uIG1pbnRzIHRoZSBob2xkZXIgaWQgZnJvbSB0aGUgdHJhbnNwb3J0LCBzbyBhXG4gKiBjbGllbnQgY2FuIG9ubHkgcmVuZXcgb3IgcmVsZWFzZSBpdHMgb3duIGxlYXNlcy5cbiAqIEBwYXJhbSB7TG9ja1NlcnZlckVuZ2luZUNvbm5lY3Rpb259IGNvbm5lY3Rpb24gLSBUcmFuc3BvcnQtc2lkZSBjb25uZWN0aW9uLlxuICogQHBhcmFtIHtzdHJpbmd9IGlkIC0gSG9sZGVyIGlkLlxuICogQHJldHVybnMge0xvY2tTZXJ2ZXJFbmdpbmVSZWdpc3RlcmVkQ29ubmVjdGlvbn0gLSBSZWdpc3RlcmVkIGNvbm5lY3Rpb24uXG4gKi9cbmZ1bmN0aW9uIHJlZ2lzdGVyZWRDb25uZWN0aW9uKGNvbm5lY3Rpb24sIGlkKSB7XG4gIHJldHVybiB7Y29ubmVjdGlvbiwgaGVsZDogbmV3IE1hcCgpLCBpZCwgb3BlbjogdHJ1ZX1cbn1cblxuLyoqXG4gKiBTaGFyZWQgbG9jay1zZXJ2ZXIgZW5naW5lIGltcGxlbWVudGluZyB0aGUgY29uc2Vucy1sb2NrIHByb3RvY29sIHYyIHNlbWFudGljc1xuICogaW4gcGxhaW4gSlMgd2l0aCBubyBOb2RlIGJ1aWx0aW5zIGFuZCBubyBzb2NrZXRzIChTVEMtNzE1KS4gSXQgaXMgdGhlIHNpbmdsZVxuICogbGVhc2UvZXBvY2gvZmVuY2luZyBhdXRob3JpdHkgcmV1c2VkIGJ5IGV2ZXJ5IGxvY2stc2VydmVyIG1vZGU6XG4gKlxuICogLSBgZW1iZWRkZWRgIG1vZGUgcnVucyBpdCBkaXJlY3RseSBpbnNpZGUgdGhlIGVudmlyb25tZW50IHByb2Nlc3MgKHRoZVxuICogICBpbi1wcm9jZXNzIHRyYW5zcG9ydCBmZWVkcyB0aGlzIHNhbWUgbWVzc2FnZSBzdXJmYWNlIG92ZXIgZnVuY3Rpb24gY2FsbHMpLFxuICogICBzbyBicm93c2VyL0V4cG8gYnVuZGxlcyBjYW4gdXNlIHRoZSBsb2NrLXNlcnZlciB0aWVyIHdpdGhvdXQgYHdzYC5cbiAqIC0gYGxvY2FsYCBtb2RlIHJ1bnMgaXQgaW4gYSBzcGF3bmVkIGNoaWxkIHByb2Nlc3Mgb3ZlciBzdGRpbyBKU09OLWxpbmVzXG4gKiAgIChgc3JjL2Vudmlyb25tZW50LWhhbmRsZXJzL25vZGUvYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1zZXJ2ZXIuanNgKS5cbiAqXG4gKiBTZW1hbnRpY3MgbWlycm9yIHRoZSBleHRlcm5hbCBkYWVtb24gKGBkb2NzL3Byb3RvY29sLm1kYCBpblxuICogYGRpZXN0b2Vja2Vscy9jb25zZW5zLWxvY2tgKTogc2VydmVyLW1pbnRlZCBob2xkZXIgaWRzIGJvdW5kIHRvIHRoZVxuICogY29ubmVjdGlvbiwgbGVhc2VzIHJlbmV3ZWQgcGVyIHRoaXJkIG9mIGBsZWFzZU1zYCwgYSBtb25vdG9uaWMgZmVuY2luZyBlcG9jaFxuICogcGVyIGxvY2sgbmFtZSBidW1wZWQgb24gZXZlcnkgZ3JhbnQgYW5kIG9uIGV2ZXJ5IGludmFsaWRhdGlvbiwgYSBGSUZPIHdhaXRlclxuICogcXVldWUgcGVyIG5hbWUsIGFuIGV4cGlyZWQtbGVhc2Ugc3dlZXBlciwgYW5kIGFuIGFzeW5jaHJvbm91cyBgbG9zdGAgcHVzaCBzb1xuICogYSBmZW5jZWQgaG9sZGVyIGxlYXJucyB3aXRob3V0IHdhaXRpbmcgZm9yIGl0cyBuZXh0IHJlbmV3LlxuICpcbiAqIEdyYW50IGRlY2lzaW9ucyBydW4gc3luY2hyb25vdXNseSBpbiB0aGUgZW5naW5lJ3Mgc2luZ2xlIGV2ZW50IGxvb3A6IHRoZVxuICogY2hlY2stYW5kLXNldCBvbiB0aGUgaG9sZGVyIG1hcCBoYXMgbm8gYGF3YWl0YCBiZXR3ZWVuIHJlYWQgYW5kIHdyaXRlLCBzb1xuICogdHdvIGNvbmN1cnJlbnQgYWNxdWlyZXMgY2FuIG5ldmVyIGJvdGggYmUgZ3JhbnRlZC5cbiAqL1xuZXhwb3J0IGRlZmF1bHQgY2xhc3MgQWR2aXNvcnlMb2NrTG9ja1NlcnZlckVuZ2luZSB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIG9uZSBlbmdpbmUgaW5zdGFuY2UuIE5vIEkvTyBoYXBwZW5zIGhlcmUuXG4gICAqIEBwYXJhbSB7b2JqZWN0fSBbYXJnc10gLSBFbmdpbmUgb3B0aW9ucy5cbiAgICogQHBhcmFtIHtudW1iZXJ9IFthcmdzLmxlYXNlTXNdIC0gTGVhc2UgZHVyYXRpb24gcGVyIGdyYW50LiBEZWZhdWx0cyB0byAzMDAwMC5cbiAgICogQHBhcmFtIHtudW1iZXJ9IFthcmdzLnN3ZWVwSW50ZXJ2YWxNc10gLSBFeHBpcmVkLWxlYXNlIHN3ZWVwIGludGVydmFsLiBEZWZhdWx0cyB0byAyMDAuXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih7bGVhc2VNcyA9IDMwXzAwMCwgc3dlZXBJbnRlcnZhbE1zID0gMjAwfSA9IHt9KSB7XG4gICAgdGhpcy5sZWFzZU1zID0gbGVhc2VNc1xuICAgIHRoaXMuc3dlZXBJbnRlcnZhbE1zID0gc3dlZXBJbnRlcnZhbE1zXG4gICAgLyoqIEB0eXBlIHtNYXA8c3RyaW5nLCBMb2NrU2VydmVyRW5naW5lTG9ja1JlY29yZD59ICovXG4gICAgdGhpcy5sb2NrcyA9IG5ldyBNYXAoKVxuICAgIC8qKiBAdHlwZSB7TWFwPHN0cmluZywgbnVtYmVyPn0gKi9cbiAgICB0aGlzLmVwb2NoQnlMb2NrID0gbmV3IE1hcCgpXG4gICAgLyoqIEB0eXBlIHtNYXA8c3RyaW5nLCBMb2NrU2VydmVyRW5naW5lUmVnaXN0ZXJlZENvbm5lY3Rpb24+fSAqL1xuICAgIHRoaXMuY29ubmVjdGlvbnMgPSBuZXcgTWFwKClcbiAgICB0aGlzLmNvbm5lY3Rpb25Db3VudGVyID0gMFxuICAgIHRoaXMuY2xvc2VkID0gZmFsc2VcbiAgICAvKiogQHR5cGUge1JldHVyblR5cGU8dHlwZW9mIHNldEludGVydmFsPiB8IG51bGx9ICovXG4gICAgdGhpcy5zd2VlcFRpbWVyID0gbnVsbFxuICB9XG5cbiAgLyoqXG4gICAqIFN0YXJ0cyB0aGUgZXhwaXJlZC1sZWFzZSBzd2VlcGVyIChpZGVtcG90ZW50KS4gTG9uZy1saXZlZCB0cmFuc3BvcnRzIGNhbGxcbiAgICogdGhpczsgdGhlIHN3ZWVwZXIgaXMgdGhlIGJhY2tzdG9wIGZvciBob2xkZXJzIHdob3NlIHRyYW5zcG9ydCBkaWVkIHdpdGhvdXRcbiAgICogYSBjbG9zZSBldmVudC5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBzdGFydFN3ZWVwZXIoKSB7XG4gICAgaWYgKHRoaXMuY2xvc2VkIHx8IHRoaXMuc3dlZXBUaW1lcikgcmV0dXJuXG5cbiAgICBjb25zdCB0aW1lciA9IHNldEludGVydmFsKCgpID0+IHRoaXMuc3dlZXAoKSwgdGhpcy5zd2VlcEludGVydmFsTXMpXG5cbiAgICB0aW1lci51bnJlZj8uKClcbiAgICB0aGlzLnN3ZWVwVGltZXIgPSB0aW1lclxuICB9XG5cbiAgLyoqXG4gICAqIFJlZ2lzdGVycyBvbmUgY29ubmVjdGlvbiAodGhlIHRyYW5zcG9ydCBvcGVuZWQgaXQpIGFuZCByZXR1cm5zIGl0c1xuICAgKiBzZXJ2ZXItbWludGVkIGhvbGRlciBpZC5cbiAgICogQHBhcmFtIHtMb2NrU2VydmVyRW5naW5lQ29ubmVjdGlvbn0gY29ubmVjdGlvbiAtIFRyYW5zcG9ydC1zaWRlIGNvbm5lY3Rpb24uXG4gICAqIEByZXR1cm5zIHtzdHJpbmd9IC0gSG9sZGVyIGlkIGJvdW5kIHRvIHRoaXMgY29ubmVjdGlvbi5cbiAgICovXG4gIG9wZW5Db25uZWN0aW9uKGNvbm5lY3Rpb24pIHtcbiAgICBpZiAodGhpcy5jbG9zZWQpIHRocm93IG5ldyBFcnJvcihcIkxvY2sgc2VydmVyIGVuZ2luZSBpcyBjbG9zZWRcIilcblxuICAgIGNvbnN0IGlkID0gYGVuZ2luZS1ob2xkZXItJHsrK3RoaXMuY29ubmVjdGlvbkNvdW50ZXJ9YFxuICAgIGNvbnN0IHJlZ2lzdGVyZWQgPSByZWdpc3RlcmVkQ29ubmVjdGlvbihjb25uZWN0aW9uLCBpZClcblxuICAgIHRoaXMuY29ubmVjdGlvbnMuc2V0KGlkLCByZWdpc3RlcmVkKVxuICAgIHRoaXMuY29ubmVjdGlvbkNvdW50ZXIgPSBNYXRoLm1heCh0aGlzLmNvbm5lY3Rpb25Db3VudGVyLCB0aGlzLmNvbm5lY3Rpb25zLnNpemUpXG5cbiAgICByZXR1cm4gaWRcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIHRoZSByZWdpc3RlcmVkIGNvbm5lY3Rpb24gZm9yIG9uZSB0cmFuc3BvcnQgY29ubmVjdGlvbiBpZCxcbiAgICogYXV0by1yZWdpc3RlcmluZyB0aGUgZ2l2ZW4gdHJhbnNwb3J0IHZpZXcgd2hlbiB0aGUgZmlyc3QgbWVzc2FnZSBhcnJpdmVzXG4gICAqIGJlZm9yZSBhbiBleHBsaWNpdCBvcGVuICh0aGUgc3RkaW8gc2VydmVyIGhhcyBubyBzZXBhcmF0ZSBjb25uZWN0aW9uLW9wZW5cbiAgICogZnJhbWUgcGVyIGNsaWVudCkuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBjb25uZWN0aW9uSWQgLSBUcmFuc3BvcnQgY29ubmVjdGlvbiBpZC5cbiAgICogQHBhcmFtIHtMb2NrU2VydmVyRW5naW5lQ29ubmVjdGlvbn0gW3RyYW5zcG9ydF0gLSBUcmFuc3BvcnQgdmlldyB0byByZWdpc3RlciB3aGVuIHRoZSBpZCBpcyBuZXcuXG4gICAqIEByZXR1cm5zIHtMb2NrU2VydmVyRW5naW5lUmVnaXN0ZXJlZENvbm5lY3Rpb24gfCBudWxsfSAtIFJlZ2lzdGVyZWQgY29ubmVjdGlvbiwgb3IgbnVsbCB3aGVuIHRoZSBlbmdpbmUgaXMgY2xvc2VkLlxuICAgKi9cbiAgZW5zdXJlQ29ubmVjdGlvbihjb25uZWN0aW9uSWQsIHRyYW5zcG9ydCkge1xuICAgIGlmICh0aGlzLmNsb3NlZCkgcmV0dXJuIG51bGxcblxuICAgIGNvbnN0IGV4aXN0aW5nID0gdGhpcy5jb25uZWN0aW9ucy5nZXQoY29ubmVjdGlvbklkKVxuXG4gICAgaWYgKGV4aXN0aW5nKSByZXR1cm4gZXhpc3RpbmdcblxuICAgIGNvbnN0IHJlZ2lzdGVyZWQgPSByZWdpc3RlcmVkQ29ubmVjdGlvbih0cmFuc3BvcnQgfHwge3NlbmQ6ICgpID0+IHt9fSwgY29ubmVjdGlvbklkKVxuXG4gICAgdGhpcy5jb25uZWN0aW9ucy5zZXQoY29ubmVjdGlvbklkLCByZWdpc3RlcmVkKVxuICAgIHRoaXMuY29ubmVjdGlvbkNvdW50ZXIgPSBNYXRoLm1heCh0aGlzLmNvbm5lY3Rpb25Db3VudGVyLCB0aGlzLmNvbm5lY3Rpb25zLnNpemUpXG5cbiAgICByZXR1cm4gcmVnaXN0ZXJlZFxuICB9XG5cbiAgLyoqXG4gICAqIEhhbmRsZXMgb25lIHJlcXVlc3QgbWVzc2FnZSBmcm9tIGEgY29ubmVjdGlvbiBhbmQgYW5zd2VycyBpdCAob3IgcXVldWVzXG4gICAqIHRoZSB3YWl0KSB0aHJvdWdoIHRoZSBjb25uZWN0aW9uJ3MgYHNlbmRgLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gY29ubmVjdGlvbklkIC0gQ29ubmVjdGlvbiB0aGUgbWVzc2FnZSBhcnJpdmVkIG9uLlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsIHVua25vd24+fSBib2R5IC0gUmVxdWVzdCBtZXNzYWdlLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIGhhbmRsZU1lc3NhZ2UoY29ubmVjdGlvbklkLCBib2R5KSB7XG4gICAgY29uc3QgcmVnaXN0ZXJlZCA9IHRoaXMuZW5zdXJlQ29ubmVjdGlvbihjb25uZWN0aW9uSWQpXG5cbiAgICBpZiAodGhpcy5jbG9zZWQgfHwgIXJlZ2lzdGVyZWQgfHwgIXJlZ2lzdGVyZWQub3BlbiB8fCAhYm9keSB8fCB0eXBlb2YgYm9keSAhPT0gXCJvYmplY3RcIikgcmV0dXJuXG5cbiAgICAvLyBUcmFuc3BvcnQtbGV2ZWwgZnJhbWVzICh0aGUgY29ubmVjdGlvbi1vcGVuIHBhcmFtcyBjYXJyeWluZyBhdXRoIGFuZFxuICAgIC8vIHByb3RvY29sIHZlcnNpb24pIGFyZSBhbnN3ZXJlZCBieSB0aGUgdHJhbnNwb3J0J3MgaGVsbG8tYWNrLCBub3QgaGVyZTtcbiAgICAvLyBvbmx5IHJlcXVlc3QvcmVzcG9uc2UgdHJhZmZpYyB3aXRoIGEgY29ycmVsYXRpb25JZCByZWFjaGVzIHRoZSBlbmdpbmUuXG4gICAgaWYgKGJvZHkudHlwZSA9PT0gXCJoZWxsb1wiIHx8IHR5cGVvZiBib2R5LmNvcnJlbGF0aW9uSWQgIT09IFwic3RyaW5nXCIpIHJldHVyblxuXG4gICAgY29uc3QgY29ycmVsYXRpb25JZCA9IHR5cGVvZiBib2R5LmNvcnJlbGF0aW9uSWQgPT09IFwic3RyaW5nXCIgPyBib2R5LmNvcnJlbGF0aW9uSWQgOiBcIlwiXG4gICAgY29uc3QgbmFtZSA9IHR5cGVvZiBib2R5Lm5hbWUgPT09IFwic3RyaW5nXCIgPyBib2R5Lm5hbWUgOiBcIlwiXG5cbiAgICBzd2l0Y2ggKGJvZHkudHlwZSkge1xuICAgICAgY2FzZSBcImFjcXVpcmVcIjpcbiAgICAgICAgdGhpcy5oYW5kbGVBY3F1aXJlKHJlZ2lzdGVyZWQsIHtjb3JyZWxhdGlvbklkLCBuYW1lLCB0aW1lb3V0TXM6IHR5cGVvZiBib2R5LnRpbWVvdXRNcyA9PT0gXCJudW1iZXJcIiA/IGJvZHkudGltZW91dE1zIDogdW5kZWZpbmVkfSlcblxuICAgICAgICByZXR1cm5cbiAgICAgIGNhc2UgXCJ0cnktYWNxdWlyZVwiOlxuICAgICAgICB0aGlzLmhhbmRsZVRyeUFjcXVpcmUocmVnaXN0ZXJlZCwge2NvcnJlbGF0aW9uSWQsIG5hbWV9KVxuXG4gICAgICAgIHJldHVyblxuICAgICAgY2FzZSBcInJlbmV3XCI6XG4gICAgICAgIHRoaXMuaGFuZGxlUmVuZXcocmVnaXN0ZXJlZCwge2NvcnJlbGF0aW9uSWQsIGVwb2NoOiB0eXBlb2YgYm9keS5lcG9jaCA9PT0gXCJudW1iZXJcIiA/IGJvZHkuZXBvY2ggOiAtMSwgbmFtZX0pXG5cbiAgICAgICAgcmV0dXJuXG4gICAgICBjYXNlIFwicmVsZWFzZVwiOlxuICAgICAgICB0aGlzLmhhbmRsZVJlbGVhc2UocmVnaXN0ZXJlZCwge2NvcnJlbGF0aW9uSWQsIGVwb2NoOiB0eXBlb2YgYm9keS5lcG9jaCA9PT0gXCJudW1iZXJcIiA/IGJvZHkuZXBvY2ggOiB1bmRlZmluZWQsIG5hbWV9KVxuXG4gICAgICAgIHJldHVyblxuICAgICAgY2FzZSBcIndoby1ob2xkc1wiOlxuICAgICAgICB0aGlzLnJlc3BvbmQocmVnaXN0ZXJlZCwgY29ycmVsYXRpb25JZCwge2hvbGRlcjogdGhpcy5ob2xkZXJJbmZvKG5hbWUpLCB0eXBlOiBcInJlc3BvbnNlXCJ9KVxuXG4gICAgICAgIHJldHVyblxuICAgICAgY2FzZSBcImxpc3RcIjpcbiAgICAgICAgdGhpcy5yZXNwb25kKHJlZ2lzdGVyZWQsIGNvcnJlbGF0aW9uSWQsIHtob2xkZXJzOiB0aGlzLmxpc3RIb2xkZXJzKCksIHR5cGU6IFwicmVzcG9uc2VcIn0pXG5cbiAgICAgICAgcmV0dXJuXG4gICAgICBkZWZhdWx0OlxuICAgICAgICB0aGlzLnJlc3BvbmQocmVnaXN0ZXJlZCwgY29ycmVsYXRpb25JZCwge2Vycm9yOiBgVW5rbm93biBsb2NrLXNlcnZlciByZXF1ZXN0IHR5cGU6ICR7U3RyaW5nKGJvZHkudHlwZSl9YCwgc3RhdHVzOiBcImVycm9yXCIsIHR5cGU6IFwicmVzcG9uc2VcIn0pXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFJlbW92ZXMgYSBjb25uZWN0aW9uIGFuZCByZWxlYXNlcyBldmVyeSBsZWFzZSBpdCBob2xkcyBpbW1lZGlhdGVseSDigJQgdGhlXG4gICAqIHNhbWUgdHJhbnNwb3J0LWNsb3NlIHNlbWFudGljcyB0aGUgZXh0ZXJuYWwgZGFlbW9uIGhhcy5cbiAgICogQHBhcmFtIHtzdHJpbmd9IGNvbm5lY3Rpb25JZCAtIFJlZ2lzdGVyZWQgY29ubmVjdGlvbiBpZC5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBjb25uZWN0aW9uQ2xvc2UoY29ubmVjdGlvbklkKSB7XG4gICAgY29uc3QgcmVnaXN0ZXJlZCA9IHRoaXMuY29ubmVjdGlvbnMuZ2V0KGNvbm5lY3Rpb25JZClcblxuICAgIGlmICghcmVnaXN0ZXJlZCkgcmV0dXJuXG5cbiAgICB0aGlzLmNvbm5lY3Rpb25zLmRlbGV0ZShjb25uZWN0aW9uSWQpXG4gICAgcmVnaXN0ZXJlZC5vcGVuID0gZmFsc2VcblxuICAgIGZvciAoY29uc3QgbmFtZSBvZiBbLi4ucmVnaXN0ZXJlZC5oZWxkLmtleXMoKV0pIHtcbiAgICAgIGNvbnN0IHJlY29yZCA9IHRoaXMubG9ja3MuZ2V0KG5hbWUpXG5cbiAgICAgIGlmICghcmVjb3JkIHx8IHJlY29yZC5ob2xkZXIgIT09IHJlZ2lzdGVyZWQpIGNvbnRpbnVlXG5cbiAgICAgIHJlY29yZC5ob2xkZXIgPSBudWxsXG4gICAgICByZWdpc3RlcmVkLmhlbGQuZGVsZXRlKG5hbWUpXG4gICAgICB0aGlzLmdyYW50TmV4dChyZWNvcmQpXG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFN0b3BzIHRoZSBzd2VlcGVyIGFuZCBjbG9zZXMgZXZlcnkgY29ubmVjdGlvbiAoc2h1dGRvd24gcGF0aCkuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgY2xvc2UoKSB7XG4gICAgdGhpcy5jbG9zZWQgPSB0cnVlXG5cbiAgICBpZiAodGhpcy5zd2VlcFRpbWVyKSB7XG4gICAgICBjbGVhckludGVydmFsKHRoaXMuc3dlZXBUaW1lcilcbiAgICAgIHRoaXMuc3dlZXBUaW1lciA9IG51bGxcbiAgICB9XG5cbiAgICBmb3IgKGNvbnN0IHJlZ2lzdGVyZWQgb2YgWy4uLnRoaXMuY29ubmVjdGlvbnMudmFsdWVzKCldKSB7XG4gICAgICB0cnkge1xuICAgICAgICByZWdpc3RlcmVkLmNvbm5lY3Rpb24ub25DbG9zZT8uKClcbiAgICAgIH0gY2F0Y2gge1xuICAgICAgICAvLyBBIGZhaWxpbmcgdHJhbnNwb3J0IGNsb3NlIGhvb2sgbXVzdCBub3QgYmxvY2sgdGhlIHNodXRkb3duIG9mIHRoZVxuICAgICAgICAvLyByZW1haW5pbmcgY29ubmVjdGlvbnMuXG4gICAgICB9XG5cbiAgICAgIHRoaXMuY29ubmVjdGlvbnMuZGVsZXRlKHJlZ2lzdGVyZWQuaWQpXG4gICAgICByZWdpc3RlcmVkLm9wZW4gPSBmYWxzZVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBIYW5kbGVzIGBhY3F1aXJlYDogZ3JhbnRzIGltbWVkaWF0ZWx5LCBhbnN3ZXJzIGBhbHJlYWR5LWhlbGRgIGZvciBhXG4gICAqIHJlLWVudHJhbnQgYWNxdWlzaXRpb24sIG9yIGpvaW5zIHRoZSBuYW1lJ3MgRklGTyB3YWl0ZXIgcXVldWUgd2l0aCBhXG4gICAqIGJvdW5kZWQgdGltZW91dC5cbiAgICogQHBhcmFtIHtMb2NrU2VydmVyRW5naW5lUmVnaXN0ZXJlZENvbm5lY3Rpb259IHJlZ2lzdGVyZWQgLSBSZXF1ZXN0aW5nIGNvbm5lY3Rpb24uXG4gICAqIEBwYXJhbSB7TG9ja1NlcnZlckVuZ2luZVJlcXVlc3QgJiB7dGltZW91dE1zPzogbnVtYmVyfX0gcmVxdWVzdCAtIFJlcXVlc3QgZmllbGRzLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIGhhbmRsZUFjcXVpcmUocmVnaXN0ZXJlZCwgcmVxdWVzdCkge1xuICAgIGNvbnN0IHtjb3JyZWxhdGlvbklkLCBuYW1lLCB0aW1lb3V0TXN9ID0gcmVxdWVzdFxuXG4gICAgaWYgKCFuYW1lKSB7XG4gICAgICB0aGlzLnJlc3BvbmQocmVnaXN0ZXJlZCwgY29ycmVsYXRpb25JZCwge2Vycm9yOiBcImFjcXVpcmUgcmVxdWlyZXMgYSBsb2NrIG5hbWVcIiwgc3RhdHVzOiBcImVycm9yXCIsIHR5cGU6IFwicmVzcG9uc2VcIn0pXG5cbiAgICAgIHJldHVyblxuICAgIH1cblxuICAgIGNvbnN0IHJlY29yZCA9IHRoaXMubG9ja1JlY29yZChuYW1lKVxuICAgIGNvbnN0IGhlbGRFcG9jaCA9IHJlZ2lzdGVyZWQuaGVsZC5nZXQobmFtZSlcblxuICAgIGlmIChyZWNvcmQuaG9sZGVyID09PSByZWdpc3RlcmVkICYmIHR5cGVvZiBoZWxkRXBvY2ggPT09IFwibnVtYmVyXCIpIHtcbiAgICAgIHRoaXMucmVzcG9uZChyZWdpc3RlcmVkLCBjb3JyZWxhdGlvbklkLCB7ZXBvY2g6IGhlbGRFcG9jaCwgbGVhc2VFeHBpcmVzQXQ6IHJlY29yZC5sZWFzZUV4cGlyZXNBdCwgc3RhdHVzOiBcImFscmVhZHktaGVsZFwiLCB0eXBlOiBcInJlc3BvbnNlXCJ9KVxuXG4gICAgICByZXR1cm5cbiAgICB9XG5cbiAgICBpZiAoIXJlY29yZC5ob2xkZXIpIHtcbiAgICAgIHRoaXMuZ3JhbnQocmVnaXN0ZXJlZCwgcmVjb3JkLCBjb3JyZWxhdGlvbklkKVxuXG4gICAgICByZXR1cm5cbiAgICB9XG5cbiAgICBjb25zdCB3YWl0ZXIgPSAvKiogQHR5cGUge0xvY2tTZXJ2ZXJFbmdpbmVXYWl0ZXJ9ICovICh7Y29ubmVjdGlvbjogcmVnaXN0ZXJlZCwgY29ycmVsYXRpb25JZCwgbmFtZX0pXG5cbiAgICBpZiAodHlwZW9mIHRpbWVvdXRNcyA9PT0gXCJudW1iZXJcIiAmJiB0aW1lb3V0TXMgPj0gMCkge1xuICAgICAgd2FpdGVyLmRlYWRsaW5lID0gRGF0ZS5ub3coKSArIHRpbWVvdXRNc1xuICAgICAgY29uc3QgdGltZXIgPSBzZXRUaW1lb3V0KCgpID0+IHRoaXMuZXhwaXJlV2FpdGVyKHJlY29yZCwgd2FpdGVyKSwgdGltZW91dE1zKVxuXG4gICAgICB0aW1lci51bnJlZj8uKClcbiAgICAgIHdhaXRlci50aW1lciA9IHRpbWVyXG4gICAgfVxuXG4gICAgcmVjb3JkLndhaXRlcnMucHVzaCh3YWl0ZXIpXG4gIH1cblxuICAvKipcbiAgICogSGFuZGxlcyBgdHJ5LWFjcXVpcmVgOiBncmFudHMgd2hlbiBmcmVlLCBhbnN3ZXJzIGBidXN5YCB3aGVuIGhlbGQuXG4gICAqIEBwYXJhbSB7TG9ja1NlcnZlckVuZ2luZVJlZ2lzdGVyZWRDb25uZWN0aW9ufSByZWdpc3RlcmVkIC0gUmVxdWVzdGluZyBjb25uZWN0aW9uLlxuICAgKiBAcGFyYW0ge0xvY2tTZXJ2ZXJFbmdpbmVSZXF1ZXN0fSByZXF1ZXN0IC0gUmVxdWVzdCBmaWVsZHMuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgaGFuZGxlVHJ5QWNxdWlyZShyZWdpc3RlcmVkLCByZXF1ZXN0KSB7XG4gICAgY29uc3Qge2NvcnJlbGF0aW9uSWQsIG5hbWV9ID0gcmVxdWVzdFxuXG4gICAgaWYgKCFuYW1lKSB7XG4gICAgICB0aGlzLnJlc3BvbmQocmVnaXN0ZXJlZCwgY29ycmVsYXRpb25JZCwge2Vycm9yOiBcInRyeS1hY3F1aXJlIHJlcXVpcmVzIGEgbG9jayBuYW1lXCIsIHN0YXR1czogXCJlcnJvclwiLCB0eXBlOiBcInJlc3BvbnNlXCJ9KVxuXG4gICAgICByZXR1cm5cbiAgICB9XG5cbiAgICBjb25zdCByZWNvcmQgPSB0aGlzLmxvY2tSZWNvcmQobmFtZSlcbiAgICBjb25zdCBoZWxkRXBvY2ggPSByZWdpc3RlcmVkLmhlbGQuZ2V0KG5hbWUpXG5cbiAgICBpZiAocmVjb3JkLmhvbGRlciA9PT0gcmVnaXN0ZXJlZCAmJiB0eXBlb2YgaGVsZEVwb2NoID09PSBcIm51bWJlclwiKSB7XG4gICAgICB0aGlzLnJlc3BvbmQocmVnaXN0ZXJlZCwgY29ycmVsYXRpb25JZCwge2Vwb2NoOiBoZWxkRXBvY2gsIGxlYXNlRXhwaXJlc0F0OiByZWNvcmQubGVhc2VFeHBpcmVzQXQsIHN0YXR1czogXCJhbHJlYWR5LWhlbGRcIiwgdHlwZTogXCJyZXNwb25zZVwifSlcblxuICAgICAgcmV0dXJuXG4gICAgfVxuXG4gICAgaWYgKHJlY29yZC5ob2xkZXIpIHtcbiAgICAgIHRoaXMucmVzcG9uZChyZWdpc3RlcmVkLCBjb3JyZWxhdGlvbklkLCB7b3duZXJJZDogcmVjb3JkLmhvbGRlci5pZCwgc3RhdHVzOiBcImJ1c3lcIiwgdHlwZTogXCJyZXNwb25zZVwifSlcblxuICAgICAgcmV0dXJuXG4gICAgfVxuXG4gICAgdGhpcy5ncmFudChyZWdpc3RlcmVkLCByZWNvcmQsIGNvcnJlbGF0aW9uSWQpXG4gIH1cblxuICAvKipcbiAgICogSGFuZGxlcyBgcmVuZXdgIHdpdGggdGhlIGZlbmNpbmcgY2hlY2s6IG9ubHkgdGhlIGN1cnJlbnQgaG9sZGVyIHdpdGggdGhlXG4gICAqIG1hdGNoaW5nIGVwb2NoIG1heSBleHRlbmQgdGhlIGxlYXNlOyBhIHN1cGVyc2VkZWQgaG9sZGVyIGdldHMgYGxvc3RgIHdpdGhcbiAgICogdGhlIGN1cnJlbnQgZXBvY2guXG4gICAqIEBwYXJhbSB7TG9ja1NlcnZlckVuZ2luZVJlZ2lzdGVyZWRDb25uZWN0aW9ufSByZWdpc3RlcmVkIC0gUmVuZXdpbmcgY29ubmVjdGlvbi5cbiAgICogQHBhcmFtIHtMb2NrU2VydmVyRW5naW5lUmVxdWVzdCAmIHtlcG9jaDogbnVtYmVyfX0gcmVxdWVzdCAtIFJlcXVlc3QgZmllbGRzLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIGhhbmRsZVJlbmV3KHJlZ2lzdGVyZWQsIHJlcXVlc3QpIHtcbiAgICBjb25zdCB7Y29ycmVsYXRpb25JZCwgZXBvY2gsIG5hbWV9ID0gcmVxdWVzdFxuICAgIGNvbnN0IHJlY29yZCA9IHRoaXMubG9ja3MuZ2V0KG5hbWUpXG5cbiAgICBpZiAoIXJlY29yZCkge1xuICAgICAgdGhpcy5yZXNwb25kKHJlZ2lzdGVyZWQsIGNvcnJlbGF0aW9uSWQsIHtzdGF0dXM6IFwibm90LWZvdW5kXCIsIHR5cGU6IFwicmVzcG9uc2VcIn0pXG5cbiAgICAgIHJldHVyblxuICAgIH1cblxuICAgIGlmIChyZWNvcmQuaG9sZGVyICE9PSByZWdpc3RlcmVkIHx8IHJlY29yZC5lcG9jaCAhPT0gZXBvY2gpIHtcbiAgICAgIGNvbnN0IHN0YXR1cyA9IHJlZ2lzdGVyZWQuaGVsZC5oYXMobmFtZSkgPyBcImxvc3RcIiA6IFwibm90LWZvdW5kXCJcblxuICAgICAgdGhpcy5yZXNwb25kKHJlZ2lzdGVyZWQsIGNvcnJlbGF0aW9uSWQsIHtjdXJyZW50RXBvY2g6IHJlY29yZC5lcG9jaCwgc3RhdHVzLCB0eXBlOiBcInJlc3BvbnNlXCJ9KVxuXG4gICAgICByZXR1cm5cbiAgICB9XG5cbiAgICByZWNvcmQubGVhc2VFeHBpcmVzQXQgPSBEYXRlLm5vdygpICsgdGhpcy5sZWFzZU1zXG4gICAgdGhpcy5yZXNwb25kKHJlZ2lzdGVyZWQsIGNvcnJlbGF0aW9uSWQsIHtsZWFzZUV4cGlyZXNBdDogcmVjb3JkLmxlYXNlRXhwaXJlc0F0LCBzdGF0dXM6IFwicmVuZXdlZFwiLCB0eXBlOiBcInJlc3BvbnNlXCJ9KVxuICB9XG5cbiAgLyoqXG4gICAqIEhhbmRsZXMgYHJlbGVhc2VgOiBpZGVtcG90ZW50IGZvciB0aGUgaG9sZGVyOyBgbm90LWhvbGRlcmAgYWZ0ZXIgYW4gZXBvY2hcbiAgICogYnVtcCBpcyB0aGUgZXhwZWN0ZWQgYW5zd2VyIGZvciBhIHN1cGVyc2VkZWQgaG9sZGVyLlxuICAgKiBAcGFyYW0ge0xvY2tTZXJ2ZXJFbmdpbmVSZWdpc3RlcmVkQ29ubmVjdGlvbn0gcmVnaXN0ZXJlZCAtIFJlbGVhc2luZyBjb25uZWN0aW9uLlxuICAgKiBAcGFyYW0ge0xvY2tTZXJ2ZXJFbmdpbmVSZXF1ZXN0ICYge2Vwb2NoPzogbnVtYmVyfX0gcmVxdWVzdCAtIFJlcXVlc3QgZmllbGRzLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIGhhbmRsZVJlbGVhc2UocmVnaXN0ZXJlZCwgcmVxdWVzdCkge1xuICAgIGNvbnN0IHtjb3JyZWxhdGlvbklkLCBlcG9jaCwgbmFtZX0gPSByZXF1ZXN0XG4gICAgY29uc3QgcmVjb3JkID0gdGhpcy5sb2Nrcy5nZXQobmFtZSlcblxuICAgIGlmICghcmVjb3JkKSB7XG4gICAgICB0aGlzLnJlc3BvbmQocmVnaXN0ZXJlZCwgY29ycmVsYXRpb25JZCwge3N0YXR1czogXCJub3QtZm91bmRcIiwgdHlwZTogXCJyZXNwb25zZVwifSlcblxuICAgICAgcmV0dXJuXG4gICAgfVxuXG4gICAgaWYgKHJlY29yZC5ob2xkZXIgIT09IHJlZ2lzdGVyZWQpIHtcbiAgICAgIGNvbnN0IHN0YXR1cyA9IHJlZ2lzdGVyZWQuaGVsZC5oYXMobmFtZSkgPyBcIm5vdC1ob2xkZXJcIiA6IFwibm90LWZvdW5kXCJcblxuICAgICAgdGhpcy5yZXNwb25kKHJlZ2lzdGVyZWQsIGNvcnJlbGF0aW9uSWQsIHtjdXJyZW50RXBvY2g6IHJlY29yZC5lcG9jaCwgc3RhdHVzLCB0eXBlOiBcInJlc3BvbnNlXCJ9KVxuXG4gICAgICByZXR1cm5cbiAgICB9XG5cbiAgICBpZiAodHlwZW9mIGVwb2NoID09PSBcIm51bWJlclwiICYmIGVwb2NoICE9PSByZWNvcmQuZXBvY2gpIHtcbiAgICAgIHRoaXMucmVzcG9uZChyZWdpc3RlcmVkLCBjb3JyZWxhdGlvbklkLCB7Y3VycmVudEVwb2NoOiByZWNvcmQuZXBvY2gsIHN0YXR1czogXCJub3QtaG9sZGVyXCIsIHR5cGU6IFwicmVzcG9uc2VcIn0pXG5cbiAgICAgIHJldHVyblxuICAgIH1cblxuICAgIHJlY29yZC5ob2xkZXIgPSBudWxsXG4gICAgcmVnaXN0ZXJlZC5oZWxkLmRlbGV0ZShuYW1lKVxuICAgIHRoaXMucmVzcG9uZChyZWdpc3RlcmVkLCBjb3JyZWxhdGlvbklkLCB7c3RhdHVzOiBcInJlbGVhc2VkXCIsIHR5cGU6IFwicmVzcG9uc2VcIn0pXG4gICAgdGhpcy5ncmFudE5leHQocmVjb3JkKVxuICB9XG5cbiAgLyoqXG4gICAqIEdyYW50cyB0aGUgbG9jayB0byBhIGNvbm5lY3Rpb246IGJ1bXBzIHRoZSBtb25vdG9uaWMgcGVyLW5hbWUgZXBvY2gsXG4gICAqIGluc3RhbGxzIHRoZSBob2xkZXIsIGFuZCBhbnN3ZXJzIGBhY3F1aXJlZGAgZWNob2luZyB0aGUgY29ycmVsYXRpb24uXG4gICAqIEBwYXJhbSB7TG9ja1NlcnZlckVuZ2luZVJlZ2lzdGVyZWRDb25uZWN0aW9ufSByZWdpc3RlcmVkIC0gR3JhbnRlZCBjb25uZWN0aW9uLlxuICAgKiBAcGFyYW0ge0xvY2tTZXJ2ZXJFbmdpbmVMb2NrUmVjb3JkfSByZWNvcmQgLSBMb2NrIHJlY29yZC5cbiAgICogQHBhcmFtIHtzdHJpbmd9IGNvcnJlbGF0aW9uSWQgLSBDb3JyZWxhdGlvbiB0byBlY2hvLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIGdyYW50KHJlZ2lzdGVyZWQsIHJlY29yZCwgY29ycmVsYXRpb25JZCkge1xuICAgIGNvbnN0IGVwb2NoID0gKHRoaXMuZXBvY2hCeUxvY2suZ2V0KHJlY29yZC5uYW1lKSA/PyAwKSArIDFcblxuICAgIHRoaXMuZXBvY2hCeUxvY2suc2V0KHJlY29yZC5uYW1lLCBlcG9jaClcbiAgICByZWNvcmQuZXBvY2ggPSBlcG9jaFxuICAgIHJlY29yZC5ob2xkZXIgPSByZWdpc3RlcmVkXG4gICAgcmVjb3JkLmxlYXNlRXhwaXJlc0F0ID0gRGF0ZS5ub3coKSArIHRoaXMubGVhc2VNc1xuICAgIHJlZ2lzdGVyZWQuaGVsZC5zZXQocmVjb3JkLm5hbWUsIGVwb2NoKVxuXG4gICAgdGhpcy5yZXNwb25kKHJlZ2lzdGVyZWQsIGNvcnJlbGF0aW9uSWQsIHtlcG9jaCwgbGVhc2VFeHBpcmVzQXQ6IHJlY29yZC5sZWFzZUV4cGlyZXNBdCwgc3RhdHVzOiBcImFjcXVpcmVkXCIsIHR5cGU6IFwicmVzcG9uc2VcIn0pXG4gIH1cblxuICAvKipcbiAgICogTW92ZXMgdGhlIEZJRk8gcXVldWUncyBmaXJzdCBsaXZlIHdhaXRlciBpbnRvIHRoZSBncmFudCBwYXRoLlxuICAgKiBAcGFyYW0ge0xvY2tTZXJ2ZXJFbmdpbmVMb2NrUmVjb3JkfSByZWNvcmQgLSBGcmVlZCBsb2NrIHJlY29yZC5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBncmFudE5leHQocmVjb3JkKSB7XG4gICAgd2hpbGUgKHJlY29yZC53YWl0ZXJzLmxlbmd0aCA+IDApIHtcbiAgICAgIGNvbnN0IHdhaXRlciA9IC8qKiBAdHlwZSB7TG9ja1NlcnZlckVuZ2luZVdhaXRlcn0gKi8gKHJlY29yZC53YWl0ZXJzLnNoaWZ0KCkpXG5cbiAgICAgIGlmICh3YWl0ZXIudGltZXIpIGNsZWFyVGltZW91dCh3YWl0ZXIudGltZXIpXG4gICAgICBpZiAoIXdhaXRlci5jb25uZWN0aW9uLm9wZW4pIGNvbnRpbnVlXG5cbiAgICAgIHRoaXMuZ3JhbnQod2FpdGVyLmNvbm5lY3Rpb24sIHJlY29yZCwgd2FpdGVyLmNvcnJlbGF0aW9uSWQpXG5cbiAgICAgIHJldHVyblxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZW1vdmVzIGEgd2FpdGVyIHdob3NlIGJvdW5kZWQgd2FpdCBlbGFwc2VkIGFuZCBhbnN3ZXJzIGB0aW1lb3V0YC5cbiAgICogQHBhcmFtIHtMb2NrU2VydmVyRW5naW5lTG9ja1JlY29yZH0gcmVjb3JkIC0gTG9jayByZWNvcmQgdGhlIHdhaXRlciBxdWV1ZWQgb24uXG4gICAqIEBwYXJhbSB7TG9ja1NlcnZlckVuZ2luZVdhaXRlcn0gd2FpdGVyIC0gRXhwaXJlZCB3YWl0ZXIuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgZXhwaXJlV2FpdGVyKHJlY29yZCwgd2FpdGVyKSB7XG4gICAgY29uc3QgaW5kZXggPSByZWNvcmQud2FpdGVycy5pbmRleE9mKHdhaXRlcilcblxuICAgIGlmIChpbmRleCA+PSAwKSByZWNvcmQud2FpdGVycy5zcGxpY2UoaW5kZXgsIDEpXG4gICAgaWYgKCF3YWl0ZXIuY29ubmVjdGlvbi5vcGVuKSByZXR1cm5cblxuICAgIHRoaXMucmVzcG9uZCh3YWl0ZXIuY29ubmVjdGlvbiwgd2FpdGVyLmNvcnJlbGF0aW9uSWQsIHtzdGF0dXM6IFwidGltZW91dFwiLCB0eXBlOiBcInJlc3BvbnNlXCJ9KVxuICB9XG5cbiAgLyoqXG4gICAqIFN3ZWVwcyBleHBpcmVkIGxlYXNlczogYnVtcHMgdGhlIGVwb2NoICh0aGUgb2xkIGhvbGRlciBpcyBmZW5jZWQpLCBwdXNoZXNcbiAgICogYGxvc3RgIHRvIHRoZSBvbGQgaG9sZGVyLCBhbmQgZ3JhbnRzIHRoZSBuZXh0IHdhaXRlci5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICBzd2VlcCgpIHtcbiAgICBpZiAodGhpcy5jbG9zZWQpIHJldHVyblxuXG4gICAgY29uc3Qgbm93ID0gRGF0ZS5ub3coKVxuXG4gICAgZm9yIChjb25zdCByZWNvcmQgb2YgdGhpcy5sb2Nrcy52YWx1ZXMoKSkge1xuICAgICAgY29uc3QgaG9sZGVyID0gcmVjb3JkLmhvbGRlclxuXG4gICAgICBpZiAoIWhvbGRlciB8fCByZWNvcmQubGVhc2VFeHBpcmVzQXQgPiBub3cpIGNvbnRpbnVlXG5cbiAgICAgIGNvbnN0IGZlbmNlZEVwb2NoID0gcmVjb3JkLmVwb2NoXG5cbiAgICAgIHJlY29yZC5ob2xkZXIgPSBudWxsXG4gICAgICBob2xkZXIuaGVsZC5kZWxldGUocmVjb3JkLm5hbWUpXG4gICAgICB0aGlzLmVwb2NoQnlMb2NrLnNldChyZWNvcmQubmFtZSwgZmVuY2VkRXBvY2ggKyAxKVxuICAgICAgcmVjb3JkLmVwb2NoID0gZmVuY2VkRXBvY2ggKyAxXG5cbiAgICAgIHRyeSB7XG4gICAgICAgIGhvbGRlci5jb25uZWN0aW9uLnNlbmQoe2Vwb2NoOiByZWNvcmQuZXBvY2gsIG5hbWU6IHJlY29yZC5uYW1lLCB0eXBlOiBcImxvc3RcIn0pXG4gICAgICB9IGNhdGNoIHtcbiAgICAgICAgLy8gQSBkZWFkIHRyYW5zcG9ydCBjYW5ub3QgcmVjZWl2ZSB0aGUgcHVzaDsgdGhlIGxlYXNlIGlzIGFscmVhZHkgZ29uZS5cbiAgICAgIH1cblxuICAgICAgdGhpcy5ncmFudE5leHQocmVjb3JkKVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIChjcmVhdGluZyB3aGVuIG5lZWRlZCkgdGhlIGxpdmUgcmVjb3JkIGZvciBvbmUgbG9jayBuYW1lLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gbmFtZSAtIExvY2sgbmFtZS5cbiAgICogQHJldHVybnMge0xvY2tTZXJ2ZXJFbmdpbmVMb2NrUmVjb3JkfSAtIExpdmUgcmVjb3JkLlxuICAgKi9cbiAgbG9ja1JlY29yZChuYW1lKSB7XG4gICAgY29uc3QgZXhpc3RpbmcgPSB0aGlzLmxvY2tzLmdldChuYW1lKVxuXG4gICAgaWYgKGV4aXN0aW5nKSByZXR1cm4gZXhpc3RpbmdcblxuICAgIC8qKiBAdHlwZSB7TG9ja1NlcnZlckVuZ2luZUxvY2tSZWNvcmR9ICovXG4gICAgY29uc3QgcmVjb3JkID0ge2Vwb2NoOiB0aGlzLmVwb2NoQnlMb2NrLmdldChuYW1lKSA/PyAwLCBob2xkZXI6IG51bGwsIGxlYXNlRXhwaXJlc0F0OiAwLCBuYW1lLCB3YWl0ZXJzOiBbXX1cblxuICAgIHRoaXMubG9ja3Muc2V0KG5hbWUsIHJlY29yZClcblxuICAgIHJldHVybiByZWNvcmRcbiAgfVxuXG4gIC8qKlxuICAgKiBDdXJyZW50IGhvbGRlciBpbmZvIGZvciBvbmUgbmFtZSAoZGlhZ25vc3RpY3MpLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gbmFtZSAtIExvY2sgbmFtZS5cbiAgICogQHJldHVybnMge3tlcG9jaDogbnVtYmVyLCBob2xkZXJJZDogc3RyaW5nLCBsZWFzZUV4cGlyZXNBdDogbnVtYmVyLCBuYW1lOiBzdHJpbmcsIHdhaXRlckNvdW50OiBudW1iZXJ9IHwgbnVsbH0gLSBIb2xkZXIgaW5mbywgb3IgbnVsbCB3aGVuIGZyZWUuXG4gICAqL1xuICBob2xkZXJJbmZvKG5hbWUpIHtcbiAgICBjb25zdCByZWNvcmQgPSB0aGlzLmxvY2tzLmdldChuYW1lKVxuXG4gICAgaWYgKCFyZWNvcmQgfHwgIXJlY29yZC5ob2xkZXIpIHJldHVybiBudWxsXG5cbiAgICByZXR1cm4ge2Vwb2NoOiByZWNvcmQuZXBvY2gsIGhvbGRlcklkOiByZWNvcmQuaG9sZGVyLmlkLCBsZWFzZUV4cGlyZXNBdDogcmVjb3JkLmxlYXNlRXhwaXJlc0F0LCBuYW1lLCB3YWl0ZXJDb3VudDogcmVjb3JkLndhaXRlcnMubGVuZ3RofVxuICB9XG5cbiAgLyoqXG4gICAqIExpdmUgaG9sZGVyIGxpc3QgKGRpYWdub3N0aWNzKS5cbiAgICogQHJldHVybnMge3tlcG9jaDogbnVtYmVyLCBob2xkZXJJZDogc3RyaW5nLCBsZWFzZUV4cGlyZXNBdDogbnVtYmVyLCBuYW1lOiBzdHJpbmcsIHdhaXRlckNvdW50OiBudW1iZXJ9W119IC0gTGl2ZSBob2xkZXJzLlxuICAgKi9cbiAgbGlzdEhvbGRlcnMoKSB7XG4gICAgY29uc3QgaG9sZGVycyA9IFtdXG5cbiAgICBmb3IgKGNvbnN0IHJlY29yZCBvZiB0aGlzLmxvY2tzLnZhbHVlcygpKSB7XG4gICAgICBpZiAoIXJlY29yZC5ob2xkZXIpIGNvbnRpbnVlXG5cbiAgICAgIGhvbGRlcnMucHVzaCh7ZXBvY2g6IHJlY29yZC5lcG9jaCwgaG9sZGVySWQ6IHJlY29yZC5ob2xkZXIuaWQsIGxlYXNlRXhwaXJlc0F0OiByZWNvcmQubGVhc2VFeHBpcmVzQXQsIG5hbWU6IHJlY29yZC5uYW1lLCB3YWl0ZXJDb3VudDogcmVjb3JkLndhaXRlcnMubGVuZ3RofSlcbiAgICB9XG5cbiAgICByZXR1cm4gaG9sZGVyc1xuICB9XG5cbiAgLyoqXG4gICAqIFNlbmRzIG9uZSByZXNwb25zZSB0byBhIGNvbm5lY3Rpb24uXG4gICAqIEBwYXJhbSB7TG9ja1NlcnZlckVuZ2luZVJlZ2lzdGVyZWRDb25uZWN0aW9ufSByZWdpc3RlcmVkIC0gVGFyZ2V0IGNvbm5lY3Rpb24uXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBjb3JyZWxhdGlvbklkIC0gQ29ycmVsYXRpb24gdG8gZWNoby5cbiAgICogQHBhcmFtIHtSZWNvcmQ8c3RyaW5nLCB1bmtub3duPn0gYm9keSAtIFJlc3BvbnNlIGZpZWxkcy5cbiAgICogQHJldHVybnMge3ZvaWR9XG4gICAqL1xuICByZXNwb25kKHJlZ2lzdGVyZWQsIGNvcnJlbGF0aW9uSWQsIGJvZHkpIHtcbiAgICByZWdpc3RlcmVkLmNvbm5lY3Rpb24uc2VuZCh7Li4uYm9keSwgY29ycmVsYXRpb25JZH0pXG4gIH1cbn1cbiJdfQ==
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import net from "node:net";
|
|
2
|
+
/**
|
|
3
|
+
* Unix-domain-socket transport client for the `local` lock-server mode
|
|
4
|
+
* (STC-715). It connects to the local engine server
|
|
5
|
+
* (`src/environment-handlers/node/advisory-lock-lock-server-local-server.js`)
|
|
6
|
+
* over a Unix socket — no listening network port, no `ws` — and spawns that
|
|
7
|
+
* server as a child of this environment when no local engine is running yet.
|
|
8
|
+
*
|
|
9
|
+
* One local engine serves every process on the host that points at the same
|
|
10
|
+
* socket path, which is what makes `local` mode the multi-process single-host
|
|
11
|
+
* answer (embedded mode only coordinates inside one JS realm).
|
|
12
|
+
*
|
|
13
|
+
* Crash detection and bounded restart: when the socket dies, the transport
|
|
14
|
+
* reports `transportClosed` to the backend adapter, which fails pending
|
|
15
|
+
* requests and starts its `reprobeCooldownMs` unavailability cache. The next
|
|
16
|
+
* acquisition after the cooldown reconnects — respawning the engine child when
|
|
17
|
+
* the socket file is gone. The cooldown IS the restart backoff; there is no
|
|
18
|
+
* separate respawn loop.
|
|
19
|
+
*/
|
|
20
|
+
export default class AdvisoryLockLockServerLocalClient {
|
|
21
|
+
authToken: string;
|
|
22
|
+
connectTimeoutMs: number;
|
|
23
|
+
leaseMs: number;
|
|
24
|
+
socketPath: string;
|
|
25
|
+
connectionId: string;
|
|
26
|
+
/** @type {net.Socket | null} */
|
|
27
|
+
socket: net.Socket | null;
|
|
28
|
+
/** @type {((body: Record<string, unknown>) => void) | null} */
|
|
29
|
+
onMessage: ((body: Record<string, unknown>) => void) | null;
|
|
30
|
+
/** @type {import("node:child_process").ChildProcess | null} */
|
|
31
|
+
spawnedChild: import("node:child_process").ChildProcess | null;
|
|
32
|
+
closed: boolean;
|
|
33
|
+
dead: boolean;
|
|
34
|
+
stdoutBuffer: string;
|
|
35
|
+
/**
|
|
36
|
+
* Creates the local transport client. No socket or process is touched until
|
|
37
|
+
* `connect()` — constructing this object performs no I/O.
|
|
38
|
+
* @param {object} args - Client options.
|
|
39
|
+
* @param {string} [args.authToken] - Shared secret forwarded in the hello params.
|
|
40
|
+
* @param {number} [args.connectTimeoutMs] - Bounded wait for the socket/engine child to become ready.
|
|
41
|
+
* @param {number} [args.leaseMs] - Lease duration the engine child should use.
|
|
42
|
+
* @param {string} args.socketPath - Unix socket path of the local engine.
|
|
43
|
+
*/
|
|
44
|
+
constructor({ authToken, connectTimeoutMs, leaseMs, socketPath }: {
|
|
45
|
+
authToken?: string;
|
|
46
|
+
connectTimeoutMs?: number;
|
|
47
|
+
leaseMs?: number;
|
|
48
|
+
socketPath: string;
|
|
49
|
+
});
|
|
50
|
+
/**
|
|
51
|
+
* Connects to the local engine, spawning the engine child when the socket is
|
|
52
|
+
* not there yet.
|
|
53
|
+
* @returns {Promise<void>} - Resolves once the socket is connected.
|
|
54
|
+
*/
|
|
55
|
+
connect(): Promise<void>;
|
|
56
|
+
/**
|
|
57
|
+
* Opens the 1:1 view of the socket connection (one connection per
|
|
58
|
+
* transport, like the websocket adapter).
|
|
59
|
+
* @param {string} _type - Connection role (`lock`).
|
|
60
|
+
* @param {{onMessage: (body: Record<string, unknown>) => void, params: Record<string, unknown>}} args - Connection options.
|
|
61
|
+
* @returns {{ready: Promise<void>, sendMessage: (body: Record<string, unknown>) => void, close: () => void}} - Connection handle.
|
|
62
|
+
*/
|
|
63
|
+
openConnection(_type: string, args: {
|
|
64
|
+
onMessage: (body: Record<string, unknown>) => void;
|
|
65
|
+
params: Record<string, unknown>;
|
|
66
|
+
}): {
|
|
67
|
+
ready: Promise<void>;
|
|
68
|
+
sendMessage: (body: Record<string, unknown>) => void;
|
|
69
|
+
close: () => void;
|
|
70
|
+
};
|
|
71
|
+
/**
|
|
72
|
+
* Closes the socket and stops an engine child this client spawned. A child
|
|
73
|
+
* it did not spawn keeps serving the other processes on the host and idles
|
|
74
|
+
* out on its own once its last connection closes.
|
|
75
|
+
* @returns {void}
|
|
76
|
+
*/
|
|
77
|
+
close(): void;
|
|
78
|
+
/**
|
|
79
|
+
* Opens the Unix socket and wires the line protocol.
|
|
80
|
+
* @returns {Promise<void>} - Resolves when connected.
|
|
81
|
+
*/
|
|
82
|
+
openSocket(): Promise<void>;
|
|
83
|
+
/**
|
|
84
|
+
* Spawns the local engine server as a child of this environment.
|
|
85
|
+
* @returns {void}
|
|
86
|
+
*/
|
|
87
|
+
spawnEngineChild(): void;
|
|
88
|
+
/**
|
|
89
|
+
* Writes one protocol message as a JSON line to the socket.
|
|
90
|
+
* @param {Record<string, unknown>} body - Message to send.
|
|
91
|
+
* @returns {void}
|
|
92
|
+
*/
|
|
93
|
+
writeLine(body: Record<string, unknown>): void;
|
|
94
|
+
/**
|
|
95
|
+
* Buffers socket data and dispatches complete JSON lines to the message
|
|
96
|
+
* handler.
|
|
97
|
+
* @param {string} chunk - Raw socket chunk.
|
|
98
|
+
* @returns {void}
|
|
99
|
+
*/
|
|
100
|
+
handleSocketChunk(chunk: string): void;
|
|
101
|
+
/**
|
|
102
|
+
* Reports transport death to the adapter (crash detection).
|
|
103
|
+
* @param {Error} error - Death reason.
|
|
104
|
+
* @returns {void}
|
|
105
|
+
*/
|
|
106
|
+
handleTransportDeath(error: Error): void;
|
|
107
|
+
/**
|
|
108
|
+
* Whether a connect failure means "no engine is listening yet" (spawn it).
|
|
109
|
+
* @param {unknown} error - Connect error.
|
|
110
|
+
* @returns {boolean} - True for ENOENT / ECONNREFUSED on a missing socket.
|
|
111
|
+
*/
|
|
112
|
+
socketMissingError(error: unknown): boolean;
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=advisory-lock-lock-server-local-client.d.ts.map
|