@start9labs/start-sdk 0.3.6-alpha8 → 0.3.6-alpha9

package/base/lib/types.d.ts

@@ -0,0 +1,196 @@
+/// <reference types="node" />
+export * as inputSpecTypes from "./actions/input/inputSpecTypes";
+import { DependencyRequirement, NamedHealthCheckResult, Manifest, ServiceInterface, ActionId } from "./osBindings";
+import { Affine, StringObject, ToKebab } from "./util";
+import { Action, Actions } from "./actions/setupActions";
+import { Effects } from "./Effects";
+export { Effects };
+export * from "./osBindings";
+export { SDKManifest } from "./types/ManifestTypes";
+export type ExposedStorePaths = string[] & Affine<"ExposedStorePaths">;
+declare const HealthProof: unique symbol;
+export type HealthReceipt = {
+    [HealthProof]: never;
+};
+export type DaemonBuildable = {
+    build(): Promise<{
+        term(): Promise<void>;
+    }>;
+};
+export type ServiceInterfaceType = "ui" | "p2p" | "api";
+export type Signals = NodeJS.Signals;
+export declare const SIGTERM: Signals;
+export declare const SIGKILL: Signals;
+export declare const NO_TIMEOUT = -1;
+export type PathMaker = (options: {
+    volume: string;
+    path: string;
+}) => string;
+export type MaybePromise<A> = Promise<A> | A;
+export declare namespace ExpectedExports {
+    /** For backing up service data though the startOS UI */
+    type createBackup = (options: {
+        effects: Effects;
+    }) => Promise<unknown>;
+    /** For restoring service data that was previously backed up using the startOS UI create backup flow. Backup restores are also triggered via the startOS UI, or doing a system restore flow during setup. */
+    type restoreBackup = (options: {
+        effects: Effects;
+    }) => Promise<unknown>;
+    /**
+     * This is the entrypoint for the main container. Used to start up something like the service that the
+     * package represents, like running a bitcoind in a bitcoind-wrapper.
+     */
+    type main = (options: {
+        effects: Effects;
+        started(onTerm: () => PromiseLike<void>): PromiseLike<null>;
+    }) => Promise<DaemonBuildable>;
+    /**
+     * After a shutdown, if we wanted to do any operations to clean up things, like
+     * set the action as unavailable or something.
+     */
+    type afterShutdown = (options: {
+        effects: Effects;
+    }) => Promise<unknown>;
+    /**
+     * Every time a service launches (both on startup, and on install) this function is called before packageInit
+     * Can be used to register callbacks
+     */
+    type containerInit = (options: {
+        effects: Effects;
+    }) => Promise<unknown>;
+    /**
+     * Every time a package completes an install, this function is called before the main.
+     * Can be used to do migration like things.
+     */
+    type packageInit = (options: {
+        effects: Effects;
+    }) => Promise<unknown>;
+    /** This will be ran during any time a package is uninstalled, for example during a update
+     * this will be called.
+     */
+    type packageUninit = (options: {
+        effects: Effects;
+        nextVersion: null | string;
+    }) => Promise<unknown>;
+    type manifest = Manifest;
+    type actions = Actions<any, Record<ActionId, Action<ActionId, any, any, any>>>;
+}
+export type ABI = {
+    createBackup: ExpectedExports.createBackup;
+    restoreBackup: ExpectedExports.restoreBackup;
+    main: ExpectedExports.main;
+    afterShutdown: ExpectedExports.afterShutdown;
+    containerInit: ExpectedExports.containerInit;
+    packageInit: ExpectedExports.packageInit;
+    packageUninit: ExpectedExports.packageUninit;
+    manifest: ExpectedExports.manifest;
+    actions: ExpectedExports.actions;
+};
+export type TimeMs = number;
+export type VersionString = string;
+declare const DaemonProof: unique symbol;
+export type DaemonReceipt = {
+    [DaemonProof]: never;
+};
+export type Daemon = {
+    wait(): Promise<string>;
+    term(): Promise<null>;
+    [DaemonProof]: never;
+};
+export type HealthStatus = NamedHealthCheckResult["result"];
+export type SmtpValue = {
+    server: string;
+    port: number;
+    from: string;
+    login: string;
+    password: string | null | undefined;
+};
+export type CommandType = string | [string, ...string[]];
+export type DaemonReturned = {
+    wait(): Promise<unknown>;
+    term(options?: {
+        signal?: Signals;
+        timeout?: number;
+    }): Promise<null>;
+};
+export declare const hostName: unique symbol;
+export type Hostname = string & {
+    [hostName]: never;
+};
+export type HostnameInfoIp = {
+    kind: "ip";
+    networkInterfaceId: string;
+    public: boolean;
+    hostname: {
+        kind: "ipv4" | "ipv6" | "local";
+        value: string;
+        port: number | null;
+        sslPort: number | null;
+    } | {
+        kind: "domain";
+        domain: string;
+        subdomain: string | null;
+        port: number | null;
+        sslPort: number | null;
+    };
+};
+export type HostnameInfoOnion = {
+    kind: "onion";
+    hostname: {
+        value: string;
+        port: number | null;
+        sslPort: number | null;
+    };
+};
+export type HostnameInfo = HostnameInfoIp | HostnameInfoOnion;
+export type ServiceInterfaceId = string;
+export { ServiceInterface };
+export type ExposeServicePaths<Store = never> = {
+    /** The path to the value in the Store. [JsonPath](https://jsonpath.com/)  */
+    paths: ExposedStorePaths;
+};
+export type EffectMethod<T extends StringObject = Effects> = {
+    [K in keyof T]-?: K extends string ? T[K] extends Function ? ToKebab<K> : T[K] extends StringObject ? `${ToKebab<K>}.${EffectMethod<T[K]>}` : never : never;
+}[keyof T];
+export type SyncOptions = {
+    /** delete files that exist in the target directory, but not in the source directory */
+    delete: boolean;
+    /** do not sync files with paths that match these patterns */
+    exclude: string[];
+};
+/**
+ * This is the metadata that is returned from the metadata call.
+ */
+export type Metadata = {
+    fileType: string;
+    isDir: boolean;
+    isFile: boolean;
+    isSymlink: boolean;
+    len: number;
+    modified?: Date;
+    accessed?: Date;
+    created?: Date;
+    readonly: boolean;
+    uid: number;
+    gid: number;
+    mode: number;
+};
+export type SetResult = {
+    dependsOn: DependsOn;
+    signal: Signals;
+};
+export type PackageId = string;
+export type Message = string;
+export type DependencyKind = "running" | "exists";
+export type DependsOn = {
+    [packageId: string]: string[] | readonly string[];
+};
+export type KnownError = {
+    error: string;
+} | {
+    errorCode: [number, string] | readonly [number, string];
+};
+export type Dependencies = Array<DependencyRequirement>;
+export type DeepPartial<T> = T extends {} ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;

