@start9labs/start-sdk 0.4.0-beta.6 → 0.4.0-beta.60

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

@@ -1,16 +1,22 @@
-import { HealthCheckResult } from "../health/checkFns";
-import { Trigger } from "../trigger";
-import * as T from "../../../base/lib/types";
-import { ExecSpawnable, SubContainer } from "../util/SubContainer";
-import * as CP from "node:child_process";
-export { Daemon } from "./Daemon";
-export { CommandController } from "./CommandController";
-import { HealthDaemon } from "./HealthDaemon";
-import { Daemon } from "./Daemon";
-import { CommandController } from "./CommandController";
-import { HealthCheck } from "../health/HealthCheck";
+import { HealthCheckResult } from '../health/checkFns';
+import { Trigger } from '../trigger';
+import * as T from '../../../base/lib/types';
+import { SubContainer } from '../util/SubContainer';
+import * as CP from 'node:child_process';
+export { Daemon } from './Daemon';
+export { CommandController } from './CommandController';
+import { HealthDaemon } from './HealthDaemon';
+import { Daemon } from './Daemon';
+import { CommandController } from './CommandController';
+/** Promisified version of `child_process.exec` */
 export declare const cpExec: typeof CP.exec.__promisify__;
+/** Promisified version of `child_process.execFile` */
 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.
+ */
 export type Ready = {
     /** A human-readable display name for the health check. If null, the health check itself will be from the UI */
     display: string | null;
@@ -28,7 +34,7 @@ export type Ready = {
         })
     * ```
     */
-    fn: (spawnable: ExecSpawnable) => Promise<HealthCheckResult> | HealthCheckResult;
+    fn: () => Promise<HealthCheckResult> | HealthCheckResult;
     /**
      * A duration in milliseconds to treat a failing health check as "starting"
      *
@@ -37,31 +43,63 @@ export type Ready = {
     gracePeriod?: number;
     trigger?: Trigger;
 };
-type DaemonsParams<Manifest extends T.SDKManifest, Ids extends string, Command extends string, Id extends string> = {
-    /** The command line command to start the daemon */
+/**
+ * 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 = {
     command: T.CommandType;
-    /** Information about the subcontainer in which the daemon runs */
-    subcontainer: SubContainer<Manifest>;
-    env?: Record<string, string>;
-    ready: Ready;
-    /** An array of IDs of prior daemons whose successful initializations are required before this daemon will initialize */
-    requires: Exclude<Ids, Id>[];
-    sigtermTimeout?: number;
-    onStdout?: (chunk: Buffer | string | any) => void;
-    onStderr?: (chunk: Buffer | string | any) => void;
-};
-type ErrorDuplicateId<Id extends string> = `The id '${Id}' is already used`;
-export declare const runCommand: <Manifest extends T.SDKManifest>() => (effects: T.Effects, subcontainer: SubContainer<Manifest, T.Effects>, command: T.CommandType, options: {
     sigtermTimeout?: number;
     runAsInit?: boolean;
     env?: {
-        [variable: string]: string;
+        [variable in string]?: string;
     } | undefined;
     cwd?: string | undefined;
     user?: string | undefined;
-    onStdout?: ((chunk: Buffer | string | any) => void) | undefined;
-    onStderr?: ((chunk: Buffer | string | any) => void) | undefined;
-}) => Promise<CommandController<Manifest>>;
+    onStdout?: (chunk: Buffer | string | any) => void;
+    onStderr?: (chunk: Buffer | string | any) => void;
+};
+/**
+ * Options for running a daemon via an async function that may optionally return
+ * a command to execute in the subcontainer. The function receives an `AbortSignal`
+ * for cooperative cancellation.
+ */
+export type ExecFnOptions<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null> = {
+    fn: (subcontainer: C, abort: AbortSignal) => Promise<C extends null ? null : ExecCommandOptions | null>;
+    sigtermTimeout?: number;
+};
+/**
+ * The execution specification for a daemon: either an {@link ExecFnOptions} (async function)
+ * or an {@link ExecCommandOptions} (shell command, only valid when a subcontainer is provided).
+ */
+export type DaemonCommandType<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null> = ExecFnOptions<Manifest, C> | (C extends null ? never : ExecCommandOptions);
+type NewDaemonParams<Manifest extends T.SDKManifest, C extends SubContainer<Manifest> | null> = {
+    /** What to run as the daemon: either an async fn or a commandline command to run in the subcontainer */
+    exec: DaemonCommandType<Manifest, C>;
+    /** The subcontainer in which the daemon runs */
+    subcontainer: C;
+};
+type OptionalParamSync<T> = T | (() => T | null);
+type OptionalParamAsync<T> = () => Promise<T | null>;
+type AddDaemonParams<Manifest extends T.SDKManifest, Ids extends string, Id extends string, C extends SubContainer<Manifest> | null> = (NewDaemonParams<Manifest, C> | {
+    daemon: Daemon<Manifest>;
+}) & {
+    ready: Ready;
+    /** An array of IDs of prior daemons whose successful initializations are required before this daemon will initialize */
+    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 */
+    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 */
+    requires: Exclude<Ids, Id>[];
+};
+type ErrorDuplicateId<Id extends string> = `The id '${Id}' is already used`;
+export declare const runCommand: <Manifest extends T.SDKManifest>() => (effects: T.Effects, subcontainer: SubContainer<Manifest, T.Effects>, exec: DaemonCommandType<Manifest, SubContainer<Manifest, T.Effects>>) => Promise<CommandController<Manifest, SubContainer<Manifest, T.Effects>>>;
 /**
  * A class for defining and controlling the service daemons
 ```ts
