@orkestrel/process 0.0.2 → 0.0.4

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 CHANGED
@@ -1,18 +1,22 @@
1
1
  # @orkestrel/process
2
2
 
3
- A typed **child-process toolkit** in three tiers. `Process` supervises one
4
- child: stdout is drained eagerly and framed into lines, stderr is forwarded live
5
- and kept as a byte-bounded tail, stdin is a writable channel, and termination is
6
- a bounded `SIGTERM` → grace → `SIGKILL` sequence that awaits the real exit. `run`
7
- and `runSync` are the one-shot runners — they buffer a child to completion and
8
- settle with a `RunResult` carrying the captured output, the exit, and `failed` /
9
- `timedOut`, rejecting with a `ProcessError` by default or resolving the result
10
- when you pass `reject: false`. `ProcessManager` is a keyed registry of live
11
- children: `launch` spawns and registers by id, a settled child evicts itself with
12
- no polling, and `stop` terminates one id, a list, or every child. Every tier is
13
- observable through a typed `emitter`, and cancellation rides an `AbortSignal`.
14
- The contracts are host-independent and ship from `@orkestrel/process`; the Node
15
- engine ships from `@orkestrel/process/server`. Part of the `@orkestrel` line.
3
+ A typed **child-process toolkit** in tiers. `Process` supervises one
4
+ child: stdout is framed into lines under a bounded backlog, stderr is forwarded
5
+ live and kept as a byte-bounded tail, stdin is a writable channel, and
6
+ termination is bounded and reports whether the real exit arrived — `SIGTERM` then
7
+ `SIGKILL` after a grace window on a POSIX host, a whole-tree kill on Windows.
8
+ `execute` and `executeSync` buffer a child to completion and settle with an
9
+ `ExecuteResult` carrying the captured output, the exit, and `failed` /
10
+ `expired` / `aborted` / `truncated`, rejecting with a `ProcessError` by default
11
+ or resolving the result when you pass `strict: false`. `ProcessManager` is a
12
+ keyed registry of live children: `launch` spawns and registers by id, a settled
13
+ child evicts itself with no polling, and `stop` terminates one id, a list, or
14
+ every child. `Process` and `ProcessManager` expose typed `emitter` properties.
15
+ `Process`, `launch`, and `execute` take an `AbortSignal` that terminates the
16
+ child; `executeSync` and `detach` take none. No spawn uses a shell, so a
17
+ metacharacter in an argument is data rather than syntax. The contracts are
18
+ host-independent and ship from `@orkestrel/process`; the Node engine ships from
19
+ `@orkestrel/process/server`. Part of the `@orkestrel` line.
16
20
 
17
21
  ## Install
18
22
 
@@ -24,14 +28,15 @@ npm install @orkestrel/process
24
28
 
25
29
  - Node.js >= 22.12.0
26
30
  - ESM and CommonJS builds
31
+ - TypeScript `moduleResolution` set to `node16`, `nodenext`, or `bundler`
27
32
 
28
33
  ## Usage
29
34
 
30
35
  ```ts
31
- import { run } from '@orkestrel/process/server'
36
+ import { execute } from '@orkestrel/process/server'
32
37
 
33
38
  // One-shot: buffer a command to completion and read its output and exit.
34
- const { stdout } = await run({ file: 'node', arguments: ['--version'] })
39
+ const { stdout } = await execute({ file: 'node', arguments: ['--version'] })
35
40
  console.log(stdout.trim()) // for example, "v22.12.0"
36
41
  ```
37
42
 
@@ -42,7 +47,7 @@ import { createProcess } from '@orkestrel/process/server'
42
47
  const child = createProcess({
43
48
  command: { file: 'node', arguments: ['worker.js'] },
44
49
  workspace: process.cwd(),
45
- grace: 5_000, // milliseconds between SIGTERM and SIGKILL on stop
50
+ grace: 5_000, // POSIX only: milliseconds between SIGTERM and SIGKILL on stop
46
51
  })
47
52
 
48
53
  for await (const line of child.lines) console.log(line)
@@ -52,16 +57,17 @@ await child.destroy()
52
57
 
53
58
  ## Guide
54
59
 