package/base/lib/types.js

@@ -0,0 +1,39 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpectedExports = exports.NO_TIMEOUT = exports.SIGKILL = exports.SIGTERM = exports.inputSpecTypes = void 0;
+exports.inputSpecTypes = __importStar(require("./actions/input/inputSpecTypes"));
+__exportStar(require("./osBindings"), exports);
+exports.SIGTERM = "SIGTERM";
+exports.SIGKILL = "SIGKILL";
+exports.NO_TIMEOUT = -1;
+var ExpectedExports;
+(function (ExpectedExports) {
+    version: 1;
+})(ExpectedExports = exports.ExpectedExports || (exports.ExpectedExports = {}));
+//# sourceMappingURL=types.js.map

package/base/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../base/lib/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iFAAgE;AAahE,+CAA4B;AAiBf,QAAA,OAAO,GAAY,SAAS,CAAA;AAC5B,QAAA,OAAO,GAAY,SAAS,CAAA;AAC5B,QAAA,UAAU,GAAG,CAAC,CAAC,CAAA;AAI5B,IAAiB,eAAe,CAsD/B;AAtDD,WAAiB,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAA;AAqDZ,CAAC,EAtDgB,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAsD/B"}

package/base/lib/util/GetSystemSmtp.d.ts

@@ -0,0 +1,17 @@
+import { Effects } from "../Effects";
+export declare class GetSystemSmtp {
+    readonly effects: Effects;
+    constructor(effects: Effects);
+    /**
+     * Returns the system SMTP credentials. Restarts the service if the credentials change
+     */
+    const(): Promise<import("../types").SmtpValue | null>;
+    /**
+     * Returns the system SMTP credentials. Does nothing if the credentials change
+     */
+    once(): Promise<import("../types").SmtpValue | null>;
+    /**
+     * Watches the system SMTP credentials. Takes a custom callback function to run whenever the credentials change
+     */
+    watch(): AsyncGenerator<import("../types").SmtpValue | null, void, unknown>;
+}

