@start9labs/start-sdk 0.3.6-alpha.10

package/package/lib/util/SubContainer.js

@@ -0,0 +1,340 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubContainerHandle = exports.SubContainer = exports.execFile = void 0;
+const fs = __importStar(require("fs/promises"));
+const cp = __importStar(require("child_process"));
+const util_1 = require("util");
+const node_buffer_1 = require("node:buffer");
+const once_1 = require("../../../base/lib/util/once");
+exports.execFile = (0, util_1.promisify)(cp.execFile);
+const WORKDIR = (imageId) => `/media/startos/images/${imageId}/`;
+const False = () => false;
+const TIMES_TO_WAIT_FOR_PROC = 100;
+/**
+ * Want to limit what we can do in a container, so we want to launch a container with a specific image and the mounts.
+ *
+ * Implements:
+ * @see {@link ExecSpawnable}
+ */
+class SubContainer {
+    constructor(effects, imageId, rootfs, guid) {
+        this.effects = effects;
+        this.imageId = imageId;
+        this.rootfs = rootfs;
+        this.guid = guid;
+        this.leaderExited = false;
+        this.leaderExited = false;
+        this.leader = cp.spawn("start-cli", ["subcontainer", "launch", rootfs], {
+            killSignal: "SIGKILL",
+            stdio: "ignore",
+        });
+        this.leader.on("exit", () => {
+            this.leaderExited = true;
+        });
+        this.waitProc = (0, once_1.once)(() => new Promise(async (resolve, reject) => {
+            let count = 0;
+            while (!(await fs.stat(`${this.rootfs}/proc/1`).then((x) => !!x, False))) {
+                if (count++ > TIMES_TO_WAIT_FOR_PROC) {
+                    console.debug("Failed to start subcontainer", {
+                        guid: this.guid,
+                        imageId: this.imageId,
+                        rootfs: this.rootfs,
+                    });
+                    reject(new Error(`Failed to start subcontainer ${this.imageId}`));
+                }
+                await wait(1);
+            }
+            resolve(null);
+        }));
+    }
+    static async of(effects, image, name) {
+        const { id, sharedRun } = image;
+        const [rootfs, guid] = await effects.subcontainer.createFs({
+            imageId: id,
+            name,
+        });
+        const shared = ["dev", "sys"];
+        if (!!sharedRun) {
+            shared.push("run");
+        }
+        await fs.mkdir(`${rootfs}/etc`, { recursive: true });
+        await fs.copyFile("/etc/resolv.conf", `${rootfs}/etc/resolv.conf`);
+        for (const dirPart of shared) {
+            const from = `/${dirPart}`;
+            const to = `${rootfs}/${dirPart}`;
+            await fs.mkdir(from, { recursive: true });
+            await fs.mkdir(to, { recursive: true });
+            await (0, exports.execFile)("mount", ["--rbind", from, to]);
+        }
+        return new SubContainer(effects, id, rootfs, guid);
+    }
+    static async with(effects, image, mounts, name, fn) {
+        const subContainer = await SubContainer.of(effects, image, name);
+        try {
+            for (let mount of mounts) {
+                await subContainer.mount(mount.options, mount.path);
+            }
+            return await fn(subContainer);
+        }
+        finally {
+            await subContainer.destroy();
+        }
+    }
+    async mount(options, path) {
+        path = path.startsWith("/")
+            ? `${this.rootfs}${path}`
+            : `${this.rootfs}/${path}`;
+        if (options.type === "volume") {
+            const subpath = options.subpath
+                ? options.subpath.startsWith("/")
+                    ? options.subpath
+                    : `/${options.subpath}`
+                : "/";
+            const from = `/media/startos/volumes/${options.id}${subpath}`;
+            await fs.mkdir(from, { recursive: true });
+            await fs.mkdir(path, { recursive: true });
+            await (0, exports.execFile)("mount", ["--bind", from, path]);
+        }
+        else if (options.type === "assets") {
+            const subpath = options.subpath
+                ? options.subpath.startsWith("/")
+                    ? options.subpath
+                    : `/${options.subpath}`
+                : "/";
+            const from = `/media/startos/assets/${options.id}${subpath}`;
+            await fs.mkdir(from, { recursive: true });
+            await fs.mkdir(path, { recursive: true });
+            await (0, exports.execFile)("mount", ["--bind", from, path]);
+        }
+        else if (options.type === "pointer") {
+            await this.effects.mount({ location: path, target: options });
+        }
+        else if (options.type === "backup") {
+            const subpath = options.subpath
+                ? options.subpath.startsWith("/")
+                    ? options.subpath
+                    : `/${options.subpath}`
+                : "/";
+            const from = `/media/startos/backup${subpath}`;
+            await fs.mkdir(from, { recursive: true });
+            await fs.mkdir(path, { recursive: true });
+            await (0, exports.execFile)("mount", ["--bind", from, path]);
+        }
+        else {
+            throw new Error(`unknown type ${options.type}`);
+        }
+        return this;
+    }
+    async killLeader() {
+        if (this.leaderExited) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                let timeout = setTimeout(() => this.leader.kill("SIGKILL"), 30000);
+                this.leader.on("exit", () => {
+                    clearTimeout(timeout);
+                    resolve(null);
+                });
+                if (!this.leader.kill("SIGTERM")) {
+                    reject(new Error("kill(2) failed"));
+                }
+            }
+            catch (e) {
+                reject(e);
+            }
+        });
+    }
+    get destroy() {
+        return async () => {
+            const guid = this.guid;
+            await this.killLeader();
+            await this.effects.subcontainer.destroyFs({ guid });
+            return null;
+        };
+    }
+    async exec(command, options, timeoutMs = 30000) {
+        await this.waitProc();
+        const imageMeta = await fs
+            .readFile(`/media/startos/images/${this.imageId}.json`, {
+            encoding: "utf8",
+        })
+            .catch(() => "{}")
+            .then(JSON.parse);
+        let extra = [];
+        if (options === null || options === void 0 ? void 0 : options.user) {
+            extra.push(`--user=${options.user}`);
+            delete options.user;
+        }
+        let workdir = imageMeta.workdir || "/";
+        if (options === null || options === void 0 ? void 0 : options.cwd) {
+            workdir = options.cwd;
+            delete options.cwd;
+        }
+        const child = cp.spawn("start-cli", [
+            "subcontainer",
+            "exec",
+            `--env=/media/startos/images/${this.imageId}.env`,
+            `--workdir=${workdir}`,
+            ...extra,
+            this.rootfs,
+            ...command,
+        ], options || {});
+        if (options === null || options === void 0 ? void 0 : options.input) {
+            await new Promise((resolve, reject) => child.stdin.write(options.input, (e) => {
+                if (e) {
+                    reject(e);
+                }
+                else {
+                    resolve(null);
+                }
+            }));
+            await new Promise((resolve) => child.stdin.end(resolve));
+        }
+        const pid = child.pid;
+        const stdout = { data: "" };
+        const stderr = { data: "" };
+        const appendData = (appendTo) => (chunk) => {
+            if (typeof appendTo.data === "string" && typeof chunk === "string") {
+                appendTo.data += chunk;
+            }
+            else if (typeof chunk === "string" || chunk instanceof node_buffer_1.Buffer) {
+                appendTo.data = node_buffer_1.Buffer.concat([
+                    new Uint8Array(node_buffer_1.Buffer.from(appendTo.data).buffer),
+                    new Uint8Array(node_buffer_1.Buffer.from(chunk).buffer),
+                ]);
+            }
+            else {
+                console.error("received unexpected chunk", chunk);
+            }
+        };
+        return new Promise((resolve, reject) => {
+            child.on("error", reject);
+            let killTimeout;
+            if (timeoutMs !== null && child.pid) {
+                killTimeout = setTimeout(() => child.kill("SIGKILL"), timeoutMs);
+            }
+            child.stdout.on("data", appendData(stdout));
+            child.stderr.on("data", appendData(stderr));
+            child.on("exit", (code, signal) => {
+                clearTimeout(killTimeout);
+                resolve({
+                    exitCode: code,
+                    exitSignal: signal,
+                    stdout: stdout.data,
+                    stderr: stderr.data,
+                });
+            });
+        });
+    }
+    async launch(command, options) {
+        await this.waitProc();
+        const imageMeta = await fs
+            .readFile(`/media/startos/images/${this.imageId}.json`, {
+            encoding: "utf8",
+        })
+            .catch(() => "{}")
+            .then(JSON.parse);
+        let extra = [];
+        if (options === null || options === void 0 ? void 0 : options.user) {
+            extra.push(`--user=${options.user}`);
+            delete options.user;
+        }
+        let workdir = imageMeta.workdir || "/";
+        if (options === null || options === void 0 ? void 0 : options.cwd) {
+            workdir = options.cwd;
+            delete options.cwd;
+        }
+        await this.killLeader();
+        this.leaderExited = false;
+        this.leader = cp.spawn("start-cli", [
+            "subcontainer",
+            "launch",
+            `--env=/media/startos/images/${this.imageId}.env`,
+            `--workdir=${workdir}`,
+            ...extra,
+            this.rootfs,
+            ...command,
+        ], { ...options, stdio: "inherit" });
+        this.leader.on("exit", () => {
+            this.leaderExited = true;
+        });
+        return this.leader;
+    }
+    async spawn(command, options) {
+        await this.waitProc();
+        const imageMeta = await fs
+            .readFile(`/media/startos/images/${this.imageId}.json`, {
+            encoding: "utf8",
+        })
+            .catch(() => "{}")
+            .then(JSON.parse);
+        let extra = [];
+        if (options === null || options === void 0 ? void 0 : options.user) {
+            extra.push(`--user=${options.user}`);
+            delete options.user;
+        }
+        let workdir = imageMeta.workdir || "/";
+        if (options === null || options === void 0 ? void 0 : options.cwd) {
+            workdir = options.cwd;
+            delete options.cwd;
+        }
+        return cp.spawn("start-cli", [
+            "subcontainer",
+            "exec",
+            `--env=/media/startos/images/${this.imageId}.env`,
+            `--workdir=${workdir}`,
+            ...extra,
+            this.rootfs,
+            ...command,
+        ], options);
+    }
+}
+exports.SubContainer = SubContainer;
+/**
+ * Take an subcontainer but remove the ability to add the mounts and the destroy function.
+ * Lets other functions, like health checks, to not destroy the parents.
+ *
+ */
+class SubContainerHandle {
+    constructor(subContainer) {
+        this.subContainer = subContainer;
+    }
+    get destroy() {
+        return undefined;
+    }
+    exec(command, options, timeoutMs) {
+        return this.subContainer.exec(command, options, timeoutMs);
+    }
+    spawn(command, options) {
+        return this.subContainer.spawn(command, options);
+    }
+}
+exports.SubContainerHandle = SubContainerHandle;
+function wait(time) {
+    return new Promise((resolve) => setTimeout(resolve, time));
+}
+//# sourceMappingURL=SubContainer.js.map

