velocious 1.0.725 → 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.
- package/README.md +1 -1
- package/build/background-jobs/adapter.js +16 -0
- package/build/background-jobs/job-record.js +3 -1
- package/build/background-jobs/main.js +62 -2
- package/build/background-jobs/owner-liveness.js +27 -5
- package/build/background-jobs/store.js +74 -0
- package/build/background-jobs/types.js +3 -0
- package/build/configuration-types.js +1 -1
- package/build/configuration.js +53 -3
- 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/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.js +30 -3
- package/build/http-server/server-lock.js +29 -16
- package/build/src/background-jobs/adapter.d.ts +23 -0
- package/build/src/background-jobs/adapter.d.ts.map +1 -1
- package/build/src/background-jobs/adapter.js +15 -1
- package/build/src/background-jobs/job-record.d.ts +3 -1
- package/build/src/background-jobs/job-record.d.ts.map +1 -1
- package/build/src/background-jobs/job-record.js +4 -2
- package/build/src/background-jobs/main.d.ts +33 -0
- package/build/src/background-jobs/main.d.ts.map +1 -1
- package/build/src/background-jobs/main.js +59 -3
- package/build/src/background-jobs/owner-liveness.d.ts +25 -3
- package/build/src/background-jobs/owner-liveness.d.ts.map +1 -1
- package/build/src/background-jobs/owner-liveness.js +26 -7
- package/build/src/background-jobs/store.d.ts +39 -0
- package/build/src/background-jobs/store.d.ts.map +1 -1
- package/build/src/background-jobs/store.js +66 -1
- package/build/src/background-jobs/types.d.ts +6 -0
- package/build/src/background-jobs/types.d.ts.map +1 -1
- package/build/src/background-jobs/types.js +4 -1
- 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 +25 -1
- package/build/src/configuration.d.ts.map +1 -1
- package/build/src/configuration.js +47 -4
- 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/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.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 +22 -11
- package/build/src/http-server/server-lock.d.ts.map +1 -1
- package/build/src/http-server/server-lock.js +30 -17
- package/package.json +1 -1
- package/src/background-jobs/adapter.js +16 -0
- package/src/background-jobs/job-record.js +3 -1
- package/src/background-jobs/main.js +62 -2
- package/src/background-jobs/owner-liveness.js +27 -5
- package/src/background-jobs/store.js +74 -0
- package/src/background-jobs/types.js +3 -0
- package/src/configuration-types.js +1 -1
- package/src/configuration.js +53 -3
- 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/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.js +30 -3
- package/src/http-server/server-lock.js +29 -16
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"advisory-lock-lock-server-local-client.d.ts","sourceRoot":"","sources":["../../../src/database/advisory-lock-lock-server-local-client.js"],"names":[],"mappings":"AAEA,OAAO,GAAG,MAAM,UAAU,CAAA;AAI1B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,iCAAiC;IAW7C,SAAS;IACT,gBAAgB;IAChB,OAAO;IACP,UAAU;IACV,YAAY;IACjB,gCAAgC;IAC3B,MAAM,EADA,GAAG,CAAC,MAAM,GAAG,IAAI;IAE5B,+DAA+D;IAC1D,SAAS,EADH,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI;IAE3D,+DAA+D;IAC1D,YAAY,EADN,OAAO,oBAAoB,EAAE,YAAY,GAAG,IAAI;IAEtD,MAAM;IACN,IAAI;IACJ,YAAY;IAvBnB;;;;;;;;OAQG;IACH,YAAY,EAAC,SAAc,EAAE,gBAAuB,EAAE,OAAgB,EAAE,UAAU,EAAC,EALhF;QAAsB,SAAS,AAA/B,CACA,EADQ,MAAM,CACd;QAAsB,gBAAgB,AAAtC,CACA,EADQ,MAAM,CACd;QAAsB,OAAO,AAA7B,CACA,EADQ,MAAM,CACd;QAAqB,UAAU,EAAvB,MAAM,CAChB;KACkF,EAelF;IAED;;;;OAIG;IACG,OAAO,IAFA,OAAO,CAAC,IAAI,CAAC,CAgCzB;IAED;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAJT,MAIS,EAAE,IAAI,EAHf;QAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAGrE,GAFb;QAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAC,CAe3G;IAED;;;;;OAKG;IACH,KAAK,IAFQ,IAAI,CAehB;IAED;;;OAGG;IACH,UAAU,IAFG,OAAO,CAAC,IAAI,CAAC,CAgCzB;IAED;;;OAGG;IACH,gBAAgB,IAFH,IAAI,CAoBhB;IAED;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAHH,MAAM,CAAC,MAAM,EAAE,OAAO,CAGnB,GAFD,IAAI,CAQhB;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,KAAK,EAHZ,MAGY,GAFV,IAAI,CAyBhB;IAED;;;;OAIG;IACH,oBAAoB,CAAC,KAAK,EAHf,KAGe,GAFb,IAAI,CAShB;IAED;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAHb,OAGa,GAFX,OAAO,CAMnB;CACF"}
|
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
// @ts-check
|
|
2
|
+
import net from "node:net";
|
|
3
|
+
import { spawn } from "node:child_process";
|
|
4
|
+
import { fileURLToPath } from "node:url";
|
|
5
|
+
/**
|
|
6
|
+
* Unix-domain-socket transport client for the `local` lock-server mode
|
|
7
|
+
* (STC-715). It connects to the local engine server
|
|
8
|
+
* (`src/environment-handlers/node/advisory-lock-lock-server-local-server.js`)
|
|
9
|
+
* over a Unix socket — no listening network port, no `ws` — and spawns that
|
|
10
|
+
* server as a child of this environment when no local engine is running yet.
|
|
11
|
+
*
|
|
12
|
+
* One local engine serves every process on the host that points at the same
|
|
13
|
+
* socket path, which is what makes `local` mode the multi-process single-host
|
|
14
|
+
* answer (embedded mode only coordinates inside one JS realm).
|
|
15
|
+
*
|
|
16
|
+
* Crash detection and bounded restart: when the socket dies, the transport
|
|
17
|
+
* reports `transportClosed` to the backend adapter, which fails pending
|
|
18
|
+
* requests and starts its `reprobeCooldownMs` unavailability cache. The next
|
|
19
|
+
* acquisition after the cooldown reconnects — respawning the engine child when
|
|
20
|
+
* the socket file is gone. The cooldown IS the restart backoff; there is no
|
|
21
|
+
* separate respawn loop.
|
|
22
|
+
*/
|
|
23
|
+
export default class AdvisoryLockLockServerLocalClient {
|
|
24
|
+
/**
|
|
25
|
+
* Creates the local transport client. No socket or process is touched until
|
|
26
|
+
* `connect()` — constructing this object performs no I/O.
|
|
27
|
+
* @param {object} args - Client options.
|
|
28
|
+
* @param {string} [args.authToken] - Shared secret forwarded in the hello params.
|
|
29
|
+
* @param {number} [args.connectTimeoutMs] - Bounded wait for the socket/engine child to become ready.
|
|
30
|
+
* @param {number} [args.leaseMs] - Lease duration the engine child should use.
|
|
31
|
+
* @param {string} args.socketPath - Unix socket path of the local engine.
|
|
32
|
+
*/
|
|
33
|
+
constructor({ authToken = "", connectTimeoutMs = 3000, leaseMs = 30_000, socketPath }) {
|
|
34
|
+
this.authToken = authToken;
|
|
35
|
+
this.connectTimeoutMs = connectTimeoutMs;
|
|
36
|
+
this.leaseMs = leaseMs;
|
|
37
|
+
this.socketPath = socketPath;
|
|
38
|
+
this.connectionId = `client-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
|
|
39
|
+
/** @type {net.Socket | null} */
|
|
40
|
+
this.socket = null;
|
|
41
|
+
/** @type {((body: Record<string, unknown>) => void) | null} */
|
|
42
|
+
this.onMessage = null;
|
|
43
|
+
/** @type {import("node:child_process").ChildProcess | null} */
|
|
44
|
+
this.spawnedChild = null;
|
|
45
|
+
this.closed = false;
|
|
46
|
+
this.dead = false;
|
|
47
|
+
this.stdoutBuffer = "";
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Connects to the local engine, spawning the engine child when the socket is
|
|
51
|
+
* not there yet.
|
|
52
|
+
* @returns {Promise<void>} - Resolves once the socket is connected.
|
|
53
|
+
*/
|
|
54
|
+
async connect() {
|
|
55
|
+
if (this.socket)
|
|
56
|
+
return;
|
|
57
|
+
try {
|
|
58
|
+
await this.openSocket();
|
|
59
|
+
return;
|
|
60
|
+
}
|
|
61
|
+
catch (error) {
|
|
62
|
+
if (!this.socketMissingError(error))
|
|
63
|
+
throw error;
|
|
64
|
+
// No engine is listening (missing socket, or a stale socket file left by
|
|
65
|
+
// a crashed engine): spawn the engine child and poll until it is live.
|
|
66
|
+
this.spawnEngineChild();
|
|
67
|
+
const deadline = Date.now() + this.connectTimeoutMs;
|
|
68
|
+
while (true) {
|
|
69
|
+
try {
|
|
70
|
+
await this.openSocket();
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
catch (retryError) {
|
|
74
|
+
if (!this.socketMissingError(retryError))
|
|
75
|
+
throw retryError;
|
|
76
|
+
if (Date.now() >= deadline)
|
|
77
|
+
throw new Error(`Local lock server did not start at ${this.socketPath}`, { cause: retryError });
|
|
78
|
+
await new Promise((resolve) => setTimeout(resolve, 25));
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Opens the 1:1 view of the socket connection (one connection per
|
|
85
|
+
* transport, like the websocket adapter).
|
|
86
|
+
* @param {string} _type - Connection role (`lock`).
|
|
87
|
+
* @param {{onMessage: (body: Record<string, unknown>) => void, params: Record<string, unknown>}} args - Connection options.
|
|
88
|
+
* @returns {{ready: Promise<void>, sendMessage: (body: Record<string, unknown>) => void, close: () => void}} - Connection handle.
|
|
89
|
+
*/
|
|
90
|
+
openConnection(_type, args) {
|
|
91
|
+
this.onMessage = args.onMessage;
|
|
92
|
+
// The connection-open frame carries auth and protocol version; the engine
|
|
93
|
+
// answers it with a hello-ack, exactly like the external daemon does over
|
|
94
|
+
// the websocket transport.
|
|
95
|
+
this.writeLine({ connectionId: this.connectionId, params: args.params, type: "hello" });
|
|
96
|
+
return {
|
|
97
|
+
close: () => this.close(),
|
|
98
|
+
ready: Promise.resolve(),
|
|
99
|
+
sendMessage: (/** @type {Record<string, unknown>} */ body) => this.writeLine(body)
|
|
100
|
+
};
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Closes the socket and stops an engine child this client spawned. A child
|
|
104
|
+
* it did not spawn keeps serving the other processes on the host and idles
|
|
105
|
+
* out on its own once its last connection closes.
|
|
106
|
+
* @returns {void}
|
|
107
|
+
*/
|
|
108
|
+
close() {
|
|
109
|
+
this.closed = true;
|
|
110
|
+
const socket = this.socket;
|
|
111
|
+
this.socket = null;
|
|
112
|
+
socket?.end();
|
|
113
|
+
socket?.destroy();
|
|
114
|
+
const child = this.spawnedChild;
|
|
115
|
+
this.spawnedChild = null;
|
|
116
|
+
child?.kill("SIGTERM");
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* Opens the Unix socket and wires the line protocol.
|
|
120
|
+
* @returns {Promise<void>} - Resolves when connected.
|
|
121
|
+
*/
|
|
122
|
+
openSocket() {
|
|
123
|
+
return new Promise((resolve, reject) => {
|
|
124
|
+
const socket = net.connect(this.socketPath);
|
|
125
|
+
const timer = setTimeout(() => {
|
|
126
|
+
socket.destroy();
|
|
127
|
+
reject(new Error(`Timed out connecting to the local lock server at ${this.socketPath}`));
|
|
128
|
+
}, this.connectTimeoutMs);
|
|
129
|
+
timer.unref?.();
|
|
130
|
+
socket.once("connect", () => {
|
|
131
|
+
clearTimeout(timer);
|
|
132
|
+
this.socket = socket;
|
|
133
|
+
this.dead = false;
|
|
134
|
+
resolve();
|
|
135
|
+
});
|
|
136
|
+
socket.once("error", (/** @type {Error} */ error) => {
|
|
137
|
+
clearTimeout(timer);
|
|
138
|
+
if (this.socket === socket)
|
|
139
|
+
this.socket = null;
|
|
140
|
+
reject(error);
|
|
141
|
+
});
|
|
142
|
+
socket.setEncoding("utf8");
|
|
143
|
+
socket.on("data", (/** @type {string} */ chunk) => this.handleSocketChunk(chunk));
|
|
144
|
+
socket.on("close", () => this.handleTransportDeath(new Error("Local lock server socket closed")));
|
|
145
|
+
});
|
|
146
|
+
}
|
|
147
|
+
/**
|
|
148
|
+
* Spawns the local engine server as a child of this environment.
|
|
149
|
+
* @returns {void}
|
|
150
|
+
*/
|
|
151
|
+
spawnEngineChild() {
|
|
152
|
+
if (this.spawnedChild)
|
|
153
|
+
return;
|
|
154
|
+
const serverModulePath = fileURLToPath(new URL("../environment-handlers/node/advisory-lock-lock-server-local-server.js", import.meta.url));
|
|
155
|
+
const child = spawn(process.execPath, [serverModulePath], {
|
|
156
|
+
env: {
|
|
157
|
+
...process.env,
|
|
158
|
+
CONSENS_LOCK_LEASE_MS: String(this.leaseMs),
|
|
159
|
+
VELOCIOUS_LOCK_SERVER_SOCKET_PATH: this.socketPath
|
|
160
|
+
},
|
|
161
|
+
stdio: ["ignore", "ignore", "ignore"]
|
|
162
|
+
});
|
|
163
|
+
child.on("error", () => {
|
|
164
|
+
// A failed spawn surfaces as a connect failure on the next socket wait.
|
|
165
|
+
});
|
|
166
|
+
child.unref();
|
|
167
|
+
this.spawnedChild = child;
|
|
168
|
+
}
|
|
169
|
+
/**
|
|
170
|
+
* Writes one protocol message as a JSON line to the socket.
|
|
171
|
+
* @param {Record<string, unknown>} body - Message to send.
|
|
172
|
+
* @returns {void}
|
|
173
|
+
*/
|
|
174
|
+
writeLine(body) {
|
|
175
|
+
const socket = this.socket;
|
|
176
|
+
if (!socket || this.dead)
|
|
177
|
+
throw new Error("Local lock server connection is not open");
|
|
178
|
+
socket.write(`${JSON.stringify({ ...body, connectionId: this.connectionId })}\n`);
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* Buffers socket data and dispatches complete JSON lines to the message
|
|
182
|
+
* handler.
|
|
183
|
+
* @param {string} chunk - Raw socket chunk.
|
|
184
|
+
* @returns {void}
|
|
185
|
+
*/
|
|
186
|
+
handleSocketChunk(chunk) {
|
|
187
|
+
this.stdoutBuffer += chunk;
|
|
188
|
+
let newlineIndex = this.stdoutBuffer.indexOf("\n");
|
|
189
|
+
while (newlineIndex >= 0) {
|
|
190
|
+
const line = this.stdoutBuffer.slice(0, newlineIndex);
|
|
191
|
+
this.stdoutBuffer = this.stdoutBuffer.slice(newlineIndex + 1);
|
|
192
|
+
if (line.trim()) {
|
|
193
|
+
try {
|
|
194
|
+
const parsed = /** @type {Record<string, unknown>} */ (JSON.parse(line));
|
|
195
|
+
this.onMessage?.(parsed);
|
|
196
|
+
}
|
|
197
|
+
catch {
|
|
198
|
+
// A malformed engine line is not a lock answer: the adapter's
|
|
199
|
+
// request timeout surfaces it loudly instead of guessing.
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
newlineIndex = this.stdoutBuffer.indexOf("\n");
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
/**
|
|
206
|
+
* Reports transport death to the adapter (crash detection).
|
|
207
|
+
* @param {Error} error - Death reason.
|
|
208
|
+
* @returns {void}
|
|
209
|
+
*/
|
|
210
|
+
handleTransportDeath(error) {
|
|
211
|
+
if (this.dead || this.closed)
|
|
212
|
+
return;
|
|
213
|
+
this.dead = true;
|
|
214
|
+
this.socket = null;
|
|
215
|
+
this.onMessage?.({ error: error.message, status: "transport-closed", transportClosed: true, type: "response" });
|
|
216
|
+
}
|
|
217
|
+
/**
|
|
218
|
+
* Whether a connect failure means "no engine is listening yet" (spawn it).
|
|
219
|
+
* @param {unknown} error - Connect error.
|
|
220
|
+
* @returns {boolean} - True for ENOENT / ECONNREFUSED on a missing socket.
|
|
221
|
+
*/
|
|
222
|
+
socketMissingError(error) {
|
|
223
|
+
const code = /** @type {{code?: string}} */ (error || {}).code;
|
|
224
|
+
return code === "ENOENT" || code === "ECONNREFUSED";
|
|
225
|
+
}
|
|
226
|
+
}
|
|
227
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1sb2NhbC1jbGllbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGF0YWJhc2UvYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1sb2NhbC1jbGllbnQuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sR0FBRyxNQUFNLFVBQVUsQ0FBQTtBQUMxQixPQUFPLEVBQUMsS0FBSyxFQUFDLE1BQU0sb0JBQW9CLENBQUE7QUFDeEMsT0FBTyxFQUFDLGFBQWEsRUFBQyxNQUFNLFVBQVUsQ0FBQTtBQUV0Qzs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FpQkc7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLGlDQUFpQztJQUNwRDs7Ozs7Ozs7T0FRRztJQUNILFlBQVksRUFBQyxTQUFTLEdBQUcsRUFBRSxFQUFFLGdCQUFnQixHQUFHLElBQUksRUFBRSxPQUFPLEdBQUcsTUFBTSxFQUFFLFVBQVUsRUFBQztRQUNqRixJQUFJLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQTtRQUMxQixJQUFJLENBQUMsZ0JBQWdCLEdBQUcsZ0JBQWdCLENBQUE7UUFDeEMsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUE7UUFDdEIsSUFBSSxDQUFDLFVBQVUsR0FBRyxVQUFVLENBQUE7UUFDNUIsSUFBSSxDQUFDLFlBQVksR0FBRyxVQUFVLE9BQU8sQ0FBQyxHQUFHLElBQUksSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxFQUFFLENBQUE7UUFDdEYsZ0NBQWdDO1FBQ2hDLElBQUksQ0FBQyxNQUFNLEdBQUcsSUFBSSxDQUFBO1FBQ2xCLCtEQUErRDtRQUMvRCxJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQTtRQUNyQiwrREFBK0Q7UUFDL0QsSUFBSSxDQUFDLFlBQVksR0FBRyxJQUFJLENBQUE7UUFDeEIsSUFBSSxDQUFDLE1BQU0sR0FBRyxLQUFLLENBQUE7UUFDbkIsSUFBSSxDQUFDLElBQUksR0FBRyxLQUFLLENBQUE7UUFDakIsSUFBSSxDQUFDLFlBQVksR0FBRyxFQUFFLENBQUE7SUFDeEIsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxLQUFLLENBQUMsT0FBTztRQUNYLElBQUksSUFBSSxDQUFDLE1BQU07WUFBRSxPQUFNO1FBRXZCLElBQUksQ0FBQztZQUNILE1BQU0sSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFBO1lBRXZCLE9BQU07UUFDUixDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLElBQUksQ0FBQyxJQUFJLENBQUMsa0JBQWtCLENBQUMsS0FBSyxDQUFDO2dCQUFFLE1BQU0sS0FBSyxDQUFBO1lBRWhELHlFQUF5RTtZQUN6RSx1RUFBdUU7WUFDdkUsSUFBSSxDQUFDLGdCQUFnQixFQUFFLENBQUE7WUFFdkIsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQTtZQUVuRCxPQUFPLElBQUksRUFBRSxDQUFDO2dCQUNaLElBQUksQ0FBQztvQkFDSCxNQUFNLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQTtvQkFFdkIsT0FBTTtnQkFDUixDQUFDO2dCQUFDLE9BQU8sVUFBVSxFQUFFLENBQUM7b0JBQ3BCLElBQUksQ0FBQyxJQUFJLENBQUMsa0JBQWtCLENBQUMsVUFBVSxDQUFDO3dCQUFFLE1BQU0sVUFBVSxDQUFBO29CQUUxRCxJQUFJLElBQUksQ0FBQyxHQUFHLEVBQUUsSUFBSSxRQUFRO3dCQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsc0NBQXNDLElBQUksQ0FBQyxVQUFVLEVBQUUsRUFBRSxFQUFDLEtBQUssRUFBRSxVQUFVLEVBQUMsQ0FBQyxDQUFBO29CQUV6SCxNQUFNLElBQUksT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUE7Z0JBQ3pELENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSCxjQUFjLENBQUMsS0FBSyxFQUFFLElBQUk7UUFDeEIsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFBO1FBRS9CLDBFQUEwRTtRQUMxRSwwRUFBMEU7UUFDMUUsMkJBQTJCO1FBQzNCLElBQUksQ0FBQyxTQUFTLENBQUMsRUFBQyxZQUFZLEVBQUUsSUFBSSxDQUFDLFlBQVksRUFBRSxNQUFNLEVBQUUsSUFBSSxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFDLENBQUMsQ0FBQTtRQUVyRixPQUFPO1lBQ0wsS0FBSyxFQUFFLEdBQUcsRUFBRSxDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUU7WUFDekIsS0FBSyxFQUFFLE9BQU8sQ0FBQyxPQUFPLEVBQUU7WUFDeEIsV0FBVyxFQUFFLENBQUMsc0NBQXNDLENBQUMsSUFBSSxFQUFFLEVBQUUsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQztTQUNuRixDQUFBO0lBQ0gsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ0gsS0FBSztRQUNILElBQUksQ0FBQyxNQUFNLEdBQUcsSUFBSSxDQUFBO1FBRWxCLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxNQUFNLENBQUE7UUFFMUIsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUE7UUFDbEIsTUFBTSxFQUFFLEdBQUcsRUFBRSxDQUFBO1FBQ2IsTUFBTSxFQUFFLE9BQU8sRUFBRSxDQUFBO1FBRWpCLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUE7UUFFL0IsSUFBSSxDQUFDLFlBQVksR0FBRyxJQUFJLENBQUE7UUFDeEIsS0FBSyxFQUFFLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQTtJQUN4QixDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsVUFBVTtRQUNSLE9BQU8sSUFBSSxPQUFPLENBQUMsQ0FBQyxPQUFPLEVBQUUsTUFBTSxFQUFFLEVBQUU7WUFDckMsTUFBTSxNQUFNLEdBQUcsR0FBRyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUE7WUFFM0MsTUFBTSxLQUFLLEdBQUcsVUFBVSxDQUFDLEdBQUcsRUFBRTtnQkFDNUIsTUFBTSxDQUFDLE9BQU8sRUFBRSxDQUFBO2dCQUNoQixNQUFNLENBQUMsSUFBSSxLQUFLLENBQUMsb0RBQW9ELElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQyxDQUFDLENBQUE7WUFDMUYsQ0FBQyxFQUFFLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFBO1lBRXpCLEtBQUssQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFBO1lBRWYsTUFBTSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsR0FBRyxFQUFFO2dCQUMxQixZQUFZLENBQUMsS0FBSyxDQUFDLENBQUE7Z0JBQ25CLElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFBO2dCQUNwQixJQUFJLENBQUMsSUFBSSxHQUFHLEtBQUssQ0FBQTtnQkFDakIsT0FBTyxFQUFFLENBQUE7WUFDWCxDQUFDLENBQUMsQ0FBQTtZQUVGLE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxFQUFFLENBQUMsb0JBQW9CLENBQUMsS0FBSyxFQUFFLEVBQUU7Z0JBQ2xELFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQTtnQkFFbkIsSUFBSSxJQUFJLENBQUMsTUFBTSxLQUFLLE1BQU07b0JBQUUsSUFBSSxDQUFDLE1BQU0sR0FBRyxJQUFJLENBQUE7Z0JBRTlDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQTtZQUNmLENBQUMsQ0FBQyxDQUFBO1lBRUYsTUFBTSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUMsQ0FBQTtZQUMxQixNQUFNLENBQUMsRUFBRSxDQUFDLE1BQU0sRUFBRSxDQUFDLHFCQUFxQixDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLGlCQUFpQixDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUE7WUFDakYsTUFBTSxDQUFDLEVBQUUsQ0FBQyxPQUFPLEVBQUUsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLG9CQUFvQixDQUFDLElBQUksS0FBSyxDQUFDLGlDQUFpQyxDQUFDLENBQUMsQ0FBQyxDQUFBO1FBQ25HLENBQUMsQ0FBQyxDQUFBO0lBQ0osQ0FBQztJQUVEOzs7T0FHRztJQUNILGdCQUFnQjtRQUNkLElBQUksSUFBSSxDQUFDLFlBQVk7WUFBRSxPQUFNO1FBRTdCLE1BQU0sZ0JBQWdCLEdBQUcsYUFBYSxDQUFDLElBQUksR0FBRyxDQUFDLHdFQUF3RSxFQUFFLE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUE7UUFDMUksTUFBTSxLQUFLLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQyxnQkFBZ0IsQ0FBQyxFQUFFO1lBQ3hELEdBQUcsRUFBRTtnQkFDSCxHQUFHLE9BQU8sQ0FBQyxHQUFHO2dCQUNkLHFCQUFxQixFQUFFLE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDO2dCQUMzQyxpQ0FBaUMsRUFBRSxJQUFJLENBQUMsVUFBVTthQUNuRDtZQUNELEtBQUssRUFBRSxDQUFDLFFBQVEsRUFBRSxRQUFRLEVBQUUsUUFBUSxDQUFDO1NBQ3RDLENBQUMsQ0FBQTtRQUVGLEtBQUssQ0FBQyxFQUFFLENBQUMsT0FBTyxFQUFFLEdBQUcsRUFBRTtZQUNyQix3RUFBd0U7UUFDMUUsQ0FBQyxDQUFDLENBQUE7UUFDRixLQUFLLENBQUMsS0FBSyxFQUFFLENBQUE7UUFDYixJQUFJLENBQUMsWUFBWSxHQUFHLEtBQUssQ0FBQTtJQUMzQixDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILFNBQVMsQ0FBQyxJQUFJO1FBQ1osTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQTtRQUUxQixJQUFJLENBQUMsTUFBTSxJQUFJLElBQUksQ0FBQyxJQUFJO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQywwQ0FBMEMsQ0FBQyxDQUFBO1FBRXJGLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLEVBQUMsR0FBRyxJQUFJLEVBQUUsWUFBWSxFQUFFLElBQUksQ0FBQyxZQUFZLEVBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQTtJQUNqRixDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxpQkFBaUIsQ0FBQyxLQUFLO1FBQ3JCLElBQUksQ0FBQyxZQUFZLElBQUksS0FBSyxDQUFBO1FBRTFCLElBQUksWUFBWSxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFBO1FBRWxELE9BQU8sWUFBWSxJQUFJLENBQUMsRUFBRSxDQUFDO1lBQ3pCLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxZQUFZLENBQUMsQ0FBQTtZQUVyRCxJQUFJLENBQUMsWUFBWSxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxDQUFDLFlBQVksR0FBRyxDQUFDLENBQUMsQ0FBQTtZQUU3RCxJQUFJLElBQUksQ0FBQyxJQUFJLEVBQUUsRUFBRSxDQUFDO2dCQUNoQixJQUFJLENBQUM7b0JBQ0gsTUFBTSxNQUFNLEdBQUcsc0NBQXNDLENBQUMsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUE7b0JBRXhFLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQyxNQUFNLENBQUMsQ0FBQTtnQkFDMUIsQ0FBQztnQkFBQyxNQUFNLENBQUM7b0JBQ1AsOERBQThEO29CQUM5RCwwREFBMEQ7Z0JBQzVELENBQUM7WUFDSCxDQUFDO1lBRUQsWUFBWSxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFBO1FBQ2hELENBQUM7SUFDSCxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILG9CQUFvQixDQUFDLEtBQUs7UUFDeEIsSUFBSSxJQUFJLENBQUMsSUFBSSxJQUFJLElBQUksQ0FBQyxNQUFNO1lBQUUsT0FBTTtRQUVwQyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQTtRQUNoQixJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQTtRQUVsQixJQUFJLENBQUMsU0FBUyxFQUFFLENBQUMsRUFBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsa0JBQWtCLEVBQUUsZUFBZSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFDLENBQUMsQ0FBQTtJQUMvRyxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNILGtCQUFrQixDQUFDLEtBQUs7UUFDdEIsTUFBTSxJQUFJLEdBQUcsOEJBQThCLENBQUMsQ0FBQyxLQUFLLElBQUksRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFBO1FBRTlELE9BQU8sSUFBSSxLQUFLLFFBQVEsSUFBSSxJQUFJLEtBQUssY0FBYyxDQUFBO0lBQ3JELENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgbmV0IGZyb20gXCJub2RlOm5ldFwiXG5pbXBvcnQge3NwYXdufSBmcm9tIFwibm9kZTpjaGlsZF9wcm9jZXNzXCJcbmltcG9ydCB7ZmlsZVVSTFRvUGF0aH0gZnJvbSBcIm5vZGU6dXJsXCJcblxuLyoqXG4gKiBVbml4LWRvbWFpbi1zb2NrZXQgdHJhbnNwb3J0IGNsaWVudCBmb3IgdGhlIGBsb2NhbGAgbG9jay1zZXJ2ZXIgbW9kZVxuICogKFNUQy03MTUpLiBJdCBjb25uZWN0cyB0byB0aGUgbG9jYWwgZW5naW5lIHNlcnZlclxuICogKGBzcmMvZW52aXJvbm1lbnQtaGFuZGxlcnMvbm9kZS9hZHZpc29yeS1sb2NrLWxvY2stc2VydmVyLWxvY2FsLXNlcnZlci5qc2ApXG4gKiBvdmVyIGEgVW5peCBzb2NrZXQg4oCUIG5vIGxpc3RlbmluZyBuZXR3b3JrIHBvcnQsIG5vIGB3c2Ag4oCUIGFuZCBzcGF3bnMgdGhhdFxuICogc2VydmVyIGFzIGEgY2hpbGQgb2YgdGhpcyBlbnZpcm9ubWVudCB3aGVuIG5vIGxvY2FsIGVuZ2luZSBpcyBydW5uaW5nIHlldC5cbiAqXG4gKiBPbmUgbG9jYWwgZW5naW5lIHNlcnZlcyBldmVyeSBwcm9jZXNzIG9uIHRoZSBob3N0IHRoYXQgcG9pbnRzIGF0IHRoZSBzYW1lXG4gKiBzb2NrZXQgcGF0aCwgd2hpY2ggaXMgd2hhdCBtYWtlcyBgbG9jYWxgIG1vZGUgdGhlIG11bHRpLXByb2Nlc3Mgc2luZ2xlLWhvc3RcbiAqIGFuc3dlciAoZW1iZWRkZWQgbW9kZSBvbmx5IGNvb3JkaW5hdGVzIGluc2lkZSBvbmUgSlMgcmVhbG0pLlxuICpcbiAqIENyYXNoIGRldGVjdGlvbiBhbmQgYm91bmRlZCByZXN0YXJ0OiB3aGVuIHRoZSBzb2NrZXQgZGllcywgdGhlIHRyYW5zcG9ydFxuICogcmVwb3J0cyBgdHJhbnNwb3J0Q2xvc2VkYCB0byB0aGUgYmFja2VuZCBhZGFwdGVyLCB3aGljaCBmYWlscyBwZW5kaW5nXG4gKiByZXF1ZXN0cyBhbmQgc3RhcnRzIGl0cyBgcmVwcm9iZUNvb2xkb3duTXNgIHVuYXZhaWxhYmlsaXR5IGNhY2hlLiBUaGUgbmV4dFxuICogYWNxdWlzaXRpb24gYWZ0ZXIgdGhlIGNvb2xkb3duIHJlY29ubmVjdHMg4oCUIHJlc3Bhd25pbmcgdGhlIGVuZ2luZSBjaGlsZCB3aGVuXG4gKiB0aGUgc29ja2V0IGZpbGUgaXMgZ29uZS4gVGhlIGNvb2xkb3duIElTIHRoZSByZXN0YXJ0IGJhY2tvZmY7IHRoZXJlIGlzIG5vXG4gKiBzZXBhcmF0ZSByZXNwYXduIGxvb3AuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIEFkdmlzb3J5TG9ja0xvY2tTZXJ2ZXJMb2NhbENsaWVudCB7XG4gIC8qKlxuICAgKiBDcmVhdGVzIHRoZSBsb2NhbCB0cmFuc3BvcnQgY2xpZW50LiBObyBzb2NrZXQgb3IgcHJvY2VzcyBpcyB0b3VjaGVkIHVudGlsXG4gICAqIGBjb25uZWN0KClgIOKAlCBjb25zdHJ1Y3RpbmcgdGhpcyBvYmplY3QgcGVyZm9ybXMgbm8gSS9PLlxuICAgKiBAcGFyYW0ge29iamVjdH0gYXJncyAtIENsaWVudCBvcHRpb25zLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gW2FyZ3MuYXV0aFRva2VuXSAtIFNoYXJlZCBzZWNyZXQgZm9yd2FyZGVkIGluIHRoZSBoZWxsbyBwYXJhbXMuXG4gICAqIEBwYXJhbSB7bnVtYmVyfSBbYXJncy5jb25uZWN0VGltZW91dE1zXSAtIEJvdW5kZWQgd2FpdCBmb3IgdGhlIHNvY2tldC9lbmdpbmUgY2hpbGQgdG8gYmVjb21lIHJlYWR5LlxuICAgKiBAcGFyYW0ge251bWJlcn0gW2FyZ3MubGVhc2VNc10gLSBMZWFzZSBkdXJhdGlvbiB0aGUgZW5naW5lIGNoaWxkIHNob3VsZCB1c2UuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBhcmdzLnNvY2tldFBhdGggLSBVbml4IHNvY2tldCBwYXRoIG9mIHRoZSBsb2NhbCBlbmdpbmUuXG4gICAqL1xuICBjb25zdHJ1Y3Rvcih7YXV0aFRva2VuID0gXCJcIiwgY29ubmVjdFRpbWVvdXRNcyA9IDMwMDAsIGxlYXNlTXMgPSAzMF8wMDAsIHNvY2tldFBhdGh9KSB7XG4gICAgdGhpcy5hdXRoVG9rZW4gPSBhdXRoVG9rZW5cbiAgICB0aGlzLmNvbm5lY3RUaW1lb3V0TXMgPSBjb25uZWN0VGltZW91dE1zXG4gICAgdGhpcy5sZWFzZU1zID0gbGVhc2VNc1xuICAgIHRoaXMuc29ja2V0UGF0aCA9IHNvY2tldFBhdGhcbiAgICB0aGlzLmNvbm5lY3Rpb25JZCA9IGBjbGllbnQtJHtwcm9jZXNzLnBpZH0tJHtNYXRoLnJhbmRvbSgpLnRvU3RyaW5nKDM2KS5zbGljZSgyLCAxMCl9YFxuICAgIC8qKiBAdHlwZSB7bmV0LlNvY2tldCB8IG51bGx9ICovXG4gICAgdGhpcy5zb2NrZXQgPSBudWxsXG4gICAgLyoqIEB0eXBlIHsoKGJvZHk6IFJlY29yZDxzdHJpbmcsIHVua25vd24+KSA9PiB2b2lkKSB8IG51bGx9ICovXG4gICAgdGhpcy5vbk1lc3NhZ2UgPSBudWxsXG4gICAgLyoqIEB0eXBlIHtpbXBvcnQoXCJub2RlOmNoaWxkX3Byb2Nlc3NcIikuQ2hpbGRQcm9jZXNzIHwgbnVsbH0gKi9cbiAgICB0aGlzLnNwYXduZWRDaGlsZCA9IG51bGxcbiAgICB0aGlzLmNsb3NlZCA9IGZhbHNlXG4gICAgdGhpcy5kZWFkID0gZmFsc2VcbiAgICB0aGlzLnN0ZG91dEJ1ZmZlciA9IFwiXCJcbiAgfVxuXG4gIC8qKlxuICAgKiBDb25uZWN0cyB0byB0aGUgbG9jYWwgZW5naW5lLCBzcGF3bmluZyB0aGUgZW5naW5lIGNoaWxkIHdoZW4gdGhlIHNvY2tldCBpc1xuICAgKiBub3QgdGhlcmUgeWV0LlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyBvbmNlIHRoZSBzb2NrZXQgaXMgY29ubmVjdGVkLlxuICAgKi9cbiAgYXN5bmMgY29ubmVjdCgpIHtcbiAgICBpZiAodGhpcy5zb2NrZXQpIHJldHVyblxuXG4gICAgdHJ5IHtcbiAgICAgIGF3YWl0IHRoaXMub3BlblNvY2tldCgpXG5cbiAgICAgIHJldHVyblxuICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICBpZiAoIXRoaXMuc29ja2V0TWlzc2luZ0Vycm9yKGVycm9yKSkgdGhyb3cgZXJyb3JcblxuICAgICAgLy8gTm8gZW5naW5lIGlzIGxpc3RlbmluZyAobWlzc2luZyBzb2NrZXQsIG9yIGEgc3RhbGUgc29ja2V0IGZpbGUgbGVmdCBieVxuICAgICAgLy8gYSBjcmFzaGVkIGVuZ2luZSk6IHNwYXduIHRoZSBlbmdpbmUgY2hpbGQgYW5kIHBvbGwgdW50aWwgaXQgaXMgbGl2ZS5cbiAgICAgIHRoaXMuc3Bhd25FbmdpbmVDaGlsZCgpXG5cbiAgICAgIGNvbnN0IGRlYWRsaW5lID0gRGF0ZS5ub3coKSArIHRoaXMuY29ubmVjdFRpbWVvdXRNc1xuXG4gICAgICB3aGlsZSAodHJ1ZSkge1xuICAgICAgICB0cnkge1xuICAgICAgICAgIGF3YWl0IHRoaXMub3BlblNvY2tldCgpXG5cbiAgICAgICAgICByZXR1cm5cbiAgICAgICAgfSBjYXRjaCAocmV0cnlFcnJvcikge1xuICAgICAgICAgIGlmICghdGhpcy5zb2NrZXRNaXNzaW5nRXJyb3IocmV0cnlFcnJvcikpIHRocm93IHJldHJ5RXJyb3JcblxuICAgICAgICAgIGlmIChEYXRlLm5vdygpID49IGRlYWRsaW5lKSB0aHJvdyBuZXcgRXJyb3IoYExvY2FsIGxvY2sgc2VydmVyIGRpZCBub3Qgc3RhcnQgYXQgJHt0aGlzLnNvY2tldFBhdGh9YCwge2NhdXNlOiByZXRyeUVycm9yfSlcblxuICAgICAgICAgIGF3YWl0IG5ldyBQcm9taXNlKChyZXNvbHZlKSA9PiBzZXRUaW1lb3V0KHJlc29sdmUsIDI1KSlcbiAgICAgICAgfVxuICAgICAgfVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBPcGVucyB0aGUgMToxIHZpZXcgb2YgdGhlIHNvY2tldCBjb25uZWN0aW9uIChvbmUgY29ubmVjdGlvbiBwZXJcbiAgICogdHJhbnNwb3J0LCBsaWtlIHRoZSB3ZWJzb2NrZXQgYWRhcHRlcikuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBfdHlwZSAtIENvbm5lY3Rpb24gcm9sZSAoYGxvY2tgKS5cbiAgICogQHBhcmFtIHt7b25NZXNzYWdlOiAoYm9keTogUmVjb3JkPHN0cmluZywgdW5rbm93bj4pID0+IHZvaWQsIHBhcmFtczogUmVjb3JkPHN0cmluZywgdW5rbm93bj59fSBhcmdzIC0gQ29ubmVjdGlvbiBvcHRpb25zLlxuICAgKiBAcmV0dXJucyB7e3JlYWR5OiBQcm9taXNlPHZvaWQ+LCBzZW5kTWVzc2FnZTogKGJvZHk6IFJlY29yZDxzdHJpbmcsIHVua25vd24+KSA9PiB2b2lkLCBjbG9zZTogKCkgPT4gdm9pZH19IC0gQ29ubmVjdGlvbiBoYW5kbGUuXG4gICAqL1xuICBvcGVuQ29ubmVjdGlvbihfdHlwZSwgYXJncykge1xuICAgIHRoaXMub25NZXNzYWdlID0gYXJncy5vbk1lc3NhZ2VcblxuICAgIC8vIFRoZSBjb25uZWN0aW9uLW9wZW4gZnJhbWUgY2FycmllcyBhdXRoIGFuZCBwcm90b2NvbCB2ZXJzaW9uOyB0aGUgZW5naW5lXG4gICAgLy8gYW5zd2VycyBpdCB3aXRoIGEgaGVsbG8tYWNrLCBleGFjdGx5IGxpa2UgdGhlIGV4dGVybmFsIGRhZW1vbiBkb2VzIG92ZXJcbiAgICAvLyB0aGUgd2Vic29ja2V0IHRyYW5zcG9ydC5cbiAgICB0aGlzLndyaXRlTGluZSh7Y29ubmVjdGlvbklkOiB0aGlzLmNvbm5lY3Rpb25JZCwgcGFyYW1zOiBhcmdzLnBhcmFtcywgdHlwZTogXCJoZWxsb1wifSlcblxuICAgIHJldHVybiB7XG4gICAgICBjbG9zZTogKCkgPT4gdGhpcy5jbG9zZSgpLFxuICAgICAgcmVhZHk6IFByb21pc2UucmVzb2x2ZSgpLFxuICAgICAgc2VuZE1lc3NhZ2U6ICgvKiogQHR5cGUge1JlY29yZDxzdHJpbmcsIHVua25vd24+fSAqLyBib2R5KSA9PiB0aGlzLndyaXRlTGluZShib2R5KVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBDbG9zZXMgdGhlIHNvY2tldCBhbmQgc3RvcHMgYW4gZW5naW5lIGNoaWxkIHRoaXMgY2xpZW50IHNwYXduZWQuIEEgY2hpbGRcbiAgICogaXQgZGlkIG5vdCBzcGF3biBrZWVwcyBzZXJ2aW5nIHRoZSBvdGhlciBwcm9jZXNzZXMgb24gdGhlIGhvc3QgYW5kIGlkbGVzXG4gICAqIG91dCBvbiBpdHMgb3duIG9uY2UgaXRzIGxhc3QgY29ubmVjdGlvbiBjbG9zZXMuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgY2xvc2UoKSB7XG4gICAgdGhpcy5jbG9zZWQgPSB0cnVlXG5cbiAgICBjb25zdCBzb2NrZXQgPSB0aGlzLnNvY2tldFxuXG4gICAgdGhpcy5zb2NrZXQgPSBudWxsXG4gICAgc29ja2V0Py5lbmQoKVxuICAgIHNvY2tldD8uZGVzdHJveSgpXG5cbiAgICBjb25zdCBjaGlsZCA9IHRoaXMuc3Bhd25lZENoaWxkXG5cbiAgICB0aGlzLnNwYXduZWRDaGlsZCA9IG51bGxcbiAgICBjaGlsZD8ua2lsbChcIlNJR1RFUk1cIilcbiAgfVxuXG4gIC8qKlxuICAgKiBPcGVucyB0aGUgVW5peCBzb2NrZXQgYW5kIHdpcmVzIHRoZSBsaW5lIHByb3RvY29sLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTx2b2lkPn0gLSBSZXNvbHZlcyB3aGVuIGNvbm5lY3RlZC5cbiAgICovXG4gIG9wZW5Tb2NrZXQoKSB7XG4gICAgcmV0dXJuIG5ldyBQcm9taXNlKChyZXNvbHZlLCByZWplY3QpID0+IHtcbiAgICAgIGNvbnN0IHNvY2tldCA9IG5ldC5jb25uZWN0KHRoaXMuc29ja2V0UGF0aClcblxuICAgICAgY29uc3QgdGltZXIgPSBzZXRUaW1lb3V0KCgpID0+IHtcbiAgICAgICAgc29ja2V0LmRlc3Ryb3koKVxuICAgICAgICByZWplY3QobmV3IEVycm9yKGBUaW1lZCBvdXQgY29ubmVjdGluZyB0byB0aGUgbG9jYWwgbG9jayBzZXJ2ZXIgYXQgJHt0aGlzLnNvY2tldFBhdGh9YCkpXG4gICAgICB9LCB0aGlzLmNvbm5lY3RUaW1lb3V0TXMpXG5cbiAgICAgIHRpbWVyLnVucmVmPy4oKVxuXG4gICAgICBzb2NrZXQub25jZShcImNvbm5lY3RcIiwgKCkgPT4ge1xuICAgICAgICBjbGVhclRpbWVvdXQodGltZXIpXG4gICAgICAgIHRoaXMuc29ja2V0ID0gc29ja2V0XG4gICAgICAgIHRoaXMuZGVhZCA9IGZhbHNlXG4gICAgICAgIHJlc29sdmUoKVxuICAgICAgfSlcblxuICAgICAgc29ja2V0Lm9uY2UoXCJlcnJvclwiLCAoLyoqIEB0eXBlIHtFcnJvcn0gKi8gZXJyb3IpID0+IHtcbiAgICAgICAgY2xlYXJUaW1lb3V0KHRpbWVyKVxuXG4gICAgICAgIGlmICh0aGlzLnNvY2tldCA9PT0gc29ja2V0KSB0aGlzLnNvY2tldCA9IG51bGxcblxuICAgICAgICByZWplY3QoZXJyb3IpXG4gICAgICB9KVxuXG4gICAgICBzb2NrZXQuc2V0RW5jb2RpbmcoXCJ1dGY4XCIpXG4gICAgICBzb2NrZXQub24oXCJkYXRhXCIsICgvKiogQHR5cGUge3N0cmluZ30gKi8gY2h1bmspID0+IHRoaXMuaGFuZGxlU29ja2V0Q2h1bmsoY2h1bmspKVxuICAgICAgc29ja2V0Lm9uKFwiY2xvc2VcIiwgKCkgPT4gdGhpcy5oYW5kbGVUcmFuc3BvcnREZWF0aChuZXcgRXJyb3IoXCJMb2NhbCBsb2NrIHNlcnZlciBzb2NrZXQgY2xvc2VkXCIpKSlcbiAgICB9KVxuICB9XG5cbiAgLyoqXG4gICAqIFNwYXducyB0aGUgbG9jYWwgZW5naW5lIHNlcnZlciBhcyBhIGNoaWxkIG9mIHRoaXMgZW52aXJvbm1lbnQuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgc3Bhd25FbmdpbmVDaGlsZCgpIHtcbiAgICBpZiAodGhpcy5zcGF3bmVkQ2hpbGQpIHJldHVyblxuXG4gICAgY29uc3Qgc2VydmVyTW9kdWxlUGF0aCA9IGZpbGVVUkxUb1BhdGgobmV3IFVSTChcIi4uL2Vudmlyb25tZW50LWhhbmRsZXJzL25vZGUvYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1sb2NhbC1zZXJ2ZXIuanNcIiwgaW1wb3J0Lm1ldGEudXJsKSlcbiAgICBjb25zdCBjaGlsZCA9IHNwYXduKHByb2Nlc3MuZXhlY1BhdGgsIFtzZXJ2ZXJNb2R1bGVQYXRoXSwge1xuICAgICAgZW52OiB7XG4gICAgICAgIC4uLnByb2Nlc3MuZW52LFxuICAgICAgICBDT05TRU5TX0xPQ0tfTEVBU0VfTVM6IFN0cmluZyh0aGlzLmxlYXNlTXMpLFxuICAgICAgICBWRUxPQ0lPVVNfTE9DS19TRVJWRVJfU09DS0VUX1BBVEg6IHRoaXMuc29ja2V0UGF0aFxuICAgICAgfSxcbiAgICAgIHN0ZGlvOiBbXCJpZ25vcmVcIiwgXCJpZ25vcmVcIiwgXCJpZ25vcmVcIl1cbiAgICB9KVxuXG4gICAgY2hpbGQub24oXCJlcnJvclwiLCAoKSA9PiB7XG4gICAgICAvLyBBIGZhaWxlZCBzcGF3biBzdXJmYWNlcyBhcyBhIGNvbm5lY3QgZmFpbHVyZSBvbiB0aGUgbmV4dCBzb2NrZXQgd2FpdC5cbiAgICB9KVxuICAgIGNoaWxkLnVucmVmKClcbiAgICB0aGlzLnNwYXduZWRDaGlsZCA9IGNoaWxkXG4gIH1cblxuICAvKipcbiAgICogV3JpdGVzIG9uZSBwcm90b2NvbCBtZXNzYWdlIGFzIGEgSlNPTiBsaW5lIHRvIHRoZSBzb2NrZXQuXG4gICAqIEBwYXJhbSB7UmVjb3JkPHN0cmluZywgdW5rbm93bj59IGJvZHkgLSBNZXNzYWdlIHRvIHNlbmQuXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgd3JpdGVMaW5lKGJvZHkpIHtcbiAgICBjb25zdCBzb2NrZXQgPSB0aGlzLnNvY2tldFxuXG4gICAgaWYgKCFzb2NrZXQgfHwgdGhpcy5kZWFkKSB0aHJvdyBuZXcgRXJyb3IoXCJMb2NhbCBsb2NrIHNlcnZlciBjb25uZWN0aW9uIGlzIG5vdCBvcGVuXCIpXG5cbiAgICBzb2NrZXQud3JpdGUoYCR7SlNPTi5zdHJpbmdpZnkoey4uLmJvZHksIGNvbm5lY3Rpb25JZDogdGhpcy5jb25uZWN0aW9uSWR9KX1cXG5gKVxuICB9XG5cbiAgLyoqXG4gICAqIEJ1ZmZlcnMgc29ja2V0IGRhdGEgYW5kIGRpc3BhdGNoZXMgY29tcGxldGUgSlNPTiBsaW5lcyB0byB0aGUgbWVzc2FnZVxuICAgKiBoYW5kbGVyLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gY2h1bmsgLSBSYXcgc29ja2V0IGNodW5rLlxuICAgKiBAcmV0dXJucyB7dm9pZH1cbiAgICovXG4gIGhhbmRsZVNvY2tldENodW5rKGNodW5rKSB7XG4gICAgdGhpcy5zdGRvdXRCdWZmZXIgKz0gY2h1bmtcblxuICAgIGxldCBuZXdsaW5lSW5kZXggPSB0aGlzLnN0ZG91dEJ1ZmZlci5pbmRleE9mKFwiXFxuXCIpXG5cbiAgICB3aGlsZSAobmV3bGluZUluZGV4ID49IDApIHtcbiAgICAgIGNvbnN0IGxpbmUgPSB0aGlzLnN0ZG91dEJ1ZmZlci5zbGljZSgwLCBuZXdsaW5lSW5kZXgpXG5cbiAgICAgIHRoaXMuc3Rkb3V0QnVmZmVyID0gdGhpcy5zdGRvdXRCdWZmZXIuc2xpY2UobmV3bGluZUluZGV4ICsgMSlcblxuICAgICAgaWYgKGxpbmUudHJpbSgpKSB7XG4gICAgICAgIHRyeSB7XG4gICAgICAgICAgY29uc3QgcGFyc2VkID0gLyoqIEB0eXBlIHtSZWNvcmQ8c3RyaW5nLCB1bmtub3duPn0gKi8gKEpTT04ucGFyc2UobGluZSkpXG5cbiAgICAgICAgICB0aGlzLm9uTWVzc2FnZT8uKHBhcnNlZClcbiAgICAgICAgfSBjYXRjaCB7XG4gICAgICAgICAgLy8gQSBtYWxmb3JtZWQgZW5naW5lIGxpbmUgaXMgbm90IGEgbG9jayBhbnN3ZXI6IHRoZSBhZGFwdGVyJ3NcbiAgICAgICAgICAvLyByZXF1ZXN0IHRpbWVvdXQgc3VyZmFjZXMgaXQgbG91ZGx5IGluc3RlYWQgb2YgZ3Vlc3NpbmcuXG4gICAgICAgIH1cbiAgICAgIH1cblxuICAgICAgbmV3bGluZUluZGV4ID0gdGhpcy5zdGRvdXRCdWZmZXIuaW5kZXhPZihcIlxcblwiKVxuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBSZXBvcnRzIHRyYW5zcG9ydCBkZWF0aCB0byB0aGUgYWRhcHRlciAoY3Jhc2ggZGV0ZWN0aW9uKS5cbiAgICogQHBhcmFtIHtFcnJvcn0gZXJyb3IgLSBEZWF0aCByZWFzb24uXG4gICAqIEByZXR1cm5zIHt2b2lkfVxuICAgKi9cbiAgaGFuZGxlVHJhbnNwb3J0RGVhdGgoZXJyb3IpIHtcbiAgICBpZiAodGhpcy5kZWFkIHx8IHRoaXMuY2xvc2VkKSByZXR1cm5cblxuICAgIHRoaXMuZGVhZCA9IHRydWVcbiAgICB0aGlzLnNvY2tldCA9IG51bGxcblxuICAgIHRoaXMub25NZXNzYWdlPy4oe2Vycm9yOiBlcnJvci5tZXNzYWdlLCBzdGF0dXM6IFwidHJhbnNwb3J0LWNsb3NlZFwiLCB0cmFuc3BvcnRDbG9zZWQ6IHRydWUsIHR5cGU6IFwicmVzcG9uc2VcIn0pXG4gIH1cblxuICAvKipcbiAgICogV2hldGhlciBhIGNvbm5lY3QgZmFpbHVyZSBtZWFucyBcIm5vIGVuZ2luZSBpcyBsaXN0ZW5pbmcgeWV0XCIgKHNwYXduIGl0KS5cbiAgICogQHBhcmFtIHt1bmtub3dufSBlcnJvciAtIENvbm5lY3QgZXJyb3IuXG4gICAqIEByZXR1cm5zIHtib29sZWFufSAtIFRydWUgZm9yIEVOT0VOVCAvIEVDT05OUkVGVVNFRCBvbiBhIG1pc3Npbmcgc29ja2V0LlxuICAgKi9cbiAgc29ja2V0TWlzc2luZ0Vycm9yKGVycm9yKSB7XG4gICAgY29uc3QgY29kZSA9IC8qKiBAdHlwZSB7e2NvZGU/OiBzdHJpbmd9fSAqLyAoZXJyb3IgfHwge30pLmNvZGVcblxuICAgIHJldHVybiBjb2RlID09PSBcIkVOT0VOVFwiIHx8IGNvZGUgPT09IFwiRUNPTk5SRUZVU0VEXCJcbiAgfVxufVxuIl19
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Default Unix-socket path for the `local` lock-server mode (STC-715). Kept
|
|
3
|
+
* short on purpose: Unix socket paths are limited to ~104 characters, and a
|
|
4
|
+
* long scratch TMPDIR makes `net.connect` fail with `EINVAL`.
|
|
5
|
+
* @param {string} [configuredPath] - Explicit `advisoryLocks.backends.lockServer.socketPath`.
|
|
6
|
+
* @returns {string} - Socket path for the local lock-server engine.
|
|
7
|
+
*/
|
|
8
|
+
export declare function defaultLockServerSocketPath(configuredPath?: string): string;
|
|
9
|
+
//# sourceMappingURL=advisory-lock-lock-server-socket-path.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"advisory-lock-lock-server-socket-path.d.ts","sourceRoot":"","sources":["../../../src/database/advisory-lock-lock-server-socket-path.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,AAHvD,CACA,EADQ,MAG+C,GAF7C,MAAM,CAMlB"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
// @ts-check
|
|
2
|
+
import os from "node:os";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
/**
|
|
5
|
+
* Default Unix-socket path for the `local` lock-server mode (STC-715). Kept
|
|
6
|
+
* short on purpose: Unix socket paths are limited to ~104 characters, and a
|
|
7
|
+
* long scratch TMPDIR makes `net.connect` fail with `EINVAL`.
|
|
8
|
+
* @param {string} [configuredPath] - Explicit `advisoryLocks.backends.lockServer.socketPath`.
|
|
9
|
+
* @returns {string} - Socket path for the local lock-server engine.
|
|
10
|
+
*/
|
|
11
|
+
export function defaultLockServerSocketPath(configuredPath) {
|
|
12
|
+
if (typeof configuredPath === "string" && configuredPath)
|
|
13
|
+
return configuredPath;
|
|
14
|
+
return path.join(os.tmpdir(), "velocious-lock-server.sock");
|
|
15
|
+
}
|
|
16
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1zb2NrZXQtcGF0aC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9kYXRhYmFzZS9hZHZpc29yeS1sb2NrLWxvY2stc2VydmVyLXNvY2tldC1wYXRoLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixPQUFPLEVBQUUsTUFBTSxTQUFTLENBQUE7QUFDeEIsT0FBTyxJQUFJLE1BQU0sV0FBVyxDQUFBO0FBRTVCOzs7Ozs7R0FNRztBQUNILE1BQU0sVUFBVSwyQkFBMkIsQ0FBQyxjQUFjO0lBQ3hELElBQUksT0FBTyxjQUFjLEtBQUssUUFBUSxJQUFJLGNBQWM7UUFBRSxPQUFPLGNBQWMsQ0FBQTtJQUUvRSxPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLE1BQU0sRUFBRSxFQUFFLDRCQUE0QixDQUFDLENBQUE7QUFDN0QsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgb3MgZnJvbSBcIm5vZGU6b3NcIlxuaW1wb3J0IHBhdGggZnJvbSBcIm5vZGU6cGF0aFwiXG5cbi8qKlxuICogRGVmYXVsdCBVbml4LXNvY2tldCBwYXRoIGZvciB0aGUgYGxvY2FsYCBsb2NrLXNlcnZlciBtb2RlIChTVEMtNzE1KS4gS2VwdFxuICogc2hvcnQgb24gcHVycG9zZTogVW5peCBzb2NrZXQgcGF0aHMgYXJlIGxpbWl0ZWQgdG8gfjEwNCBjaGFyYWN0ZXJzLCBhbmQgYVxuICogbG9uZyBzY3JhdGNoIFRNUERJUiBtYWtlcyBgbmV0LmNvbm5lY3RgIGZhaWwgd2l0aCBgRUlOVkFMYC5cbiAqIEBwYXJhbSB7c3RyaW5nfSBbY29uZmlndXJlZFBhdGhdIC0gRXhwbGljaXQgYGFkdmlzb3J5TG9ja3MuYmFja2VuZHMubG9ja1NlcnZlci5zb2NrZXRQYXRoYC5cbiAqIEByZXR1cm5zIHtzdHJpbmd9IC0gU29ja2V0IHBhdGggZm9yIHRoZSBsb2NhbCBsb2NrLXNlcnZlciBlbmdpbmUuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBkZWZhdWx0TG9ja1NlcnZlclNvY2tldFBhdGgoY29uZmlndXJlZFBhdGgpIHtcbiAgaWYgKHR5cGVvZiBjb25maWd1cmVkUGF0aCA9PT0gXCJzdHJpbmdcIiAmJiBjb25maWd1cmVkUGF0aCkgcmV0dXJuIGNvbmZpZ3VyZWRQYXRoXG5cbiAgcmV0dXJuIHBhdGguam9pbihvcy50bXBkaXIoKSwgXCJ2ZWxvY2lvdXMtbG9jay1zZXJ2ZXIuc29ja1wiKVxufVxuIl19
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Default external transport factory for the lock-server backend: the
|
|
3
|
+
* framework websocket client with the Node `ws` implementation bound explicitly
|
|
4
|
+
* (no global mutation).
|
|
5
|
+
*
|
|
6
|
+
* This module is Node-only on purpose (STC-715): the `ws` dependency lives here
|
|
7
|
+
* instead of inside `advisory-lock-lock-server-backend.js`, so the backend
|
|
8
|
+
* module itself is transport-agnostic and browser/Expo bundles can statically
|
|
9
|
+
* import it for the embedded mode without pulling `ws` or Node builtins into
|
|
10
|
+
* the graph.
|
|
11
|
+
* @param {{authToken: string, url: string}} args - Connection args.
|
|
12
|
+
* @returns {import("./advisory-lock-lock-server-backend.js").LockServerClientLike} - Websocket client.
|
|
13
|
+
*/
|
|
14
|
+
export declare function createLockServerWebsocketTransport({ url }: {
|
|
15
|
+
authToken: string;
|
|
16
|
+
url: string;
|
|
17
|
+
}): import("./advisory-lock-lock-server-backend.js").LockServerClientLike;
|
|
18
|
+
//# sourceMappingURL=advisory-lock-lock-server-transport.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"advisory-lock-lock-server-transport.d.ts","sourceRoot":"","sources":["../../../src/database/advisory-lock-lock-server-transport.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAAC,EAAC,GAAG,EAAC,EAH7C;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAGc,GAF3C,OAAO,wCAAwC,EAAE,oBAAoB,CAYjF"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
// @ts-check
|
|
2
|
+
import WebSocket from "ws";
|
|
3
|
+
import VelociousWebsocketClient from "../http-client/websocket-client.js";
|
|
4
|
+
/**
|
|
5
|
+
* Default external transport factory for the lock-server backend: the
|
|
6
|
+
* framework websocket client with the Node `ws` implementation bound explicitly
|
|
7
|
+
* (no global mutation).
|
|
8
|
+
*
|
|
9
|
+
* This module is Node-only on purpose (STC-715): the `ws` dependency lives here
|
|
10
|
+
* instead of inside `advisory-lock-lock-server-backend.js`, so the backend
|
|
11
|
+
* module itself is transport-agnostic and browser/Expo bundles can statically
|
|
12
|
+
* import it for the embedded mode without pulling `ws` or Node builtins into
|
|
13
|
+
* the graph.
|
|
14
|
+
* @param {{authToken: string, url: string}} args - Connection args.
|
|
15
|
+
* @returns {import("./advisory-lock-lock-server-backend.js").LockServerClientLike} - Websocket client.
|
|
16
|
+
*/
|
|
17
|
+
export function createLockServerWebsocketTransport({ url }) {
|
|
18
|
+
// Node's global WebSocket is not guaranteed to exist, so the implementation is
|
|
19
|
+
// bound explicitly instead of mutating `globalThis`.
|
|
20
|
+
const webSocketImplementation = /** @type {typeof globalThis.WebSocket} */ ( /** @type {unknown} */(WebSocket));
|
|
21
|
+
return /** @type {import("./advisory-lock-lock-server-backend.js").LockServerClientLike} */ ( /** @type {unknown} */(new VelociousWebsocketClient({
|
|
22
|
+
heartbeatIntervalMs: 10_000,
|
|
23
|
+
url,
|
|
24
|
+
webSocketImplementation
|
|
25
|
+
})));
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci10cmFuc3BvcnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvZGF0YWJhc2UvYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci10cmFuc3BvcnQuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sU0FBUyxNQUFNLElBQUksQ0FBQTtBQUUxQixPQUFPLHdCQUF3QixNQUFNLG9DQUFvQyxDQUFBO0FBRXpFOzs7Ozs7Ozs7Ozs7R0FZRztBQUNILE1BQU0sVUFBVSxrQ0FBa0MsQ0FBQyxFQUFDLEdBQUcsRUFBQztJQUN0RCwrRUFBK0U7SUFDL0UscURBQXFEO0lBQ3JELE1BQU0sdUJBQXVCLEdBQUcsMENBQTBDLENBQUMsRUFBQyxzQkFBdUIsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFBO0lBRS9HLE9BQU8sb0ZBQW9GLENBQUMsRUFBQyxzQkFBdUIsQ0FBQyxJQUFJLHdCQUF3QixDQUFDO1FBQ2hKLG1CQUFtQixFQUFFLE1BQU07UUFDM0IsR0FBRztRQUNILHVCQUF1QjtLQUN4QixDQUFDLENBQUMsQ0FBQyxDQUFBO0FBQ04sQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQgV2ViU29ja2V0IGZyb20gXCJ3c1wiXG5cbmltcG9ydCBWZWxvY2lvdXNXZWJzb2NrZXRDbGllbnQgZnJvbSBcIi4uL2h0dHAtY2xpZW50L3dlYnNvY2tldC1jbGllbnQuanNcIlxuXG4vKipcbiAqIERlZmF1bHQgZXh0ZXJuYWwgdHJhbnNwb3J0IGZhY3RvcnkgZm9yIHRoZSBsb2NrLXNlcnZlciBiYWNrZW5kOiB0aGVcbiAqIGZyYW1ld29yayB3ZWJzb2NrZXQgY2xpZW50IHdpdGggdGhlIE5vZGUgYHdzYCBpbXBsZW1lbnRhdGlvbiBib3VuZCBleHBsaWNpdGx5XG4gKiAobm8gZ2xvYmFsIG11dGF0aW9uKS5cbiAqXG4gKiBUaGlzIG1vZHVsZSBpcyBOb2RlLW9ubHkgb24gcHVycG9zZSAoU1RDLTcxNSk6IHRoZSBgd3NgIGRlcGVuZGVuY3kgbGl2ZXMgaGVyZVxuICogaW5zdGVhZCBvZiBpbnNpZGUgYGFkdmlzb3J5LWxvY2stbG9jay1zZXJ2ZXItYmFja2VuZC5qc2AsIHNvIHRoZSBiYWNrZW5kXG4gKiBtb2R1bGUgaXRzZWxmIGlzIHRyYW5zcG9ydC1hZ25vc3RpYyBhbmQgYnJvd3Nlci9FeHBvIGJ1bmRsZXMgY2FuIHN0YXRpY2FsbHlcbiAqIGltcG9ydCBpdCBmb3IgdGhlIGVtYmVkZGVkIG1vZGUgd2l0aG91dCBwdWxsaW5nIGB3c2Agb3IgTm9kZSBidWlsdGlucyBpbnRvXG4gKiB0aGUgZ3JhcGguXG4gKiBAcGFyYW0ge3thdXRoVG9rZW46IHN0cmluZywgdXJsOiBzdHJpbmd9fSBhcmdzIC0gQ29ubmVjdGlvbiBhcmdzLlxuICogQHJldHVybnMge2ltcG9ydChcIi4vYWR2aXNvcnktbG9jay1sb2NrLXNlcnZlci1iYWNrZW5kLmpzXCIpLkxvY2tTZXJ2ZXJDbGllbnRMaWtlfSAtIFdlYnNvY2tldCBjbGllbnQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjcmVhdGVMb2NrU2VydmVyV2Vic29ja2V0VHJhbnNwb3J0KHt1cmx9KSB7XG4gIC8vIE5vZGUncyBnbG9iYWwgV2ViU29ja2V0IGlzIG5vdCBndWFyYW50ZWVkIHRvIGV4aXN0LCBzbyB0aGUgaW1wbGVtZW50YXRpb24gaXNcbiAgLy8gYm91bmQgZXhwbGljaXRseSBpbnN0ZWFkIG9mIG11dGF0aW5nIGBnbG9iYWxUaGlzYC5cbiAgY29uc3Qgd2ViU29ja2V0SW1wbGVtZW50YXRpb24gPSAvKiogQHR5cGUge3R5cGVvZiBnbG9iYWxUaGlzLldlYlNvY2tldH0gKi8gKC8qKiBAdHlwZSB7dW5rbm93bn0gKi8gKFdlYlNvY2tldCkpXG5cbiAgcmV0dXJuIC8qKiBAdHlwZSB7aW1wb3J0KFwiLi9hZHZpc29yeS1sb2NrLWxvY2stc2VydmVyLWJhY2tlbmQuanNcIikuTG9ja1NlcnZlckNsaWVudExpa2V9ICovICgvKiogQHR5cGUge3Vua25vd259ICovIChuZXcgVmVsb2Npb3VzV2Vic29ja2V0Q2xpZW50KHtcbiAgICBoZWFydGJlYXRJbnRlcnZhbE1zOiAxMF8wMDAsXG4gICAgdXJsLFxuICAgIHdlYlNvY2tldEltcGxlbWVudGF0aW9uXG4gIH0pKSlcbn1cbiJdfQ==
|
|
@@ -50,8 +50,20 @@ export type CreateAuditArgs = {
|
|
|
50
50
|
*/
|
|
51
51
|
params?: Record<string, ReturnType<typeof JSON.parse>> | null;
|
|
52
52
|
};
|
|
53
|
+
export type AuditedOptions = {
|
|
54
|
+
/**
|
|
55
|
+
* - When set, only these attribute names are written to the audit trail.
|
|
56
|
+
*/
|
|
57
|
+
only?: string[];
|
|
58
|
+
/**
|
|
59
|
+
* - Attribute names that must never be written to the audit trail.
|
|
60
|
+
*/
|
|
61
|
+
except?: string[];
|
|
62
|
+
};
|
|
53
63
|
export type AuditedModelClass = typeof import("./index.js").default & {
|
|
54
64
|
_auditCallbacks?: Record<string, AuditCallback[]>;
|
|
65
|
+
_auditIncludedAttributes?: Set<string> | null;
|
|
66
|
+
_auditExcludedAttributes?: Set<string>;
|
|
55
67
|
_auditLifecycleCallbacksRegistered?: boolean;
|
|
56
68
|
_auditTableResolved?: boolean;
|
|
57
69
|
_auditTableData?: AuditTableData;
|
|
@@ -81,12 +93,10 @@ declare const AuditEvents: AuditEventsType;
|
|
|
81
93
|
* Table detection and relationship registration happen lazily on first usage.
|
|
82
94
|
* Called synchronously from Model.audited() at module-load time.
|
|
83
95
|
* @param {AuditedModelClass} modelClass - Model class to audit.
|
|
84
|
-
* @param {
|
|
96
|
+
* @param {AuditedOptions} [options] - Audit options: `only` lists the only attribute names written to the audit trail; `except` lists attribute names never written to the audit trail (e.g. high-frequency telemetry columns). Invalid option shapes throw at registration time.
|
|
85
97
|
* @returns {void}
|
|
86
98
|
*/
|
|
87
|
-
declare function registerAuditing(modelClass: AuditedModelClass, options?:
|
|
88
|
-
except?: string[];
|
|
89
|
-
}): void;
|
|
99
|
+
declare function registerAuditing(modelClass: AuditedModelClass, options?: AuditedOptions): void;
|
|
90
100
|
/**
|
|
91
101
|
* Initializes audit metadata for audited model classes.
|
|
92
102
|
* @param {typeof import("./index.js").default} modelClass - Model class to initialize.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auditing.d.ts","sourceRoot":"","sources":["../../../../src/database/record/auditing.js"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"auditing.d.ts","sourceRoot":"","sources":["../../../../src/database/record/auditing.js"],"names":[],"mappings":"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"}
|