@start9labs/start-sdk 0.3.6-alpha1

package/mjs/lib/util/Overlay.js

@@ -0,0 +1,172 @@
+import * as fs from "fs/promises";
+import * as cp from "child_process";
+import { promisify } from "util";
+import { Buffer } from "node:buffer";
+export const execFile = promisify(cp.execFile);
+const WORKDIR = (imageId) => `/media/startos/images/${imageId}/`;
+export class Overlay {
+    effects;
+    imageId;
+    rootfs;
+    guid;
+    constructor(effects, imageId, rootfs, guid) {
+        this.effects = effects;
+        this.imageId = imageId;
+        this.rootfs = rootfs;
+        this.guid = guid;
+    }
+    static async of(effects, image) {
+        const { id: imageId, sharedRun } = image;
+        const [rootfs, guid] = await effects.createOverlayedImage({ imageId });
+        const shared = ["dev", "sys", "proc"];
+        if (!!sharedRun) {
+            shared.push("run");
+        }
+        for (const dirPart of shared) {
+            await fs.mkdir(`${rootfs}/${dirPart}`, { recursive: true });
+            await execFile("mount", [
+                "--rbind",
+                `/${dirPart}`,
+                `${rootfs}/${dirPart}`,
+            ]);
+        }
+        return new Overlay(effects, imageId, rootfs, guid);
+    }
+    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}`
+                : "/";
+            await execFile("mount", [
+                "--bind",
+                `/media/startos/volumes/${options.id}${subpath}`,
+                path,
+            ]);
+        }
+        else if (options.type === "assets") {
+            const subpath = options.subpath
+                ? options.subpath.startsWith("/")
+                    ? options.subpath
+                    : `/${options.subpath}`
+                : "/";
+            await execFile("mount", [
+                "--bind",
+                `/media/startos/assets/${options.id}${subpath}`,
+                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}`
+                : "/";
+            await execFile("mount", [
+                "--bind",
+                `/media/startos/backup${subpath}`,
+                path,
+            ]);
+        }
+        else {
+            throw new Error(`unknown type ${options.type}`);
+        }
+        return this;
+    }
+    async destroy() {
+        const imageId = this.imageId;
+        const guid = this.guid;
+        await this.effects.destroyOverlayedImage({ guid });
+    }
+    async exec(command, options, timeoutMs = 30000) {
+        const imageMeta = await fs
+            .readFile(`/media/startos/images/${this.imageId}.json`, {
+            encoding: "utf8",
+        })
+            .catch(() => "{}")
+            .then(JSON.parse);
+        let extra = [];
+        if (options?.user) {
+            extra.push(`--user=${options.user}`);
+            delete options.user;
+        }
+        let workdir = imageMeta.workdir || "/";
+        if (options?.cwd) {
+            workdir = options.cwd;
+            delete options.cwd;
+        }
+        const child = cp.spawn("start-cli", [
+            "chroot",
+            `--env=/media/startos/images/${this.imageId}.env`,
+            `--workdir=${workdir}`,
+            ...extra,
+            this.rootfs,
+            ...command,
+        ], options || {});
+        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 Buffer) {
+                appendTo.data = Buffer.concat([
+                    Buffer.from(appendTo.data),
+                    Buffer.from(chunk),
+                ]);
+            }
+            else {
+                console.error("received unexpected chunk", chunk);
+            }
+        };
+        return new Promise((resolve, reject) => {
+            child.on("error", reject);
+            if (timeoutMs !== null && pid) {
+                setTimeout(() => execFile("pkill", ["-9", "-s", String(pid)]).catch((_) => { }), timeoutMs);
+            }
+            child.stdout.on("data", appendData(stdout));
+            child.stderr.on("data", appendData(stderr));
+            child.on("exit", (code, signal) => resolve({
+                exitCode: code,
+                exitSignal: signal,
+                stdout: stdout.data,
+                stderr: stderr.data,
+            }));
+        });
+    }
+    async spawn(command, options) {
+        const imageMeta = await fs
+            .readFile(`/media/startos/images/${this.imageId}.json`, {
+            encoding: "utf8",
+        })
+            .catch(() => "{}")
+            .then(JSON.parse);
+        let extra = [];
+        if (options?.user) {
+            extra.push(`--user=${options.user}`);
+            delete options.user;
+        }
+        let workdir = imageMeta.workdir || "/";
+        if (options?.cwd) {
+            workdir = options.cwd;
+            delete options.cwd;
+        }
+        return cp.spawn("start-cli", [
+            "chroot",
+            `--env=/media/startos/images/${this.imageId}.env`,
+            `--workdir=${workdir}`,
+            ...extra,
+            this.rootfs,
+            ...command,
+        ], options);
+    }
+}
+//# sourceMappingURL=Overlay.js.map

