@orkestrel/process 0.0.14 → 0.0.16

package/dist/src/server/index.d.cts

@@ -309,6 +309,20 @@ export declare function executeSync(command: ProcessCommand, options?: ExecuteSy
  */
 export declare function formatCommand(command: ProcessCommand): string;
 
+/**
+ * Reports whether a process or POSIX process group still exists.
+ *
+ * @param pid - A positive process id, or a negative POSIX process-group id
+ * @returns True when the host confirms existence or refuses permission; false for ESRCH; undefined for another host failure
+ * @throws A {@link ProcessError} coded `invalid` for an unsafe integer, zero, minus one, or a negative id on Windows
+ * @remarks Negative ids probe POSIX process groups. The `process.platform` branch refuses negative ids on Windows, where the host supports positive process ids only.
+ * @example
+ * ```ts
+ * inspectProcess(process.pid) // true
+ * ```
+ */
+export declare function inspectProcess(pid: number): boolean | undefined;
+
 /**
  * Checks whether a child process has reached its native exit.
  *
@@ -482,7 +496,7 @@ export declare class Process implements ProcessInterface {
     /** Reports whether the terminal moment arrived and `exit` settled. */
     get settled(): boolean;
     /** Reports whether termination began, including after the terminal moment. */
-    get stopping(): boolean;
+    get terminated(): boolean;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
     get exit(): Promise<ProcessExit>;
     /**
@@ -791,7 +805,7 @@ export declare function resolveExecutable(file: string, options?: ExecutableOpti
  *
  * The standard-input channel is open from the spawn, and `end` closes it without terminating
  * anything. That is the member a cooperative protocol reaches for: the child observes end of input
- * and exits on its own, which `ending` reports. `stop` and `destroy` remain the terminations, and
+ * and exits on its own, which `ended` reports. `stop` and `destroy` remain the terminations, and
  * `exit` remains the terminal moment — the native exit plus at most `drain` while a descendant holds
  * the inherited read ends.
  *
@@ -827,9 +841,9 @@ export declare class Session implements SessionInterface {
     /** Reports whether the terminal moment arrived and `exit` settled. */
     get settled(): boolean;
     /** Reports whether termination began, including after the terminal moment. `end` never turns it true. */
-    get stopping(): boolean;
+    get terminated(): boolean;
     /** Settles at the child's own ending, awaited without the terminal moment's drain window. */
-    get ending(): Promise<void>;
+    get ended(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
     get exit(): Promise<ProcessExit>;
     /**
@@ -849,7 +863,7 @@ export declare class Session implements SessionInterface {
      * Closes the standard-input channel and leaves the child running.
      *
      * @remarks
-     * Never rejects and terminates nothing: `stopping` stays false and the terminal moment does not
+     * Never rejects and terminates nothing: `terminated` stays false and the terminal moment does not
      * arrive. Every call shares one barrier, which resolves after the host flushes the writes it had
      * already accepted. A later `write` resolves `false`.
      *
@@ -936,7 +950,7 @@ export declare function stopChild(child: ProcessChildInterface, grace: number, c
  * emitter and event map its consumers subscribe to.
  *
  * The child's ending and the supervision's ending are distinct. `pid`, `code`, and `signal` read the
- * host child directly, so they expose native exit as soon as the host records it, and `ending`
+ * host child directly, so they expose native exit as soon as the host records it, and `ended`
  * settles at that same moment. `settled`, `exit`, and `evidence` reach one terminal moment after the
  * read channels close or the bounded `drain` window cuts them off. That window is armed by the
  * child's native exit and by a termination this package initiated, so every way a child can end
@@ -1002,7 +1016,7 @@ export declare class Supervisor {
     /** Reports whether the terminal moment arrived and `exit` settled. */
     get settled(): boolean;
     /** Reports whether termination began, including after the terminal moment. */
-    get stopping(): boolean;
+    get terminated(): boolean;
     /**
      * Settles at the child's own ending, awaited without the terminal moment's drain window.
      *
@@ -1011,7 +1025,7 @@ export declare class Supervisor {
      * the host records them. It settles at the native exit, and at the terminal moment for a child
      * whose spawn produced no native exit at all, so it can never outlive the supervision.
      */
-    get ending(): Promise<void>;
+    get ended(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
     get exit(): Promise<ProcessExit>;
     /**
@@ -1057,7 +1071,7 @@ export declare class Supervisor {
      * Closes the standard-input channel while leaving the child running.
      *
      * @remarks
-     * Never rejects, and terminates nothing: no signal is sent, `stopping` stays false, no drain
+     * Never rejects, and terminates nothing: no signal is sent, `terminated` stays false, no drain
      * window is armed, and the terminal moment does not arrive. The child observes end of input and
      * decides for itself what to do about it, which is what separates this from `stop`.
      *

package/dist/src/server/index.d.ts

@@ -309,6 +309,20 @@ export declare function executeSync(command: ProcessCommand, options?: ExecuteSy
  */
 export declare function formatCommand(command: ProcessCommand): string;
 
+/**
+ * Reports whether a process or POSIX process group still exists.
+ *
+ * @param pid - A positive process id, or a negative POSIX process-group id
+ * @returns True when the host confirms existence or refuses permission; false for ESRCH; undefined for another host failure
+ * @throws A {@link ProcessError} coded `invalid` for an unsafe integer, zero, minus one, or a negative id on Windows
+ * @remarks Negative ids probe POSIX process groups. The `process.platform` branch refuses negative ids on Windows, where the host supports positive process ids only.
+ * @example
+ * ```ts
+ * inspectProcess(process.pid) // true
+ * ```
+ */
+export declare function inspectProcess(pid: number): boolean | undefined;
+
 /**
  * Checks whether a child process has reached its native exit.
  *
@@ -482,7 +496,7 @@ export declare class Process implements ProcessInterface {
     /** Reports whether the terminal moment arrived and `exit` settled. */
     get settled(): boolean;
     /** Reports whether termination began, including after the terminal moment. */
-    get stopping(): boolean;
+    get terminated(): boolean;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
     get exit(): Promise<ProcessExit>;
     /**
@@ -791,7 +805,7 @@ export declare function resolveExecutable(file: string, options?: ExecutableOpti
  *
  * The standard-input channel is open from the spawn, and `end` closes it without terminating
  * anything. That is the member a cooperative protocol reaches for: the child observes end of input
- * and exits on its own, which `ending` reports. `stop` and `destroy` remain the terminations, and
+ * and exits on its own, which `ended` reports. `stop` and `destroy` remain the terminations, and
  * `exit` remains the terminal moment — the native exit plus at most `drain` while a descendant holds
  * the inherited read ends.
  *
@@ -827,9 +841,9 @@ export declare class Session implements SessionInterface {
     /** Reports whether the terminal moment arrived and `exit` settled. */
     get settled(): boolean;
     /** Reports whether termination began, including after the terminal moment. `end` never turns it true. */
-    get stopping(): boolean;
+    get terminated(): boolean;
     /** Settles at the child's own ending, awaited without the terminal moment's drain window. */
-    get ending(): Promise<void>;
+    get ended(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
     get exit(): Promise<ProcessExit>;
     /**
@@ -849,7 +863,7 @@ export declare class Session implements SessionInterface {
      * Closes the standard-input channel and leaves the child running.
      *
      * @remarks
-     * Never rejects and terminates nothing: `stopping` stays false and the terminal moment does not
+     * Never rejects and terminates nothing: `terminated` stays false and the terminal moment does not
      * arrive. Every call shares one barrier, which resolves after the host flushes the writes it had
      * already accepted. A later `write` resolves `false`.
      *
@@ -936,7 +950,7 @@ export declare function stopChild(child: ProcessChildInterface, grace: number, c
  * emitter and event map its consumers subscribe to.
  *
  * The child's ending and the supervision's ending are distinct. `pid`, `code`, and `signal` read the
- * host child directly, so they expose native exit as soon as the host records it, and `ending`
+ * host child directly, so they expose native exit as soon as the host records it, and `ended`
  * settles at that same moment. `settled`, `exit`, and `evidence` reach one terminal moment after the
  * read channels close or the bounded `drain` window cuts them off. That window is armed by the
  * child's native exit and by a termination this package initiated, so every way a child can end
@@ -1002,7 +1016,7 @@ export declare class Supervisor {
     /** Reports whether the terminal moment arrived and `exit` settled. */
     get settled(): boolean;
     /** Reports whether termination began, including after the terminal moment. */
-    get stopping(): boolean;
+    get terminated(): boolean;
     /**
      * Settles at the child's own ending, awaited without the terminal moment's drain window.
      *
@@ -1011,7 +1025,7 @@ export declare class Supervisor {
      * the host records them. It settles at the native exit, and at the terminal moment for a child
      * whose spawn produced no native exit at all, so it can never outlive the supervision.
      */
-    get ending(): Promise<void>;
+    get ended(): Promise<void>;
     /** Settles with the terminal child state, observed once after stream close or the drain cutoff. */
     get exit(): Promise<ProcessExit>;
     /**
@@ -1057,7 +1071,7 @@ export declare class Supervisor {
      * Closes the standard-input channel while leaving the child running.
      *
      * @remarks
-     * Never rejects, and terminates nothing: no signal is sent, `stopping` stays false, no drain
+     * Never rejects, and terminates nothing: no signal is sent, `terminated` stays false, no drain
      * window is armed, and the terminal moment does not arrive. The child observes end of input and
      * decides for itself what to do about it, which is what separates this from `stop`.
      *