@start9labs/start-sdk 0.3.6-alpha.10

package/base/lib/types/ManifestTypes.d.ts

@@ -0,0 +1,158 @@
+import { T } from "..";
+import { ImageId, ImageSource } from "../types";
+export type SDKManifest = {
+    /**
+     * The package identifier used by StartOS. This must be unique amongst all other known packages.
+     * @example nextcloud
+     * */
+    readonly id: string;
+    /**
+     * The human readable name of your service
+     * @example Nextcloud
+     * */
+    readonly title: string;
+    /**
+     * The name of the software license for this project. The license itself should be included in the root of the project directory.
+     * @example MIT
+     */
+    readonly license: string;
+    /**
+     * URL of the StartOS package repository
+     * @example `https://github.com/Start9Labs/nextcloud-startos`
+     */
+    readonly wrapperRepo: string;
+    /**
+     * URL of the upstream service repository
+     * @example `https://github.com/nextcloud/docker`
+     */
+    readonly upstreamRepo: string;
+    /**
+     * URL where users can get help using the upstream service
+     * @example `https://github.com/nextcloud/docker/issues`
+     */
+    readonly supportSite: string;
+    /**
+     * URL where users can learn more about the upstream service
+     * @example `https://nextcloud.com`
+     */
+    readonly marketingSite: string;
+    /**
+     * (optional) URL where users can donate to the upstream project
+     * @example `https://nextcloud.com/contribute/`
+     */
+    readonly donationUrl: string | null;
+    readonly description: {
+        /** Short description to display on the marketplace list page. Max length 80 chars. */
+        readonly short: string;
+        /** Long description to display on the marketplace details page for this service. Max length 500 chars. */
+        readonly long: string;
+    };
+    /**
+     * @description A mapping of OS images needed to run the container processes. Each image ID is a unique key.
+     * @example
+     * Using dockerTag...
+     *
+     * ```
+      images: {
+        main: {
+          source: {
+            dockerTag: 'start9/hello-world',
+          },
+        },
+      },
+     * ```
+     * @example
+     * Using dockerBuild...
+     *
+     * ```
+      images: {
+        main: {
+          source: {
+            dockerBuild: {
+              dockerFile: '../Dockerfile',
+              workdir: '.',
+            },
+          },
+        },
+      },
+     * ```
+     */
+    readonly images: Record<ImageId, SDKImageInputSpec>;
+    /**
+     * @description A list of readonly asset directories that will mount to the container. Each item here must
+     *   correspond to a directory in the /assets directory of this project.
+     *
+     *   Most projects will not make use of this.
+     * @example []
+     */
+    readonly assets: string[];
+    /**
+     * @description A list of data volumes that will mount to the container. Must contain at least one volume.
+     * @example ['main']
+     */
+    readonly volumes: string[];
+    readonly alerts?: {
+        /** An warning alert requiring user confirmation before proceeding with initial installation of this service. */
+        readonly install?: string | null;
+        /** An warning alert requiring user confirmation before updating this service. */
+        readonly update?: string | null;
+        /** An warning alert requiring user confirmation before uninstalling this service. */
+        readonly uninstall?: string | null;
+        /** An warning alert requiring user confirmation before restoring this service from backup. */
+        readonly restore?: string | null;
+        /** An warning alert requiring user confirmation before starting this service. */
+        readonly start?: string | null;
+        /** An warning alert requiring user confirmation before stopping this service. */
+        readonly stop?: string | null;
+    };
+    /**
+     * @description A mapping of service dependencies to be displayed to users when viewing the Marketplace
+     * @property {string} description - An explanation of why this service is a dependency.
+     * @property {boolean} optional - Whether or not this dependency is required or contingent on user configuration.
+     * @property {string} s9pk - A path or url to an s9pk of the dependency to extract metadata at build time
+     * @example
+     * ```
+      dependencies: {
+        'hello-world': {
+          description: 'A moon needs a world',
+          optional: false,
+          s9pk: '',
+        },
+      },
+     * ```
+     */
+    readonly dependencies: Record<string, ManifestDependency>;
+    /**
+     * @description (optional) A set of hardware requirements for this service. If the user's machine
+     *   does not meet these requirements, they will not be able to install this service.
+     * @property {object[]} devices - TODO Aiden confirm type on the left. List of required devices (displays or processors).
+     * @property {number} ram - Minimum RAM requirement (in megabytes MB)
+     * @property {string[]} arch - List of supported arches
+     * @example
+     * ```
+      TODO Aiden verify below and provide examples for devices
+      hardwareRequirements: {
+        devices: [
+          { class: 'display', value: '' },
+          { class: 'processor', value: '' },
+        ],
+        ram: 8192,
+        arch: ['x86-64'],
+      },
+     * ```
+     */
+    readonly hardwareRequirements?: {
+        readonly device?: {
+            display?: RegExp;
+            processor?: RegExp;
+        };
+        readonly ram?: number | null;
+        readonly arch?: string[] | null;
+    };
+};
+export type SDKImageInputSpec = {
+    source: Exclude<ImageSource, "packed">;
+    arch?: string[];
+    emulateMissingAs?: string | null;
+};
+export type ManifestDependency = T.Manifest["dependencies"][string];

