@start9labs/start-sdk 0.3.6-alpha1

package/mjs/lib/mainFn/Daemon.js

@@ -0,0 +1,50 @@
+import { CommandController } from "./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
+ */
+export class Daemon {
+    startCommand;
+    commandController = null;
+    shouldBeRunning = false;
+    constructor(startCommand) {
+        this.startCommand = startCommand;
+    }
+    static of() {
+        return async (effects, imageId, command, options) => {
+            const startCommand = () => CommandController.of()(effects, imageId, 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(err);
+        });
+    }
+    async term(termOptions) {
+        return this.stop(termOptions);
+    }
+    async stop(termOptions) {
+        this.shouldBeRunning = false;
+        await this.commandController
+            ?.term(termOptions)
+            .catch((e) => console.error(e));
+        this.commandController = null;
+    }
+}
+//# sourceMappingURL=Daemon.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Daemon.js","sourceRoot":"","sources":["../../../../lib/mainFn/Daemon.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACjC,MAAM,cAAc,GAAG,KAAK,CAAA;AAC5B;;;GAGG;AAEH,MAAM,OAAO,MAAM;IAGW;IAFpB,iBAAiB,GAA6B,IAAI,CAAA;IAClD,eAAe,GAAG,KAAK,CAAA;IAC/B,YAA4B,YAA8C;QAA9C,iBAAY,GAAZ,YAAY,CAAkC;IAAG,CAAC;IAC9E,MAAM,CAAC,EAAE;QACP,OAAO,KAAK,EACV,OAAgB,EAChB,OAGC,EACD,OAAyD,EACzD,OAYC,EACD,EAAE;YACF,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB,iBAAiB,CAAC,EAAE,EAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;YACtE,OAAO,IAAI,MAAM,CAAC,YAAY,CAAC,CAAA;QACjC,CAAC,CAAA;IACH,CAAC;IAED,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,GAAG,CAAC,CAAA;QACpB,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,IAAI,CAAC,iBAAiB;YAC1B,EAAE,IAAI,CAAC,WAAW,CAAC;aAClB,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QACjC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;IAC/B,CAAC;CACF"}

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