package/base/lib/util/GetSystemSmtp.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSystemSmtp = void 0;
+class GetSystemSmtp {
+    constructor(effects) {
+        this.effects = effects;
+    }
+    /**
+     * Returns the system SMTP credentials. Restarts the service if the credentials change
+     */
+    const() {
+        return this.effects.getSystemSmtp({
+            callback: () => this.effects.constRetry(),
+        });
+    }
+    /**
+     * Returns the system SMTP credentials. Does nothing if the credentials change
+     */
+    once() {
+        return this.effects.getSystemSmtp({});
+    }
+    /**
+     * Watches the system SMTP credentials. Takes a custom callback function to run whenever the credentials change
+     */
+    async *watch() {
+        while (true) {
+            let callback;
+            const waitForNext = new Promise((resolve) => {
+                callback = resolve;
+            });
+            yield await this.effects.getSystemSmtp({
+                callback: () => callback(),
+            });
+            await waitForNext;
+        }
+    }
+}
+exports.GetSystemSmtp = GetSystemSmtp;
+//# sourceMappingURL=GetSystemSmtp.js.map

package/base/lib/util/GetSystemSmtp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetSystemSmtp.js","sourceRoot":"","sources":["../../../../base/lib/util/GetSystemSmtp.ts"],"names":[],"mappings":";;;AAEA,MAAa,aAAa;IACxB,YAAqB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEzC;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAChC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;SAC1C,CAAC,CAAA;IACJ,CAAC;IACD;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IACD;;OAEG;IACH,KAAK,CAAC,CAAC,KAAK;QACV,OAAO,IAAI,EAAE;YACX,IAAI,QAAoB,CAAA;YACxB,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAChD,QAAQ,GAAG,OAAO,CAAA;YACpB,CAAC,CAAC,CAAA;YACF,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;gBACrC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE;aAC3B,CAAC,CAAA;YACF,MAAM,WAAW,CAAA;SAClB;IACH,CAAC;CACF;AAhCD,sCAgCC"}

package/base/lib/util/Hostname.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hostname.js","sourceRoot":"","sources":["../../../../base/lib/util/Hostname.ts"],"names":[],"mappings":";;;AAEA,SAAgB,qBAAqB,CAAC,QAAsB;IAC1D,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE;QAC7B,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;KACpC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE;QAC1B,MAAM,KAAK,CAAC,gCAAgC,CAAC,CAAA;KAC9C;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAA;IAClC,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE;QAC9B,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAA;KACjF;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAA;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACzC,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,IAAI,MAAM,KAAK,QAAQ,CAAC,IAAI,EAAE;QACxD,OAAO,GAAG,QAAQ,CAAC,KAAK,GAAG,UAAU,EAAE,CAAA;KACxC;IACD,IAAI,OAAO,KAAK,QAAQ,CAAC,IAAI,EAAE;QAC7B,OAAO,GAAG,QAAQ,CAAC,KAAK,GAAG,UAAU,EAAE,CAAA;KACxC;IACD,MAAM,KAAK,CACT,0CAA0C,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CACtE,CAAA;AACH,CAAC;AAtBD,sDAsBC"}