package/mjs/lib/util/Overlay.js.map

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

package/mjs/lib/util/deepEqual.d.ts

@@ -0,0 +1 @@
+export declare function deepEqual(...args: unknown[]): unknown;

package/mjs/lib/util/deepEqual.js

@@ -0,0 +1,25 @@
+import { object } from "ts-matches";
+export function deepEqual(...args) {
+    if (!object.test(args[args.length - 1]))
+        return args[args.length - 1];
+    const objects = args.filter(object.test);
+    if (objects.length === 0) {
+        for (const x of args)
+            if (x !== args[0])
+                return false;
+        return true;
+    }
+    if (objects.length !== args.length)
+        return false;
+    const allKeys = new Set(objects.flatMap((x) => Object.keys(x)));
+    for (const key of allKeys) {
+        for (const x of objects) {
+            if (!(key in x))
+                return false;
+            if (!deepEqual(objects[0][key], x[key]))
+                return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=deepEqual.js.map

package/mjs/lib/util/deepEqual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepEqual.js","sourceRoot":"","sources":["../../../../lib/util/deepEqual.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,MAAM,UAAU,SAAS,CAAC,GAAG,IAAe;IAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;QACxB,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;QACrD,OAAO,IAAI,CAAA;KACZ;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAChD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;QACzB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;YACvB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC7B,IAAI,CAAC,SAAS,CAAE,OAAO,CAAC,CAAC,CAAS,CAAC,GAAG,CAAC,EAAG,CAAS,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;SACxE;KACF;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/mjs/lib/util/deepMerge.d.ts

@@ -0,0 +1 @@
+export declare function deepMerge(...args: unknown[]): unknown;

package/mjs/lib/util/deepMerge.js

@@ -0,0 +1,18 @@
+import { object } from "ts-matches";
+export function deepMerge(...args) {
+    const lastItem = args[args.length - 1];
+    if (!object.test(lastItem))
+        return lastItem;
+    const objects = args.filter(object.test).filter((x) => !Array.isArray(x));
+    if (objects.length === 0)
+        return lastItem;
+    if (objects.length === 1)
+        objects.unshift({});
+    const allKeys = new Set(objects.flatMap((x) => Object.keys(x)));
+    for (const key of allKeys) {
+        const filteredValues = objects.flatMap((x) => key in x ? [x[key]] : []);
+        objects[0][key] = deepMerge(...filteredValues);
+    }
+    return objects[0];
+}
+//# sourceMappingURL=deepMerge.js.map

package/mjs/lib/util/deepMerge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.js","sourceRoot":"","sources":["../../../../lib/util/deepMerge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnC,MAAM,UAAU,SAAS,CAAC,GAAG,IAAe;IAC1C,MAAM,QAAQ,GAAI,IAAY,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAA;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IACzE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAe,CAAA;IAChD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;QACzB,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3C,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,CAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAClC,CACA;QAAC,OAAe,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,cAAc,CAAC,CAAA;KACzD;IACD,OAAO,OAAO,CAAC,CAAC,CAAQ,CAAA;AAC1B,CAAC"}

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

@@ -0,0 +1,74 @@
+import * as matches from "ts-matches";
+import * as T from "../types";
+/**
+ * Used in the get config and the set config exported functions.
+ * The idea is that we are going to be reading/ writing to a file, or multiple files. And then we use this tool
+ * to keep the same path on the read and write, and have methods for helping with structured data.
+ * And if we are not using a structured data, we can use the raw method which forces the construction of a BiMap
+ * ```ts
+        import {InputSpec} from './InputSpec.ts'
+        import {matches, T} from '../deps.ts';
+        const { object, string, number, boolean, arrayOf, array, anyOf, allOf } = matches
+        const someValidator = object({
+        data: string
+        })
+        const jsonFile = FileHelper.json({
+        path: 'data.json',
+        validator: someValidator,
+        volume: 'main'
+        })
+        const  tomlFile = FileHelper.toml({
+        path: 'data.toml',
+        validator: someValidator,
+        volume: 'main'
+        })
+        const rawFile = FileHelper.raw({
+        path: 'data.amazingSettings',
+        volume: 'main'
+        fromData(dataIn: Data): string {
+            return `myDatais ///- ${dataIn.data}`
+        },
+        toData(rawData: string): Data {
+        const [,data] = /myDatais \/\/\/- (.*)/.match(rawData)
+        return {data}
+        }
+        })
+
+        export const setConfig : T.ExpectedExports.setConfig= async (effects, config) => {
+        await  jsonFile.write({ data: 'here lies data'}, effects)
+        }
+
+        export const getConfig: T.ExpectedExports.getConfig = async (effects, config) => ({
+        spec: InputSpec,
+        config: nullIfEmpty({
+            ...jsonFile.get(effects)
+        })
+    ```
+ */
+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);
+    write(data: A, effects: T.Effects): Promise<void>;
+    read(effects: T.Effects): Promise<A | null>;
+    /**
+     * Create a File Helper for an arbitrary file type.
+     *
+     * Provide custom functions for translating data to the file format and visa versa.
+     */
+    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/mjs/lib/util/fileHelper.js

@@ -0,0 +1,111 @@
+import * as YAML from "yaml";
+import * as TOML from "@iarna/toml";
+import * as fs from "fs";
+const previousPath = /(.+?)\/([^/]*)$/;
+/**
+ * Used in the get config and the set config exported functions.
+ * The idea is that we are going to be reading/ writing to a file, or multiple files. And then we use this tool
+ * to keep the same path on the read and write, and have methods for helping with structured data.
+ * And if we are not using a structured data, we can use the raw method which forces the construction of a BiMap
+ * ```ts
+        import {InputSpec} from './InputSpec.ts'
+        import {matches, T} from '../deps.ts';
+        const { object, string, number, boolean, arrayOf, array, anyOf, allOf } = matches
+        const someValidator = object({
+        data: string
+        })
+        const jsonFile = FileHelper.json({
+        path: 'data.json',
+        validator: someValidator,
+        volume: 'main'
+        })
+        const  tomlFile = FileHelper.toml({
+        path: 'data.toml',
+        validator: someValidator,
+        volume: 'main'
+        })
+        const rawFile = FileHelper.raw({
+        path: 'data.amazingSettings',
+        volume: 'main'
+        fromData(dataIn: Data): string {
+            return `myDatais ///- ${dataIn.data}`
+        },
+        toData(rawData: string): Data {
+        const [,data] = /myDatais \/\/\/- (.*)/.match(rawData)
+        return {data}
+        }
+        })
+
+        export const setConfig : T.ExpectedExports.setConfig= async (effects, config) => {
+        await  jsonFile.write({ data: 'here lies data'}, effects)
+        }
+
+        export const getConfig: T.ExpectedExports.getConfig = async (effects, config) => ({
+        spec: InputSpec,
+        config: nullIfEmpty({
+            ...jsonFile.get(effects)
+        })
+    ```
+ */
+export class FileHelper {
+    path;
+    writeData;
+    readData;
+    constructor(path, writeData, readData) {
+        this.path = path;
+        this.writeData = writeData;
+        this.readData = readData;
+    }
+    async write(data, effects) {
+        if (previousPath.exec(this.path)) {
+            await new Promise((resolve, reject) => fs.mkdir(this.path, (err) => (!err ? resolve(null) : reject(err))));
+        }
+        await new Promise((resolve, reject) => fs.writeFile(this.path, this.writeData(data), (err) => !err ? resolve(null) : reject(err)));
+    }
+    async read(effects) {
+        if (!fs.existsSync(this.path)) {
+            return null;
+        }
+        return this.readData(await new Promise((resolve, reject) => fs.readFile(this.path, (err, data) => !err ? resolve(data.toString("utf-8")) : reject(err))));
+    }
+    /**
+     * Create a File Helper for an arbitrary file type.
+     *
+     * Provide custom functions for translating data to the file format and visa versa.
+     */
+    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 JSON.stringify(inData, null, 2);
+        }, (inString) => {
+            return shape.unsafeCast(YAML.parse(inString));
+        });
+    }
+}
+export default FileHelper;
+//# sourceMappingURL=fileHelper.js.map

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

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

