@start9labs/start-sdk 1.0.0 → 1.2.0

package/package/lib/mainFn/Daemons.d.ts

@@ -15,48 +15,99 @@ export declare const cpExecFile: typeof CP.execFile.__promisify__;
 /**
  * Configuration for a daemon's health-check readiness probe.
  *
- * Determines how the system knows when a daemon is healthy and ready to serve.
+ * Every daemon and standalone health check requires a `Ready` configuration
+ * that tells StartOS how to determine whether the daemon is healthy.
+ *
+ * The `fn` is called on a recurring interval controlled by `trigger` (defaults
+ * to 1 s before the first non-pending result, then 30 s). During the initial
+ * `gracePeriod` window, `failure` results are softened to `starting` so the
+ * UI doesn't flash red while a daemon is still booting.
+ *
+ * ### Health check result states
+ *
+ * | Result      | Meaning                                              | UI treatment     |
+ * |-------------|------------------------------------------------------|------------------|
+ * | `success`   | Healthy and fully operational                        | Green / ready    |
+ * | `loading`   | Operational but still catching up (e.g. syncing)     | Progress / amber |
+ * | `disabled`  | Intentionally inactive (excluded by configuration)   | Grey / skipped   |
+ * | `starting`  | Not yet ready, still initializing                    | Spinner          |
+ * | `waiting`   | Blocked on an external dependency                    | Spinner          |
+ * | `failure`   | Unhealthy — something is wrong                       | Red / error      |
  */
 export type Ready = {
-    /** A human-readable display name for the health check. If null, the health check itself will be from the UI */
+    /**
+     * Human-readable label shown in the StartOS health-check UI.
+     * Set to `null` to hide this check from the UI entirely.
+     */
     display: string | null;
     /**
-     * @description The function to determine the health status of the daemon
+     * The function called on each polling interval to determine the daemon's health.
+     *
+     * Return a {@link HealthCheckResult} with a `result` field (`success`, `loading`,
+     * `failure`, etc.) and an optional `message` string shown in the UI.
      *
-     *   The SDK provides some built-in health checks. To see them, type sdk.healthCheck.
+     * The SDK ships several built-in helpers on `sdk.healthCheck`:
+     * - `checkPortListening` — checks whether a TCP/UDP port is bound
+     * - `checkWebUrl` — fetches a URL and succeeds on any HTTP response
+     * - `runHealthScript` — runs a command in a subcontainer and succeeds on exit 0
      *
      * @example
+     * ```ts
+     * fn: () =>
+     *   sdk.healthCheck.checkPortListening(effects, 80, {
+     *     successMessage: 'Web server is ready',
+     *     errorMessage: 'Web server is not listening',
+     *   })
      * ```
-      fn: () =>
-        sdk.healthCheck.checkPortListening(effects, 80, {
-          successMessage: 'service listening on port 80',
-          errorMessage: 'service is unreachable',
-        })
-    * ```
-    */
+     */
     fn: () => Promise<HealthCheckResult> | HealthCheckResult;
     /**
-     * A duration in milliseconds to treat a failing health check as "starting"
+     * Duration in milliseconds during which `failure` results are reported
+     * as `starting` instead, giving the daemon time to initialize without
+     * showing errors in the UI.
      *
-     * defaults to 5000
+     * @default 10_000
      */
     gracePeriod?: number;
+    /**
+     * Controls the polling interval for this health check.
+     *
+     * Use one of the built-in triggers from `sdk.trigger`:
+     * - `cooldownTrigger(ms)` — fixed interval between checks
+     * - `statusTrigger({ success, loading, failure, ... })` — per-status
+     *   polling intervals
+     *
+     * If omitted, uses the default trigger: 1 s before the first non-pending
+     * result, then 30 s afterward.
+     */
     trigger?: Trigger;
 };
 /**
  * Options for running a daemon as a shell command inside a subcontainer.
- * Includes the command to run, optional signal/timeout, environment, user, and stdio callbacks.
  */
 export type ExecCommandOptions = {
+    /** The command and arguments to execute (e.g. `['bitcoind', '-conf=/etc/bitcoin.conf']`) */
     command: T.CommandType;
+    /**
+     * How long (ms) to wait for the process to exit after sending SIGTERM
+     * before force-killing it.
+     *
+     * @default 30_000
+     */
     sigtermTimeout?: number;
+    /** Run the command as PID 1 inside the container (init process) */
     runAsInit?: boolean;
+    /** Environment variables to set for the process */
     env?: {
         [variable in string]?: string;
     } | undefined;
+    /** Working directory for the process */
     cwd?: string | undefined;
+    /** Run the process as this user inside the container */
     user?: string | undefined;
+    /** Callback invoked with each chunk written to stdout */
     onStdout?: (chunk: Buffer | string | any) => void;
+    /** Callback invoked with each chunk written to stderr */
     onStderr?: (chunk: Buffer | string | any) => void;
 };
 /**
@@ -85,17 +136,26 @@ type AddDaemonParams<Manifest extends T.SDKManifest, Ids extends string, Id exte
     daemon: Daemon<Manifest>;
 }) & {
     ready: Ready;
-    /** An array of IDs of prior daemons whose successful initializations are required before this daemon will initialize */
+    /**
+     * IDs of prior daemons/oneshots/health checks that must be ready before
+     * this daemon starts. Enforces startup ordering in the daemon chain.
+     */
     requires: Exclude<Ids, Id>[];
 };
 type AddOneshotParams<Manifest extends T.SDKManifest, Ids extends string, Id extends string, C extends SubContainer<Manifest> | null> = NewDaemonParams<Manifest, C> & {
     exec: DaemonCommandType<Manifest, C>;
-    /** An array of IDs of prior daemons whose successful initializations are required before this daemon will initialize */
+    /**
+     * IDs of prior daemons/oneshots/health checks that must be ready before
+     * this oneshot runs.
+     */
     requires: Exclude<Ids, Id>[];
 };
 type AddHealthCheckParams<Ids extends string, Id extends string> = {
     ready: Ready;
-    /** An array of IDs of prior daemons whose successful initializations are required before this daemon will initialize */
+    /**
+     * IDs of prior daemons/oneshots/health checks that must be ready before
+     * this health check starts polling.
+     */
     requires: Exclude<Ids, Id>[];
 };
 type ErrorDuplicateId<Id extends string> = `The id '${Id}' is already used`;
