@start9labs/start-sdk 0.3.6-alpha.10

package/package/lib/health/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./checkFns");
+//# sourceMappingURL=index.js.map

package/package/lib/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../package/lib/health/index.ts"],"names":[],"mappings":";;AAAA,sBAAmB"}

package/package/lib/index.d.ts

@@ -0,0 +1,22 @@
+import { S9pk, Version, VersionRange, ExtendedVersion, inputSpec, ISB, IST, types, T, matches, utils } from "../../base/lib";
+export { S9pk, Version, VersionRange, ExtendedVersion, inputSpec, ISB, IST, types, T, matches, utils, };
+export { Daemons } from "./mainFn/Daemons";
+export { SubContainer } from "./util/SubContainer";
+export { StartSdk } from "./StartSdk";
+export { setupManifest } from "./manifest/setupManifest";
+export { FileHelper } from "./util/fileHelper";
+export { setupExposeStore } from "./store/setupExposeStore";
+export { pathBuilder } from "../../base/lib/util/PathBuilder";
+export * as actions from "../../base/lib/actions";
+export * as backup from "./backup";
+export * as daemons from "./mainFn/Daemons";
+export * as health from "./health";
+export * as healthFns from "./health/checkFns";
+export * as inits from "./inits";
+export * as mainFn from "./mainFn";
+export * as toml from "@iarna/toml";
+export * as yaml from "yaml";
+export * as startSdk from "./StartSdk";
+export * as YAML from "yaml";
+export * as TOML from "@iarna/toml";
+export * from "./version";

package/package/lib/index.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOML = exports.YAML = exports.startSdk = exports.yaml = exports.toml = exports.mainFn = exports.inits = exports.healthFns = exports.health = exports.daemons = exports.backup = exports.actions = exports.pathBuilder = exports.setupExposeStore = exports.FileHelper = exports.setupManifest = exports.StartSdk = exports.SubContainer = exports.Daemons = exports.utils = exports.matches = exports.T = exports.types = exports.IST = exports.ISB = exports.inputSpec = exports.ExtendedVersion = exports.VersionRange = exports.Version = exports.S9pk = void 0;
+const lib_1 = require("../../base/lib");
+Object.defineProperty(exports, "S9pk", { enumerable: true, get: function () { return lib_1.S9pk; } });
+Object.defineProperty(exports, "Version", { enumerable: true, get: function () { return lib_1.Version; } });
+Object.defineProperty(exports, "VersionRange", { enumerable: true, get: function () { return lib_1.VersionRange; } });
+Object.defineProperty(exports, "ExtendedVersion", { enumerable: true, get: function () { return lib_1.ExtendedVersion; } });
+Object.defineProperty(exports, "inputSpec", { enumerable: true, get: function () { return lib_1.inputSpec; } });
+Object.defineProperty(exports, "ISB", { enumerable: true, get: function () { return lib_1.ISB; } });
+Object.defineProperty(exports, "IST", { enumerable: true, get: function () { return lib_1.IST; } });
+Object.defineProperty(exports, "types", { enumerable: true, get: function () { return lib_1.types; } });
+Object.defineProperty(exports, "T", { enumerable: true, get: function () { return lib_1.T; } });
+Object.defineProperty(exports, "matches", { enumerable: true, get: function () { return lib_1.matches; } });
+Object.defineProperty(exports, "utils", { enumerable: true, get: function () { return lib_1.utils; } });
+var Daemons_1 = require("./mainFn/Daemons");
+Object.defineProperty(exports, "Daemons", { enumerable: true, get: function () { return Daemons_1.Daemons; } });
+var SubContainer_1 = require("./util/SubContainer");
+Object.defineProperty(exports, "SubContainer", { enumerable: true, get: function () { return SubContainer_1.SubContainer; } });
+var StartSdk_1 = require("./StartSdk");
+Object.defineProperty(exports, "StartSdk", { enumerable: true, get: function () { return StartSdk_1.StartSdk; } });
+var setupManifest_1 = require("./manifest/setupManifest");
+Object.defineProperty(exports, "setupManifest", { enumerable: true, get: function () { return setupManifest_1.setupManifest; } });
+var fileHelper_1 = require("./util/fileHelper");
+Object.defineProperty(exports, "FileHelper", { enumerable: true, get: function () { return fileHelper_1.FileHelper; } });
+var setupExposeStore_1 = require("./store/setupExposeStore");
+Object.defineProperty(exports, "setupExposeStore", { enumerable: true, get: function () { return setupExposeStore_1.setupExposeStore; } });
+var PathBuilder_1 = require("../../base/lib/util/PathBuilder");
+Object.defineProperty(exports, "pathBuilder", { enumerable: true, get: function () { return PathBuilder_1.pathBuilder; } });
+exports.actions = __importStar(require("../../base/lib/actions"));
+exports.backup = __importStar(require("./backup"));
+exports.daemons = __importStar(require("./mainFn/Daemons"));
+exports.health = __importStar(require("./health"));
+exports.healthFns = __importStar(require("./health/checkFns"));
+exports.inits = __importStar(require("./inits"));
+exports.mainFn = __importStar(require("./mainFn"));
+exports.toml = __importStar(require("@iarna/toml"));
+exports.yaml = __importStar(require("yaml"));
+exports.startSdk = __importStar(require("./StartSdk"));
+exports.YAML = __importStar(require("yaml"));
+exports.TOML = __importStar(require("@iarna/toml"));
+__exportStar(require("./version"), exports);
+//# sourceMappingURL=index.js.map

