@start9labs/start-sdk 0.3.6-alpha2 → 0.3.6-alpha4

package/cjs/lib/interfaces/Host.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiHost = exports.Host = exports.knownProtocols = void 0;
+const ts_matches_1 = require("ts-matches");
+const Origin_1 = require("./Origin");
+exports.knownProtocols = {
+    http: {
+        secure: null,
+        defaultPort: 80,
+        withSsl: "https",
+        alpn: { specified: ["http/1.1"] },
+    },
+    https: {
+        secure: { ssl: true },
+        defaultPort: 443,
+    },
+    ws: {
+        secure: null,
+        defaultPort: 80,
+        withSsl: "wss",
+        alpn: { specified: ["http/1.1"] },
+    },
+    wss: {
+        secure: { ssl: true },
+        defaultPort: 443,
+    },
+    ssh: {
+        secure: { ssl: false },
+        defaultPort: 22,
+    },
+    bitcoin: {
+        secure: { ssl: false },
+        defaultPort: 8333,
+    },
+    lightning: {
+        secure: { ssl: true },
+        defaultPort: 9735,
+    },
+    grpc: {
+        secure: { ssl: true },
+        defaultPort: 50051,
+    },
+    dns: {
+        secure: { ssl: false },
+        defaultPort: 53,
+    },
+};
+const hasStringProtocol = (0, ts_matches_1.object)({
+    protocol: ts_matches_1.string,
+}).test;
+class Host {
+    constructor(options) {
+        this.options = options;
+    }
+    async bindPort(internalPort, options) {
+        if (hasStringProtocol(options)) {
+            return await this.bindPortForKnown(options, internalPort);
+        }
+        else {
+            return await this.bindPortForUnknown(internalPort, options);
+        }
+    }
+    async bindPortForUnknown(internalPort, options) {
+        const binderOptions = {
+            kind: this.options.kind,
+            id: this.options.id,
+            internalPort,
+            ...options,
+        };
+        await this.options.effects.bind(binderOptions);
+        return new Origin_1.Origin(this, internalPort, null, null);
+    }
+    async bindPortForKnown(options, internalPort) {
+        const protoInfo = exports.knownProtocols[options.protocol];
+        const preferredExternalPort = options.preferredExternalPort ||
+            exports.knownProtocols[options.protocol].defaultPort;
+        const sslProto = this.getSslProto(options, protoInfo);
+        const addSsl = sslProto && "alpn" in protoInfo
+            ? {
+                // addXForwardedHeaders: null,
+                preferredExternalPort: exports.knownProtocols[sslProto].defaultPort,
+                scheme: sslProto,
+                alpn: protoInfo.alpn,
+                ...("addSsl" in options ? options.addSsl : null),
+            }
+            : null;
+        const secure = !protoInfo.secure ? null : { ssl: false };
+        await this.options.effects.bind({
+            kind: this.options.kind,
+            id: this.options.id,
+            internalPort,
+            preferredExternalPort,
+            addSsl,
+            secure,
+        });
+        return new Origin_1.Origin(this, internalPort, options.protocol, sslProto);
+    }
+    getSslProto(options, protoInfo) {
+        if (inObject("noAddSsl", options) && options.noAddSsl)
+            return null;
+        if ("withSsl" in protoInfo && protoInfo.withSsl)
+            return protoInfo.withSsl;
+        return null;
+    }
+}
+exports.Host = Host;
+function inObject(key, obj) {
+    return key in obj;
+}
+// export class StaticHost extends Host {
+//   constructor(options: { effects: Effects; id: string }) {
+//     super({ ...options, kind: "static" })
+//   }
+// }
+// export class SingleHost extends Host {
+//   constructor(options: { effects: Effects; id: string }) {
+//     super({ ...options, kind: "single" })
+//   }
+// }
+class MultiHost extends Host {
+    constructor(options) {
+        super({ ...options, kind: "multi" });
+    }
+}
+exports.MultiHost = MultiHost;
+//# sourceMappingURL=Host.js.map

package/cjs/lib/interfaces/Host.js.map

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

package/cjs/lib/interfaces/Origin.d.ts