package/base/lib/util/PathBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathBuilder.js","sourceRoot":"","sources":["../../../../base/lib/util/PathBuilder.ts"],"names":[],"mappings":";;;AAEA,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,CAAA;AAkBrC,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;AACjC,MAAM,eAAe,GAAG,CAAC,OAA6B,EAAE,EAAE;IAC/D,OAAQ,OAAe,CAAC,aAAa,CAAc,CAAA;AACrD,CAAC,CAAA;AAFY,QAAA,eAAe,mBAE3B;AAEM,MAAM,WAAW,GAAG,CACzB,QAAkB,EAAE,EACW,EAAE;IACjC,OAAO,IAAI,KAAK,CAAC,EAAmC,EAAE;QACpD,GAAG,CAAC,MAAM,EAAE,IAAI;YACd,IAAI,IAAI,KAAK,aAAa,EAAE;gBAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAA;gBACjC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;aAC7B;YACD,OAAO,IAAA,mBAAW,EAAM,CAAC,GAAG,KAAK,EAAE,IAAc,CAAC,CAAC,CAAA;QACrD,CAAC;KACF,CAAkC,CAAA;AACrC,CAAC,CAAA;AAZY,QAAA,WAAW,eAYvB"}

package/base/lib/util/asError.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asError = void 0;
+const asError = (e) => {
+    if (e instanceof Error) {
+        return new Error(e);
+    }
+    if (typeof e === "string") {
+        return new Error(`${e}`);
+    }
+    return new Error(`${JSON.stringify(e)}`);
+};
+exports.asError = asError;
+//# sourceMappingURL=asError.js.map

package/base/lib/util/asError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asError.js","sourceRoot":"","sources":["../../../../base/lib/util/asError.ts"],"names":[],"mappings":";;;AAAO,MAAM,OAAO,GAAG,CAAC,CAAU,EAAE,EAAE;IACpC,IAAI,CAAC,YAAY,KAAK,EAAE;QACtB,OAAO,IAAI,KAAK,CAAC,CAAQ,CAAC,CAAA;KAC3B;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;KACzB;IACD,OAAO,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAC1C,CAAC,CAAA;AARY,QAAA,OAAO,WAQnB"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"deepEqual.js","sourceRoot":"","sources":["../../../../base/lib/util/deepEqual.ts"],"names":[],"mappings":";;;AAAA,2CAAmC;AAEnC,SAAgB,SAAS,CAAC,GAAG,IAAe;IAC1C,IAAI,CAAC,mBAAM,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,mBAAM,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;AAhBD,8BAgBC"}

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

@@ -0,0 +1,4 @@
+export declare function partialDiff<T>(prev: T, next: T): {
+    diff: Partial<T>;
+} | undefined;
+export declare function deepMerge(...args: unknown[]): unknown;