package/package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../package/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wCAYuB;AAGrB,qFAdA,UAAI,OAcA;AACJ,wFAdA,aAAO,OAcA;AACP,6FAdA,kBAAY,OAcA;AACZ,gGAdA,qBAAe,OAcA;AACf,0FAdA,eAAS,OAcA;AACT,oFAdA,SAAG,OAcA;AACH,oFAdA,SAAG,OAcA;AACH,sFAdA,WAAK,OAcA;AACL,kFAdA,OAAC,OAcA;AACD,wFAdA,aAAO,OAcA;AACP,sFAdA,WAAK,OAcA;AAEP,4CAA0C;AAAjC,kGAAA,OAAO,OAAA;AAChB,oDAAkD;AAAzC,4GAAA,YAAY,OAAA;AACrB,uCAAqC;AAA5B,oGAAA,QAAQ,OAAA;AACjB,0DAAwD;AAA/C,8GAAA,aAAa,OAAA;AACtB,gDAA8C;AAArC,wGAAA,UAAU,OAAA;AACnB,6DAA2D;AAAlD,oHAAA,gBAAgB,OAAA;AACzB,+DAA6D;AAApD,0GAAA,WAAW,OAAA;AAEpB,kEAAiD;AACjD,mDAAkC;AAClC,4DAA2C;AAC3C,mDAAkC;AAClC,+DAA8C;AAC9C,iDAAgC;AAChC,mDAAkC;AAClC,oDAAmC;AACnC,6CAA4B;AAC5B,uDAAsC;AACtC,6CAA4B;AAC5B,oDAAmC;AACnC,4CAAyB"}

package/package/lib/inits/index.d.ts

@@ -0,0 +1,3 @@
+import "./setupInit";
+import "./setupUninstall";
+import "./setupInstall";

package/package/lib/inits/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./setupInit");
+require("./setupUninstall");
+require("./setupInstall");
+//# sourceMappingURL=index.js.map

package/package/lib/inits/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../package/lib/inits/index.ts"],"names":[],"mappings":";;AAAA,uBAAoB;AACpB,4BAAyB;AACzB,0BAAuB"}

package/package/lib/inits/setupInit.d.ts