@@ -0,0 +1,113 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Signals } from "../StartSdk";
+import { HealthReceipt } from "../health/HealthReceipt";
+import { CheckResult } from "../health/checkFns";
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { Trigger } from "../trigger";
+import { Effects, ValidIfNoStupidEscape } from "../types";
+import { MountOptions, Overlay } from "../util/Overlay";
+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 cpExecFile: typeof CP.execFile.__promisify__;
+export type Ready = {
+    display: string | null;
+    fn: () => Promise<CheckResult> | CheckResult;
+    trigger?: Trigger;
+};
+type DaemonsParams<Manifest extends SDKManifest, Ids extends string, Command extends string, Id extends string> = {
+    command: ValidIfNoStupidEscape<Command> | [string, ...string[]];
+    image: {
+        id: Manifest["images"][number];
+        sharedRun?: boolean;
+    };
+    mounts: {
+        path: string;
+        options: MountOptions;
+    }[];
+    env?: Record<string, string>;
+    ready: Ready;
+    requires: Exclude<Ids, Id>[];
+};
+type ErrorDuplicateId<Id extends string> = `The id '${Id}' is already used`;
+export declare const runCommand: <Manifest extends SDKManifest>() => <A extends string>(effects: Effects, imageId: {
+    id: Manifest["images"][number];
+    sharedRun?: boolean | undefined;
+}, command: [string, ...string[]] | ValidIfNoStupidEscape<A>, options: {
+    mounts?: {
+        path: string;
+        options: MountOptions;
+    }[] | undefined;
+    overlay?: Overlay | undefined;
+    env?: {
+        [variable: string]: string;
+    } | undefined;
+    cwd?: string | undefined;
+    user?: string | undefined;
+    onStdout?: ((x: Buffer) => void) | undefined;
+    onStderr?: ((x: Buffer) => void) | 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 SDKManifest, Ids extends string> {
+    readonly effects: Effects;
+    readonly started: (onTerm: () => PromiseLike<void>) => PromiseLike<void>;
+    readonly daemons: Promise<Daemon>[];
+    readonly ids: Ids[];
+    readonly healthDaemons: HealthDaemon[];
+    private constructor();
+    /**
+     * Returns an empty new Daemons class with the provided config.
+     *
+     * 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 config
+     * @returns
+     */
+    static of<Manifest extends SDKManifest>(config: {
+        effects: Effects;
+        started: (onTerm: () => PromiseLike<void>) => PromiseLike<void>;
+        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;
+}

package/mjs/lib/mainFn/Daemons.js

@@ -0,0 +1,103 @@
+import { promisify } from "node:util";
+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";
+const cpExec = promisify(CP.exec);
+export const cpExecFile = promisify(CP.execFile);
+export const runCommand = () => CommandController.of();
+/**
+ * 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 class Daemons {
+    effects;
+    started;
+    daemons;
+    ids;
+    healthDaemons;
+    constructor(effects, started, daemons, ids, healthDaemons) {
+        this.effects = effects;
+        this.started = started;
+        this.daemons = daemons;
+        this.ids = ids;
+        this.healthDaemons = healthDaemons;
+    }
+    /**
+     * Returns an empty new Daemons class with the provided config.
+     *
+     * 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 config
+     * @returns
+     */
+    static of(config) {
+        return new Daemons(config.effects, config.started, [], [], []);
+    }
+    /**
+     * 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.of()(this.effects, options.image, options.command, options);
+        const healthDaemon = new HealthDaemon(daemon, daemonIndex, options.requires
+            .map((x) => this.ids.indexOf(id))
+            .filter((x) => x >= 0)
+            .map((id) => this.healthDaemons[id]), id, this.ids, options.ready, this.effects);
+        const daemons = this.daemons.concat(daemon);
+        const ids = [...this.ids, id];
+        const healthDaemons = [...this.healthDaemons, healthDaemon];
+        return new Daemons(this.effects, this.started, daemons, ids, healthDaemons);
+    }
+    async build() {
+        this.updateMainHealth();
+        this.healthDaemons.forEach((x) => x.addWatcher(() => this.updateMainHealth()));
+        return {
+            term: async (options) => {
+                try {
+                    await Promise.all(this.healthDaemons.map((x) => x.term(options)));
+                }
+                finally {
+                    this.effects.setMainStatus({ status: "stopped" });
+                }
+            },
+        };
+    }
+    updateMainHealth() {
+        if (this.healthDaemons.every((x) => x.health.status === "success")) {
+            this.effects.setMainStatus({ status: "running" });
+        }
+        else {
+            this.effects.setMainStatus({ status: "starting" });
+        }
+    }
+}
+//# sourceMappingURL=Daemons.js.map

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

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

package/mjs/lib/mainFn/HealthDaemon.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="node" />
+import { CheckResult } from "../health/checkFns";
+import { Ready } from "./Daemons";
+import { Daemon } from "./Daemon";
+import { Effects } from "../types";
+/**
+ * Wanted a structure that deals with controlling daemons by their health status
+ * States:
+ * -- Waiting for dependencies to be success
+ * -- Running: Daemon is running and the status is in the health
+ *
+ */
+export declare class HealthDaemon {
+    #private;
+    readonly daemon: Promise<Daemon>;
+    readonly daemonIndex: number;
+    readonly dependencies: HealthDaemon[];
+    readonly id: string;
+    readonly ids: string[];
+    readonly ready: Ready;
+    readonly effects: Effects;
+    constructor(daemon: Promise<Daemon>, daemonIndex: number, dependencies: HealthDaemon[], id: string, ids: string[], ready: Ready, effects: Effects);
+    /** Run after we want to do cleanup */
+    term(termOptions?: {
+        signal?: NodeJS.Signals | undefined;
+        timeout?: number | undefined;
+    }): Promise<void>;
+    /** Want to add another notifier that the health might have changed */
+    addWatcher(watcher: () => unknown): void;
+    get health(): Readonly<CheckResult>;
+    private changeRunning;
+    private turnOffHealthCheck;
+    private setupHealthCheck;
+    private setHealth;
+    private updateStatus;
+}

package/mjs/lib/mainFn/HealthDaemon.js

@@ -0,0 +1,133 @@
+import { defaultTrigger } from "../trigger/defaultTrigger";
+const oncePromise = () => {
+    let resolve;
+    const promise = new Promise((res) => {
+        resolve = res;
+    });
+    return { resolve: resolve, promise };
+};
+/**
+ * Wanted a structure that deals with controlling daemons by their health status
+ * States:
+ * -- Waiting for dependencies to be success
+ * -- Running: Daemon is running and the status is in the health
+ *
+ */
+export class HealthDaemon {
+    daemon;
+    daemonIndex;
+    dependencies;
+    id;
+    ids;
+    ready;
+    effects;
+    #health = { status: "starting", message: null };
+    #healthWatchers = [];
+    #running = false;
+    #hadSuccess = false;
+    constructor(daemon, daemonIndex, dependencies, id, ids, ready, effects) {
+        this.daemon = daemon;
+        this.daemonIndex = daemonIndex;
+        this.dependencies = dependencies;
+        this.id = id;
+        this.ids = ids;
+        this.ready = ready;
+        this.effects = effects;
+        this.updateStatus();
+        this.dependencies.forEach((d) => d.addWatcher(() => this.updateStatus()));
+    }
+    /** Run after we want to do cleanup */
+    async term(termOptions) {
+        this.#healthWatchers = [];
+        this.#running = false;
+        this.#healthCheckCleanup?.();
+        await this.daemon.then((d) => d.stop(termOptions));
+    }
+    /** Want to add another notifier that the health might have changed */
+    addWatcher(watcher) {
+        this.#healthWatchers.push(watcher);
+    }
+    get health() {
+        return Object.freeze(this.#health);
+    }
+    async changeRunning(newStatus) {
+        if (this.#running === newStatus)
+            return;
+        this.#running = newStatus;
+        if (newStatus) {
+            ;
+            (await this.daemon).start();
+            this.setupHealthCheck();
+        }
+        else {
+            ;
+            (await this.daemon).stop();
+            this.turnOffHealthCheck();
+            this.setHealth({ status: "starting", message: null });
+        }
+    }
+    #healthCheckCleanup = null;
+    turnOffHealthCheck() {
+        this.#healthCheckCleanup?.();
+    }
+    async setupHealthCheck() {
+        if (this.#healthCheckCleanup)
+            return;
+        const trigger = (this.ready.trigger ?? defaultTrigger)(() => ({
+            hadSuccess: this.#hadSuccess,
+            lastResult: this.#health.status,
+        }));
+        const { promise: status, resolve: setStatus } = oncePromise();
+        new Promise(async () => {
+            for (let res = await Promise.race([status, trigger.next()]); !res.done; res = await Promise.race([status, trigger.next()])) {
+                const response = await Promise.resolve(this.ready.fn()).catch((err) => {
+                    console.error(err);
+                    return {
+                        status: "failure",
+                        message: "message" in err ? err.message : String(err),
+                    };
+                });
+                this.setHealth(response);
+                if (response.status === "success") {
+                    this.#hadSuccess = true;
+                }
+            }
+        }).catch((err) => console.error(`Daemon ${this.id} failed: ${err}`));
+        this.#healthCheckCleanup = () => {
+            setStatus({ done: true });
+            this.#healthCheckCleanup = null;
+        };
+    }
+    setHealth(health) {
+        this.#health = health;
+        this.#healthWatchers.forEach((watcher) => watcher());
+        const display = this.ready.display;
+        const status = health.status;
+        if (!display) {
+            return;
+        }
+        if (status === "success" ||
+            status === "disabled" ||
+            status === "starting") {
+            this.effects.setHealth({
+                result: status,
+                message: health.message,
+                id: display,
+                name: display,
+            });
+        }
+        else {
+            this.effects.setHealth({
+                result: health.status,
+                message: health.message || "",
+                id: display,
+                name: display,
+            });
+        }
+    }
+    async updateStatus() {
+        const healths = this.dependencies.map((d) => d.#health);
+        this.changeRunning(healths.every((x) => x.status === "success"));
+    }
+}
+//# sourceMappingURL=HealthDaemon.js.map

package/mjs/lib/mainFn/HealthDaemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthDaemon.js","sourceRoot":"","sources":["../../../../lib/mainFn/HealthDaemon.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAK1D,MAAM,WAAW,GAAG,GAAM,EAAE;IAC1B,IAAI,OAA2B,CAAA;IAC/B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,GAAG,EAAE,EAAE;QACrC,OAAO,GAAG,GAAG,CAAA;IACf,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,OAAO,EAAE,OAAQ,EAAE,OAAO,EAAE,CAAA;AACvC,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IAMZ;IACA;IACA;IACA;IACA;IACA;IACA;IAXX,OAAO,GAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC5D,eAAe,GAAyB,EAAE,CAAA;IAC1C,QAAQ,GAAG,KAAK,CAAA;IAChB,WAAW,GAAG,KAAK,CAAA;IACnB,YACW,MAAuB,EACvB,WAAmB,EACnB,YAA4B,EAC5B,EAAU,EACV,GAAa,EACb,KAAY,EACZ,OAAgB;QANhB,WAAM,GAAN,MAAM,CAAiB;QACvB,gBAAW,GAAX,WAAW,CAAQ;QACnB,iBAAY,GAAZ,YAAY,CAAgB;QAC5B,OAAE,GAAF,EAAE,CAAQ;QACV,QAAG,GAAH,GAAG,CAAU;QACb,UAAK,GAAL,KAAK,CAAO;QACZ,YAAO,GAAP,OAAO,CAAS;QAEzB,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,IAAI,CAAC,WAGV;QACC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAA;QACzB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAA;QACrB,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAA;QAE5B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAA;IACpD,CAAC;IAED,sEAAsE;IACtE,UAAU,CAAC,OAAsB;QAC/B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,SAAkB;QAC5C,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAM;QAEvC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;QAEzB,IAAI,SAAS,EAAE;YACb,CAAC;YAAA,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAA;YAC5B,IAAI,CAAC,gBAAgB,EAAE,CAAA;SACxB;aAAM;YACL,CAAC;YAAA,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;YAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAA;YAEzB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;SACtD;IACH,CAAC;IAED,mBAAmB,GAAwB,IAAI,CAAA;IACvC,kBAAkB;QACxB,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAA;IAC9B,CAAC;IACO,KAAK,CAAC,gBAAgB;QAC5B,IAAI,IAAI,CAAC,mBAAmB;YAAE,OAAM;QACpC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5D,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;SAChC,CAAC,CAAC,CAAA;QAEH,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,WAAW,EAEvD,CAAA;QACJ,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE;YACrB,KACE,IAAI,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EACtD,CAAC,GAAG,CAAC,IAAI,EACT,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAClD;gBACA,MAAM,QAAQ,GAAgB,MAAM,OAAO,CAAC,OAAO,CACjD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAChB,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACd,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;oBAClB,OAAO;wBACL,MAAM,EAAE,SAAS;wBACjB,OAAO,EAAE,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACtD,CAAA;gBACH,CAAC,CAAC,CAAA;gBACF,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;gBACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE;oBACjC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;iBACxB;aACF;QACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,YAAY,GAAG,EAAE,CAAC,CAAC,CAAA;QAEpE,IAAI,CAAC,mBAAmB,GAAG,GAAG,EAAE;YAC9B,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACzB,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;QACjC,CAAC,CAAA;IACH,CAAC;IAEO,SAAS,CAAC,MAAmB;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAA;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,OAAO,EAAE;YACZ,OAAM;SACP;QACD,IACE,MAAM,KAAK,SAAS;YACpB,MAAM,KAAK,UAAU;YACrB,MAAM,KAAK,UAAU,EACrB;YACA,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBACrB,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,OAAO;aACd,CAAC,CAAA;SACH;aAAM;YACL,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;gBAC7B,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,OAAO;aACd,CAAC,CAAA;SACH;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACvD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAA;IAClE,CAAC;CACF"}

package/mjs/lib/mainFn/Mounts.d.ts

@@ -0,0 +1,33 @@
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { MountOptions } from "../util/Overlay";
+type MountArray = {
+    path: string;
+    options: MountOptions;
+}[];
+export declare class Mounts<Manifest extends SDKManifest> {
+    readonly volumes: {
+        id: Manifest["volumes"][number];
+        subpath: string | null;
+        mountpoint: string;
+        readonly: boolean;
+    }[];
+    readonly assets: {
+        id: Manifest["assets"][number];
+        subpath: string | null;
+        mountpoint: string;
+    }[];
+    readonly dependencies: {
+        dependencyId: string;
+        volumeId: string;
+        subpath: string | null;
+        mountpoint: string;
+        readonly: boolean;
+    }[];
+    private constructor();
+    static of<Manifest extends SDKManifest>(): Mounts<Manifest>;
+    addVolume(id: Manifest["volumes"][number], subpath: string | null, mountpoint: string, readonly: boolean): this;
+    addAssets(id: Manifest["assets"][number], subpath: string | null, mountpoint: string): this;
+    addDependency<DependencyManifest extends SDKManifest>(dependencyId: keyof Manifest["dependencies"] & string, volumeId: DependencyManifest["volumes"][number], subpath: string | null, mountpoint: string, readonly: boolean): this;
+    build(): MountArray;
+}
+export {};

package/mjs/lib/mainFn/Mounts.js

@@ -0,0 +1,81 @@
+export class Mounts {
+    volumes;
+    assets;
+    dependencies;
+    constructor(volumes, assets, dependencies) {
+        this.volumes = volumes;
+        this.assets = assets;
+        this.dependencies = dependencies;
+    }
+    static of() {
+        return new Mounts([], [], []);
+    }
+    addVolume(id, subpath, mountpoint, readonly) {
+        this.volumes.push({
+            id,
+            subpath,
+            mountpoint,
+            readonly,
+        });
+        return this;
+    }
+    addAssets(id, subpath, mountpoint) {
+        this.assets.push({
+            id,
+            subpath,
+            mountpoint,
+        });
+        return this;
+    }
+    addDependency(dependencyId, volumeId, subpath, mountpoint, readonly) {
+        this.dependencies.push({
+            dependencyId,
+            volumeId,
+            subpath,
+            mountpoint,
+            readonly,
+        });
+        return this;
+    }
+    build() {
+        const mountpoints = new Set();
+        for (let mountpoint of this.volumes
+            .map((v) => v.mountpoint)
+            .concat(this.assets.map((a) => a.mountpoint))
+            .concat(this.dependencies.map((d) => d.mountpoint))) {
+            if (mountpoints.has(mountpoint)) {
+                throw new Error(`cannot mount more than once to mountpoint ${mountpoint}`);
+            }
+            mountpoints.add(mountpoint);
+        }
+        return []
+            .concat(this.volumes.map((v) => ({
+            path: v.mountpoint,
+            options: {
+                type: "volume",
+                id: v.id,
+                subpath: v.subpath,
+                readonly: v.readonly,
+            },
+        })))
+            .concat(this.assets.map((a) => ({
+            path: a.mountpoint,
+            options: {
+                type: "assets",
+                id: a.id,
+                subpath: a.subpath,
+            },
+        })))
+            .concat(this.dependencies.map((d) => ({
+            path: d.mountpoint,
+            options: {
+                type: "pointer",
+                packageId: d.dependencyId,
+                volumeId: d.volumeId,
+                subpath: d.subpath,
+                readonly: d.readonly,
+            },
+        })));
+    }
+}
+//# sourceMappingURL=Mounts.js.map

package/mjs/lib/mainFn/Mounts.js.map

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

package/mjs/lib/mainFn/index.d.ts

@@ -0,0 +1,21 @@
+import { ExpectedExports } from "../types";
+import { Daemons } from "./Daemons";
+import "../interfaces/ServiceInterfaceBuilder";
+import "../interfaces/Origin";
+import "./Daemons";
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { MainEffects } from "../StartSdk";
+/**
+ * Used to ensure that the main function is running with the valid proofs.
+ * We first do the folowing order of things
+ * 1. We get the interfaces
+ * 2. We setup all the commands to setup the system
+ * 3. We create the health checks
+ * 4. We setup the daemons init system
+ * @param fn
+ * @returns
+ */
+export declare const setupMain: <Manifest extends SDKManifest, Store>(fn: (o: {
+    effects: MainEffects;
+    started(onTerm: () => PromiseLike<void>): PromiseLike<void>;
+}) => Promise<Daemons<Manifest, any>>) => ExpectedExports.main;

package/mjs/lib/mainFn/index.js

@@ -0,0 +1,20 @@
+import "../interfaces/ServiceInterfaceBuilder";
+import "../interfaces/Origin";
+import "./Daemons";
+/**
+ * Used to ensure that the main function is running with the valid proofs.
+ * We first do the folowing order of things
+ * 1. We get the interfaces
+ * 2. We setup all the commands to setup the system
+ * 3. We create the health checks
+ * 4. We setup the daemons init system
+ * @param fn
+ * @returns
+ */
+export const setupMain = (fn) => {
+    return async (options) => {
+        const result = await fn(options);
+        return result;
+    };
+};
+//# sourceMappingURL=index.js.map

package/mjs/lib/mainFn/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/mainFn/index.ts"],"names":[],"mappings":"AAEA,OAAO,uCAAuC,CAAA;AAC9C,OAAO,sBAAsB,CAAA;AAE7B,OAAO,WAAW,CAAA;AAIlB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,EAGqC,EACf,EAAE;IACxB,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAA;QAChC,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC,CAAA"}