@@ -87,11 +125,8 @@ Daemons.of({
  */
 export declare class Daemons<Manifest extends T.SDKManifest, Ids extends string> implements T.DaemonBuildable {
     readonly effects: T.Effects;
-    readonly started: (onTerm: () => PromiseLike<void>) => PromiseLike<null>;
-    readonly daemons: Promise<Daemon<Manifest>>[];
     readonly ids: Ids[];
     readonly healthDaemons: HealthDaemon<Manifest>[];
-    readonly healthChecks: HealthCheck[];
     private constructor();
     /**
      * Returns an empty new Daemons class with the provided inputSpec.
@@ -100,21 +135,59 @@ export declare class Daemons<Manifest extends T.SDKManifest, Ids extends string>
      *
      * Daemons run in the order they are defined, with latter daemons being capable of
      * depending on prior daemons
-     * @param options
+     *
+     * @param effects
+     *
+     * @param started
      * @returns
      */
     static of<Manifest extends T.SDKManifest>(options: {
         effects: T.Effects;
-        started: (onTerm: () => PromiseLike<void>) => PromiseLike<null>;
-        healthChecks: HealthCheck[];
     }): Daemons<Manifest, never>;
+    private addDaemonImpl;
     /**
      * Returns the complete list of daemons, including the one defined here
      * @param id
-     * @param newDaemon
-     * @returns
+     * @param options
+     * @returns a new Daemons object
+     */
+    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
+     */
+    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
+     */
+    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
+     */
+    runUntilSuccess(timeout: number | null): Promise<null>;
+    /**
+     * Gracefully terminate all daemons in reverse dependency order.
+     *
+     * Daemons with no remaining dependents are shut down first, proceeding
+     * until all daemons have been terminated. Falls back to a bulk shutdown
+     * if a dependency cycle is detected.
      */
-    addDaemon<Id extends string, Command extends string>(id: "" extends Id ? never : ErrorDuplicateId<Id> extends Id ? never : Id extends Ids ? ErrorDuplicateId<Id> : Id, options: DaemonsParams<Manifest, Ids, Command, Id>): Daemons<Manifest, Ids | Id>;
     term(): Promise<void>;
+    /**
+     * Start all registered daemons and their health checks.
+     * @returns This `Daemons` instance, now running
+     */
     build(): Promise<this>;
 }

package/package/lib/mainFn/Daemons.js

@@ -43,7 +43,10 @@ Object.defineProperty(exports, "CommandController", { enumerable: true, get: fun
 const HealthDaemon_1 = require("./HealthDaemon");
 const Daemon_2 = require("./Daemon");
 const CommandController_2 = require("./CommandController");
+const Oneshot_1 = require("./Oneshot");
+/** Promisified version of `child_process.exec` */
 exports.cpExec = (0, node_util_1.promisify)(CP.exec);
+/** Promisified version of `child_process.execFile` */
 exports.cpExecFile = (0, node_util_1.promisify)(CP.execFile);
 const runCommand = () => CommandController_2.CommandController.of();
 exports.runCommand = runCommand;
@@ -71,13 +74,10 @@ Daemons.of({
 ```
  */
 class Daemons {
-    constructor(effects, started, daemons, ids, healthDaemons, healthChecks) {
+    constructor(effects, ids, healthDaemons) {
         this.effects = effects;
-        this.started = started;
-        this.daemons = daemons;
         this.ids = ids;
         this.healthDaemons = healthDaemons;
-        this.healthChecks = healthChecks;
     }
     /**
      * Returns an empty new Daemons class with the provided inputSpec.
@@ -86,55 +86,155 @@ class Daemons {
      *
      * Daemons run in the order they are defined, with latter daemons being capable of
      * depending on prior daemons
-     * @param options
+     *
+     * @param effects
+     *
+     * @param started
      * @returns
      */
     static of(options) {
-        return new Daemons(options.effects, options.started, [], [], [], options.healthChecks);
+        return new Daemons(options.effects, [], []);
     }
-    /**
-     * Returns the complete list of daemons, including the one defined here
-     * @param id
-     * @param newDaemon
-     * @returns
-     */
-    addDaemon(
-    // prettier-ignore
-    id, options) {
-        const daemonIndex = this.daemons.length;
-        const daemon = Daemon_2.Daemon.of()(this.effects, options.subcontainer, options.command, {
-            ...options,
-        });
-        const healthDaemon = new HealthDaemon_1.HealthDaemon(daemon, daemonIndex, options.requires
+    addDaemonImpl(id, daemon, requires, ready) {
+        const healthDaemon = new HealthDaemon_1.HealthDaemon(daemon, requires
             .map((x) => this.ids.indexOf(x))
             .filter((x) => x >= 0)
-            .map((id) => this.healthDaemons[id]), id, this.ids, options.ready, this.effects, options.sigtermTimeout);
-        const daemons = this.daemons.concat(daemon);
+            .map((id) => this.healthDaemons[id]), id, ready, this.effects);
         const ids = [...this.ids, id];
         const healthDaemons = [...this.healthDaemons, healthDaemon];
-        return new Daemons(this.effects, this.started, daemons, ids, healthDaemons, this.healthChecks);
+        return new Daemons(this.effects, ids, healthDaemons);
     }
-    async term() {
-        try {
-            this.healthChecks.forEach((health) => health.stop());
-            for (let result of await Promise.allSettled(this.healthDaemons.map((x) => x.term({ timeout: x.sigtermTimeout })))) {
-                if (result.status === "rejected") {
-                    console.error(result.reason);
-                }
+    addDaemon(id, options) {
+        const prev = this;
+        const res = (options) => {
+            if (!options)
+                return prev;
+            const daemon = 'daemon' in options
+                ? options.daemon
+                : Daemon_2.Daemon.of()(this.effects, options.subcontainer, options.exec);
+            return prev.addDaemonImpl(id, daemon, options.requires, options.ready);
+        };
+        if (options instanceof Function) {
+            const opts = options();
+            if (opts instanceof Promise) {
+                return opts.then(res);
+            }
+            return res(opts);
+        }
+        return res(options);
+    }
+    addOneshot(id, options) {
+        const prev = this;
+        const res = (options) => {
+            if (!options)
+                return prev;
+            const daemon = Oneshot_1.Oneshot.of()(this.effects, options.subcontainer, options.exec);
+            return prev.addDaemonImpl(id, daemon, options.requires, HealthDaemon_1.EXIT_SUCCESS);
+        };
+        if (options instanceof Function) {
+            const opts = options();
+            if (opts instanceof Promise) {
+                return opts.then(res);
             }
+            return res(opts);
+        }
+        return res(options);
+    }
+    addHealthCheck(id, options) {
+        const prev = this;
+        const res = (options) => {
+            if (!options)
+                return prev;
+            return prev.addDaemonImpl(id, null, options.requires, options.ready);
+        };
+        if (options instanceof Function) {
+            const opts = options();
+            if (opts instanceof Promise) {
+                return opts.then(res);
+            }
+            return res(opts);
+        }
+        return res(options);
+    }
+    /**
+     * Runs the entire system until all daemons have returned `ready`.
+     * @param id
+     * @param options
+     * @returns a new Daemons object
+     */
+    async runUntilSuccess(timeout) {
+        let resolve = (_) => { };
+        const res = new Promise((res, rej) => {
+            resolve = res;
+            if (timeout)
+                setTimeout(() => {
+                    const notReady = this.healthDaemons
+                        .filter((d) => !d.isReady)
+                        .map((d) => d.id);
+                    rej(new Error(`Timed out waiting for ${notReady}`));
+                }, timeout);
+        });
+        const daemon = Oneshot_1.Oneshot.of()(this.effects, null, {
+            fn: async () => {
+                resolve();
+                return null;
+            },
+        });
+        const healthDaemon = new HealthDaemon_1.HealthDaemon(daemon, [...this.healthDaemons], '__RUN_UNTIL_SUCCESS', 'EXIT_SUCCESS', this.effects);
+        const daemons = await new Daemons(this.effects, this.ids, [
+            ...this.healthDaemons,
+            healthDaemon,
+        ]).build();
+        try {
+            await res;
         }
         finally {
-            this.effects.setMainStatus({ status: "stopped" });
+            await daemons.term();
+        }
+        return null;
+    }
+    /**
+     * Gracefully terminate all daemons in reverse dependency order.
+     *
+     * Daemons with no remaining dependents are shut down first, proceeding
+     * until all daemons have been terminated. Falls back to a bulk shutdown
+     * if a dependency cycle is detected.
+     */
+    async term() {
+        const remaining = new Set(this.healthDaemons);
+        while (remaining.size > 0) {
+            // Find daemons with no remaining dependents
+            const canShutdown = [...remaining].filter((daemon) => ![...remaining].some((other) => other.dependencies.some((dep) => dep.id === daemon.id)));
+            if (canShutdown.length === 0) {
+                // Dependency cycle that should not happen, just shutdown remaining daemons
+                console.warn('Dependency cycle detected, shutting down remaining daemons');
+                canShutdown.push(...[...remaining].reverse());
+            }
+            // remove from remaining set
+            canShutdown.forEach((daemon) => remaining.delete(daemon));
+            // Shutdown daemons with no remaining dependents concurrently
+            await Promise.allSettled(canShutdown.map(async (daemon) => {
+                try {
+                    console.debug(`Terminating daemon ${daemon.id}`);
+                    const destroySubcontainer = daemon.daemon
+                        ? ![...remaining].some((d) => d.daemon?.sharesSubcontainerWith(daemon.daemon))
+                        : false;
+                    await daemon.term({ destroySubcontainer });
+                }
+                catch (e) {
+                    console.error(e);
+                }
+            }));
         }
     }
+    /**
+     * Start all registered daemons and their health checks.
+     * @returns This `Daemons` instance, now running
+     */
     async build() {
         for (const daemon of this.healthDaemons) {
             await daemon.updateStatus();
         }
-        for (const health of this.healthChecks) {
-            health.start();
-        }
-        this.started(() => this.term());
         return this;
     }
 }

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/mainFn/HealthDaemon.d.ts

@@ -1,7 +1,8 @@
-import { HealthCheckResult } from "../health/checkFns";
-import { Ready } from "./Daemons";
-import { Daemon } from "./Daemon";
-import { Effects, SDKManifest } from "../../../base/lib/types";
+import { HealthCheckResult } from '../health/checkFns';
+import { Ready } from './Daemons';
+import { Daemon } from './Daemon';
+import { Effects, SDKManifest } from '../../../base/lib/types';
+export declare const EXIT_SUCCESS: "EXIT_SUCCESS";
 /**
  * Wanted a structure that deals with controlling daemons by their health status
  * States:
@@ -10,25 +11,24 @@ import { Effects, SDKManifest } from "../../../base/lib/types";
  *
  */
 export declare class HealthDaemon<Manifest extends SDKManifest> {
-    private readonly daemon;
-    readonly daemonIndex: number;
-    private readonly dependencies;
+    readonly daemon: Daemon<Manifest> | null;
+    readonly dependencies: HealthDaemon<Manifest>[];
     readonly id: string;
-    readonly ids: string[];
-    readonly ready: Ready;
+    readonly ready: Ready | typeof EXIT_SUCCESS;
     readonly effects: Effects;
-    readonly sigtermTimeout: number;
     private _health;
     private healthWatchers;
     private running;
     private started?;
     private resolveReady;
+    private resolvedReady;
     private readyPromise;
-    constructor(daemon: Promise<Daemon<Manifest>>, daemonIndex: number, dependencies: HealthDaemon<Manifest>[], id: string, ids: string[], ready: Ready, effects: Effects, sigtermTimeout?: number);
+    constructor(daemon: Daemon<Manifest> | null, dependencies: HealthDaemon<Manifest>[], id: string, ready: Ready | typeof EXIT_SUCCESS, effects: Effects);
     /** Run after we want to do cleanup */
     term(termOptions?: {
         signal?: NodeJS.Signals | undefined;
         timeout?: number | undefined;
+        destroySubcontainer?: boolean;
     }): Promise<void>;
     /** Want to add another notifier that the health might have changed */
     addWatcher(watcher: () => unknown): void;
@@ -38,6 +38,7 @@ export declare class HealthDaemon<Manifest extends SDKManifest> {
     private turnOffHealthCheck;
     private setupHealthCheck;
     onReady(): Promise<void>;
+    get isReady(): boolean;
     private setHealth;
     updateStatus(): Promise<void>;
 }