@@ -0,0 +1,14 @@
+import { Actions } from "../../../base/lib/actions/setupActions";
+import { UpdateServiceInterfaces } from "../../../base/lib/interfaces/setupInterfaces";
+import { ExposedStorePaths } from "../../../base/lib/types";
+import * as T from "../../../base/lib/types";
+import { VersionGraph } from "../version/VersionGraph";
+import { Install } from "./setupInstall";
+import { Uninstall } from "./setupUninstall";
+export declare function setupInit<Manifest extends T.Manifest, Store>(versions: VersionGraph<Manifest["version"]>, install: Install<Manifest, Store>, uninstall: Uninstall<Manifest, Store>, setServiceInterfaces: UpdateServiceInterfaces<any>, setDependencies: (options: {
+    effects: T.Effects;
+}) => Promise<null | void | undefined>, actions: Actions<Store, any>, exposedStore: ExposedStorePaths): {
+    packageInit: T.ExpectedExports.packageInit;
+    packageUninit: T.ExpectedExports.packageUninit;
+    containerInit: T.ExpectedExports.containerInit;
+};

package/package/lib/inits/setupInit.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupInit = void 0;
+const exver_1 = require("../../../base/lib/exver");
+function setupInit(versions, install, uninstall, setServiceInterfaces, setDependencies, actions, exposedStore) {
+    return {
+        packageInit: async (opts) => {
+            const prev = await opts.effects.getDataVersion();
+            if (prev) {
+                await versions.migrate({
+                    effects: opts.effects,
+                    from: exver_1.ExtendedVersion.parse(prev),
+                    to: versions.currentVersion(),
+                });
+            }
+            else {
+                await install.install(opts);
+                await opts.effects.setDataVersion({
+                    version: versions.current.options.version,
+                });
+            }
+        },
+        packageUninit: async (opts) => {
+            if (opts.nextVersion) {
+                const prev = await opts.effects.getDataVersion();
+                if (prev) {
+                    await versions.migrate({
+                        effects: opts.effects,
+                        from: exver_1.ExtendedVersion.parse(prev),
+                        to: exver_1.ExtendedVersion.parse(opts.nextVersion),
+                    });
+                }
+            }
+            else {
+                await uninstall.uninstall(opts);
+            }
+        },
+        containerInit: async (opts) => {
+            await setServiceInterfaces({
+                ...opts,
+            });
+            await actions.update({ effects: opts.effects });
+            await opts.effects.exposeForDependents({ paths: exposedStore });
+            await setDependencies({ effects: opts.effects });
+        },
+    };
+}
+exports.setupInit = setupInit;
+//# sourceMappingURL=setupInit.js.map

package/package/lib/inits/setupInit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupInit.js","sourceRoot":"","sources":["../../../../package/lib/inits/setupInit.ts"],"names":[],"mappings":";;;AACA,mDAAyD;AAQzD,SAAgB,SAAS,CACvB,QAA2C,EAC3C,OAAiC,EACjC,SAAqC,EACrC,oBAAkD,EAClD,eAEsC,EACtC,OAA4B,EAC5B,YAA+B;IAM/B,OAAO;QACL,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAA;YAChD,IAAI,IAAI,EAAE;gBACR,MAAM,QAAQ,CAAC,OAAO,CAAC;oBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,IAAI,EAAE,uBAAe,CAAC,KAAK,CAAC,IAAI,CAAC;oBACjC,EAAE,EAAE,QAAQ,CAAC,cAAc,EAAE;iBAC9B,CAAC,CAAA;aACH;iBAAM;gBACL,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBAC3B,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;oBAChC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO;iBAC1C,CAAC,CAAA;aACH;QACH,CAAC;QACD,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC5B,IAAI,IAAI,CAAC,WAAW,EAAE;gBACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAA;gBAChD,IAAI,IAAI,EAAE;oBACR,MAAM,QAAQ,CAAC,OAAO,CAAC;wBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,IAAI,EAAE,uBAAe,CAAC,KAAK,CAAC,IAAI,CAAC;wBACjC,EAAE,EAAE,uBAAe,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;qBAC5C,CAAC,CAAA;iBACH;aACF;iBAAM;gBACL,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;aAChC;QACH,CAAC;QACD,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC5B,MAAM,oBAAoB,CAAC;gBACzB,GAAG,IAAI;aACR,CAAC,CAAA;YACF,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;YAC/C,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAA;YAC/D,MAAM,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;QAClD,CAAC;KACF,CAAA;AACH,CAAC;AAtDD,8BAsDC"}