package/mjs/lib/util/getDefaultString.d.ts

@@ -0,0 +1,2 @@
+import { DefaultString } from "../config/configTypes";
+export declare function getDefaultString(defaultSpec: DefaultString): string;

package/mjs/lib/util/getDefaultString.js

@@ -0,0 +1,10 @@
+import { getRandomString } from "./getRandomString";
+export function getDefaultString(defaultSpec) {
+    if (typeof defaultSpec === "string") {
+        return defaultSpec;
+    }
+    else {
+        return getRandomString(defaultSpec);
+    }
+}
+//# sourceMappingURL=getDefaultString.js.map

package/mjs/lib/util/getDefaultString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultString.js","sourceRoot":"","sources":["../../../../lib/util/getDefaultString.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,MAAM,UAAU,gBAAgB,CAAC,WAA0B;IACzD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;QACnC,OAAO,WAAW,CAAA;KACnB;SAAM;QACL,OAAO,eAAe,CAAC,WAAW,CAAC,CAAA;KACpC;AACH,CAAC"}

package/mjs/lib/util/getRandomCharInSet.d.ts

@@ -0,0 +1 @@
+export declare function getRandomCharInSet(charset: string): string;

package/mjs/lib/util/getRandomCharInSet.js

@@ -0,0 +1,100 @@
+// a,g,h,A-Z,,,,-
+import * as crypto from "crypto";
+export function getRandomCharInSet(charset) {
+    const set = stringToCharSet(charset);
+    let charIdx = crypto.randomInt(0, set.len);
+    for (let range of set.ranges) {
+        if (range.len > charIdx) {
+            return String.fromCharCode(range.start.charCodeAt(0) + charIdx);
+        }
+        charIdx -= range.len;
+    }
+    throw new Error("unreachable");
+}
+function stringToCharSet(charset) {
+    let set = { ranges: [], len: 0 };
+    let start = null;
+    let end = null;
+    let in_range = false;
+    for (let char of charset) {
+        switch (char) {
+            case ",":
+                if (start !== null && end !== null) {
+                    if (start.charCodeAt(0) > end.charCodeAt(0)) {
+                        throw new Error("start > end of charset");
+                    }
+                    const len = end.charCodeAt(0) - start.charCodeAt(0) + 1;
+                    set.ranges.push({
+                        start,
+                        end,
+                        len,
+                    });
+                    set.len += len;
+                    start = null;
+                    end = null;
+                    in_range = false;
+                }
+                else if (start !== null && !in_range) {
+                    set.len += 1;
+                    set.ranges.push({ start, end: start, len: 1 });
+                    start = null;
+                }
+                else if (start !== null && in_range) {
+                    end = ",";
+                }
+                else if (start === null && end === null && !in_range) {
+                    start = ",";
+                }
+                else {
+                    throw new Error('unexpected ","');
+                }
+                break;
+            case "-":
+                if (start === null) {
+                    start = "-";
+                }
+                else if (!in_range) {
+                    in_range = true;
+                }
+                else if (in_range && end === null) {
+                    end = "-";
+                }
+                else {
+                    throw new Error('unexpected "-"');
+                }
+                break;
+            default:
+                if (start === null) {
+                    start = char;
+                }
+                else if (in_range && end === null) {
+                    end = char;
+                }
+                else {
+                    throw new Error(`unexpected "${char}"`);
+                }
+        }
+    }
+    if (start !== null && end !== null) {
+        if (start.charCodeAt(0) > end.charCodeAt(0)) {
+            throw new Error("start > end of charset");
+        }
+        const len = end.charCodeAt(0) - start.charCodeAt(0) + 1;
+        set.ranges.push({
+            start,
+            end,
+            len,
+        });
+        set.len += len;
+    }
+    else if (start !== null) {
+        set.len += 1;
+        set.ranges.push({
+            start,
+            end: start,
+            len: 1,
+        });
+    }
+    return set;
+}
+//# sourceMappingURL=getRandomCharInSet.js.map