@@ -0,0 +1,31 @@
+import { AddressInfo } from "../types";
+import { AddressReceipt } from "./AddressReceipt";
+import { Host, Scheme } from "./Host";
+import { ServiceInterfaceBuilder } from "./ServiceInterfaceBuilder";
+export declare class Origin<T extends Host> {
+    readonly host: T;
+    readonly internalPort: number;
+    readonly scheme: string | null;
+    readonly sslScheme: string | null;
+    constructor(host: T, internalPort: number, scheme: string | null, sslScheme: string | null);
+    build({ username, path, search, schemeOverride }: BuildOptions): AddressInfo;
+    /**
+     * A function to register a group of origins (<PROTOCOL> :// <HOSTNAME> : <PORT>) with StartOS
+     *
+     * The returned addressReceipt serves as proof that the addresses were registered
+     *
+     * @param addressInfo
+     * @returns
+     */
+    export(serviceInterfaces: ServiceInterfaceBuilder[]): Promise<AddressInfo[] & AddressReceipt>;
+}
+type BuildOptions = {
+    schemeOverride: {
+        ssl: Scheme;
+        noSsl: Scheme;
+    } | null;
+    username: string | null;
+    path: string;
+    search: Record<string, string>;
+};
+export {};

package/cjs/lib/interfaces/Origin.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Origin = void 0;
+class Origin {
+    constructor(host, internalPort, scheme, sslScheme) {
+        this.host = host;
+        this.internalPort = internalPort;
+        this.scheme = scheme;
+        this.sslScheme = sslScheme;
+    }
+    build({ username, path, search, schemeOverride }) {
+        const qpEntries = Object.entries(search)
+            .map(([key, val]) => `${encodeURIComponent(key)}=${encodeURIComponent(val)}`)
+            .join("&");
+        const qp = qpEntries.length ? `?${qpEntries}` : "";
+        return {
+            hostId: this.host.options.id,
+            internalPort: this.internalPort,
+            scheme: schemeOverride ? schemeOverride.noSsl : this.scheme,
+            sslScheme: schemeOverride ? schemeOverride.ssl : this.sslScheme,
+            suffix: `${path}${qp}`,
+            username,
+        };
+    }
+    /**
+     * A function to register a group of origins (<PROTOCOL> :// <HOSTNAME> : <PORT>) with StartOS
+     *
+     * The returned addressReceipt serves as proof that the addresses were registered
+     *
+     * @param addressInfo
+     * @returns
+     */
+    async export(serviceInterfaces) {
+        const addressesInfo = [];
+        for (let serviceInterface of serviceInterfaces) {
+            const { name, description, hasPrimary, disabled, id, type, username, path, search, schemeOverride, masked, } = serviceInterface.options;
+            const addressInfo = this.build({
+                username,
+                path,
+                search,
+                schemeOverride,
+            });
+            await serviceInterface.options.effects.exportServiceInterface({
+                id,
+                name,
+                description,
+                hasPrimary,
+                disabled,
+                addressInfo,
+                type,
+                masked,
+            });
+            addressesInfo.push(addressInfo);
+        }
+        return addressesInfo;
+    }
+}
+exports.Origin = Origin;
+//# sourceMappingURL=Origin.js.map

package/cjs/lib/interfaces/Origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Origin.js","sourceRoot":"","sources":["../../../../lib/interfaces/Origin.ts"],"names":[],"mappings":";;;AAKA,MAAa,MAAM;IACjB,YACW,IAAO,EACP,YAAoB,EACpB,MAAqB,EACrB,SAAwB;QAHxB,SAAI,GAAJ,IAAI,CAAG;QACP,iBAAY,GAAZ,YAAY,CAAQ;QACpB,WAAM,GAAN,MAAM,CAAe;QACrB,cAAS,GAAT,SAAS,CAAe;IAChC,CAAC;IAEJ,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAgB;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;aACrC,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CACxE;aACA,IAAI,CAAC,GAAG,CAAC,CAAA;QAEZ,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAElD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAC5B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM;YAC3D,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS;YAC/D,MAAM,EAAE,GAAG,IAAI,GAAG,EAAE,EAAE;YACtB,QAAQ;SACT,CAAA;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,iBAA4C;QAE5C,MAAM,aAAa,GAAG,EAAE,CAAA;QACxB,KAAK,IAAI,gBAAgB,IAAI,iBAAiB,EAAE;YAC9C,MAAM,EACJ,IAAI,EACJ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,cAAc,EACd,MAAM,GACP,GAAG,gBAAgB,CAAC,OAAO,CAAA;YAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;gBAC7B,QAAQ;gBACR,IAAI;gBACJ,MAAM;gBACN,cAAc;aACf,CAAC,CAAA;YAEF,MAAM,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC;gBAC5D,EAAE;gBACF,IAAI;gBACJ,WAAW;gBACX,UAAU;gBACV,QAAQ;gBACR,WAAW;gBACX,IAAI;gBACJ,MAAM;aACP,CAAC,CAAA;YAEF,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;SAChC;QAED,OAAO,aAA+C,CAAA;IACxD,CAAC;CACF;AA7ED,wBA6EC"}