package/package/lib/inits/setupInstall.d.ts

@@ -0,0 +1,11 @@
+import * as T from "../../../base/lib/types";
+export type InstallFn<Manifest extends T.Manifest, Store> = (opts: {
+    effects: T.Effects;
+}) => Promise<null | void | undefined>;
+export declare class Install<Manifest extends T.Manifest, Store> {
+    readonly fn: InstallFn<Manifest, Store>;
+    private constructor();
+    static of<Manifest extends T.Manifest, Store>(fn: InstallFn<Manifest, Store>): Install<Manifest, Store>;
+    install({ effects }: Parameters<T.ExpectedExports.packageInit>[0]): Promise<void>;
+}
+export declare function setupInstall<Manifest extends T.Manifest, Store>(fn: InstallFn<Manifest, Store>): Install<Manifest, Store>;

package/package/lib/inits/setupInstall.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupInstall = exports.Install = void 0;
+class Install {
+    constructor(fn) {
+        this.fn = fn;
+    }
+    static of(fn) {
+        return new Install(fn);
+    }
+    async install({ effects }) {
+        await this.fn({
+            effects,
+        });
+    }
+}
+exports.Install = Install;
+function setupInstall(fn) {
+    return Install.of(fn);
+}
+exports.setupInstall = setupInstall;
+//# sourceMappingURL=setupInstall.js.map

package/package/lib/inits/setupInstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupInstall.js","sourceRoot":"","sources":["../../../../package/lib/inits/setupInstall.ts"],"names":[],"mappings":";;;AAKA,MAAa,OAAO;IAClB,YAA6B,EAA8B;QAA9B,OAAE,GAAF,EAAE,CAA4B;IAAG,CAAC;IAC/D,MAAM,CAAC,EAAE,CACP,EAA8B;QAE9B,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAAA;IACxB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAgD;QACrE,MAAM,IAAI,CAAC,EAAE,CAAC;YACZ,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;CACF;AAbD,0BAaC;AAED,SAAgB,YAAY,CAC1B,EAA8B;IAE9B,OAAO,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACvB,CAAC;AAJD,oCAIC"}

package/package/lib/inits/setupUninstall.d.ts

@@ -0,0 +1,11 @@
+import * as T from "../../../base/lib/types";
+export type UninstallFn<Manifest extends T.Manifest, Store> = (opts: {
+    effects: T.Effects;
+}) => Promise<null | void | undefined>;
+export declare class Uninstall<Manifest extends T.Manifest, Store> {
+    readonly fn: UninstallFn<Manifest, Store>;
+    private constructor();
+    static of<Manifest extends T.Manifest, Store>(fn: UninstallFn<Manifest, Store>): Uninstall<Manifest, Store>;
+    uninstall({ effects, nextVersion, }: Parameters<T.ExpectedExports.packageUninit>[0]): Promise<void>;
+}
+export declare function setupUninstall<Manifest extends T.Manifest, Store>(fn: UninstallFn<Manifest, Store>): Uninstall<Manifest, Store>;

package/package/lib/inits/setupUninstall.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupUninstall = exports.Uninstall = void 0;
+class Uninstall {
+    constructor(fn) {
+        this.fn = fn;
+    }
+    static of(fn) {
+        return new Uninstall(fn);
+    }
+    async uninstall({ effects, nextVersion, }) {
+        if (!nextVersion)
+            await this.fn({
+                effects,
+            });
+    }
+}
+exports.Uninstall = Uninstall;
+function setupUninstall(fn) {
+    return Uninstall.of(fn);
+}
+exports.setupUninstall = setupUninstall;
+//# sourceMappingURL=setupUninstall.js.map