package/mjs/lib/util/getRandomCharInSet.js.map

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

package/mjs/lib/util/getRandomString.d.ts

@@ -0,0 +1,2 @@
+import { RandomString } from "../config/configTypes";
+export declare function getRandomString(generator: RandomString): string;

package/mjs/lib/util/getRandomString.js

@@ -0,0 +1,9 @@
+import { getRandomCharInSet } from "./getRandomCharInSet";
+export function getRandomString(generator) {
+    let s = "";
+    for (let i = 0; i < generator.len; i++) {
+        s = s + getRandomCharInSet(generator.charset);
+    }
+    return s;
+}
+//# sourceMappingURL=getRandomString.js.map

package/mjs/lib/util/getRandomString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRandomString.js","sourceRoot":"","sources":["../../../../lib/util/getRandomString.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,MAAM,UAAU,eAAe,CAAC,SAAuB;IACrD,IAAI,CAAC,GAAG,EAAE,CAAA;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QACtC,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;KAC9C;IAED,OAAO,CAAC,CAAA;AACV,CAAC"}

package/mjs/lib/util/getServiceInterface.d.ts

@@ -0,0 +1,73 @@
+import { ServiceInterfaceType } from "../StartSdk";
+import { AddressInfo, Effects, HostInfo, Hostname } from "../types";
+export type UrlString = string;
+export type HostId = string;
+export declare const getHostname: (url: string) => Hostname | null;
+export type Filled = {
+    hostnames: Hostname[];
+    onionHostnames: Hostname[];
+    localHostnames: Hostname[];
+    ipHostnames: Hostname[];
+    ipv4Hostnames: Hostname[];
+    ipv6Hostnames: Hostname[];
+    nonIpHostnames: Hostname[];
+    urls: UrlString[];
+    onionUrls: UrlString[];
+    localUrls: UrlString[];
+    ipUrls: UrlString[];
+    ipv4Urls: UrlString[];
+    ipv6Urls: UrlString[];
+    nonIpUrls: UrlString[];
+};
+export type FilledAddressInfo = AddressInfo & Filled;
+export type ServiceInterfaceFilled = {
+    id: string;
+    /** The title of this field to be displayed */
+    name: string;
+    /** Human readable description, used as tooltip usually */
+    description: string;
+    /** Whether or not the interface has a primary URL */
+    hasPrimary: boolean;
+    /** Whether or not the interface disabled */
+    disabled: boolean;
+    /** Whether or not to mask the URIs for this interface. Useful if the URIs contain sensitive information, such as a password, macaroon, or API key */
+    masked: boolean;
+    /** Information about the host for this binding */
+    hostInfo: HostInfo;
+    /** URI information */
+    addressInfo: FilledAddressInfo;
+    /** Indicates if we are a ui/p2p/api for the kind of interface that this is representing */
+    type: ServiceInterfaceType;
+    /** The primary hostname for the service, as chosen by the user */
+    primaryHostname: Hostname | null;
+    /** The primary URL for the service, as chosen by the user */
+    primaryUrl: UrlString | null;
+};
+export declare const filledAddress: (hostInfo: HostInfo, addressInfo: AddressInfo) => FilledAddressInfo;
+export declare class GetServiceInterface {
+    readonly effects: Effects;
+    readonly opts: {
+        id: string;
+        packageId: string | null;
+    };
+    constructor(effects: Effects, opts: {
+        id: string;
+        packageId: string | null;
+    });
+    /**
+     * Returns the value of Store at the provided path. Restart the service if the value changes
+     */
+    const(): Promise<ServiceInterfaceFilled>;
+    /**
+     * Returns the value of ServiceInterfacesFilled at the provided path. Does nothing if the value changes
+     */
+    once(): Promise<ServiceInterfaceFilled>;
+    /**
+     * Watches the value of ServiceInterfacesFilled at the provided path. Takes a custom callback function to run whenever the value changes
+     */
+    watch(): AsyncGenerator<ServiceInterfaceFilled, void, unknown>;
+}
+export declare function getServiceInterface(effects: Effects, opts: {
+    id: string;
+    packageId: string | null;
+}): GetServiceInterface;