package/base/lib/util/deepMerge.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepMerge = exports.partialDiff = void 0;
+function partialDiff(prev, next) {
+    if (prev === next) {
+        return;
+    }
+    else if (Array.isArray(prev) && Array.isArray(next)) {
+        const res = { diff: [] };
+        for (let newItem of next) {
+            let anyEq = false;
+            for (let oldItem of prev) {
+                if (!partialDiff(oldItem, newItem)) {
+                    anyEq = true;
+                    break;
+                }
+            }
+            if (!anyEq) {
+                res.diff.push(newItem);
+            }
+        }
+        if (res.diff.length) {
+            return res;
+        }
+        else {
+            return;
+        }
+    }
+    else if (typeof prev === "object" && typeof next === "object") {
+        if (prev === null) {
+            return { diff: next };
+        }
+        if (next === null)
+            return;
+        const res = { diff: {} };
+        for (let key in next) {
+            const diff = partialDiff(prev[key], next[key]);
+            if (diff) {
+                res.diff[key] = diff.diff;
+            }
+        }
+        if (Object.keys(res.diff).length) {
+            return res;
+        }
+        else {
+            return;
+        }
+    }
+    else {
+        return { diff: next };
+    }
+}
+exports.partialDiff = partialDiff;
+function deepMerge(...args) {
+    const lastItem = args[args.length - 1];
+    if (typeof lastItem !== "object" || !lastItem)
+        return lastItem;
+    if (Array.isArray(lastItem))
+        return deepMergeList(...args.filter((x) => Array.isArray(x)));
+    return deepMergeObject(...args.filter((x) => typeof x === "object" && x && !Array.isArray(x)));
+}
+exports.deepMerge = deepMerge;
+function deepMergeList(...args) {
+    const res = [];
+    for (let arg of args) {
+        for (let item of arg) {
+            if (!res.some((x) => !partialDiff(x, item))) {
+                res.push(item);
+            }
+        }
+    }
+    return res;
+}
+function deepMergeObject(...args) {
+    const lastItem = args[args.length - 1];
+    if (args.length === 0)
+        return lastItem;
+    if (args.length === 1)
+        args.unshift({});
+    const allKeys = new Set(args.flatMap((x) => Object.keys(x)));
+    for (const key of allKeys) {
+        const filteredValues = args.flatMap((x) => key in x ? [x[key]] : []);
+        args[0][key] = deepMerge(...filteredValues);
+    }
+    return args[0];
+}
+//# sourceMappingURL=deepMerge.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultString.js","sourceRoot":"","sources":["../../../../base/lib/util/getDefaultString.ts"],"names":[],"mappings":";;;AACA,uDAAmD;AAEnD,SAAgB,gBAAgB,CAAC,WAA0B;IACzD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE;QACnC,OAAO,WAAW,CAAA;KACnB;SAAM;QACL,OAAO,IAAA,iCAAe,EAAC,WAAW,CAAC,CAAA;KACpC;AACH,CAAC;AAND,4CAMC"}

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRandomString.js","sourceRoot":"","sources":["../../../../base/lib/util/getRandomString.ts"],"names":[],"mappings":";;;AACA,6DAAyD;AAEzD,SAAgB,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,IAAA,uCAAkB,EAAC,SAAS,CAAC,OAAO,CAAC,CAAA;KAC9C;IAED,OAAO,CAAC,CAAA;AACV,CAAC;AAPD,0CAOC"}

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

@@ -0,0 +1,73 @@
+import { ServiceInterfaceType } from "../types";
+import { AddressInfo, Host, Hostname, HostnameInfo } from "../types";
+import { Effects } from "../Effects";
+export type UrlString = string;
+export type HostId = string;
+export declare const getHostname: (url: string) => Hostname | null;
+export type Filled = {
+    hostnames: HostnameInfo[];
+    onionHostnames: HostnameInfo[];
+    localHostnames: HostnameInfo[];
+    ipHostnames: HostnameInfo[];
+    ipv4Hostnames: HostnameInfo[];
+    ipv6Hostnames: HostnameInfo[];
+    nonIpHostnames: HostnameInfo[];
+    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 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 */
+    host: Host | null;
+    /** URI information */
+    addressInfo: FilledAddressInfo | null;
+    /** 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 addressHostToUrl: ({ scheme, sslScheme, username, suffix }: AddressInfo, host: HostnameInfo) => UrlString[];
+export declare const filledAddress: (host: Host, addressInfo: AddressInfo) => FilledAddressInfo;
+export declare class GetServiceInterface {
+    readonly effects: Effects;
+    readonly opts: {
+        id: string;
+        packageId?: string;
+    };
+    constructor(effects: Effects, opts: {
+        id: string;
+        packageId?: string;
+    });
+    /**
+     * Returns the value of Store at the provided path. Restart the service if the value changes
+     */
+    const(): Promise<ServiceInterfaceFilled | null>;
+    /**
+     * Returns the value of ServiceInterfacesFilled at the provided path. Does nothing if the value changes
+     */
+    once(): Promise<ServiceInterfaceFilled | null>;
+    /**
+     * Watches the value of ServiceInterfacesFilled at the provided path. Takes a custom callback function to run whenever the value changes
+     */
+    watch(): AsyncGenerator<ServiceInterfaceFilled | null, void, unknown>;
+}
+export declare function getServiceInterface(effects: Effects, opts: {
+    id: string;
+    packageId?: string;
+}): GetServiceInterface;