@start9labs/start-sdk 0.3.6-alpha.10

package/package/lib/StartSdk.js.map

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

package/package/lib/backup/Backups.d.ts

@@ -0,0 +1,52 @@
+import * as T from "../../../base/lib/types";
+export declare const DEFAULT_OPTIONS: T.SyncOptions;
+export type BackupSync<Volumes extends string> = {
+    dataPath: `/media/startos/volumes/${Volumes}/${string}`;
+    backupPath: `/media/startos/backup/${string}`;
+    options?: Partial<T.SyncOptions>;
+    backupOptions?: Partial<T.SyncOptions>;
+    restoreOptions?: Partial<T.SyncOptions>;
+};
+/**
+ * This utility simplifies the volume backup process.
+ * ```ts
+ * export const { createBackup, restoreBackup } = Backups.volumes("main").build();
+ * ```
+ *
+ * Changing the options of the rsync, (ie excludes) use either
+ * ```ts
+ *  Backups.volumes("main").set_options({exclude: ['bigdata/']}).volumes('excludedVolume').build()
+ * // or
+ *  Backups.with_options({exclude: ['bigdata/']}).volumes('excludedVolume').build()
+ * ```
+ *
+ * Using the more fine control, using the addSets for more control
+ * ```ts
+ * Backups.addSets({
+ * srcVolume: 'main', srcPath:'smallData/', dstPath: 'main/smallData/', dstVolume: : Backups.BACKUP
+ * }, {
+ * srcVolume: 'main', srcPath:'bigData/', dstPath: 'main/bigData/', dstVolume: : Backups.BACKUP, options: {exclude:['bigData/excludeThis']}}
+ * ).build()q
+ * ```
+ */
+export declare class Backups<M extends T.Manifest> {
+    private options;
+    private restoreOptions;
+    private backupOptions;
+    private backupSet;
+    private constructor();
+    static withVolumes<M extends T.Manifest = never>(...volumeNames: Array<M["volumes"][number]>): Backups<M>;
+    static withSyncs<M extends T.Manifest = never>(...syncs: BackupSync<M["volumes"][number]>[]): Backups<M>;
+    static withOptions<M extends T.Manifest = never>(options?: Partial<T.SyncOptions>): Backups<M>;
+    setOptions(options?: Partial<T.SyncOptions>): this;
+    setBackupOptions(options?: Partial<T.SyncOptions>): this;
+    setRestoreOptions(options?: Partial<T.SyncOptions>): this;
+    addVolume(volume: M["volumes"][number], options?: Partial<{
+        options: T.SyncOptions;
+        backupOptions: T.SyncOptions;
+        restoreOptions: T.SyncOptions;
+    }>): this;
+    addSync(sync: BackupSync<M["volumes"][0]>): this;
+    createBackup(): Promise<void>;
+    restoreBackup(): Promise<void>;
+}

package/package/lib/backup/Backups.js