package/base/lib/types/ManifestTypes.js

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

package/base/lib/types/ManifestTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestTypes.js","sourceRoot":"","sources":["../../../../base/lib/types/ManifestTypes.ts"],"names":[],"mappings":""}

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.d.ts

@@ -0,0 +1,2 @@
+import { HostnameInfo } from "../types";
+export declare function hostnameInfoToAddress(hostInfo: HostnameInfo): string;

package/base/lib/util/Hostname.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hostnameInfoToAddress = void 0;
+function hostnameInfoToAddress(hostInfo) {
+    if (hostInfo.kind === "onion") {
+        return `${hostInfo.hostname.value}`;
+    }
+    if (hostInfo.kind !== "ip") {
+        throw Error("Expecting that the kind is ip.");
+    }
+    const hostname = hostInfo.hostname;
+    if (hostname.kind === "domain") {
+        return `${hostname.subdomain ? `${hostname.subdomain}.` : ""}${hostname.domain}`;
+    }
+    const port = hostname.sslPort || hostname.port;
+    const portString = port ? `:${port}` : "";
+    if ("ipv4" === hostname.kind || "ipv6" === hostname.kind) {
+        return `${hostname.value}${portString}`;
+    }
+    if ("local" === hostname.kind) {
+        return `${hostname.value}${portString}`;
+    }
+    throw Error("Expecting to have a valid hostname kind." + JSON.stringify(hostname));
+}
+exports.hostnameInfoToAddress = hostnameInfoToAddress;
+//# sourceMappingURL=Hostname.js.map

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.d.ts

@@ -0,0 +1,13 @@
+import { Affine } from "../util";
+declare const pathValue: unique symbol;
+export type PathValue = typeof pathValue;
+export type PathBuilderStored<AllStore, Store> = {
+    [K in PathValue]: [AllStore, Store];
+};
+export type PathBuilder<AllStore, Store = AllStore> = (Store extends Record<string, unknown> ? {
+    [K in keyof Store]: PathBuilder<AllStore, Store[K]>;
+} : {}) & PathBuilderStored<AllStore, Store>;
+export type StorePath = string & Affine<"StorePath">;
+export declare const extractJsonPath: (builder: PathBuilder<unknown>) => StorePath;
+export declare const pathBuilder: <Store, StorePath_1 = Store>(paths?: string[]) => PathBuilder<Store, StorePath_1>;
+export {};

package/base/lib/util/PathBuilder.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pathBuilder = exports.extractJsonPath = void 0;
+const pathValue = Symbol("pathValue");
+const privateSymbol = Symbol("jsonPath");
+const extractJsonPath = (builder) => {
+    return builder[privateSymbol];
+};
+exports.extractJsonPath = extractJsonPath;
+const pathBuilder = (paths = []) => {
+    return new Proxy({}, {
+        get(target, prop) {
+            if (prop === privateSymbol) {
+                if (paths.length === 0)
+                    return "";
+                return `/${paths.join("/")}`;
+            }
+            return (0, exports.pathBuilder)([...paths, prop]);
+        },
+    });
+};
+exports.pathBuilder = pathBuilder;
+//# sourceMappingURL=PathBuilder.js.map

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.d.ts

@@ -0,0 +1 @@
+export declare const asError: (e: unknown) => Error;

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.d.ts

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

package/base/lib/util/deepEqual.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepEqual = void 0;
+const ts_matches_1 = require("ts-matches");
+function deepEqual(...args) {
+    if (!ts_matches_1.object.test(args[args.length - 1]))
+        return args[args.length - 1];
+    const objects = args.filter(ts_matches_1.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;
+}
+exports.deepEqual = deepEqual;
+//# sourceMappingURL=deepEqual.js.map

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;