55
- For the full surface — the supervised `Process`, the `run` / `runSync` runners,
56
- the keyed `ProcessManager`, the observable `emitter`, the `ProcessError` failure
57
- type, and the lower-level helpers — see [`guides/process.md`](guides/process.md).
60
+ For the full surface — the supervised `Process`, the `execute` / `executeSync` /
61
+ `detach` spawns, the keyed `ProcessManager`, the observable `emitter`, the
62
+ `ProcessError` failure type, and the lower-level helpers — see
63
+ [`guides/process.md`](guides/process.md).
58
64
 
59
65
  ## Package
60
66
 
61
- Two typed entry points per the `exports` field in `package.json`: the
67
+ Typed entry points per the `exports` field in `package.json`: the
62
68
  host-independent contracts, constants, errors, and `isProcessError` guard from
63
- `@orkestrel/process`, and the Node engine — `Process`, `run`, `runSync`,
64
- `ProcessManager`, and their factories and helpers — from
69
+ `@orkestrel/process`, and the Node engine — `Process`, `execute`, `executeSync`,
70
+ `detach`, `ProcessManager`, and their factories and helpers — from
65
71
  `@orkestrel/process/server`.
66
72
 
67
73
  ## License
@@ -1,12 +1,28 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
2
  let _orkestrel_contract = require("@orkestrel/contract");
3
3
  //#region src/core/constants.ts
4
- /** The default cooperative window in milliseconds between `SIGTERM` and `SIGKILL` during termination. */
4
+ /** The default cooperative POSIX window in milliseconds between `SIGTERM` and `SIGKILL` during termination. */
5
5
  var PROCESS_GRACE = 5e3;
6
+ /** The window in milliseconds a termination waits for the child's native exit after the final kill. */
7
+ var PROCESS_CONFIRMATION = 5e3;
6
8
  /** The default maximum retained stderr tail in bytes for a supervised {@link ProcessInterface}. */
7
9
  var PROCESS_EVIDENCE = 2048;
10
+ /** The default soft high-water mark in bytes for a supervised {@link ProcessInterface} line backlog. */
11
+ var PROCESS_BACKLOG = 10485760;
8
12
  /** The default maximum captured bytes for a one-shot run's stdout and stderr, each. */
9
13
  var PROCESS_OUTPUT = 10485760;
14
+ /** The largest timer delay in milliseconds the host schedules without truncating it to one. */
15
+ var PROCESS_TIMER = 2147483647;
16
+ /** The executable extensions a Windows lookup applies when the environment declares no `PATHEXT`. */
17
+ var PROCESS_PATHEXT = ".COM;.EXE;.BAT;.CMD";
18
+ /** The machine-readable failure categories a {@link ProcessError} carries, in declaration order. */
19
+ var PROCESS_ERROR_CODES = Object.freeze([
20
+ "spawn",
21
+ "timeout",
22
+ "duplicate",
23
+ "protocol",
24
+ "invalid"
25
+ ]);
10
26
  //#endregion
11
27
  //#region src/core/errors.ts
12
28
  /** A child-process failure with a stable machine-readable category. */