@@ -0,0 +1,194 @@
+"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.Backups = exports.DEFAULT_OPTIONS = void 0;
+const child_process = __importStar(require("child_process"));
+const util_1 = require("../util");
+exports.DEFAULT_OPTIONS = {
+    delete: true,
+    exclude: [],
+};
+/**
+ * This utility simplifies the volume backup process.
+ * ```ts
+ * export const { createBackup, restoreBackup } = Backups.volumes("main").build();
+ * ```
+ *
+ * Changing the options of the rsync, (ie excludes) use either
+ * ```ts
+ *  Backups.volumes("main").set_options({exclude: ['bigdata/']}).volumes('excludedVolume').build()
+ * // or
+ *  Backups.with_options({exclude: ['bigdata/']}).volumes('excludedVolume').build()
+ * ```
+ *
+ * Using the more fine control, using the addSets for more control
+ * ```ts
+ * Backups.addSets({
+ * srcVolume: 'main', srcPath:'smallData/', dstPath: 'main/smallData/', dstVolume: : Backups.BACKUP
+ * }, {
+ * srcVolume: 'main', srcPath:'bigData/', dstPath: 'main/bigData/', dstVolume: : Backups.BACKUP, options: {exclude:['bigData/excludeThis']}}
+ * ).build()q
+ * ```
+ */
+class Backups {
+    constructor(options = exports.DEFAULT_OPTIONS, restoreOptions = {}, backupOptions = {}, backupSet = []) {
+        this.options = options;
+        this.restoreOptions = restoreOptions;
+        this.backupOptions = backupOptions;
+        this.backupSet = backupSet;
+    }
+    static withVolumes(...volumeNames) {
+        return Backups.withSyncs(...volumeNames.map((srcVolume) => ({
+            dataPath: `/media/startos/volumes/${srcVolume}/`,
+            backupPath: `/media/startos/backup/${srcVolume}/`,
+        })));
+    }
+    static withSyncs(...syncs) {
+        return syncs.reduce((acc, x) => acc.addSync(x), new Backups());
+    }
+    static withOptions(options) {
+        return new Backups({ ...exports.DEFAULT_OPTIONS, ...options });
+    }
+    setOptions(options) {
+        this.options = {
+            ...this.options,
+            ...options,
+        };
+        return this;
+    }
+    setBackupOptions(options) {
+        this.backupOptions = {
+            ...this.backupOptions,
+            ...options,
+        };
+        return this;
+    }
+    setRestoreOptions(options) {
+        this.restoreOptions = {
+            ...this.restoreOptions,
+            ...options,
+        };
+        return this;
+    }
+    addVolume(volume, options) {
+        return this.addSync({
+            dataPath: `/media/startos/volumes/${volume}/`,
+            backupPath: `/media/startos/backup/${volume}/`,
+            ...options,
+        });
+    }
+    addSync(sync) {
+        this.backupSet.push({
+            ...sync,
+            options: { ...this.options, ...sync.options },
+        });
+        return this;
+    }
+    async createBackup() {
+        for (const item of this.backupSet) {
+            const rsyncResults = await runRsync({
+                srcPath: item.dataPath,
+                dstPath: item.backupPath,
+                options: {
+                    ...this.options,
+                    ...this.backupOptions,
+                    ...item.options,
+                    ...item.backupOptions,
+                },
+            });
+            await rsyncResults.wait();
+        }
+        return;
+    }
+    async restoreBackup() {
+        for (const item of this.backupSet) {
+            const rsyncResults = await runRsync({
+                srcPath: item.backupPath,
+                dstPath: item.dataPath,
+                options: {
+                    ...this.options,
+                    ...this.backupOptions,
+                    ...item.options,
+                    ...item.backupOptions,
+                },
+            });
+            await rsyncResults.wait();
+        }
+        return;
+    }
+}
+exports.Backups = Backups;
+async function runRsync(rsyncOptions) {
+    const { srcPath, dstPath, options } = rsyncOptions;
+    const command = "rsync";
+    const args = [];
+    if (options.delete) {
+        args.push("--delete");
+    }
+    for (const exclude of options.exclude) {
+        args.push(`--exclude=${exclude}`);
+    }
+    args.push("-actAXH");
+    args.push("--info=progress2");
+    args.push("--no-inc-recursive");
+    args.push(srcPath);
+    args.push(dstPath);
+    const spawned = child_process.spawn(command, args, { detached: true });
+    let percentage = 0.0;
+    spawned.stdout.on("data", (data) => {
+        var _a;
+        const lines = String(data).replace("\r", "\n").split("\n");
+        for (const line of lines) {
+            const parsed = (_a = /$([0-9.]+)%/.exec(line)) === null || _a === void 0 ? void 0 : _a[1];
+            if (!parsed)
+                continue;
+            percentage = Number.parseFloat(parsed);
+        }
+    });
+    spawned.stderr.on("data", (data) => {
+        console.error(`Backups.runAsync`, (0, util_1.asError)(data));
+    });
+    const id = async () => {
+        const pid = spawned.pid;
+        if (pid === undefined) {
+            throw new Error("rsync process has no pid");
+        }
+        return String(pid);
+    };
+    const waitPromise = new Promise((resolve, reject) => {
+        spawned.on("exit", (code) => {
+            if (code === 0) {
+                resolve(null);
+            }
+            else {
+                reject(new Error(`rsync exited with code ${code}`));
+            }
+        });
+    });
+    const wait = () => waitPromise;
+    const progress = () => Promise.resolve(percentage);
+    return { id, wait, progress };
+}
+//# sourceMappingURL=Backups.js.map