@@ -147,35 +207,55 @@ export declare class Daemons<Manifest extends T.SDKManifest, Ids extends string>
     }): Daemons<Manifest, never>;
     private addDaemonImpl;
     /**
-     * Returns the complete list of daemons, including the one defined here
-     * @param id
-     * @param options
-     * @returns a new Daemons object
+     * Register a long-running daemon process.
+     *
+     * The daemon starts in its subcontainer and is monitored by its `ready`
+     * health check. Other daemons and health checks can depend on it via
+     * `requires`.
+     *
+     * Pass a static options object, a sync/async factory that returns options
+     * (or `null` to conditionally skip the daemon), or an object with a
+     * pre-built `daemon` instance.
+     *
+     * @param id - Unique string identifier for this daemon
+     * @param options - Daemon configuration, or a factory returning it (return `null` to skip)
      */
     addDaemon<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamSync<AddDaemonParams<Manifest, Ids, Id, C>>): Daemons<Manifest, Ids | Id>;
     addDaemon<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamAsync<AddDaemonParams<Manifest, Ids, Id, C>>): Promise<Daemons<Manifest, Ids | Id>>;
     /**
-     * Returns the complete list of daemons, including a "oneshot" daemon one defined here
-     * a oneshot daemon is a command that executes once when started, and is considered "running" once it exits successfully
-     * @param id
-     * @param options
-     * @returns a new Daemons object
+     * Register a one-shot command that runs to completion before dependents start.
+     *
+     * Common uses: `chown` for file ownership, database migrations, config
+     * generation, wallet unlocking. The oneshot is considered "ready" as soon
+     * as the command exits successfully (exit code 0).
+     *
+     * @param id - Unique string identifier for this oneshot
+     * @param options - Oneshot configuration, or a factory returning it (return `null` to skip)
      */
     addOneshot<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamSync<AddOneshotParams<Manifest, Ids, Id, C>>): Daemons<Manifest, Ids | Id>;
     addOneshot<Id extends string, C extends SubContainer<Manifest> | null>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamAsync<AddOneshotParams<Manifest, Ids, Id, C>>): Promise<Daemons<Manifest, Ids | Id>>;
     /**
-     * Returns the complete list of daemons, including a new HealthCheck defined here
-     * @param id
-     * @param options
-     * @returns a new Daemons object
+     * Register a standalone health check with no associated process.
+     *
+     * Use this for ongoing conditions that don't map to a single daemon, such
+     * as blockchain sync progress or network reachability. Dependent services
+     * can reference standalone health check IDs in their dependency config.
+     *
+     * @param id - Unique string identifier for this health check
+     * @param options - Health check configuration, or a factory returning it (return `null` to skip)
      */
     addHealthCheck<Id extends string>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamSync<AddHealthCheckParams<Ids, Id>>): Daemons<Manifest, Ids | Id>;
     addHealthCheck<Id extends string>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: OptionalParamAsync<AddHealthCheckParams<Ids, Id>>): Promise<Daemons<Manifest, Ids | Id>>;
     /**
-     * Runs the entire system until all daemons have returned `ready`.
-     * @param id
-     * @param options
-     * @returns a new Daemons object
+     * Start all registered daemons and wait until every one passes its ready
+     * check, then tear everything down.
+     *
+     * Used for bootstrapping via a temporary daemon chain — e.g. starting a
+     * service to call its API (create admin users, register apps), then
+     * shutting it down before the real daemon chain starts.
+     *
+     * @param timeout - Maximum time (ms) to wait for all daemons to become ready, or `null` for no limit
+     * @throws If the timeout is reached before all daemons are ready
      */
     runUntilSuccess(timeout: number | null): Promise<null>;
     /**

package/package/lib/mainFn/Daemons.js

@@ -158,10 +158,15 @@ class Daemons {
         return res(options);
     }
     /**
-     * Runs the entire system until all daemons have returned `ready`.
-     * @param id
-     * @param options
-     * @returns a new Daemons object
+     * Start all registered daemons and wait until every one passes its ready
+     * check, then tear everything down.
+     *
+     * Used for bootstrapping via a temporary daemon chain — e.g. starting a
+     * service to call its API (create admin users, register apps), then
+     * shutting it down before the real daemon chain starts.
+     *
+     * @param timeout - Maximum time (ms) to wait for all daemons to become ready, or `null` for no limit
+     * @throws If the timeout is reached before all daemons are ready
      */
     async runUntilSuccess(timeout) {
         let resolve = (_) => { };

package/package/lib/mainFn/Daemons.js.map

@@ -1 +1 @@
-{"version":3,"file":"Daemons.js","sourceRoot":"","sources":["../../../../package/lib/mainFn/Daemons.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Daemons.js","sourceRoot":"","sources":["../../../../package/lib/mainFn/Daemons.ts"],"names":[],"mappings":"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"}

package/package/lib/test/output.d.ts

@@ -0,0 +1,158 @@
+export declare const inputSpecSpec: import("../../../base/lib/actions/input/builder").InputSpec<{
+    mediasources: ("nextcloud" | "filebrowser")[];
+    testListUnion: {
+        union: {
+            selection: "lnd";
+            value: {
+                name: string;
+            };
+            other?: {} | undefined;
+        };
+    }[];
+    rpc: {
+        enable: boolean;
+        username: string;
+        password: string;
+        bio: string;
+        advanced: {
+            auth: string[];
+            serialversion: "segwit" | "non-segwit";
+            servertimeout: number;
+            threads: number;
+            workqueue: number;
+        };
+    };
+    'zmq-enabled': boolean;
+    txindex: boolean;
+    wallet: {
+        enable: boolean;
+        avoidpartialspends: boolean;
+        discardfee: number;
+    };
+    advanced: {
+        mempool: {
+            mempoolfullrbf: boolean;
+            persistmempool: boolean;
+            maxmempool: number;
+            mempoolexpiry: number;
+        };
+        peers: {
+            listen: boolean;
+            onlyconnect: boolean;
+            onlyonion: boolean;
+            addnode: {
+                hostname: string | null;
+                port: number | null;
+            }[];
+        };
+        dbcache: number | null;
+        pruning: import("../../../base/lib/actions/input/builder/variants").UnionRes<{
+            disabled: {
+                name: string;
+                spec: import("../../../base/lib/actions/input/builder").InputSpec<{}, {}>;
+            };
+            automatic: {
+                name: string;
+                spec: import("../../../base/lib/actions/input/builder").InputSpec<{
+                    size: number;
+                }, {
+                    size: number;
+                }>;
+            };
+            manual: {
+                name: string;
+                spec: import("../../../base/lib/actions/input/builder").InputSpec<{
+                    size: number;
+                }, {
+                    size: number;
+                }>;
+            };
+        }, "disabled" | "automatic" | "manual">;
+        blockfilters: {
+            blockfilterindex: boolean;
+            peerblockfilters: boolean;
+        };
+        bloomfilters: {
+            peerbloomfilters: boolean;
+        };
+    };
+}, {
+    mediasources: ("nextcloud" | "filebrowser")[];
+    testListUnion: {
+        union: {
+            selection: "lnd";
+            value: {
+                name: string;
+            };
+            other?: {} | undefined;
+        };
+    }[];
+    rpc: {
+        enable: boolean;
+        username: string;
+        password: string;
+        bio: string;
+        advanced: {
+            auth: string[];
+            serialversion: "segwit" | "non-segwit";
+            servertimeout: number;
+            threads: number;
+            workqueue: number;
+        };
+    };
+    'zmq-enabled': boolean;
+    txindex: boolean;
+    wallet: {
+        enable: boolean;
+        avoidpartialspends: boolean;
+        discardfee: number;
+    };
+    advanced: {
+        mempool: {
+            mempoolfullrbf: boolean;
+            persistmempool: boolean;
+            maxmempool: number;
+            mempoolexpiry: number;
+        };
+        peers: {
+            listen: boolean;
+            onlyconnect: boolean;
+            onlyonion: boolean;
+            addnode: {
+                hostname: string | null;
+                port: number | null;
+            }[];
+        };
+        dbcache: number | null;
+        pruning: import("../../../base/lib/actions/input/builder/variants").UnionResStaticValidatedAs<{
+            disabled: {
+                name: string;
+                spec: import("../../../base/lib/actions/input/builder").InputSpec<{}, {}>;
+            };
+            automatic: {
+                name: string;
+                spec: import("../../../base/lib/actions/input/builder").InputSpec<{
+                    size: number;
+                }, {
+                    size: number;
+                }>;
+            };
+            manual: {
+                name: string;
+                spec: import("../../../base/lib/actions/input/builder").InputSpec<{
+                    size: number;
+                }, {
+                    size: number;
+                }>;
+            };
+        }, "disabled" | "automatic" | "manual">;
+        blockfilters: {
+            blockfilterindex: boolean;
+            peerblockfilters: boolean;
+        };
+        bloomfilters: {
+            peerbloomfilters: boolean;
+        };
+    };
+}>;
+export type InputSpecSpec = typeof inputSpecSpec._TYPE;