package/package/lib/inits/setupUninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupUninstall.js","sourceRoot":"","sources":["../../../../package/lib/inits/setupUninstall.ts"],"names":[],"mappings":";;;AAKA,MAAa,SAAS;IACpB,YAA6B,EAAgC;QAAhC,OAAE,GAAF,EAAE,CAA8B;IAAG,CAAC;IACjE,MAAM,CAAC,EAAE,CACP,EAAgC;QAEhC,OAAO,IAAI,SAAS,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EACd,OAAO,EACP,WAAW,GACoC;QAC/C,IAAI,CAAC,WAAW;YACd,MAAM,IAAI,CAAC,EAAE,CAAC;gBACZ,OAAO;aACR,CAAC,CAAA;IACN,CAAC;CACF;AAjBD,8BAiBC;AAED,SAAgB,cAAc,CAC5B,EAAgC;IAEhC,OAAO,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;AACzB,CAAC;AAJD,wCAIC"}

package/package/lib/mainFn/CommandController.d.ts

@@ -0,0 +1,39 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import * as T from "../../../base/lib/types";
+import { MountOptions, SubContainerHandle, SubContainer } from "../util/SubContainer";
+export declare class CommandController {
+    readonly runningAnswer: Promise<unknown>;
+    private state;
+    private readonly subcontainer;
+    private process;
+    readonly sigtermTimeout: number;
+    private constructor();
+    static of<Manifest extends T.Manifest>(): <A extends string>(effects: T.Effects, subcontainer: {
+        id: keyof Manifest["images"] & T.ImageId;
+        sharedRun?: boolean;
+    } | SubContainer, command: T.CommandType, options: {
+        subcontainerName?: string | undefined;
+        sigtermTimeout?: number | undefined;
+        mounts?: {
+            path: string;
+            options: MountOptions;
+        }[] | undefined;
+        runAsInit?: boolean | undefined;
+        env?: {
+            [variable: string]: string;
+        } | undefined;
+        cwd?: string | undefined;
+        user?: string | undefined;
+        onStdout?: ((x: Buffer) => null) | undefined;
+        onStderr?: ((x: Buffer) => null) | undefined;
+    }) => Promise<CommandController>;
+    get subContainerHandle(): SubContainerHandle;
+    wait({ timeout }?: {
+        timeout?: number | undefined;
+    }): Promise<unknown>;
+    term({ signal, timeout }?: {
+        signal?: NodeJS.Signals | undefined;
+        timeout?: number | undefined;
+    }): Promise<void>;
+}

package/package/lib/mainFn/CommandController.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandController = void 0;
+const _1 = require(".");
+const types_1 = require("../../../base/lib/types");
+const SubContainer_1 = require("../util/SubContainer");
+const util_1 = require("../util");
+class CommandController {
+    constructor(runningAnswer, state, subcontainer, process, sigtermTimeout = _1.DEFAULT_SIGTERM_TIMEOUT) {
+        this.runningAnswer = runningAnswer;
+        this.state = state;
+        this.subcontainer = subcontainer;
+        this.process = process;
+        this.sigtermTimeout = sigtermTimeout;
+    }
+    static of() {
+        return async (effects, subcontainer, command, options) => {
+            const commands = (0, util_1.splitCommand)(command);
+            const subc = subcontainer instanceof SubContainer_1.SubContainer
+                ? subcontainer
+                : await (async () => {
+                    const subc = await SubContainer_1.SubContainer.of(effects, subcontainer, (options === null || options === void 0 ? void 0 : options.subcontainerName) || commands.join(" "));
+                    for (let mount of options.mounts || []) {
+                        await subc.mount(mount.options, mount.path);
+                    }
+                    return subc;
+                })();
+            let childProcess;
+            if (options.runAsInit) {
+                childProcess = await subc.launch(commands, {
+                    env: options.env,
+                });
+            }
+            else {
+                childProcess = await subc.spawn(commands, {
+                    env: options.env,
+                });
+            }
+            const state = { exited: false };
+            const answer = new Promise((resolve, reject) => {
+                childProcess.on("exit", (code) => {
+                    state.exited = true;
+                    if (code === 0 ||
+                        code === 143 ||
+                        (code === null && childProcess.signalCode == "SIGTERM")) {
+                        return resolve(null);
+                    }
+                    if (code) {
+                        return reject(new Error(`${commands[0]} exited with code ${code}`));
+                    }
+                    else {
+                        return reject(new Error(`${commands[0]} exited with signal ${childProcess.signalCode}`));
+                    }
+                });
+            });
+            return new CommandController(answer, state, subc, childProcess, options.sigtermTimeout);
+        };
+    }
+    get subContainerHandle() {
+        return new SubContainer_1.SubContainerHandle(this.subcontainer);
+    }
+    async wait({ timeout = types_1.NO_TIMEOUT } = {}) {
+        var _a, _b;
+        if (timeout > 0)
+            setTimeout(() => {
+                this.term();
+            }, timeout);
+        try {
+            return await this.runningAnswer;
+        }
+        finally {
+            if (!this.state.exited) {
+                this.process.kill("SIGKILL");
+            }
+            await ((_b = (_a = this.subcontainer).destroy) === null || _b === void 0 ? void 0 : _b.call(_a).catch((_) => { }));
+        }
+    }
+    async term({ signal = types_1.SIGTERM, timeout = this.sigtermTimeout } = {}) {
+        var _a, _b;
+        try {
+            if (!this.state.exited) {
+                if (signal !== "SIGKILL") {
+                    setTimeout(() => {
+                        if (!this.state.exited)
+                            this.process.kill("SIGKILL");
+                    }, timeout);
+                }
+                if (!this.process.kill(signal)) {
+                    console.error(`failed to send signal ${signal} to pid ${this.process.pid}`);
+                }
+            }
+            await this.runningAnswer;
+        }
+        finally {
+            await ((_b = (_a = this.subcontainer).destroy) === null || _b === void 0 ? void 0 : _b.call(_a));
+        }
+    }
+}
+exports.CommandController = CommandController;
+//# sourceMappingURL=CommandController.js.map

