@omnitron-dev/titan-pm 0.1.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/dist/backoff.d.ts +12 -0
  2. package/dist/backoff.d.ts.map +1 -0
  3. package/dist/backoff.js +44 -0
  4. package/dist/backoff.js.map +1 -0
  5. package/dist/child-contract.d.ts +58 -0
  6. package/dist/child-contract.d.ts.map +1 -0
  7. package/dist/child-contract.js +27 -0
  8. package/dist/child-contract.js.map +1 -0
  9. package/dist/confirm-death.d.ts +18 -0
  10. package/dist/confirm-death.d.ts.map +1 -0
  11. package/dist/confirm-death.js +49 -0
  12. package/dist/confirm-death.js.map +1 -0
  13. package/dist/decorators.d.ts +1 -10
  14. package/dist/decorators.d.ts.map +1 -1
  15. package/dist/decorators.js +43 -99
  16. package/dist/decorators.js.map +1 -1
  17. package/dist/discovery.d.ts +24 -0
  18. package/dist/discovery.d.ts.map +1 -0
  19. package/dist/discovery.js +162 -0
  20. package/dist/discovery.js.map +1 -0
  21. package/dist/fork-worker.js +64 -27
  22. package/dist/fork-worker.js.map +1 -1
  23. package/dist/index.d.ts +6 -1
  24. package/dist/index.d.ts.map +1 -1
  25. package/dist/index.js +5 -0
  26. package/dist/index.js.map +1 -1
  27. package/dist/last-resort-handlers.d.ts +5 -0
  28. package/dist/last-resort-handlers.d.ts.map +1 -0
  29. package/dist/last-resort-handlers.js +40 -0
  30. package/dist/last-resort-handlers.js.map +1 -0
  31. package/dist/lifecycle-queue.d.ts +20 -0
  32. package/dist/lifecycle-queue.d.ts.map +1 -0
  33. package/dist/lifecycle-queue.js +110 -0
  34. package/dist/lifecycle-queue.js.map +1 -0
  35. package/dist/liveness.d.ts +5 -0
  36. package/dist/liveness.d.ts.map +1 -0
  37. package/dist/liveness.js +34 -0
  38. package/dist/liveness.js.map +1 -0
  39. package/dist/netron-client.d.ts +10 -9
  40. package/dist/netron-client.d.ts.map +1 -1
  41. package/dist/netron-client.js +32 -21
  42. package/dist/netron-client.js.map +1 -1
  43. package/dist/parent-death-watchdog.d.ts +13 -0
  44. package/dist/parent-death-watchdog.d.ts.map +1 -0
  45. package/dist/parent-death-watchdog.js +58 -0
  46. package/dist/parent-death-watchdog.js.map +1 -0
  47. package/dist/pm.module.d.ts.map +1 -1
  48. package/dist/pm.module.js.map +1 -1
  49. package/dist/process-health.d.ts +2 -0
  50. package/dist/process-health.d.ts.map +1 -1
  51. package/dist/process-health.js +49 -13
  52. package/dist/process-health.js.map +1 -1
  53. package/dist/process-manager.d.ts +6 -0
  54. package/dist/process-manager.d.ts.map +1 -1
  55. package/dist/process-manager.js +111 -4
  56. package/dist/process-manager.js.map +1 -1
  57. package/dist/process-metrics.d.ts +1 -0
  58. package/dist/process-metrics.d.ts.map +1 -1
  59. package/dist/process-metrics.js +18 -19
  60. package/dist/process-metrics.js.map +1 -1
  61. package/dist/process-pool.d.ts +12 -0
  62. package/dist/process-pool.d.ts.map +1 -1
  63. package/dist/process-pool.js +340 -147
  64. package/dist/process-pool.js.map +1 -1
  65. package/dist/process-registry.d.ts.map +1 -1
  66. package/dist/process-spawner.d.ts +27 -5
  67. package/dist/process-spawner.d.ts.map +1 -1
  68. package/dist/process-spawner.js +397 -70
  69. package/dist/process-spawner.js.map +1 -1
  70. package/dist/process-supervisor.d.ts +7 -0
  71. package/dist/process-supervisor.d.ts.map +1 -1
  72. package/dist/process-supervisor.js +141 -17
  73. package/dist/process-supervisor.js.map +1 -1
  74. package/dist/process-workflow.d.ts.map +1 -1
  75. package/dist/process-workflow.js +11 -4
  76. package/dist/process-workflow.js.map +1 -1
  77. package/dist/service-proxy.d.ts.map +1 -1
  78. package/dist/service-proxy.js +33 -3
  79. package/dist/service-proxy.js.map +1 -1
  80. package/dist/shutdown-windows.d.ts +19 -0
  81. package/dist/shutdown-windows.d.ts.map +1 -0
  82. package/dist/shutdown-windows.js +35 -0
  83. package/dist/shutdown-windows.js.map +1 -0
  84. package/dist/thread-pool.d.ts +7 -0
  85. package/dist/thread-pool.d.ts.map +1 -0
  86. package/dist/thread-pool.js +11 -0
  87. package/dist/thread-pool.js.map +1 -0
  88. package/dist/types.d.ts +91 -37
  89. package/dist/types.d.ts.map +1 -1
  90. package/dist/types.js +35 -39
  91. package/dist/types.js.map +1 -1
  92. package/dist/utils/deque.d.ts.map +1 -1
  93. package/dist/worker-health.d.ts +8 -0
  94. package/dist/worker-health.d.ts.map +1 -0
  95. package/dist/worker-health.js +63 -0
  96. package/dist/worker-health.js.map +1 -0
  97. package/dist/worker-runtime.js +25 -52
  98. package/dist/worker-runtime.js.map +1 -1
  99. package/dist/worker-traffic.d.ts +8 -0
  100. package/dist/worker-traffic.d.ts.map +1 -0
  101. package/dist/worker-traffic.js +56 -0
  102. package/dist/worker-traffic.js.map +1 -0
  103. package/package.json +11 -10