package/package/lib/util/SubContainer.js.map

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

package/package/lib/util/fileHelper.d.ts

@@ -0,0 +1,79 @@
+import * as matches from "ts-matches";
+import * as T from "../../../base/lib/types";
+/**
+ * @description Use this class to read/write an underlying configuration file belonging to the upstream service.
+ *
+ * Using the static functions, choose between officially supported file formats (json, yaml, toml), or a custom format (raw).
+ * @example
+ * Below are a few examples
+ *
+ * ```
+ * import { matches, FileHelper } from '@start9labs/start-sdk'
+ * const { arrayOf, boolean, literal, literals, object, oneOf, natural, string } = matches
+ *
+ * export const jsonFile = FileHelper.json('./inputSpec.json', object({
+ *   passwords: arrayOf(string)
+ *   type: oneOf(literals('private', 'public'))
+ * }))
+ *
+ * export const tomlFile = FileHelper.toml('./inputSpec.toml', object({
+ *   url: literal('https://start9.com')
+ *   public: boolean
+ * }))
+ *
+ * export const yamlFile = FileHelper.yaml('./inputSpec.yml', object({
+ *   name: string
+ *   age: natural
+ * }))
+ *
+ * export const bitcoinConfFile = FileHelper.raw(
+ *   './service.conf',
+ *   (obj: CustomType) => customConvertObjToFormattedString(obj),
+ *   (str) => customParseStringToTypedObj(str),
+ * )
+ * ```
+ */
+export declare class FileHelper<A> {
+    readonly path: string;
+    readonly writeData: (dataIn: A) => string;
+    readonly readData: (stringValue: string) => A;
+    protected constructor(path: string, writeData: (dataIn: A) => string, readData: (stringValue: string) => A);
+    /**
+     * Accepts structured data and overwrites the existing file on disk.
+     */
+    write(data: A): Promise<null>;
+    /**
+     * Reads the file from disk and converts it to structured data.
+     */
+    private readOnce;
+    private readConst;
+    private readWatch;
+    get read(): {
+        once: () => Promise<A | null>;
+        const: (effects: T.Effects) => Promise<A | null>;
+        watch: () => AsyncGenerator<Awaited<A> | null, null, unknown>;
+    };
+    /**
+     * Accepts structured data and performs a merge with the existing file on disk.
+     */
+    merge(data: A): Promise<null>;
+    /**
+     * Create a File Helper for an arbitrary file type.
+     *
+     * Provide custom functions for translating data to/from the file format.
+     */
+    static raw<A>(path: string, toFile: (dataIn: A) => string, fromFile: (rawData: string) => A): FileHelper<A>;
+    /**
+     * Create a File Helper for a .json file.
+     */
+    static json<A>(path: string, shape: matches.Validator<unknown, A>): FileHelper<A>;
+    /**
+     * Create a File Helper for a .toml file
+     */
+    static toml<A extends Record<string, unknown>>(path: string, shape: matches.Validator<unknown, A>): FileHelper<A>;
+    /**
+     * Create a File Helper for a .yaml file
+     */
+    static yaml<A extends Record<string, unknown>>(path: string, shape: matches.Validator<unknown, A>): FileHelper<A>;
+}
+export default FileHelper;