package/package/lib/mainFn/CommandController.js.map

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

package/package/lib/mainFn/Daemon.d.ts

@@ -0,0 +1,43 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import * as T from "../../../base/lib/types";
+import { ExecSpawnable, MountOptions, SubContainer } from "../util/SubContainer";
+import { CommandController } from "./CommandController";
+/**
+ * This is a wrapper around CommandController that has a state of off, where the command shouldn't be running
+ * and the others state of running, where it will keep a living running command
+ */
+export declare class Daemon {
+    private startCommand;
+    private commandController;
+    private shouldBeRunning;
+    constructor(startCommand: () => Promise<CommandController>);
+    get subContainerHandle(): undefined | ExecSpawnable;
+    static of<Manifest extends T.Manifest>(): <A extends string>(effects: T.Effects, subcontainer: {
+        id: keyof Manifest["images"] & T.ImageId;
+        sharedRun?: boolean;
+    } | SubContainer, command: T.CommandType, options: {
+        subcontainerName?: string | undefined;
+        mounts?: {
+            path: string;
+            options: MountOptions;
+        }[] | undefined;
+        env?: {
+            [variable: string]: string;
+        } | undefined;
+        cwd?: string | undefined;
+        user?: string | undefined;
+        onStdout?: ((x: Buffer) => null) | undefined;
+        onStderr?: ((x: Buffer) => null) | undefined;
+        sigtermTimeout?: number | undefined;
+    }) => Promise<Daemon>;
+    start(): Promise<void>;
+    term(termOptions?: {
+        signal?: NodeJS.Signals | undefined;
+        timeout?: number | undefined;
+    }): Promise<void>;
+    stop(termOptions?: {
+        signal?: NodeJS.Signals | undefined;
+        timeout?: number | undefined;
+    }): Promise<void>;
+}