@@ -0,0 +1,162 @@
1
+ import { execSync } from 'node:child_process';
2
+ import { readFileSync } from 'node:fs';
3
+ import { isAlive } from './liveness.js';
4
+ export function discoverManagedProcesses(opts) {
5
+ const pids = opts?.listPids ? opts.listPids() : listAllPids();
6
+ const bulkEnv = opts?.readEnv ? null : readAllEnvsBsd();
7
+ const readEnv = opts?.readEnv ?? (bulkEnv ? (pid) => bulkEnv.get(pid) ?? defaultReadEnv(pid) : defaultReadEnv);
8
+ const out = [];
9
+ for (const row of pids) {
10
+ if (!isAlive(row.pid))
11
+ continue;
12
+ const env = readEnv(row.pid);
13
+ if (!env)
14
+ continue;
15
+ const appName = env['OMNITRON_APP_NAME'];
16
+ if (!appName)
17
+ continue;
18
+ const project = env['OMNITRON_PROJECT'];
19
+ const stack = env['OMNITRON_STACK'];
20
+ const fqn = project && stack ? `${project}/${stack}/${appName}` : appName;
21
+ out.push({
22
+ pid: row.pid,
23
+ ppid: row.ppid,
24
+ appName,
25
+ fullyQualifiedName: fqn,
26
+ managed: env['OMNITRON_MANAGED'] === '1' || env['OMNITRON_MANAGED'] === 'true',
27
+ env,
28
+ elapsedSeconds: row.elapsedSeconds,
29
+ });
30
+ }
31
+ return out;
32
+ }
33
+ function defaultReadEnv(pid) {
34
+ try {
35
+ if (process.platform === 'linux') {
36
+ const raw = readFileSync(`/proc/${pid}/environ`, 'utf-8');
37
+ return parseEnvironZeros(raw);
38
+ }
39
+ }
40
+ catch {
41
+ }
42
+ try {
43
+ const out = execSync(`ps -p ${pid} -E -o command=`, { encoding: 'utf-8', timeout: 1000 });
44
+ return parseEnvironSpace(out);
45
+ }
46
+ catch {
47
+ return null;
48
+ }
49
+ }
50
+ function readAllEnvsBsd() {
51
+ if (process.platform === 'linux' || process.platform === 'win32')
52
+ return null;
53
+ try {
54
+ const raw = execSync('ps -A -E -o pid=,command=', {
55
+ encoding: 'utf-8',
56
+ maxBuffer: 64 * 1024 * 1024,
57
+ timeout: 10_000,
58
+ });
59
+ const envs = new Map();
60
+ for (const line of raw.split('\n')) {
61
+ const trimmed = line.trimStart();
62
+ if (!trimmed)
63
+ continue;
64
+ const space = trimmed.indexOf(' ');
65
+ if (space <= 0)
66
+ continue;
67
+ const pid = Number(trimmed.slice(0, space));
68
+ if (!Number.isInteger(pid))
69
+ continue;
70
+ envs.set(pid, parseEnvironSpace(trimmed.slice(space + 1)));
71
+ }
72
+ return envs;
73
+ }
74
+ catch {
75
+ return null;
76
+ }
77
+ }
78
+ function parseEnvironZeros(raw) {
79
+ const env = {};
80
+ for (const entry of raw.split('\0')) {
81
+ if (!entry)
82
+ continue;
83
+ const eq = entry.indexOf('=');
84
+ if (eq < 0)
85
+ continue;
86
+ env[entry.slice(0, eq)] = entry.slice(eq + 1);
87
+ }
88
+ return env;
89
+ }
90
+ function parseEnvironSpace(raw) {
91
+ const env = {};
92
+ const tokens = raw.trim().split(/\s+/);
93
+ for (let i = tokens.length - 1; i >= 0; i--) {
94
+ const tok = tokens[i];
95
+ if (!tok)
96
+ continue;
97
+ const eq = tok.indexOf('=');
98
+ if (eq <= 0)
99
+ break;
100
+ const key = tok.slice(0, eq);
101
+ if (!/^[A-Z_][A-Z0-9_]*$/.test(key))
102
+ break;
103
+ env[key] = tok.slice(eq + 1);
104
+ }
105
+ return env;
106
+ }
107
+ export function parseEtime(value) {
108
+ const trimmed = value.trim();
109
+ if (trimmed === '')
110
+ return 0;
111
+ let days = 0;
112
+ let rest = trimmed;
113
+ const dash = rest.indexOf('-');
114
+ if (dash > 0) {
115
+ days = Number(rest.slice(0, dash));
116
+ rest = rest.slice(dash + 1);
117
+ if (!Number.isFinite(days))
118
+ return 0;
119
+ }
120
+ const parts = rest.split(':');
121
+ if (parts.length < 2 || parts.length > 3)
122
+ return 0;
123
+ let seconds = 0;
124
+ for (const part of parts) {
125
+ const n = Number(part);
126
+ if (!Number.isFinite(n) || n < 0)
127
+ return 0;
128
+ seconds = seconds * 60 + n;
129
+ }
130
+ return days * 86_400 + seconds;
131
+ }
132
+ export function parsePsRows(raw) {
133
+ const out = [];
134
+ const lines = raw.split('\n');
135
+ for (let i = 1; i < lines.length; i++) {
136
+ const line = lines[i]?.trim();
137
+ if (!line)
138
+ continue;
139
+ const parts = line.split(/\s+/);
140
+ const pid = Number(parts[0]);
141
+ const ppid = Number(parts[1]);
142
+ if (!Number.isFinite(pid) || !Number.isFinite(ppid))
143
+ continue;
144
+ out.push({ pid, ppid, elapsedSeconds: parts[2] === undefined ? 0 : parseEtime(parts[2]) });
145
+ }
146
+ return out;
147
+ }
148
+ function listAllPids() {
149
+ const opts = { encoding: 'utf-8', maxBuffer: 4 * 1024 * 1024 };
150
+ try {
151
+ return parsePsRows(execSync('ps -eo pid,ppid,etime', opts));
152
+ }
153
+ catch {
154
+ }
155
+ try {
156
+ return parsePsRows(execSync('ps -eo pid,ppid', opts));
157
+ }
158
+ catch {
159
+ return [];
160
+ }
161
+ }
162
+ //# sourceMappingURL=discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,6 @@
1
1
  import 'reflect-metadata';