@@ -25,6 +41,7 @@ var ProcessError = class extends Error {
25
41
  constructor(message, options) {
26
42
  const cause = options.cause;
27
43
  super(message, cause === void 0 ? void 0 : { cause });
44
+ Object.defineProperty(this, Symbol.for("@orkestrel/process.error"), { value: true });
28
45
  this.code = options.code;
29
46
  if (options.context !== void 0) this.context = options.context;
30
47
  if (options.result !== void 0) this.result = options.result;
@@ -33,6 +50,13 @@ var ProcessError = class extends Error {
33
50
  /**
34
51
  * Checks whether an unknown value is a {@link ProcessError}.
35
52
  *
53
+ * @remarks
54
+ * Recognition combines a global own-property brand with the native `Error` base, the subclass
55
+ * prototype, the fixed name, and a code {@link PROCESS_ERROR_CODES} declares. The brand is
56
+ * recognized across duplicate installations and ESM/CommonJS module copies at 0.0.4 or later. A copy
57
+ * earlier than 0.0.4 stamps no brand, so an error it throws stays outside the type, and so does a
58
+ * plain or property-only lookalike.
59
+ *
36
60
  * @param value - The value to inspect
37
61
  * @returns True only for a `ProcessError` instance; false otherwise
38
62
  *
@@ -43,7 +67,14 @@ var ProcessError = class extends Error {
43
67
  * ```
44
68
  */
45
69
  function isProcessError(value) {
46
- return (0, _orkestrel_contract.holds)(() => value instanceof ProcessError);
70
+ if (!(0, _orkestrel_contract.isError)(value)) return false;
71
+ return (0, _orkestrel_contract.holds)(() => {
72
+ if (Object.getPrototypeOf(value) === Error.prototype) return false;
73
+ if (value.name !== "ProcessError" || !("code" in value)) return false;
74
+ if (Object.getOwnPropertyDescriptor(value, Symbol.for("@orkestrel/process.error"))?.value !== true) return false;
75
+ const code = value.code;
76
+ return PROCESS_ERROR_CODES.some((declared) => declared === code);
77
+ });
47
78
  }
48
79
  /**
49
80
  * Creates the failure raised when a manager launch reuses a live id.
@@ -58,16 +89,55 @@ function createDuplicateError(id) {
58
89
  });
59
90
  }
60
91
  /**
92
+ * Creates the failure raised when a launch is attempted on a registry that is being destroyed.
93
+ *
94
+ * @param id - The id the refused launch asked for
95
+ * @returns A typed protocol failure
96
+ */
97
+ function createProtocolError(id) {
98
+ return new ProcessError(`Process '${id}' cannot launch: the registry is destroyed`, {
99
+ code: "protocol",
100
+ context: { id }
101
+ });
102
+ }
103
+ /**
104
+ * Creates the failure raised when a public input is refused before anything is spawned.
105
+ *
106
+ * @param subject - The rejected input named as the caller wrote it, such as `option 'grace'`
107
+ * @param value - The rejected value, carried as `context.value`
108
+ * @returns A typed validation failure
109
+ *
110
+ * @example
111
+ * ```ts
112
+ * createInvalidError("option 'grace'", -1).code // 'invalid'
113
+ * ```
114
+ */
115
+ function createInvalidError(subject, value) {
116
+ return new ProcessError(`Invalid ${subject}`, {
117
+ code: "invalid",
118
+ context: { value }
119
+ });
120
+ }
121
+ /**
61
122
  * Creates the failure raised when a run does not complete successfully and rejection is requested.
62
123
  *
124
+ * @remarks
125
+ * The category is `timeout` only when the run's own timeout elapsed; every other failure,
126
+ * including an abort and an output overflow, is a `spawn` failure carrying its
127
+ * {@link ExecuteResult}.
128
+ *
63
129
  * @param result - The buffered run outcome that failed
64
- * @param cause - The underlying spawn error, when one ended the run
65
- * @returns A typed run failure carrying its {@link RunResult}
130
+ * @param cause - The underlying host fault, when one ended the run
131
+ * @returns A typed run failure carrying its {@link ExecuteResult}
66
132
  */
67
- function createRunError(result, cause) {
68
- const reason = result.timedOut ? "timed out" : result.signal !== null ? `was killed by ${result.signal}` : `exited with code ${String(result.code)}`;
133
+ function createExecuteError(result, cause) {
134
+ let reason = `exited with code ${String(result.code)}`;
135
+ if (result.signal !== null) reason = `was killed by ${result.signal}`;
136
+ if (result.truncated) reason = "exceeded its output limit";
137
+ if (result.aborted) reason = "was aborted";
138
+ if (result.expired) reason = "timed out";
69
139
  return new ProcessError(`Command '${result.command}' ${reason}`, {
70
- code: result.timedOut ? "timeout" : "spawn",
140
+ code: result.expired ? "timeout" : "spawn",
71
141
  context: {
72
142
  command: result.command,
73
143
  code: result.code,
@@ -78,12 +148,19 @@ function createRunError(result, cause) {
78
148
  });
79
149
  }
80
150
  //#endregion
151
+ exports.PROCESS_BACKLOG = PROCESS_BACKLOG;
152
+ exports.PROCESS_CONFIRMATION = PROCESS_CONFIRMATION;
153
+ exports.PROCESS_ERROR_CODES = PROCESS_ERROR_CODES;
81
154
  exports.PROCESS_EVIDENCE = PROCESS_EVIDENCE;
82
155
  exports.PROCESS_GRACE = PROCESS_GRACE;
83
156
  exports.PROCESS_OUTPUT = PROCESS_OUTPUT;
157
+ exports.PROCESS_PATHEXT = PROCESS_PATHEXT;
158
+ exports.PROCESS_TIMER = PROCESS_TIMER;
84
159
  exports.ProcessError = ProcessError;
85
160
  exports.createDuplicateError = createDuplicateError;
86
- exports.createRunError = createRunError;
161
+ exports.createExecuteError = createExecuteError;
162
+ exports.createInvalidError = createInvalidError;
163
+ exports.createProtocolError = createProtocolError;
87
164
  exports.isProcessError = isProcessError;
88
165
 
89
166
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":[],"sources":["../../../src/core/constants.ts","../../../src/core/errors.ts"],"sourcesContent":["/** The default cooperative window in milliseconds between `SIGTERM` and `SIGKILL` during termination. */\nexport const PROCESS_GRACE = 5_000\n\n/** The default maximum retained stderr tail in bytes for a supervised {@link ProcessInterface}. */\nexport const PROCESS_EVIDENCE = 2_048\n\n/** The default maximum captured bytes for a one-shot run's stdout and stderr, each. */\nexport const PROCESS_OUTPUT = 10_485_760\n","import { holds } from '@orkestrel/contract'\nimport type {\n\tProcessErrorCode,\n\tProcessErrorContext,\n\tProcessErrorOptions,\n\tRunResult,\n} from './types.js'\n\n/** A child-process failure with a stable machine-readable category. */\nexport class ProcessError extends Error {\n\toverride readonly name = 'ProcessError'\n\treadonly code: ProcessErrorCode\n\treadonly context?: ProcessErrorContext\n\t/** The buffered run outcome, present when a one-shot run produced the failure. */\n\treadonly result?: RunResult\n\n\t/**\n\t * Create a process error.\n\t *\n\t * @param message - Human-readable failure description\n\t * @param options - Machine-readable category, optional context, optional cause, and optional run result\n\t */\n\tconstructor(message: string, options: ProcessErrorOptions) {\n\t\tconst cause = options.cause\n\t\tsuper(message, cause === undefined ? undefined : { cause })\n\t\tthis.code = options.code\n\t\tif (options.context !== undefined) this.context = options.context\n\t\tif (options.result !== undefined) this.result = options.result\n\t}\n}\n\n/**\n * Checks whether an unknown value is a {@link ProcessError}.\n *\n * @param value - The value to inspect\n * @returns True only for a `ProcessError` instance; false otherwise\n *\n * @example\n * ```ts\n * isProcessError(new ProcessError('spawn failed', { code: 'spawn' })) // true\n * isProcessError(new Error('spawn failed')) // false\n * ```\n */\nexport function isProcessError(value: unknown): value is ProcessError {\n\treturn holds(() => value instanceof ProcessError)\n}\n\n/**\n * Creates the failure raised when a manager launch reuses a live id.\n *\n * @param id - The id already occupied by a live child\n * @returns A typed duplicate-id failure\n */\nexport function createDuplicateError(id: string): ProcessError {\n\treturn new ProcessError(`Process '${id}' is already live`, {\n\t\tcode: 'duplicate',\n\t\tcontext: { id },\n\t})\n}\n\n/**\n * Creates the failure raised when a run does not complete successfully and rejection is requested.\n *\n * @param result - The buffered run outcome that failed\n * @param cause - The underlying spawn error, when one ended the run\n * @returns A typed run failure carrying its {@link RunResult}\n */\nexport function createRunError(result: RunResult, cause?: unknown): ProcessError {\n\tconst reason = result.timedOut\n\t\t? 'timed out'\n\t\t: result.signal !== null\n\t\t\t? `was killed by ${result.signal}`\n\t\t\t: `exited with code ${String(result.code)}`\n\treturn new ProcessError(`Command '${result.command}' ${reason}`, {\n\t\tcode: result.timedOut ? 'timeout' : 'spawn',\n\t\tcontext: { command: result.command, code: result.code, signal: result.signal },\n\t\t...(cause === undefined ? {} : { cause }),\n\t\tresult,\n\t})\n}\n"],"mappings":";;;;AACA,IAAa,gBAAgB;;AAG7B,IAAa,mBAAmB;;AAGhC,IAAa,iBAAiB;;;;ACE9B,IAAa,eAAb,cAAkC,MAAM;CACvC,OAAyB;CACzB;CACA;;CAEA;;;;;;;CAQA,YAAY,SAAiB,SAA8B;EAC1D,MAAM,QAAQ,QAAQ;EACtB,MAAM,SAAS,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,MAAM,CAAC;EAC1D,KAAK,OAAO,QAAQ;EACpB,IAAI,QAAQ,YAAY,KAAA,GAAW,KAAK,UAAU,QAAQ;EAC1D,IAAI,QAAQ,WAAW,KAAA,GAAW,KAAK,SAAS,QAAQ;CACzD;AACD;;;;;;;;;;;;;AAcA,SAAgB,eAAe,OAAuC;CACrE,QAAA,GAAO,oBAAA,MAAA,OAAY,iBAAiB,YAAY;AACjD;;;;;;;AAQA,SAAgB,qBAAqB,IAA0B;CAC9D,OAAO,IAAI,aAAa,YAAY,GAAG,oBAAoB;EAC1D,MAAM;EACN,SAAS,EAAE,GAAG;CACf,CAAC;AACF;;;;;;;;AASA,SAAgB,eAAe,QAAmB,OAA+B;CAChF,MAAM,SAAS,OAAO,WACnB,cACA,OAAO,WAAW,OACjB,iBAAiB,OAAO,WACxB,oBAAoB,OAAO,OAAO,IAAI;CAC1C,OAAO,IAAI,aAAa,YAAY,OAAO,QAAQ,IAAI,UAAU;EAChE,MAAM,OAAO,WAAW,YAAY;EACpC,SAAS;GAAE,SAAS,OAAO;GAAS,MAAM,OAAO;GAAM,QAAQ,OAAO;EAAO;EAC7E,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EACvC;CACD,CAAC;AACF"}
1
+ {"version":3,"file":"index.cjs","names":[],"sources":["../../../src/core/constants.ts","../../../src/core/errors.ts"],"sourcesContent":["/** The default cooperative POSIX window in milliseconds between `SIGTERM` and `SIGKILL` during termination. */\nexport const PROCESS_GRACE = 5_000\n\n/** The window in milliseconds a termination waits for the child's native exit after the final kill. */\nexport const PROCESS_CONFIRMATION = 5_000\n\n/** The default maximum retained stderr tail in bytes for a supervised {@link ProcessInterface}. */\nexport const PROCESS_EVIDENCE = 2_048\n\n/** The default soft high-water mark in bytes for a supervised {@link ProcessInterface} line backlog. */\nexport const PROCESS_BACKLOG = 10_485_760\n\n/** The default maximum captured bytes for a one-shot run's stdout and stderr, each. */\nexport const PROCESS_OUTPUT = 10_485_760\n\n/** The largest timer delay in milliseconds the host schedules without truncating it to one. */\nexport const PROCESS_TIMER = 2_147_483_647\n\n/** The executable extensions a Windows lookup applies when the environment declares no `PATHEXT`. */\nexport const PROCESS_PATHEXT = '.COM;.EXE;.BAT;.CMD'\n\n/** The machine-readable failure categories a {@link ProcessError} carries, in declaration order. */\nexport const PROCESS_ERROR_CODES = Object.freeze([\n\t'spawn',\n\t'timeout',\n\t'duplicate',\n\t'protocol',\n\t'invalid',\n] as const)\n","import type {\n\tProcessErrorCode,\n\tProcessErrorContext,\n\tProcessErrorOptions,\n\tExecuteResult,\n} from './types.js'\nimport { holds, isError } from '@orkestrel/contract'\nimport { PROCESS_ERROR_CODES } from './constants.js'\n\n/** A child-process failure with a stable machine-readable category. */\nexport class ProcessError extends Error {\n\toverride readonly name = 'ProcessError'\n\treadonly code: ProcessErrorCode\n\treadonly context?: ProcessErrorContext\n\t/** The buffered run outcome, present when a one-shot run produced the failure. */\n\treadonly result?: ExecuteResult\n\n\t/**\n\t * Create a process error.\n\t *\n\t * @param message - Human-readable failure description\n\t * @param options - Machine-readable category, optional context, optional cause, and optional run result\n\t */\n\tconstructor(message: string, options: ProcessErrorOptions) {\n\t\tconst cause = options.cause\n\t\tsuper(message, cause === undefined ? undefined : { cause })\n\t\tObject.defineProperty(this, Symbol.for('@orkestrel/process.error'), { value: true })\n\t\tthis.code = options.code\n\t\tif (options.context !== undefined) this.context = options.context\n\t\tif (options.result !== undefined) this.result = options.result\n\t}\n}\n\n/**\n * Checks whether an unknown value is a {@link ProcessError}.\n *\n * @remarks\n * Recognition combines a global own-property brand with the native `Error` base, the subclass\n * prototype, the fixed name, and a code {@link PROCESS_ERROR_CODES} declares. The brand is\n * recognized across duplicate installations and ESM/CommonJS module copies at 0.0.4 or later. A copy\n * earlier than 0.0.4 stamps no brand, so an error it throws stays outside the type, and so does a\n * plain or property-only lookalike.\n *\n * @param value - The value to inspect\n * @returns True only for a `ProcessError` instance; false otherwise\n *\n * @example\n * ```ts\n * isProcessError(new ProcessError('spawn failed', { code: 'spawn' })) // true\n * isProcessError(new Error('spawn failed')) // false\n * ```\n */\nexport function isProcessError(value: unknown): value is ProcessError {\n\tif (!isError(value)) return false\n\treturn holds(() => {\n\t\tif (Object.getPrototypeOf(value) === Error.prototype) return false\n\t\tif (value.name !== 'ProcessError' || !('code' in value)) return false\n\t\tconst descriptor = Object.getOwnPropertyDescriptor(\n\t\t\tvalue,\n\t\t\tSymbol.for('@orkestrel/process.error'),\n\t\t)\n\t\tif (descriptor?.value !== true) return false\n\t\tconst code: unknown = value.code\n\t\treturn PROCESS_ERROR_CODES.some((declared) => declared === code)\n\t})\n}\n\n/**\n * Creates the failure raised when a manager launch reuses a live id.\n *\n * @param id - The id already occupied by a live child\n * @returns A typed duplicate-id failure\n */\nexport function createDuplicateError(id: string): ProcessError {\n\treturn new ProcessError(`Process '${id}' is already live`, {\n\t\tcode: 'duplicate',\n\t\tcontext: { id },\n\t})\n}\n\n/**\n * Creates the failure raised when a launch is attempted on a registry that is being destroyed.\n *\n * @param id - The id the refused launch asked for\n * @returns A typed protocol failure\n */\nexport function createProtocolError(id: string): ProcessError {\n\treturn new ProcessError(`Process '${id}' cannot launch: the registry is destroyed`, {\n\t\tcode: 'protocol',\n\t\tcontext: { id },\n\t})\n}\n\n/**\n * Creates the failure raised when a public input is refused before anything is spawned.\n *\n * @param subject - The rejected input named as the caller wrote it, such as `option 'grace'`\n * @param value - The rejected value, carried as `context.value`\n * @returns A typed validation failure\n *\n * @example\n * ```ts\n * createInvalidError(\"option 'grace'\", -1).code // 'invalid'\n * ```\n */\nexport function createInvalidError(subject: string, value: unknown): ProcessError {\n\treturn new ProcessError(`Invalid ${subject}`, { code: 'invalid', context: { value } })\n}\n\n/**\n * Creates the failure raised when a run does not complete successfully and rejection is requested.\n *\n * @remarks\n * The category is `timeout` only when the run's own timeout elapsed; every other failure,\n * including an abort and an output overflow, is a `spawn` failure carrying its\n * {@link ExecuteResult}.\n *\n * @param result - The buffered run outcome that failed\n * @param cause - The underlying host fault, when one ended the run\n * @returns A typed run failure carrying its {@link ExecuteResult}\n */\nexport function createExecuteError(result: ExecuteResult, cause?: unknown): ProcessError {\n\tlet reason = `exited with code ${String(result.code)}`\n\tif (result.signal !== null) reason = `was killed by ${result.signal}`\n\tif (result.truncated) reason = 'exceeded its output limit'\n\tif (result.aborted) reason = 'was aborted'\n\tif (result.expired) reason = 'timed out'\n\treturn new ProcessError(`Command '${result.command}' ${reason}`, {\n\t\tcode: result.expired ? 'timeout' : 'spawn',\n\t\tcontext: { command: result.command, code: result.code, signal: result.signal },\n\t\t...(cause === undefined ? {} : { cause }),\n\t\tresult,\n\t})\n}\n"],"mappings":";;;;AACA,IAAa,gBAAgB;;AAG7B,IAAa,uBAAuB;;AAGpC,IAAa,mBAAmB;;AAGhC,IAAa,kBAAkB;;AAG/B,IAAa,iBAAiB;;AAG9B,IAAa,gBAAgB;;AAG7B,IAAa,kBAAkB;;AAG/B,IAAa,sBAAsB,OAAO,OAAO;CAChD;CACA;CACA;CACA;CACA;AACD,CAAU;;;;AClBV,IAAa,eAAb,cAAkC,MAAM;CACvC,OAAyB;CACzB;CACA;;CAEA;;;;;;;CAQA,YAAY,SAAiB,SAA8B;EAC1D,MAAM,QAAQ,QAAQ;EACtB,MAAM,SAAS,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,MAAM,CAAC;EAC1D,OAAO,eAAe,MAAM,OAAO,IAAI,0BAA0B,GAAG,EAAE,OAAO,KAAK,CAAC;EACnF,KAAK,OAAO,QAAQ;EACpB,IAAI,QAAQ,YAAY,KAAA,GAAW,KAAK,UAAU,QAAQ;EAC1D,IAAI,QAAQ,WAAW,KAAA,GAAW,KAAK,SAAS,QAAQ;CACzD;AACD;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,eAAe,OAAuC;CACrE,IAAI,EAAA,GAAC,oBAAA,QAAA,CAAQ,KAAK,GAAG,OAAO;CAC5B,QAAA,GAAO,oBAAA,MAAA,OAAY;EAClB,IAAI,OAAO,eAAe,KAAK,MAAM,MAAM,WAAW,OAAO;EAC7D,IAAI,MAAM,SAAS,kBAAkB,EAAE,UAAU,QAAQ,OAAO;EAKhE,IAJmB,OAAO,yBACzB,OACA,OAAO,IAAI,0BAA0B,CAElC,CAAA,EAAY,UAAU,MAAM,OAAO;EACvC,MAAM,OAAgB,MAAM;EAC5B,OAAO,oBAAoB,MAAM,aAAa,aAAa,IAAI;CAChE,CAAC;AACF;;;;;;;AAQA,SAAgB,qBAAqB,IAA0B;CAC9D,OAAO,IAAI,aAAa,YAAY,GAAG,oBAAoB;EAC1D,MAAM;EACN,SAAS,EAAE,GAAG;CACf,CAAC;AACF;;;;;;;AAQA,SAAgB,oBAAoB,IAA0B;CAC7D,OAAO,IAAI,aAAa,YAAY,GAAG,6CAA6C;EACnF,MAAM;EACN,SAAS,EAAE,GAAG;CACf,CAAC;AACF;;;;;;;;;;;;;AAcA,SAAgB,mBAAmB,SAAiB,OAA8B;CACjF,OAAO,IAAI,aAAa,WAAW,WAAW;EAAE,MAAM;EAAW,SAAS,EAAE,MAAM;CAAE,CAAC;AACtF;;;;;;;;;;;;;AAcA,SAAgB,mBAAmB,QAAuB,OAA+B;CACxF,IAAI,SAAS,oBAAoB,OAAO,OAAO,IAAI;CACnD,IAAI,OAAO,WAAW,MAAM,SAAS,iBAAiB,OAAO;CAC7D,IAAI,OAAO,WAAW,SAAS;CAC/B,IAAI,OAAO,SAAS,SAAS;CAC7B,IAAI,OAAO,SAAS,SAAS;CAC7B,OAAO,IAAI,aAAa,YAAY,OAAO,QAAQ,IAAI,UAAU;EAChE,MAAM,OAAO,UAAU,YAAY;EACnC,SAAS;GAAE,SAAS,OAAO;GAAS,MAAM,OAAO;GAAM,QAAQ,OAAO;EAAO;EAC7E,GAAI,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,MAAM;EACvC;CACD,CAAC;AACF"}