package/package/lib/mainFn/Daemon.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Daemon = void 0;
+const asError_1 = require("../../../base/lib/util/asError");
+const CommandController_1 = require("./CommandController");
+const TIMEOUT_INCREMENT_MS = 1000;
+const MAX_TIMEOUT_MS = 30000;
+/**
+ * This is a wrapper around CommandController that has a state of off, where the command shouldn't be running
+ * and the others state of running, where it will keep a living running command
+ */
+class Daemon {
+    constructor(startCommand) {
+        this.startCommand = startCommand;
+        this.commandController = null;
+        this.shouldBeRunning = false;
+    }
+    get subContainerHandle() {
+        var _a;
+        return (_a = this.commandController) === null || _a === void 0 ? void 0 : _a.subContainerHandle;
+    }
+    static of() {
+        return async (effects, subcontainer, command, options) => {
+            const startCommand = () => CommandController_1.CommandController.of()(effects, subcontainer, command, options);
+            return new Daemon(startCommand);
+        };
+    }
+    async start() {
+        if (this.commandController) {
+            return;
+        }
+        this.shouldBeRunning = true;
+        let timeoutCounter = 0;
+        new Promise(async () => {
+            while (this.shouldBeRunning) {
+                this.commandController = await this.startCommand();
+                await this.commandController.wait().catch((err) => console.error(err));
+                await new Promise((resolve) => setTimeout(resolve, timeoutCounter));
+                timeoutCounter += TIMEOUT_INCREMENT_MS;
+                timeoutCounter = Math.max(MAX_TIMEOUT_MS, timeoutCounter);
+            }
+        }).catch((err) => {
+            console.error((0, asError_1.asError)(err));
+        });
+    }
+    async term(termOptions) {
+        return this.stop(termOptions);
+    }
+    async stop(termOptions) {
+        var _a;
+        this.shouldBeRunning = false;
+        await ((_a = this.commandController) === null || _a === void 0 ? void 0 : _a.term({ ...termOptions }).catch((e) => console.error((0, asError_1.asError)(e))));
+        this.commandController = null;
+    }
+}
+exports.Daemon = Daemon;
+//# sourceMappingURL=Daemon.js.map

package/package/lib/mainFn/Daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Daemon.js","sourceRoot":"","sources":["../../../../package/lib/mainFn/Daemon.ts"],"names":[],"mappings":";;;AACA,4DAAwD;AAExD,2DAAuD;AAEvD,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACjC,MAAM,cAAc,GAAG,KAAK,CAAA;AAC5B;;;GAGG;AAEH,MAAa,MAAM;IAGjB,YAAoB,YAA8C;QAA9C,iBAAY,GAAZ,YAAY,CAAkC;QAF1D,sBAAiB,GAA6B,IAAI,CAAA;QAClD,oBAAe,GAAG,KAAK,CAAA;IACsC,CAAC;IACtE,IAAI,kBAAkB;;QACpB,OAAO,MAAA,IAAI,CAAC,iBAAiB,0CAAE,kBAAkB,CAAA;IACnD,CAAC;IACD,MAAM,CAAC,EAAE;QACP,OAAO,KAAK,EACV,OAAkB,EAClB,YAKgB,EAChB,OAAsB,EACtB,OAaC,EACD,EAAE;YACF,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB,qCAAiB,CAAC,EAAE,EAAY,CAC9B,OAAO,EACP,YAAY,EACZ,OAAO,EACP,OAAO,CACR,CAAA;YACH,OAAO,IAAI,MAAM,CAAC,YAAY,CAAC,CAAA;QACjC,CAAC,CAAA;IACH,CAAC;IACD,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,iBAAiB,EAAE;YAC1B,OAAM;SACP;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAA;QAC3B,IAAI,cAAc,GAAG,CAAC,CAAA;QACtB,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE;YACrB,OAAO,IAAI,CAAC,eAAe,EAAE;gBAC3B,IAAI,CAAC,iBAAiB,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;gBAClD,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;gBACtE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAA;gBACnE,cAAc,IAAI,oBAAoB,CAAA;gBACtC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;aAC1D;QACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,OAAO,CAAC,KAAK,CAAC,IAAA,iBAAO,EAAC,GAAG,CAAC,CAAC,CAAA;QAC7B,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,WAGV;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC/B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,WAGV;;QACC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAA;QAC5B,MAAM,CAAA,MAAA,IAAI,CAAC,iBAAiB,0CACxB,IAAI,CAAC,EAAE,GAAG,WAAW,EAAE,EACxB,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,iBAAO,EAAC,CAAC,CAAC,CAAC,CAAC,CAAA,CAAA;QAC1C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;IAC/B,CAAC;CACF;AA5ED,wBA4EC"}

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