package/cjs/lib/interfaces/ServiceInterfaceBuilder.d.ts

@@ -0,0 +1,50 @@
+import { ServiceInterfaceType } from "../StartSdk";
+import { Effects } from "../types";
+import { Scheme } from "./Host";
+/**
+ * A helper class for creating a Network Interface
+ *
+ * Network Interfaces are collections of web addresses that expose the same API or other resource,
+ * display to the user with under a common name and description.
+ *
+ * All URIs on an interface inherit the same ui: bool, basic auth credentials, path, and search (query) params
+ *
+ * @param options
+ * @returns
+ */
+export declare class ServiceInterfaceBuilder {
+    readonly options: {
+        effects: Effects;
+        name: string;
+        id: string;
+        description: string;
+        hasPrimary: boolean;
+        disabled: boolean;
+        type: ServiceInterfaceType;
+        username: string | null;
+        path: string;
+        search: Record<string, string>;
+        schemeOverride: {
+            ssl: Scheme;
+            noSsl: Scheme;
+        } | null;
+        masked: boolean;
+    };
+    constructor(options: {
+        effects: Effects;
+        name: string;
+        id: string;
+        description: string;
+        hasPrimary: boolean;
+        disabled: boolean;
+        type: ServiceInterfaceType;
+        username: string | null;
+        path: string;
+        search: Record<string, string>;
+        schemeOverride: {
+            ssl: Scheme;
+            noSsl: Scheme;
+        } | null;
+        masked: boolean;
+    });
+}

package/cjs/lib/interfaces/ServiceInterfaceBuilder.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceInterfaceBuilder = void 0;
+/**
+ * A helper class for creating a Network Interface
+ *
+ * Network Interfaces are collections of web addresses that expose the same API or other resource,
+ * display to the user with under a common name and description.
+ *
+ * All URIs on an interface inherit the same ui: bool, basic auth credentials, path, and search (query) params
+ *
+ * @param options
+ * @returns
+ */
+class ServiceInterfaceBuilder {
+    constructor(options) {
+        this.options = options;
+    }
+}
+exports.ServiceInterfaceBuilder = ServiceInterfaceBuilder;
+//# sourceMappingURL=ServiceInterfaceBuilder.js.map

package/cjs/lib/interfaces/ServiceInterfaceBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceInterfaceBuilder.js","sourceRoot":"","sources":["../../../../lib/interfaces/ServiceInterfaceBuilder.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;GAUG;AACH,MAAa,uBAAuB;IAClC,YACW,OAaR;QAbQ,YAAO,GAAP,OAAO,CAaf;IACA,CAAC;CACL;AAjBD,0DAiBC"}

package/cjs/lib/interfaces/interfaceReceipt.d.ts

@@ -0,0 +1,5 @@
+declare const InterfaceProof: unique symbol;
+export type InterfaceReceipt = {
+    [InterfaceProof]: never;
+};
+export {};

package/cjs/lib/interfaces/interfaceReceipt.js

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

package/cjs/lib/interfaces/interfaceReceipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaceReceipt.js","sourceRoot":"","sources":["../../../../lib/interfaces/interfaceReceipt.ts"],"names":[],"mappings":""}

package/cjs/lib/interfaces/setupInterfaces.d.ts