package/package/lib/backup/Backups.js.map

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

package/package/lib/backup/index.d.ts

@@ -0,0 +1,2 @@
+import "./Backups";
+import "./setupBackups";

package/package/lib/backup/index.js

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

package/package/lib/backup/index.js.map

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

package/package/lib/backup/setupBackups.d.ts

@@ -0,0 +1,9 @@
+import { Backups } from "./Backups";
+import * as T from "../../../base/lib/types";
+export type SetupBackupsParams<M extends T.Manifest> = M["volumes"][number][] | ((_: {
+    effects: T.Effects;
+}) => Promise<Backups<M>>);
+export declare function setupBackups<M extends T.Manifest>(options: SetupBackupsParams<M>): {
+    createBackup: T.ExpectedExports.createBackup;
+    restoreBackup: T.ExpectedExports.restoreBackup;
+};

package/package/lib/backup/setupBackups.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupBackups = void 0;
+const Backups_1 = require("./Backups");
+function setupBackups(options) {
+    let backupsFactory;
+    if (options instanceof Function) {
+        backupsFactory = options;
+    }
+    else {
+        backupsFactory = async () => Backups_1.Backups.withVolumes(...options);
+    }
+    const answer = {
+        get createBackup() {
+            return (async (options) => {
+                return (await backupsFactory(options)).createBackup();
+            });
+        },
+        get restoreBackup() {
+            return (async (options) => {
+                return (await backupsFactory(options)).restoreBackup();
+            });
+        },
+    };
+    return answer;
+}
+exports.setupBackups = setupBackups;
+//# sourceMappingURL=setupBackups.js.map

package/package/lib/backup/setupBackups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupBackups.js","sourceRoot":"","sources":["../../../../package/lib/backup/setupBackups.ts"],"names":[],"mappings":";;;AAAA,uCAAmC;AAanC,SAAgB,YAAY,CAC1B,OAA8B;IAE9B,IAAI,cAAkE,CAAA;IACtE,IAAI,OAAO,YAAY,QAAQ,EAAE;QAC/B,cAAc,GAAG,OAAO,CAAA;KACzB;SAAM;QACL,cAAc,GAAG,KAAK,IAAI,EAAE,CAAC,iBAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,CAAA;KAC7D;IACD,MAAM,MAAM,GAGR;QACF,IAAI,YAAY;YACd,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBACxB,OAAO,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,CAAA;YACvD,CAAC,CAAmC,CAAA;QACtC,CAAC;QACD,IAAI,aAAa;YACf,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBACxB,OAAO,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;YACxD,CAAC,CAAoC,CAAA;QACvC,CAAC;KACF,CAAA;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAzBD,oCAyBC"}

package/package/lib/health/HealthCheck.d.ts

@@ -0,0 +1,11 @@
+import { Effects, HealthReceipt } from "../../../base/lib/types";
+import { HealthCheckResult } from "./checkFns/HealthCheckResult";
+import { Trigger } from "../trigger";
+export type HealthCheckParams = {
+    effects: Effects;
+    name: string;
+    trigger?: Trigger;
+    fn(): Promise<HealthCheckResult> | HealthCheckResult;
+    onFirstSuccess?: () => unknown | Promise<unknown>;
+};
+export declare function healthCheck(o: HealthCheckParams): HealthReceipt;

