@start9labs/start-sdk 0.3.6-alpha1

package/cjs/lib/trigger/successFailure.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.successFailure = void 0;
+function successFailure(o) {
+    return async function* (getInput) {
+        while (true) {
+            const beforeSuccess = o.duringSuccess(getInput);
+            yield;
+            let currentValue = getInput();
+            beforeSuccess.next();
+            for (let res = await beforeSuccess.next(); (currentValue === null || currentValue === void 0 ? void 0 : currentValue.lastResult) !== "success" && !res.done; res = await beforeSuccess.next()) {
+                yield;
+                currentValue = getInput();
+            }
+            const duringError = o.duringError(getInput);
+            for (let res = await duringError.next(); (currentValue === null || currentValue === void 0 ? void 0 : currentValue.lastResult) === "success" && !res.done; res = await duringError.next()) {
+                yield;
+                currentValue = getInput();
+            }
+        }
+    };
+}
+exports.successFailure = successFailure;
+//# sourceMappingURL=successFailure.js.map

package/cjs/lib/trigger/successFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"successFailure.js","sourceRoot":"","sources":["../../../../lib/trigger/successFailure.ts"],"names":[],"mappings":";;;AAEA,SAAgB,cAAc,CAAC,CAG9B;IACC,OAAO,KAAK,SAAS,CAAC,EAAE,QAAQ;QAC9B,OAAO,IAAI,EAAE;YACX,MAAM,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;YAC/C,KAAK,CAAA;YACL,IAAI,YAAY,GAAG,QAAQ,EAAE,CAAA;YAC7B,aAAa,CAAC,IAAI,EAAE,CAAA;YACpB,KACE,IAAI,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,EACpC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,UAAU,MAAK,SAAS,IAAI,CAAC,GAAG,CAAC,IAAI,EACnD,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,EAChC;gBACA,KAAK,CAAA;gBACL,YAAY,GAAG,QAAQ,EAAE,CAAA;aAC1B;YACD,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;YAC3C,KACE,IAAI,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAClC,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,UAAU,MAAK,SAAS,IAAI,CAAC,GAAG,CAAC,IAAI,EACnD,GAAG,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAC9B;gBACA,KAAK,CAAA;gBACL,YAAY,GAAG,QAAQ,EAAE,CAAA;aAC1B;SACF;IACH,CAAC,CAAA;AACH,CAAC;AA7BD,wCA6BC"}

package/cjs/lib/types.d.ts