@@ -0,0 +1,12 @@
+import { Config } from "../config/builder/config";
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { AddressInfo, Effects } from "../types";
+import { AddressReceipt } from "./AddressReceipt";
+export type InterfacesReceipt = Array<AddressInfo[] & AddressReceipt>;
+export type SetInterfaces<Manifest extends SDKManifest, Store, ConfigInput extends Record<string, any>, Output extends InterfacesReceipt> = (opts: {
+    effects: Effects;
+    input: null | ConfigInput;
+}) => Promise<Output>;
+export type SetupInterfaces = <Manifest extends SDKManifest, Store, ConfigInput extends Record<string, any>, Output extends InterfacesReceipt>(config: Config<ConfigInput, Store>, fn: SetInterfaces<Manifest, Store, ConfigInput, Output>) => SetInterfaces<Manifest, Store, ConfigInput, Output>;
+export declare const NO_INTERFACE_CHANGES: InterfacesReceipt;
+export declare const setupInterfaces: SetupInterfaces;

package/cjs/lib/interfaces/setupInterfaces.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupInterfaces = exports.NO_INTERFACE_CHANGES = void 0;
+exports.NO_INTERFACE_CHANGES = [];
+const setupInterfaces = (_config, fn) => fn;
+exports.setupInterfaces = setupInterfaces;
+//# sourceMappingURL=setupInterfaces.js.map

package/cjs/lib/interfaces/setupInterfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupInterfaces.js","sourceRoot":"","sources":["../../../../lib/interfaces/setupInterfaces.ts"],"names":[],"mappings":";;;AAqBa,QAAA,oBAAoB,GAAG,EAAuB,CAAA;AACpD,MAAM,eAAe,GAAoB,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAA;AAAtD,QAAA,eAAe,mBAAuC"}

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