package/package/lib/health/HealthCheck.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healthCheck = void 0;
+const defaultTrigger_1 = require("../trigger/defaultTrigger");
+const util_1 = require("../util");
+const ts_matches_1 = require("ts-matches");
+function healthCheck(o) {
+    new Promise(async () => {
+        var _a;
+        let currentValue = {};
+        const getCurrentValue = () => currentValue;
+        const trigger = ((_a = o.trigger) !== null && _a !== void 0 ? _a : defaultTrigger_1.defaultTrigger)(getCurrentValue);
+        const triggerFirstSuccess = (0, util_1.once)(() => Promise.resolve("onFirstSuccess" in o && o.onFirstSuccess
+            ? o.onFirstSuccess()
+            : undefined));
+        for (let res = await trigger.next(); !res.done; res = await trigger.next()) {
+            try {
+                const { result, message } = await o.fn();
+                await o.effects.setHealth({
+                    name: o.name,
+                    id: o.name,
+                    result,
+                    message: message || "",
+                });
+                currentValue.lastResult = result;
+                await triggerFirstSuccess().catch((err) => {
+                    console.error((0, util_1.asError)(err));
+                });
+            }
+            catch (e) {
+                await o.effects.setHealth({
+                    name: o.name,
+                    id: o.name,
+                    result: "failure",
+                    message: asMessage(e) || "",
+                });
+                currentValue.lastResult = "failure";
+            }
+        }
+    });
+    return {};
+}
+exports.healthCheck = healthCheck;
+function asMessage(e) {
+    if ((0, ts_matches_1.object)({ message: ts_matches_1.unknown }).test(e))
+        return String(e.message);
+    const value = String(e);
+    if (value.length == null)
+        return null;
+    return value;
+}
+//# sourceMappingURL=HealthCheck.js.map

package/package/lib/health/HealthCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthCheck.js","sourceRoot":"","sources":["../../../../package/lib/health/HealthCheck.ts"],"names":[],"mappings":";;;AAIA,8DAA0D;AAC1D,kCAAuC;AACvC,2CAA4C;AAU5C,SAAgB,WAAW,CAAC,CAAoB;IAC9C,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE;;QACrB,IAAI,YAAY,GAAiB,EAAE,CAAA;QACnC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,YAAY,CAAA;QAC1C,MAAM,OAAO,GAAG,CAAC,MAAA,CAAC,CAAC,OAAO,mCAAI,+BAAc,CAAC,CAAC,eAAe,CAAC,CAAA;QAC9D,MAAM,mBAAmB,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,CACpC,OAAO,CAAC,OAAO,CACb,gBAAgB,IAAI,CAAC,IAAI,CAAC,CAAC,cAAc;YACvC,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE;YACpB,CAAC,CAAC,SAAS,CACd,CACF,CAAA;QACD,KACE,IAAI,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAC9B,CAAC,GAAG,CAAC,IAAI,EACT,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAC1B;YACA,IAAI;gBACF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,CAAA;gBACxC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;oBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,EAAE,EAAE,CAAC,CAAC,IAAI;oBACV,MAAM;oBACN,OAAO,EAAE,OAAO,IAAI,EAAE;iBACvB,CAAC,CAAA;gBACF,YAAY,CAAC,UAAU,GAAG,MAAM,CAAA;gBAChC,MAAM,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACxC,OAAO,CAAC,KAAK,CAAC,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC,CAAA;gBAC7B,CAAC,CAAC,CAAA;aACH;YAAC,OAAO,CAAC,EAAE;gBACV,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;oBACxB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,EAAE,EAAE,CAAC,CAAC,IAAI;oBACV,MAAM,EAAE,SAAS;oBACjB,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE;iBAC5B,CAAC,CAAA;gBACF,YAAY,CAAC,UAAU,GAAG,SAAS,CAAA;aACpC;SACF;IACH,CAAC,CAAC,CAAA;IACF,OAAO,EAAmB,CAAA;AAC5B,CAAC;AAzCD,kCAyCC;AACD,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,IAAA,mBAAM,EAAC,EAAE,OAAO,EAAE,oBAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IACvB,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACrC,OAAO,KAAK,CAAA;AACd,CAAC"}

package/package/lib/health/checkFns/HealthCheckResult.d.ts

@@ -0,0 +1,2 @@
+import { T } from "../../../../base/lib";
+export type HealthCheckResult = Omit<T.NamedHealthCheckResult, "name">;

package/package/lib/health/checkFns/HealthCheckResult.js

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

package/package/lib/health/checkFns/HealthCheckResult.js.map

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

package/package/lib/health/checkFns/checkPortListening.d.ts

@@ -0,0 +1,13 @@
+import { Effects } from "../../../../base/lib/types";
+import { HealthCheckResult } from "./HealthCheckResult";
+export declare function containsAddress(x: string, port: number): boolean;
+/**
+ * This is used to check if a port is listening on the system.
+ * Used during the health check fn or the check main fn.
+ */
+export declare function checkPortListening(effects: Effects, port: number, options: {
+    errorMessage: string;
+    successMessage: string;
+    timeoutMessage?: string;
+    timeout?: number;
+}): Promise<HealthCheckResult>;