2
+ import { startParentDeathWatchdog } from './parent-death-watchdog.js';
3
+ import { installLastResortErrorHandlers } from './last-resort-handlers.js';
2
4
  const config = JSON.parse(process.env['TITAN_WORKER_CONTEXT'] || process.env['WORKER_DATA'] || '{}');
3
5
  if (!config || !config.processId || !config.processPath) {
4
6
  const entry = JSON.stringify({
@@ -10,11 +12,39 @@ if (!config || !config.processId || !config.processPath) {
10
12
  process.stderr.write(entry + '\n');
11
13
  process.exit(1);
12
14
  }
15
+ let droppedFrames = 0;
16
+ let lastDropLogAt = 0;
17
+ const DROP_LOG_INTERVAL_MS = 30_000;
18
+ function noteDropped(reason, err) {
19
+ droppedFrames++;
20
+ const now = Date.now();
21
+ if (now - lastDropLogAt < DROP_LOG_INTERVAL_MS)
22
+ return;
23
+ lastDropLogAt = now;
24
+ process.stderr.write(JSON.stringify({
25
+ level: 40,
26
+ time: new Date().toISOString(),
27
+ pid: process.pid,
28
+ msg: 'IPC frame dropped',
29
+ reason,
30
+ droppedTotal: droppedFrames,
31
+ ...(err && { err: { message: err.message, type: err.name } }),
32
+ }) + '\n');
33
+ }
13
34
  const parentPort = {
14
35
  postMessage: (message) => {
15
- if (process.send) {
16
- process.send(message);
36
+ if (!process.send)
37
+ return;
38
+ if (!process.connected) {
39
+ noteDropped('parent disconnected');
40
+ return;
17
41
  }
42
+ const accepted = process.send(message, (err) => {
43
+ if (err)
44
+ noteDropped('callback error', err);
45
+ });
46
+ if (!accepted)
47
+ noteDropped('channel full (process.send returned false)');
18
48
  },
19
49
  on: (event, handler) => {
20
50
  if (event === 'message') {
@@ -26,32 +56,39 @@ const workerData = config;
26
56
  global.parentPort = parentPort;
27
57
  global.workerData = workerData;
28
58
  process.on('disconnect', () => {
29
- process.exit(0);
30
- });
31
- process.on('uncaughtException', (error) => {
32
- const entry = JSON.stringify({
33
- level: 60,
34
- time: new Date().toISOString(),
35
- pid: process.pid,
36
- msg: 'Uncaught exception in fork-worker',
37
- err: { message: error.message, stack: error.stack, type: error.name },
38
- });
39
- process.stderr.write(entry + '\n');
40
- process.exit(1);
41
- });
42
- process.on('unhandledRejection', (reason) => {
43
- const entry = JSON.stringify({
44
- level: 60,
45
- time: new Date().toISOString(),
46
- pid: process.pid,
47
- msg: 'Unhandled rejection in fork-worker',
48
- err: reason instanceof Error
49
- ? { message: reason.message, stack: reason.stack, type: reason.name }
50
- : { message: String(reason) },
51
- });
52
- process.stderr.write(entry + '\n');
53
- process.exit(1);
59
+ noteDropped('parent disconnected — terminating worker');
60
+ process.exit(130);
54
61
  });
62
+ startParentDeathWatchdog();
63
+ let heartbeatSeq = 0;
64
+ let beat = 0;
65
+ const HEARTBEAT_INTERVAL_MS = 5_000;
66
+ const heartbeatTimer = setInterval(() => {
67
+ if (!process.connected || !process.send)
68
+ return;
69
+ beat += 1;
70
+ heartbeatSeq += 1;
71
+ const msg = {
72
+ type: 'heartbeat',
73
+ seq: heartbeatSeq,
74
+ beat,
75
+ uptimeSeconds: Math.round(process.uptime()),
76
+ rssBytes: process.memoryUsage().rss,
77
+ };
78
+ try {
79
+ const accepted = process.send(msg, (err) => {
80
+ if (err)
81
+ noteDropped('heartbeat send error', err);
82
+ });
83
+ if (!accepted)
84
+ noteDropped('heartbeat channel full');
85
+ }
86
+ catch (err) {
87
+ noteDropped('heartbeat throw', err);
88
+ }
89
+ }, HEARTBEAT_INTERVAL_MS);
90
+ heartbeatTimer.unref();
91
+ installLastResortErrorHandlers();
55
92
  import('./worker-runtime.js').catch((error) => {
56
93
  const entry = JSON.stringify({
57
94
  level: 60,
@@ -1 +1 @@
1
- {"version":3,"file":"fork-worker.js","sourceRoot":"","sources":["../src/fork-worker.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"fork-worker.js","sourceRoot":"","sources":["../src/fork-worker.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -6,8 +6,13 @@ export { ProcessPool } from './process-pool.js';
6
6
  export { ProcessSupervisor } from './process-supervisor.js';
7
7
  export { ProcessMetricsCollector } from './process-metrics.js';
8
8
  export { ProcessHealthChecker } from './process-health.js';
9
+ export { ProcessLifecycleQueue, LifecyclePreempted, type LifecycleOp } from './lifecycle-queue.js';
10
+ export { computeBackoff, backoffSchedule, sleepBackoff, type BackoffConfig, type BackoffType } from './backoff.js';
11
+ export { getLiveness, isAlive, verifyPidIdentity, type Liveness } from './liveness.js';
12
+ export { discoverManagedProcesses, type DiscoveredProcess } from './discovery.js';
13
+ export { isChildToParent, isParentToChild, HEARTBEAT_INTERVAL_MS, HEARTBEAT_TIMEOUT_MS, type ChildToParentMessage, type ParentToChildMessage, type ChildReadyMessage, type ChildHeartbeatMessage, type ChildSnapshotResponseMessage, type ChildShutdownIntentMessage, type ChildErrorReportMessage, type ParentSnapshotRequestMessage, type ParentDrainMessage, type ParentConfigUpdateMessage, } from './child-contract.js';
9
14
  export { Process, Workflow, Actor, Public, Stage, Compensate, HealthCheck, OnShutdown, Trace, Metric, Validate, Cache, Supervisor, Child, CircuitBreaker, RateLimit, Idempotent, PROCESS_METADATA_KEY, PROCESS_METHOD_METADATA_KEY, SUPERVISOR_METADATA_KEY, WORKFLOW_METADATA_KEY, } from './decorators.js';
10
15
  export { ProcessStatus, PoolStrategy, SupervisionStrategy, RestartDecision } from './types.js';
11
- export type { IProcessOptions, IProcessMetadata, IProcessMethodMetadata, IProcessInfo, ServiceProxy, IServiceProxyControl, IProcessPoolOptions, IProcessPool, ISupervisorOptions, ISupervisorChild, ISupervisorConfig, ISupervisorChildConfig, IProcessEvents, IProcessMetrics, IPoolMetrics, ILatencyMetrics, IHealthStatus, IHealthCheck, IBackoffOptions, IRestartPolicy, IProcessManager, IProcessManagerConfig, IProcessManagerModule, IProcessSpawner, ISpawnOptions, IWorkerHandle, } from './types.js';
16
+ export type { IProcessOptions, IProcessMetadata, IProcessMethodMetadata, IProcessInfo, ServiceProxy, IServiceProxyControl, IProcessPoolOptions, IProcessPool, ISupervisorOptions, ISupervisorChild, ISupervisorConfig, ISupervisorChildConfig, IProcessEvents, IProcessMetrics, IProcessTraffic, IProcessTrafficReporter, IPoolMetrics, ILatencyMetrics, IHealthStatus, IHealthCheck, IBackoffOptions, IRestartPolicy, IProcessManager, IProcessManagerConfig, IProcessManagerModule, IProcessSpawner, ISpawnOptions, IWorkerHandle, } from './types.js';
12
17
  export type { ProcessMethod, AsyncProcessMethod, ServiceMethodMap } from './common-types.js';
13
18
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAM3D,OAAO,EAEL,OAAO,EACP,QAAQ,EACR,KAAK,EAGL,MAAM,EACN,KAAK,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EAGL,UAAU,EACV,KAAK,EAGL,cAAc,EACd,SAAS,EACT,UAAU,EAGV,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM/F,YAAY,EAEV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EAGZ,YAAY,EACZ,oBAAoB,EAGpB,mBAAmB,EACnB,YAAY,EAGZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EAGtB,cAAc,EAGd,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EAGZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EAGrB,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACnH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EACL,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAEL,OAAO,EACP,QAAQ,EACR,KAAK,EAGL,MAAM,EACN,KAAK,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EAGL,UAAU,EACV,KAAK,EAGL,cAAc,EACd,SAAS,EACT,UAAU,EAGV,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAM/F,YAAY,EAEV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EAGZ,YAAY,EACZ,oBAAoB,EAGpB,mBAAmB,EACnB,YAAY,EAGZ,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EAGtB,cAAc,EAGd,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EAGZ,eAAe,EACf,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EAGrB,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
package/dist/index.js CHANGED
@@ -6,6 +6,11 @@ export { ProcessPool } from './process-pool.js';
6
6
  export { ProcessSupervisor } from './process-supervisor.js';
7
7
  export { ProcessMetricsCollector } from './process-metrics.js';
8
8
  export { ProcessHealthChecker } from './process-health.js';
9
+ export { ProcessLifecycleQueue, LifecyclePreempted } from './lifecycle-queue.js';
10
+ export { computeBackoff, backoffSchedule, sleepBackoff } from './backoff.js';
11
+ export { getLiveness, isAlive, verifyPidIdentity } from './liveness.js';
12
+ export { discoverManagedProcesses } from './discovery.js';
13
+ export { isChildToParent, isParentToChild, HEARTBEAT_INTERVAL_MS, HEARTBEAT_TIMEOUT_MS, } from './child-contract.js';
9
14
  export { Process, Workflow, Actor, Public, Stage, Compensate, HealthCheck, OnShutdown, Trace, Metric, Validate, Cache, Supervisor, Child, CircuitBreaker, RateLimit, Idempotent, PROCESS_METADATA_KEY, PROCESS_METHOD_METADATA_KEY, SUPERVISOR_METADATA_KEY, WORKFLOW_METADATA_KEY, } from './decorators.js';
10
15
  export { ProcessStatus, PoolStrategy, SupervisionStrategy, RestartDecision } from './types.js';
11
16
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAM3D,OAAO,EAEL,OAAO,EACP,QAAQ,EACR,KAAK,EAGL,MAAM,EACN,KAAK,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EAGL,UAAU,EACV,KAAK,EAGL,cAAc,EACd,SAAS,EACT,UAAU,EAGV,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAoB,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAwC,MAAM,cAAc,CAAC;AACnH,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAiB,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAA0B,MAAM,gBAAgB,CAAC;AAClF,OAAO,EACL,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GAWrB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAEL,OAAO,EACP,QAAQ,EACR,KAAK,EAGL,MAAM,EACN,KAAK,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EAGL,UAAU,EACV,KAAK,EAGL,cAAc,EACd,SAAS,EACT,UAAU,EAGV,oBAAoB,EACpB,2BAA2B,EAC3B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,5 @@
1
+ export interface LastResortOptions {
2
+ forceExitAfterMs?: number;
3
+ }
4
+ export declare function installLastResortErrorHandlers(options?: LastResortOptions): void;
5
+ //# sourceMappingURL=last-resort-handlers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"last-resort-handlers.d.ts","sourceRoot":"","sources":["../src/last-resort-handlers.ts"],"names":[],"mappings":"AA+DA,MAAM,WAAW,iBAAiB;IAEhC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,iBAAsB,GAAG,IAAI,CA2CpF"}
@@ -0,0 +1,40 @@
1
+ import { isOperationalError } from '@omnitron-dev/titan/utils';
2
+ import { childShutdownWindowMs } from './shutdown-windows.js';
3
+ function describe(err) {
4
+ return err instanceof Error
5
+ ? { message: err.message, stack: err.stack, type: err.name }
6
+ : { message: String(err) };
7
+ }
8
+ function emit(level, msg, err) {
9
+ process.stderr.write(JSON.stringify({ level, time: new Date().toISOString(), pid: process.pid, msg, err: describe(err) }) + '\n');
10
+ }
11
+ export function installLastResortErrorHandlers(options = {}) {
12
+ const forceExitAfterMs = options.forceExitAfterMs ?? childShutdownWindowMs(process.env);
13
+ const fatal = (event, msg, err) => {
14
+ emit(60, msg, err);
15
+ if (process.listenerCount(event) > 1) {
16
+ const timer = setTimeout(() => {
17
+ emit(60, `No shutdown owner finished within ${forceExitAfterMs}ms — exiting`, err);
18
+ process.exit(1);
19
+ }, forceExitAfterMs);
20
+ timer.unref?.();
21
+ return;
22
+ }
23
+ process.exit(1);
24
+ };
25
+ process.on('uncaughtException', (error) => {
26
+ if (isOperationalError(error)) {
27
+ emit(40, 'Uncaught operational exception in fork-worker — letting client recover', error);
28
+ return;
29
+ }
30
+ fatal('uncaughtException', 'Uncaught exception in fork-worker', error);
31
+ });
32
+ process.on('unhandledRejection', (reason) => {
33
+ if (isOperationalError(reason)) {
34
+ emit(40, 'Unhandled operational rejection in fork-worker — letting client recover', reason);
35
+ return;
36
+ }
37
+ fatal('unhandledRejection', 'Unhandled rejection in fork-worker', reason);
38
+ });
39
+ }
40
+ //# sourceMappingURL=last-resort-handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"last-resort-handlers.js","sourceRoot":"","sources":["../src/last-resort-handlers.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAU9D,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,GAAG,YAAY,KAAK;QACzB,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;QAC5D,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,IAAI,CAAC,KAAa,EAAE,GAAW,EAAE,GAAY;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAC5G,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,8BAA8B,CAAC,OAAO,GAAsB,EAAE;IAK5E,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAExF,MAAM,KAAK,GAAG,CAAC,KAAiD,EAAE,GAAW,EAAE,GAAY,EAAQ,EAAE;QACnG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAQnB,IAAI,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,EAAE,EAAE,qCAAqC,gBAAgB,cAAc,EAAE,GAAG,CAAC,CAAC;gBACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACrB,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QACxC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,EAAE,EAAE,wEAAwE,EAAE,KAAK,CAAC,CAAC;YAC1F,OAAO;QACT,CAAC;QACD,KAAK,CAAC,mBAAmB,EAAE,mCAAmC,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC1C,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,EAAE,EAAE,yEAAyE,EAAE,MAAM,CAAC,CAAC;YAC5F,OAAO;QACT,CAAC;QACD,KAAK,CAAC,oBAAoB,EAAE,oCAAoC,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,20 @@
1
+ export type LifecycleOp = 'start' | 'stop' | 'restart' | 'crash-restart';
2
+ export declare class ProcessLifecycleQueue {
3
+ private readonly queues;
4
+ enqueue<T>(key: string, op: LifecycleOp, run: () => Promise<T>, onPreempt?: () => void): Promise<T>;
5
+ cancelPending(key: string, reason: string): void;
6
+ isBusy(key: string): boolean;
7
+ size(): number;
8
+ private getOrCreate;
9
+ private priority;
10
+ private drain;
11
+ }
12
+ export declare class LifecyclePreempted extends Error {
13
+ readonly key: string;
14
+ readonly preemptedOp: LifecycleOp;
15
+ readonly byOp: LifecycleOp | 'cancel';
16
+ readonly reason?: string | undefined;
17
+ readonly name = "LifecyclePreempted";
18
+ constructor(key: string, preemptedOp: LifecycleOp, byOp: LifecycleOp | 'cancel', reason?: string | undefined);
19
+ }
20
+ //# sourceMappingURL=lifecycle-queue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-queue.d.ts","sourceRoot":"","sources":["../src/lifecycle-queue.ts"],"names":[],"mappings":"AAyCA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,CAAC;AAkBzE,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IAgBzD,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBlG;IASD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAW/C;IAMD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG3B;IAGD,IAAI,IAAI,MAAM,CAIb;IAED,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,QAAQ;YAUF,KAAK;CAsBpB;AAQD,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,GAAG,EAAE,MAAM;aACX,WAAW,EAAE,WAAW;aACxB,IAAI,EAAE,WAAW,GAAG,QAAQ;aAC5B,MAAM,CAAC,EAAE,MAAM;IALjC,SAAkB,IAAI,wBAAwB;IAC9C,YACkB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,WAAW,GAAG,QAAQ,EAC5B,MAAM,CAAC,EAAE,MAAM,YAAA,EAOhC;CACF"}
@@ -0,0 +1,110 @@
1
+ export class ProcessLifecycleQueue {
2
+ constructor() {
3
+ this.queues = new Map();
4
+ }
5
+ enqueue(key, op, run, onPreempt) {
6
+ const queue = this.getOrCreate(key);
7
+ return new Promise((resolve, reject) => {
8
+ const item = { op, run, resolve, reject, ...(onPreempt && { onPreempt }), preempted: false };
9
+ const incomingPriority = this.priority(op);
10
+ for (let i = queue.items.length - 1; i >= 0; i--) {
11
+ const existing = queue.items[i];
12
+ if (!existing)
13
+ continue;
14
+ if (i === 0 && queue.running)
15
+ continue;
16
+ if (this.priority(existing.op) >= incomingPriority)
17
+ continue;
18
+ existing.preempted = true;
19
+ try {
20
+ existing.onPreempt?.();
21
+ }
22
+ catch { }
23
+ queue.items.splice(i, 1);
24
+ existing.reject(new LifecyclePreempted(key, existing.op, op));
25
+ }
26
+ queue.items.push(item);
27
+ void this.drain(key);
28
+ });
29
+ }
30
+ cancelPending(key, reason) {
31
+ const queue = this.queues.get(key);
32
+ if (!queue)
33
+ return;
34
+ const startIdx = queue.running ? 1 : 0;
35
+ const toCancel = queue.items.slice(startIdx);
36
+ queue.items.length = startIdx;
37
+ for (const item of toCancel) {
38
+ item.preempted = true;
39
+ try {
40
+ item.onPreempt?.();
41
+ }
42
+ catch { }
43
+ item.reject(new LifecyclePreempted(key, item.op, 'cancel', reason));
44
+ }
45
+ }
46
+ isBusy(key) {
47
+ const queue = this.queues.get(key);
48
+ return !!queue && queue.items.length > 0;
49
+ }
50
+ size() {
51
+ let n = 0;
52
+ for (const q of this.queues.values())
53
+ n += q.items.length;
54
+ return n;
55
+ }
56
+ getOrCreate(key) {
57
+ let q = this.queues.get(key);
58
+ if (!q) {
59
+ q = { items: [], running: false };
60
+ this.queues.set(key, q);
61
+ }
62
+ return q;
63
+ }
64
+ priority(op) {
65
+ switch (op) {
66
+ case 'stop': return 4;
67
+ case 'restart': return 3;
68
+ case 'start': return 2;
69
+ case 'crash-restart': return 1;
70
+ default: return 0;
71
+ }
72
+ }
73
+ async drain(key) {
74
+ const queue = this.queues.get(key);
75
+ if (!queue || queue.running)
76
+ return;
77
+ const head = queue.items[0];
78
+ if (!head) {
79
+ this.queues.delete(key);
80
+ return;
81
+ }
82
+ queue.running = true;
83
+ try {
84
+ const result = await head.run();
85
+ head.resolve(result);
86
+ }
87
+ catch (err) {
88
+ head.reject(err);
89
+ }
90
+ finally {
91
+ queue.running = false;
92
+ if (queue.items[0] === head)
93
+ queue.items.shift();
94
+ void this.drain(key);
95
+ }
96
+ }
97
+ }
98
+ export class LifecyclePreempted extends Error {
99
+ constructor(key, preemptedOp, byOp, reason) {
100
+ super(byOp === 'cancel'
101
+ ? `Lifecycle op '${preemptedOp}' for '${key}' was cancelled${reason ? `: ${reason}` : ''}`
102
+ : `Lifecycle op '${preemptedOp}' for '${key}' was preempted by '${byOp}'`);
103
+ this.key = key;
104
+ this.preemptedOp = preemptedOp;
105
+ this.byOp = byOp;
106
+ this.reason = reason;
107
+ this.name = 'LifecyclePreempted';
108
+ }
109
+ }
110
+ //# sourceMappingURL=lifecycle-queue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lifecycle-queue.js","sourceRoot":"","sources":["../src/lifecycle-queue.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export type Liveness = 'alive' | 'dead' | 'unknown';
2
+ export declare function getLiveness(pid: number | null | undefined): Liveness;
3
+ export declare function isAlive(pid: number | null | undefined): boolean;
4
+ export declare function verifyPidIdentity(pid: number, expectedCommandPrefixes: readonly string[]): boolean | null;
5
+ //# sourceMappingURL=liveness.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liveness.d.ts","sourceRoot":"","sources":["../src/liveness.ts"],"names":[],"mappings":"AAmCA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAEpD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,CAcpE;AAQD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE/D;AAeD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,uBAAuB,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,GAAG,IAAI,CAgBzG"}
@@ -0,0 +1,34 @@
1
+ import { execSync } from 'node:child_process';
2
+ export function getLiveness(pid) {
3
+ if (pid == null || !Number.isFinite(pid) || pid < 1)
4
+ return 'dead';
5
+ try {
6
+ process.kill(pid, 0);
7
+ return 'alive';
8
+ }
9
+ catch (err) {
10
+ const code = err.code;
11
+ if (code === 'ESRCH')
12
+ return 'dead';
13
+ if (code === 'EPERM')
14
+ return 'unknown';
15
+ return 'unknown';
16
+ }
17
+ }
18
+ export function isAlive(pid) {
19
+ return getLiveness(pid) !== 'dead';
20
+ }
21
+ export function verifyPidIdentity(pid, expectedCommandPrefixes) {
22
+ if (!Number.isFinite(pid) || pid < 1)
23
+ return null;
24
+ try {
25
+ const out = execSync(`ps -p ${pid} -o comm=`, { encoding: 'utf-8', timeout: 1000 }).trim();
26
+ if (!out)
27
+ return null;
28
+ return expectedCommandPrefixes.some((p) => out === p || out.endsWith('/' + p) || out.includes(p));
29
+ }
30
+ catch {
31
+ return null;
32
+ }
33
+ }
34
+ //# sourceMappingURL=liveness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liveness.js","sourceRoot":"","sources":["../src/liveness.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9C,MAAM,UAAU,WAAW,CAAC,GAA8B;IACxD,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACnE,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,MAAM,CAAC;QACpC,IAAI,IAAI,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QAIvC,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,OAAO,CAAC,GAA8B;IACpD,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;AACrC,CAAC;AAeD,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,uBAA0C;IACvF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,CAAC;QAQH,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,GAAG,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3F,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACpG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}