@@ -0,0 +1,33 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { Effects, ImageId, ValidIfNoStupidEscape } from "../types";
+import { MountOptions, Overlay } from "../util/Overlay";
+export declare class CommandController {
+    readonly runningAnswer: Promise<unknown>;
+    readonly overlay: Overlay;
+    readonly pid: number | undefined;
+    private constructor();
+    static of<Manifest extends SDKManifest>(): <A extends string>(effects: Effects, imageId: {
+        id: keyof Manifest["images"] & ImageId;
+        sharedRun?: boolean;
+    }, 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>;
+    wait(): Promise<unknown>;
+    term({ signal, timeout }?: {
+        signal?: NodeJS.Signals | undefined;
+        timeout?: number | undefined;
+    }): Promise<void>;
+}

package/cjs/lib/mainFn/CommandController.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandController = void 0;
+const StartSdk_1 = require("../StartSdk");
+const Overlay_1 = require("../util/Overlay");
+const splitCommand_1 = require("../util/splitCommand");
+const Daemons_1 = require("./Daemons");
+class CommandController {
+    constructor(runningAnswer, overlay, pid) {
+        this.runningAnswer = runningAnswer;
+        this.overlay = overlay;
+        this.pid = pid;
+    }
+    static of() {
+        return async (effects, imageId, command, options) => {
+            const commands = (0, splitCommand_1.splitCommand)(command);
+            const overlay = options.overlay || (await Overlay_1.Overlay.of(effects, imageId));
+            for (let mount of options.mounts || []) {
+                await overlay.mount(mount.options, mount.path);
+            }
+            const childProcess = await overlay.spawn(commands, {
+                env: options.env,
+            });
+            const answer = new Promise((resolve, reject) => {
+                var _a, _b;
+                childProcess.stdout.on("data", (_a = options.onStdout) !== null && _a !== void 0 ? _a : ((data) => {
+                    console.log(data.toString());
+                }));
+                childProcess.stderr.on("data", (_b = options.onStderr) !== null && _b !== void 0 ? _b : ((data) => {
+                    console.error(data.toString());
+                }));
+                childProcess.on("exit", (code) => {
+                    if (code === 0) {
+                        return resolve(null);
+                    }
+                    return reject(new Error(`${commands[0]} exited with code ${code}`));
+                });
+            });
+            const pid = childProcess.pid;
+            return new CommandController(answer, overlay, pid);
+        };
+    }
+    async wait() {
+        try {
+            return await this.runningAnswer;
+        }
+        finally {
+            if (this.pid !== undefined) {
+                await (0, Daemons_1.cpExecFile)("pkill", ["-9", "-s", String(this.pid)]).catch((_) => { });
+            }
+            await this.overlay.destroy().catch((_) => { });
+        }
+    }
+    async term({ signal = StartSdk_1.SIGTERM, timeout = StartSdk_1.NO_TIMEOUT } = {}) {
+        if (this.pid === undefined)
+            return;
+        try {
+            await (0, Daemons_1.cpExecFile)("pkill", [
+                `-${signal.replace("SIG", "")}`,
+                "-s",
+                String(this.pid),
+            ]);
+            const didTimeout = await waitSession(this.pid, timeout);
+            if (didTimeout) {
+                await (0, Daemons_1.cpExecFile)("pkill", [`-9`, "-s", String(this.pid)]).catch((_) => { });
+            }
+        }
+        finally {
+            await this.overlay.destroy();
+        }
+    }
+}
+exports.CommandController = CommandController;
+function waitSession(sid, timeout = StartSdk_1.NO_TIMEOUT, interval = 100) {
+    let nextInterval = interval * 2;
+    if (timeout >= 0 && timeout < nextInterval) {
+        nextInterval = timeout;
+    }
+    let nextTimeout = timeout;
+    if (timeout > 0) {
+        if (timeout >= interval) {
+            nextTimeout -= interval;
+        }
+        else {
+            nextTimeout = 0;
+        }
+    }
+    return new Promise((resolve, reject) => {
+        let next = null;
+        if (timeout !== 0) {
+            next = setTimeout(() => {
+                waitSession(sid, nextTimeout, nextInterval).then(resolve, reject);
+            }, interval);
+        }
+        (0, Daemons_1.cpExecFile)("ps", [`--sid=${sid}`, "-o", "--pid="]).then((_) => {
+            if (timeout === 0) {
+                resolve(true);
+            }
+        }, (e) => {
+            if (next) {
+                clearTimeout(next);
+            }
+            if (typeof e === "object" && e && "code" in e && e.code) {
+                resolve(false);
+            }
+            else {
+                reject(e);
+            }
+        });
+    });
+}
+//# sourceMappingURL=CommandController.js.map

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

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

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

@@ -0,0 +1,41 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { SDKManifest } from "../manifest/ManifestTypes";
+import { Effects, ImageId, ValidIfNoStupidEscape } from "../types";
+import { MountOptions, Overlay } from "../util/Overlay";
+/**
+ * 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;
+    private constructor();
+    static of<Manifest extends SDKManifest>(): <A extends string>(effects: Effects, imageId: {
+        id: keyof Manifest["images"] & ImageId;
+        sharedRun?: boolean;
+    }, 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<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/cjs/lib/mainFn/Daemon.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Daemon = void 0;
+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;
+    }
+    static of() {
+        return async (effects, imageId, command, options) => {
+            const startCommand = () => CommandController_1.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) {
+        var _a;
+        this.shouldBeRunning = false;
+        await ((_a = this.commandController) === null || _a === void 0 ? void 0 : _a.term(termOptions).catch((e) => console.error(e)));
+        this.commandController = null;
+    }
+}
+exports.Daemon = Daemon;
+//# sourceMappingURL=Daemon.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Daemon.js","sourceRoot":"","sources":["../../../../lib/mainFn/Daemon.ts"],"names":[],"mappings":";;;AAGA,2DAAuD;AAEvD,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACjC,MAAM,cAAc,GAAG,KAAK,CAAA;AAC5B;;;GAGG;AAEH,MAAa,MAAM;IAGjB,YAA4B,YAA8C;QAA9C,iBAAY,GAAZ,YAAY,CAAkC;QAFlE,sBAAiB,GAA6B,IAAI,CAAA;QAClD,oBAAe,GAAG,KAAK,CAAA;IAC8C,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,qCAAiB,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,CAAA,MAAA,IAAI,CAAC,iBAAiB,0CACxB,IAAI,CAAC,WAAW,EACjB,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA,CAAA;QACjC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;IAC/B,CAAC;CACF;AAlED,wBAkEC"}