@@ -0,0 +1,113 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { HealthReceipt, Signals } from "../../../base/lib/types";
+import { HealthCheckResult } from "../health/checkFns";
+import { Trigger } from "../trigger";
+import * as T from "../../../base/lib/types";
+import { Mounts } from "./Mounts";
+import { ExecSpawnable, MountOptions } 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";
+export declare const cpExec: typeof CP.exec.__promisify__;
+export declare const cpExecFile: typeof CP.execFile.__promisify__;
+export type Ready = {
+    display: string | null;
+    fn: (spawnable: ExecSpawnable) => Promise<HealthCheckResult> | HealthCheckResult;
+    trigger?: Trigger;
+};
+type DaemonsParams<Manifest extends T.Manifest, Ids extends string, Command extends string, Id extends string> = {
+    command: T.CommandType;
+    image: {
+        id: keyof Manifest["images"] & T.ImageId;
+        sharedRun?: boolean;
+    };
+    mounts: Mounts<Manifest>;
+    env?: Record<string, string>;
+    ready: Ready;
+    requires: Exclude<Ids, Id>[];
+    sigtermTimeout?: number;
+};
+type ErrorDuplicateId<Id extends string> = `The id '${Id}' is already used`;
+export declare const runCommand: <Manifest extends T.Manifest>() => <A extends string>(effects: T.Effects, subcontainer: import("../util/SubContainer").SubContainer | {
+    id: keyof Manifest["images"] & string;
+    sharedRun?: boolean | undefined;
+}, command: T.CommandType, options: {
+    subcontainerName?: string | undefined;
+    sigtermTimeout?: number | undefined;
+    mounts?: {
+        path: string;
+        options: MountOptions;
+    }[] | undefined;
+    runAsInit?: boolean | undefined;
+    env?: {
+        [variable: string]: string;
+    } | undefined;
+    cwd?: string | undefined;
+    user?: string | undefined;
+    onStdout?: ((x: Buffer) => null) | undefined;
+    onStderr?: ((x: Buffer) => null) | undefined;
+}) => Promise<CommandController>;
+/**
+ * A class for defining and controlling the service daemons
+```ts
+Daemons.of({
+  effects,
+  started,
+  interfaceReceipt, // Provide the interfaceReceipt to prove it was completed
+  healthReceipts, // Provide the healthReceipts or [] to prove they were at least considered
+}).addDaemon('webui', {
+  command: 'hello-world', // The command to start the daemon
+  ready: {
+    display: 'Web Interface',
+    // The function to run to determine the health status of the daemon
+    fn: () =>
+      checkPortListening(effects, 80, {
+        successMessage: 'The web interface is ready',
+        errorMessage: 'The web interface is not ready',
+      }),
+  },
+  requires: [],
+})
+```
+ */
+export declare class Daemons<Manifest extends T.Manifest, Ids extends string> implements T.DaemonBuildable {
+    readonly effects: T.Effects;
+    readonly started: (onTerm: () => PromiseLike<void>) => PromiseLike<null>;
+    readonly daemons: Promise<Daemon>[];
+    readonly ids: Ids[];
+    readonly healthDaemons: HealthDaemon[];
+    private constructor();
+    /**
+     * Returns an empty new Daemons class with the provided inputSpec.
+     *
+     * Call .addDaemon() on the returned class to add a daemon.
+     *
+     * Daemons run in the order they are defined, with latter daemons being capable of
+     * depending on prior daemons
+     * @param options
+     * @returns
+     */
+    static of<Manifest extends T.Manifest>(options: {
+        effects: T.Effects;
+        started: (onTerm: () => PromiseLike<void>) => PromiseLike<null>;
+        healthReceipts: HealthReceipt[];
+    }): Daemons<Manifest, never>;
+    /**
+     * Returns the complete list of daemons, including the one defined here
+     * @param id
+     * @param newDaemon
+     * @returns
+     */
+    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>;
+    build(): Promise<{
+        term: (options?: {
+            signal?: Signals;
+            timeout?: number;
+        }) => Promise<void>;
+    }>;
+    private updateMainHealth;
+}