package/package/lib/health/checkFns/checkPortListening.js

@@ -0,0 +1,71 @@
+"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.checkPortListening = exports.containsAddress = void 0;
+const util_1 = require("../../util");
+const node_util_1 = require("node:util");
+const CP = __importStar(require("node:child_process"));
+const cpExec = (0, node_util_1.promisify)(CP.exec);
+const cpExecFile = (0, node_util_1.promisify)(CP.execFile);
+function containsAddress(x, port) {
+    const readPorts = x
+        .split("\n")
+        .filter(Boolean)
+        .splice(1)
+        .map((x) => { var _a, _b; return (_b = (_a = x.split(" ").filter(Boolean)[1]) === null || _a === void 0 ? void 0 : _a.split(":")) === null || _b === void 0 ? void 0 : _b[1]; })
+        .filter(Boolean)
+        .map((x) => Number.parseInt(x, 16))
+        .filter(Number.isFinite);
+    return readPorts.indexOf(port) >= 0;
+}
+exports.containsAddress = containsAddress;
+/**
+ * This is used to check if a port is listening on the system.
+ * Used during the health check fn or the check main fn.
+ */
+async function checkPortListening(effects, port, options) {
+    return Promise.race([
+        Promise.resolve().then(async () => {
+            const hasAddress = containsAddress(await cpExec(`cat /proc/net/tcp`, {}).then(util_1.stringFromStdErrOut), port) ||
+                containsAddress(await cpExec("cat /proc/net/udp", {}).then(util_1.stringFromStdErrOut), port);
+            if (hasAddress) {
+                return { result: "success", message: options.successMessage };
+            }
+            return {
+                result: "failure",
+                message: options.errorMessage,
+            };
+        }),
+        new Promise((resolve) => {
+            var _a;
+            setTimeout(() => resolve({
+                result: "failure",
+                message: options.timeoutMessage || `Timeout trying to check port ${port}`,
+            }), (_a = options.timeout) !== null && _a !== void 0 ? _a : 1000);
+        }),
+    ]);
+}
+exports.checkPortListening = checkPortListening;
+//# sourceMappingURL=checkPortListening.js.map

package/package/lib/health/checkFns/checkPortListening.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkPortListening.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/checkPortListening.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,qCAAgD;AAGhD,yCAAqC;AACrC,uDAAwC;AAExC,MAAM,MAAM,GAAG,IAAA,qBAAS,EAAC,EAAE,CAAC,IAAI,CAAC,CAAA;AACjC,MAAM,UAAU,GAAG,IAAA,qBAAS,EAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;AACzC,SAAgB,eAAe,CAAC,CAAS,EAAE,IAAY;IACrD,MAAM,SAAS,GAAG,CAAC;SAChB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CAAC,CAAC,CAAC;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,eAAC,OAAA,MAAA,MAAA,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,0CAAE,KAAK,CAAC,GAAG,CAAC,0CAAG,CAAC,CAAC,CAAA,EAAA,CAAC;SAC5D,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SAClC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC1B,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACrC,CAAC;AAVD,0CAUC;AAED;;;GAGG;AACI,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,IAAY,EACZ,OAKC;IAED,OAAO,OAAO,CAAC,IAAI,CAAoB;QACrC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAChC,MAAM,UAAU,GACd,eAAe,CACb,MAAM,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,0BAAmB,CAAC,EAC/D,IAAI,CACL;gBACD,eAAe,CACb,MAAM,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,0BAAmB,CAAC,EAC/D,IAAI,CACL,CAAA;YACH,IAAI,UAAU,EAAE;gBACd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE,CAAA;aAC9D;YACD,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,OAAO,CAAC,YAAY;aAC9B,CAAA;QACH,CAAC,CAAC;QACF,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;;YACtB,UAAU,CACR,GAAG,EAAE,CACH,OAAO,CAAC;gBACN,MAAM,EAAE,SAAS;gBACjB,OAAO,EACL,OAAO,CAAC,cAAc,IAAI,gCAAgC,IAAI,EAAE;aACnE,CAAC,EACJ,MAAA,OAAO,CAAC,OAAO,mCAAI,IAAK,CACzB,CAAA;QACH,CAAC,CAAC;KACH,CAAC,CAAA;AACJ,CAAC;AAzCD,gDAyCC"}