@@ -0,0 +1,532 @@
+export * as configTypes from "./config/configTypes";
+import { DependencyRequirement, SetHealth, HealthCheckResult, SetMainStatus } from "./osBindings";
+import { MainEffects, ServiceInterfaceType, Signals } from "./StartSdk";
+import { InputSpec } from "./config/configTypes";
+import { DependenciesReceipt } from "./config/setupConfig";
+import { BindOptions } from "./interfaces/Host";
+import { Daemons } from "./mainFn/Daemons";
+import { StorePath } from "./store/PathBuilder";
+import { ExposedStorePaths } from "./store/setupExposeStore";
+import { UrlString } from "./util/getServiceInterface";
+export * from "./osBindings";
+export { SDKManifest } from "./manifest/ManifestTypes";
+export { HealthReceipt } from "./health/HealthReceipt";
+export type ExportedAction = (options: {
+    effects: Effects;
+    input?: Record<string, unknown>;
+}) => Promise<ActionResult>;
+export type MaybePromise<A> = Promise<A> | A;
+export declare namespace ExpectedExports {
+    /** Set configuration is called after we have modified and saved the configuration in the start9 ui. Use this to make a file for the docker to read from for configuration.  */
+    type setConfig = (options: {
+        effects: Effects;
+        input: Record<string, unknown>;
+    }) => Promise<void>;
+    /** Get configuration returns a shape that describes the format that the start9 ui will generate, and later send to the set config  */
+    type getConfig = (options: {
+        effects: Effects;
+    }) => Promise<ConfigRes>;
+    /** 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>;
+    /**
+     * Actions are used so we can effect the service, like deleting a directory.
+     * One old use case is to add a action where we add a file, that will then be run during the
+     * service starting, and that file would indicate that it would rescan all the data.
+     */
+    type actions = (options: {
+        effects: Effects;
+    }) => MaybePromise<{
+        [id: string]: {
+            run: ExportedAction;
+            getConfig: (options: {
+                effects: Effects;
+            }) => Promise<InputSpec>;
+        };
+    }>;
+    type actionsMetadata = (options: {
+        effects: Effects;
+    }) => Promise<Array<ActionMetadata>>;
+    /**
+     * 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: MainEffects;
+        started(onTerm: () => PromiseLike<void>): PromiseLike<void>;
+    }) => Promise<Daemons<any, any>>;
+    /**
+     * 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 package completes an install, this function is called before the main.
+     * Can be used to do migration like things.
+     */
+    type init = (options: {
+        effects: Effects;
+        previousVersion: null | string;
+    }) => Promise<unknown>;
+    /** This will be ran during any time a package is uninstalled, for example during a update
+     * this will be called.
+     */
+    type uninit = (options: {
+        effects: Effects;
+        nextVersion: null | string;
+    }) => Promise<unknown>;
+    /** Auto configure is used to make sure that other dependencies have the values t
+     * that this service could use.
+     */
+    type dependencyConfig = Record<PackageId, DependencyConfig | null>;
+    type Properties = (options: {
+        effects: Effects;
+    }) => Promise<PropertiesReturn>;
+}
+export type TimeMs = number;
+export type VersionString = string;
+/**
+ * AutoConfigure is used as the value to the key of package id,
+ * this is used to make sure that other dependencies have the values that this service could use.
+ */
+export type DependencyConfig = {
+    /** During autoconfigure, we have access to effects and local data. We are going to figure out all the data that we need and send it to update. For the sdk it is the desired delta */
+    query(options: {
+        effects: Effects;
+    }): Promise<unknown>;
+    /** This is the second part. Given the query results off the previous function, we will determine what to change the remote config to. In our sdk normall we are going to use the previous as a deep merge. */
+    update(options: {
+        queryResults: unknown;
+        remoteConfig: unknown;
+    }): Promise<unknown>;
+};
+export type ValidIfNoStupidEscape<A> = A extends `${string}'"'"'${string}` | `${string}\\"${string}` ? never : "" extends A & "" ? never : A;
+export type ConfigRes = {
+    /** This should be the previous config, that way during set config we start with the previous */
+    config?: null | Record<string, unknown>;
+    /** Shape that is describing the form in the ui */
+    spec: InputSpec;
+};
+declare const DaemonProof: unique symbol;
+export type DaemonReceipt = {
+    [DaemonProof]: never;
+};
+export type Daemon = {
+    wait(): Promise<string>;
+    term(): Promise<void>;
+    [DaemonProof]: never;
+};
+export type HealthStatus = HealthCheckResult["result"];
+export type SmtpValue = {
+    server: string;
+    port: number;
+    from: string;
+    login: string;
+    password: string | null | undefined;
+};
+export type CommandType<A extends string> = ValidIfNoStupidEscape<A> | [string, ...string[]];
+export type DaemonReturned = {
+    wait(): Promise<unknown>;
+    term(options?: {
+        signal?: Signals;
+        timeout?: number;
+    }): Promise<void>;
+};
+export type ActionMetadata = {
+    name: string;
+    description: string;
+    warning: string | null;
+    input: InputSpec;
+    disabled: boolean;
+    allowedStatuses: "onlyRunning" | "onlyStopped" | "any";
+    /**
+     * So the ordering of the actions is by alphabetical order of the group, then followed by the alphabetical of the actions
+     */
+    group: string | null;
+};
+export declare const hostName: unique symbol;
+export type Hostname = string & {
+    [hostName]: never;
+};
+/** ${scheme}://${username}@${host}:${externalPort}${suffix} */
+export type AddressInfo = {
+    username: string | null;
+    hostId: string;
+    bindOptions: BindOptions;
+    suffix: string;
+};
+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 SingleHost = {
+    id: string;
+    kind: "single" | "static";
+    hostname: HostnameInfo | null;
+};
+export type MultiHost = {
+    id: string;
+    kind: "multi";
+    hostnames: HostnameInfo[];
+};
+export type HostInfo = SingleHost | MultiHost;
+export type ServiceInterfaceId = string;
+export type ServiceInterface = {
+    id: ServiceInterfaceId;
+    /** The title of this field to be displayed */
+    name: string;
+    /** Human readable description, used as tooltip usually */
+    description: string;
+    /** Whether or not one address must be the primary address */
+    hasPrimary: boolean;
+    /** Disabled interfaces do not serve, but they retain their metadata and addresses */
+    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;
+    /** URI Information */
+    addressInfo: AddressInfo;
+    /** The network interface could be several types, something like ui, p2p, or network */
+    type: ServiceInterfaceType;
+};
+export type ServiceInterfaceWithHostInfo = ServiceInterface & {
+    hostInfo: HostInfo;
+};
+export type ExposeServicePaths<Store = never> = {
+    /** The path to the value in the Store. [JsonPath](https://jsonpath.com/)  */
+    paths: ExposedStorePaths;
+};
+export type SdkPropertiesValue = {
+    type: "object";
+    value: {
+        [k: string]: SdkPropertiesValue;
+    };
+    description?: string;
+} | {
+    type: "string";
+    /** Value  */
+    value: string;
+    /** A human readable description or explanation of the value */
+    description?: string;
+    /** (string/number only) Whether or not to mask the value, for example, when displaying a password */
+    masked: boolean;
+    /** (string/number only) Whether or not to include a button for copying the value to clipboard */
+    copyable?: boolean;
+    /** (string/number only) Whether or not to include a button for displaying the value as a QR code */
+    qr?: boolean;
+};
+export type SdkPropertiesReturn = {
+    [key: string]: SdkPropertiesValue;
+};
+export type PropertiesValue = {
+    type: "object";
+    value: {
+        [k: string]: PropertiesValue;
+    };
+    description: string | null;
+} | {
+    type: "string";
+    /** Value  */
+    value: string;
+    /** A human readable description or explanation of the value */
+    description: string | null;
+    /** (string/number only) Whether or not to mask the value, for example, when displaying a password */
+    masked: boolean;
+    /** (string/number only) Whether or not to include a button for copying the value to clipboard */
+    copyable: boolean | null;
+    /** (string/number only) Whether or not to include a button for displaying the value as a QR code */
+    qr: boolean | null;
+};
+export type PropertiesReturn = {
+    [key: string]: PropertiesValue;
+};
+/** Used to reach out from the pure js runtime */
+export type Effects = {
+    executeAction<Input>(opts: {
+        serviceId: string | null;
+        input: Input;
+    }): Promise<unknown>;
+    /** A low level api used by makeOverlay */
+    createOverlayedImage(options: {
+        imageId: string;
+    }): Promise<[string, string]>;
+    /** A low level api used by destroyOverlay + makeOverlay:destroy */
+    destroyOverlayedImage(options: {
+        guid: string;
+    }): Promise<void>;
+    /** Removes all network bindings */
+    clearBindings(): Promise<void>;
+    /** Creates a host connected to the specified port with the provided options */
+    bind(options: {
+        kind: "static" | "single" | "multi";
+        id: string;
+        internalPort: number;
+    } & BindOptions): Promise<void>;
+    /** Retrieves the current hostname(s) associated with a host id */
+    getHostInfo(options: {
+        kind: "multi" | null;
+        serviceInterfaceId: string;
+        packageId: string | null;
+        callback: () => void;
+    }): Promise<MultiHost>;
+    store: {
+        /** Get a value in a json like data, can be observed and subscribed */
+        get<Store = never, ExtractStore = unknown>(options: {
+            /** If there is no packageId it is assumed the current package */
+            packageId?: string;
+            /** The path defaults to root level, using the [JsonPath](https://jsonpath.com/) */
+            path: StorePath;
+            callback: (config: unknown, previousConfig: unknown) => void;
+        }): Promise<ExtractStore>;
+        /** Used to store values that can be accessed and subscribed to */
+        set<Store = never, ExtractStore = unknown>(options: {
+            /** Sets the value for the wrapper at the path, it will override, using the [JsonPath](https://jsonpath.com/)  */
+            path: StorePath;
+            value: ExtractStore;
+        }): Promise<void>;
+    };
+    setMainStatus(o: SetMainStatus): Promise<void>;
+    getSystemSmtp(input: {
+        callback: (config: unknown, previousConfig: unknown) => void;
+    }): Promise<SmtpValue>;
+    /** Get the IP address of the container */
+    getContainerIp(): Promise<string>;
+    /**
+     * Get the port address for another service
+     */
+    getServicePortForward(options: {
+        internalPort: number;
+        packageId: string | null;
+    }): Promise<number>;
+    /** Removes all network interfaces */
+    clearServiceInterfaces(): Promise<void>;
+    /** When we want to create a link in the front end interfaces, and example is
+     * exposing a url to view a web service
+     */
+    exportServiceInterface(options: ServiceInterface): Promise<string>;
+    exposeForDependents(options: {
+        paths: string[];
+    }): Promise<void>;
+    /**
+     * There are times that we want to see the addresses that where exported
+     * @param options.addressId If we want to filter the address id
+     *
+     * Note: any auth should be filtered out already
+     */
+    getServiceInterface(options: {
+        packageId: PackageId | null;
+        serviceInterfaceId: ServiceInterfaceId;
+        callback: () => void;
+    }): Promise<ServiceInterface>;
+    /**
+     * The user sets the primary url for a interface
+     * @param options
+     */
+    getPrimaryUrl(options: {
+        packageId: PackageId | null;
+        serviceInterfaceId: ServiceInterfaceId;
+        callback: () => void;
+    }): Promise<UrlString | null>;
+    /**
+     * There are times that we want to see the addresses that where exported
+     * @param options.addressId If we want to filter the address id
+     *
+     * Note: any auth should be filtered out already
+     */
+    listServiceInterfaces(options: {
+        packageId: PackageId | null;
+        callback: () => void;
+    }): Promise<ServiceInterface[]>;
+    /**
+     *Remove an address that was exported. Used problably during main or during setConfig.
+     * @param options
+     */
+    removeAddress(options: {
+        id: string;
+    }): Promise<void>;
+    /**
+     *
+     * @param options
+     */
+    exportAction(options: {
+        id: string;
+        metadata: ActionMetadata;
+    }): Promise<void>;
+    /**
+     * Remove an action that was exported. Used problably during main or during setConfig.
+     */
+    removeAction(options: {
+        id: string;
+    }): Promise<void>;
+    getConfigured(): Promise<boolean>;
+    /**
+     * This called after a valid set config as well as during init.
+     * @param configured
+     */
+    setConfigured(options: {
+        configured: boolean;
+    }): Promise<void>;
+    /**
+     *
+     * @returns  PEM encoded fullchain (ecdsa)
+     */
+    getSslCertificate: (options: {
+        packageId: string | null;
+        hostId: string;
+        algorithm: "ecdsa" | "ed25519" | null;
+    }) => Promise<[string, string, string]>;
+    /**
+     * @returns PEM encoded ssl key (ecdsa)
+     */
+    getSslKey: (options: {
+        packageId: string | null;
+        hostId: string;
+        algorithm: "ecdsa" | "ed25519" | null;
+    }) => Promise<string>;
+    setHealth(o: SetHealth): Promise<void>;
+    /** Set the dependencies of what the service needs, usually ran during the set config as a best practice */
+    setDependencies(options: {
+        dependencies: Dependencies;
+    }): Promise<DependenciesReceipt>;
+    /** Get the list of the dependencies, both the dynamic set by the effect of setDependencies and the end result any required in the manifest  */
+    getDependencies(): Promise<DependencyRequirement[]>;
+    /** When one wants to checks the status of several services during the checking of dependencies. The result will include things like the status
+     * of the service and what the current health checks are.
+     */
+    checkDependencies(options: {
+        packageIds: PackageId[] | null;
+    }): Promise<CheckDependencyResult[]>;
+    /** Exists could be useful during the runtime to know if some service exists, option dep */
+    exists(options: {
+        packageId: PackageId;
+    }): Promise<boolean>;
+    /** Exists could be useful during the runtime to know if some service is running, option dep */
+    running(options: {
+        packageId: PackageId;
+    }): Promise<boolean>;
+    /** Instead of creating proxies with nginx, we have a utility to create and maintain a proxy in the lifetime of this running. */
+    reverseProxy(options: {
+        bind: {
+            /** Optional, default is 0.0.0.0 */
+            ip: string | null;
+            port: number;
+            ssl: boolean;
+        };
+        dst: {
+            /** Optional: default is 127.0.0.1 */
+            ip: string | null;
+            port: number;
+            ssl: boolean;
+        };
+        http: {
+            headers: Record<string, string> | null;
+        } | null;
+    }): Promise<{
+        stop(): Promise<void>;
+    }>;
+    restart(): void;
+    shutdown(): void;
+    mount(options: {
+        location: string;
+        target: {
+            packageId: string;
+            volumeId: string;
+            subpath: string | null;
+            readonly: boolean;
+        };
+    }): Promise<string>;
+    stopped(options: {
+        packageId: string | null;
+    }): Promise<boolean>;
+};
+/** rsync options: https://linux.die.net/man/1/rsync
+ */
+export type BackupOptions = {
+    delete: boolean;
+    force: boolean;
+    ignoreExisting: boolean;
+    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 MigrationRes = {
+    configured: boolean;
+};
+export type ActionResult = {
+    message: string;
+    value: null | {
+        value: string;
+        copyable: boolean;
+        qr: boolean;
+    };
+};
+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;
+export type CheckDependencyResult = {
+    packageId: PackageId;
+    isInstalled: boolean;
+    isRunning: boolean;
+    healthChecks: SetHealth[];
+    version: string | null;
+};
+export type CheckResults = CheckDependencyResult[];

package/cjs/lib/types.js

@@ -0,0 +1,36 @@
+"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.configTypes = void 0;
+exports.configTypes = __importStar(require("./config/configTypes"));
+__exportStar(require("./osBindings"), exports);
+var ExpectedExports;
+(function (ExpectedExports) {
+    version: 1;
+})(ExpectedExports = exports.ExpectedExports || (exports.ExpectedExports = {}));
+//# sourceMappingURL=types.js.map

package/cjs/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../lib/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oEAAmD;AAiBnD,+CAA4B;AAS5B,IAAiB,eAAe,CAmF/B;AAnFD,WAAiB,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAA;AAkFZ,CAAC,EAnFgB,eAAe,GAAf,uBAAe,KAAf,uBAAe,QAmF/B"}

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

@@ -0,0 +1,17 @@
+import { Effects } from "../types";
+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>;
+    /**
+     * Returns the system SMTP credentials. Does nothing if the credentials change
+     */
+    once(): Promise<import("../types").SmtpValue>;
+    /**
+     * Watches the system SMTP credentials. Takes a custom callback function to run whenever the credentials change
+     */
+    watch(): AsyncGenerator<import("../types").SmtpValue, void, unknown>;
+}

package/cjs/lib/util/GetSystemSmtp.js

@@ -0,0 +1,41 @@
+"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.restart,
+        });
+    }
+    /**
+     * Returns the system SMTP credentials. Does nothing if the credentials change
+     */
+    once() {
+        return this.effects.getSystemSmtp({
+            callback: () => { },
+        });
+    }
+    /**
+     * 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/cjs/lib/util/GetSystemSmtp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetSystemSmtp.js","sourceRoot":"","sources":["../../../../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,IAAI,CAAC,OAAO,CAAC,OAAO;SAC/B,CAAC,CAAA;IACJ,CAAC;IACD;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;YAChC,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;SACnB,CAAC,CAAA;IACJ,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;AAlCD,sCAkCC"}