package/package/lib/util/fileHelper.js

@@ -0,0 +1,211 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileHelper = void 0;
+const YAML = __importStar(require("yaml"));
+const TOML = __importStar(require("@iarna/toml"));
+const lodash_merge_1 = __importDefault(require("lodash.merge"));
+const fs = __importStar(require("node:fs/promises"));
+const util_1 = require("../../../base/lib/util");
+const previousPath = /(.+?)\/([^/]*)$/;
+const exists = (path) => fs.access(path).then(() => true, () => false);
+async function onCreated(path) {
+    if (path === "/")
+        return;
+    if (!path.startsWith("/"))
+        path = `${process.cwd()}/${path}`;
+    if (await exists(path)) {
+        return;
+    }
+    const split = path.split("/");
+    const filename = split.pop();
+    const parent = split.join("/");
+    await onCreated(parent);
+    const ctrl = new AbortController();
+    const watch = fs.watch(parent, { persistent: false, signal: ctrl.signal });
+    if (await fs.access(path).then(() => true, () => false)) {
+        ctrl.abort("finished");
+        return;
+    }
+    for await (let event of watch) {
+        if (event.filename === filename) {
+            ctrl.abort("finished");
+            return;
+        }
+    }
+}
+/**
+ * @description Use this class to read/write an underlying configuration file belonging to the upstream service.
+ *
+ * Using the static functions, choose between officially supported file formats (json, yaml, toml), or a custom format (raw).
+ * @example
+ * Below are a few examples
+ *
+ * ```
+ * import { matches, FileHelper } from '@start9labs/start-sdk'
+ * const { arrayOf, boolean, literal, literals, object, oneOf, natural, string } = matches
+ *
+ * export const jsonFile = FileHelper.json('./inputSpec.json', object({
+ *   passwords: arrayOf(string)
+ *   type: oneOf(literals('private', 'public'))
+ * }))
+ *
+ * export const tomlFile = FileHelper.toml('./inputSpec.toml', object({
+ *   url: literal('https://start9.com')
+ *   public: boolean
+ * }))
+ *
+ * export const yamlFile = FileHelper.yaml('./inputSpec.yml', object({
+ *   name: string
+ *   age: natural
+ * }))
+ *
+ * export const bitcoinConfFile = FileHelper.raw(
+ *   './service.conf',
+ *   (obj: CustomType) => customConvertObjToFormattedString(obj),
+ *   (str) => customParseStringToTypedObj(str),
+ * )
+ * ```
+ */
+class FileHelper {
+    constructor(path, writeData, readData) {
+        this.path = path;
+        this.writeData = writeData;
+        this.readData = readData;
+    }
+    /**
+     * Accepts structured data and overwrites the existing file on disk.
+     */
+    async write(data) {
+        const parent = previousPath.exec(this.path);
+        if (parent) {
+            await fs.mkdir(parent[1], { recursive: true });
+        }
+        await fs.writeFile(this.path, this.writeData(data));
+        return null;
+    }
+    /**
+     * Reads the file from disk and converts it to structured data.
+     */
+    async readOnce() {
+        if (!(await exists(this.path))) {
+            return null;
+        }
+        return this.readData(await fs.readFile(this.path).then((data) => data.toString("utf-8")));
+    }
+    async readConst(effects) {
+        const watch = this.readWatch();
+        const res = await watch.next();
+        watch.next().then(effects.constRetry);
+        return res.value;
+    }
+    async *readWatch() {
+        let res;
+        while (true) {
+            if (await exists(this.path)) {
+                const ctrl = new AbortController();
+                const watch = fs.watch(this.path, {
+                    persistent: false,
+                    signal: ctrl.signal,
+                });
+                res = await this.readOnce();
+                const listen = Promise.resolve()
+                    .then(async () => {
+                    for await (const _ of watch) {
+                        ctrl.abort("finished");
+                        return null;
+                    }
+                })
+                    .catch((e) => console.error((0, util_1.asError)(e)));
+                yield res;
+                await listen;
+            }
+            else {
+                yield null;
+                await onCreated(this.path).catch((e) => console.error((0, util_1.asError)(e)));
+            }
+        }
+        return null;
+    }
+    get read() {
+        return {
+            once: () => this.readOnce(),
+            const: (effects) => this.readConst(effects),
+            watch: () => this.readWatch(),
+        };
+    }
+    /**
+     * Accepts structured data and performs a merge with the existing file on disk.
+     */
+    async merge(data) {
+        const fileData = (await this.readOnce().catch(() => ({}))) || {};
+        const mergeData = (0, lodash_merge_1.default)({}, fileData, data);
+        return await this.write(mergeData);
+    }
+    /**
+     * Create a File Helper for an arbitrary file type.
+     *
+     * Provide custom functions for translating data to/from the file format.
+     */
+    static raw(path, toFile, fromFile) {
+        return new FileHelper(path, toFile, fromFile);
+    }
+    /**
+     * Create a File Helper for a .json file.
+     */
+    static json(path, shape) {
+        return new FileHelper(path, (inData) => {
+            return JSON.stringify(inData, null, 2);
+        }, (inString) => {
+            return shape.unsafeCast(JSON.parse(inString));
+        });
+    }
+    /**
+     * Create a File Helper for a .toml file
+     */
+    static toml(path, shape) {
+        return new FileHelper(path, (inData) => {
+            return TOML.stringify(inData);
+        }, (inString) => {
+            return shape.unsafeCast(TOML.parse(inString));
+        });
+    }
+    /**
+     * Create a File Helper for a .yaml file
+     */
+    static yaml(path, shape) {
+        return new FileHelper(path, (inData) => {
+            return YAML.stringify(inData, null, 2);
+        }, (inString) => {
+            return shape.unsafeCast(YAML.parse(inString));
+        });
+    }
+}
+exports.FileHelper = FileHelper;
+exports.default = FileHelper;
+//# sourceMappingURL=fileHelper.js.map

package/package/lib/util/fileHelper.js.map

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

package/package/lib/util/index.d.ts

@@ -0,0 +1,3 @@
+export * from "../../../base/lib/util";
+export { GetSslCertificate } from "./GetSslCertificate";
+export { hostnameInfoToAddress } from "../../../base/lib/util/Hostname";