package/package/lib/health/checkFns/checkWebUrl.d.ts

@@ -0,0 +1,14 @@
+import { Effects } from "../../../../base/lib/types";
+import { HealthCheckResult } from "./HealthCheckResult";
+import "isomorphic-fetch";
+/**
+ * This is a helper function to check if a web url is reachable.
+ * @param url
+ * @param createSuccess
+ * @returns
+ */
+export declare const checkWebUrl: (effects: Effects, url: string, { timeout, successMessage, errorMessage, }?: {
+    timeout?: number | undefined;
+    successMessage?: string | undefined;
+    errorMessage?: string | undefined;
+}) => Promise<HealthCheckResult>;

package/package/lib/health/checkFns/checkWebUrl.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkWebUrl = void 0;
+const util_1 = require("../../util");
+const index_1 = require("./index");
+require("isomorphic-fetch");
+/**
+ * This is a helper function to check if a web url is reachable.
+ * @param url
+ * @param createSuccess
+ * @returns
+ */
+const checkWebUrl = async (effects, url, { timeout = 1000, successMessage = `Reached ${url}`, errorMessage = `Error while fetching URL: ${url}`, } = {}) => {
+    return Promise.race([fetch(url), (0, index_1.timeoutPromise)(timeout)])
+        .then((x) => ({
+        result: "success",
+        message: successMessage,
+    }))
+        .catch((e) => {
+        console.warn(`Error while fetching URL: ${url}`);
+        console.error(JSON.stringify(e));
+        console.error((0, util_1.asError)(e));
+        return { result: "failure", message: errorMessage };
+    });
+};
+exports.checkWebUrl = checkWebUrl;
+//# sourceMappingURL=checkWebUrl.js.map

package/package/lib/health/checkFns/checkWebUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkWebUrl.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/checkWebUrl.ts"],"names":[],"mappings":";;;AACA,qCAAoC;AAEpC,mCAAwC;AACxC,4BAAyB;AAEzB;;;;;GAKG;AACI,MAAM,WAAW,GAAG,KAAK,EAC9B,OAAgB,EAChB,GAAW,EACX,EACE,OAAO,GAAG,IAAI,EACd,cAAc,GAAG,WAAW,GAAG,EAAE,EACjC,YAAY,GAAG,6BAA6B,GAAG,EAAE,GAClD,GAAG,EAAE,EACsB,EAAE;IAC9B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAA,sBAAc,EAAC,OAAO,CAAC,CAAC,CAAC;SACvD,IAAI,CACH,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC;QACC,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,cAAc;KACxB,CAAU,CACd;SACA,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACX,OAAO,CAAC,IAAI,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAA;QAChD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAChC,OAAO,CAAC,KAAK,CAAC,IAAA,cAAO,EAAC,CAAC,CAAC,CAAC,CAAA;QACzB,OAAO,EAAE,MAAM,EAAE,SAAkB,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;IAC9D,CAAC,CAAC,CAAA;AACN,CAAC,CAAA;AAvBY,QAAA,WAAW,eAuBvB"}

package/package/lib/health/checkFns/index.d.ts

@@ -0,0 +1,8 @@
+import { runHealthScript } from "./runHealthScript";
+export { checkPortListening } from "./checkPortListening";
+export { HealthCheckResult } from "./HealthCheckResult";
+export { checkWebUrl } from "./checkWebUrl";
+export declare function timeoutPromise(ms: number, { message }?: {
+    message?: string | undefined;
+}): Promise<never>;
+export { runHealthScript };

package/package/lib/health/checkFns/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHealthScript = exports.timeoutPromise = exports.checkWebUrl = exports.checkPortListening = void 0;
+const runHealthScript_1 = require("./runHealthScript");
+Object.defineProperty(exports, "runHealthScript", { enumerable: true, get: function () { return runHealthScript_1.runHealthScript; } });
+var checkPortListening_1 = require("./checkPortListening");
+Object.defineProperty(exports, "checkPortListening", { enumerable: true, get: function () { return checkPortListening_1.checkPortListening; } });
+var checkWebUrl_1 = require("./checkWebUrl");
+Object.defineProperty(exports, "checkWebUrl", { enumerable: true, get: function () { return checkWebUrl_1.checkWebUrl; } });
+function timeoutPromise(ms, { message = "Timed out" } = {}) {
+    return new Promise((resolve, reject) => setTimeout(() => reject(new Error(message)), ms));
+}
+exports.timeoutPromise = timeoutPromise;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/index.ts"],"names":[],"mappings":";;;AAAA,uDAAmD;AAU1C,gGAVA,iCAAe,OAUA;AATxB,2DAAyD;AAAhD,wHAAA,kBAAkB,OAAA;AAE3B,6CAA2C;AAAlC,0GAAA,WAAW,OAAA;AAEpB,SAAgB,cAAc,CAAC,EAAU,EAAE,EAAE,OAAO,GAAG,WAAW,EAAE,GAAG,EAAE;IACvE,OAAO,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAC5C,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,CACjD,CAAA;AACH,CAAC;AAJD,wCAIC"}

package/package/lib/health/checkFns/runHealthScript.d.ts

@@ -0,0 +1,14 @@
+import { HealthCheckResult } from "./HealthCheckResult";
+import { SubContainer } from "../../util/SubContainer";
+/**
+ * Running a health script, is used when we want to have a simple
+ * script in bash or something like that. It should return something that is useful
+ * in {result: string} else it is considered an error
+ * @param param0
+ * @returns
+ */
+export declare const runHealthScript: (runCommand: string[], subcontainer: SubContainer, { timeout, errorMessage, message, }?: {
+    timeout?: number | undefined;
+    errorMessage?: string | undefined;
+    message?: ((res: string) => string) | undefined;
+}) => Promise<HealthCheckResult>;

package/package/lib/health/checkFns/runHealthScript.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runHealthScript = void 0;
+const index_1 = require("./index");
+/**
+ * Running a health script, is used when we want to have a simple
+ * script in bash or something like that. It should return something that is useful
+ * in {result: string} else it is considered an error
+ * @param param0
+ * @returns
+ */
+const runHealthScript = async (runCommand, subcontainer, { timeout = 30000, errorMessage = `Error while running command: ${runCommand}`, message = (res) => `Have ran script ${runCommand} and the result: ${res}`, } = {}) => {
+    const res = await Promise.race([
+        subcontainer.exec(runCommand),
+        (0, index_1.timeoutPromise)(timeout),
+    ]).catch((e) => {
+        console.warn(errorMessage);
+        console.warn(JSON.stringify(e));
+        console.warn(e.toString());
+        throw { result: "failure", message: errorMessage };
+    });
+    return {
+        result: "success",
+        message: message(res.stdout.toString()),
+    };
+};
+exports.runHealthScript = runHealthScript;
+//# sourceMappingURL=runHealthScript.js.map

package/package/lib/health/checkFns/runHealthScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runHealthScript.js","sourceRoot":"","sources":["../../../../../package/lib/health/checkFns/runHealthScript.ts"],"names":[],"mappings":";;;AACA,mCAAwC;AAGxC;;;;;;GAMG;AACI,MAAM,eAAe,GAAG,KAAK,EAClC,UAAoB,EACpB,YAA0B,EAC1B,EACE,OAAO,GAAG,KAAK,EACf,YAAY,GAAG,gCAAgC,UAAU,EAAE,EAC3D,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CACxB,mBAAmB,UAAU,oBAAoB,GAAG,EAAE,MACtD,EAAE,EACsB,EAAE;IAC9B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAC7B,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC;QAC7B,IAAA,sBAAc,EAAC,OAAO,CAAC;KACxB,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACb,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC1B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAuB,CAAA;IACzE,CAAC,CAAC,CAAA;IACF,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;KACnB,CAAA;AACxB,CAAC,CAAA;AAvBY,QAAA,eAAe,mBAuB3B"}

package/package/lib/health/index.d.ts

@@ -0,0 +1 @@
+import "./checkFns";