@start9labs/start-sdk 0.3.6-alpha.10

package/base/lib/interfaces/AddressReceipt.js

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

package/base/lib/interfaces/AddressReceipt.js.map

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

package/base/lib/interfaces/Host.d.ts

@@ -0,0 +1,120 @@
+import { Effects } from "../Effects";
+import { Origin } from "./Origin";
+import { AddSslOptions, BindParams } from "../osBindings";
+import { Security } from "../osBindings";
+import { BindOptions } from "../osBindings";
+import { AlpnInfo } from "../osBindings";
+export { AddSslOptions, Security, BindOptions };
+export declare const knownProtocols: {
+    readonly http: {
+        readonly secure: null;
+        readonly defaultPort: 80;
+        readonly withSsl: "https";
+        readonly alpn: AlpnInfo;
+    };
+    readonly https: {
+        readonly secure: {
+            readonly ssl: true;
+        };
+        readonly defaultPort: 443;
+    };
+    readonly ws: {
+        readonly secure: null;
+        readonly defaultPort: 80;
+        readonly withSsl: "wss";
+        readonly alpn: AlpnInfo;
+    };
+    readonly wss: {
+        readonly secure: {
+            readonly ssl: true;
+        };
+        readonly defaultPort: 443;
+    };
+    readonly ssh: {
+        readonly secure: {
+            readonly ssl: false;
+        };
+        readonly defaultPort: 22;
+    };
+    readonly bitcoin: {
+        readonly secure: {
+            readonly ssl: false;
+        };
+        readonly defaultPort: 8333;
+    };
+    readonly lightning: {
+        readonly secure: {
+            readonly ssl: true;
+        };
+        readonly defaultPort: 9735;
+    };
+    readonly grpc: {
+        readonly secure: {
+            readonly ssl: true;
+        };
+        readonly defaultPort: 50051;
+    };
+    readonly dns: {
+        readonly secure: {
+            readonly ssl: false;
+        };
+        readonly defaultPort: 53;
+    };
+};
+export type Scheme = string | null;
+type KnownProtocols = typeof knownProtocols;
+type ProtocolsWithSslVariants = {
+    [K in keyof KnownProtocols]: KnownProtocols[K] extends {
+        withSsl: string;
+    } ? K : never;
+}[keyof KnownProtocols];
+type NotProtocolsWithSslVariants = Exclude<keyof KnownProtocols, ProtocolsWithSslVariants>;
+type BindOptionsByKnownProtocol = {
+    protocol: ProtocolsWithSslVariants;
+    preferredExternalPort?: number;
+    addSsl?: Partial<AddSslOptions>;
+} | {
+    protocol: NotProtocolsWithSslVariants;
+    preferredExternalPort?: number;
+    addSsl?: AddSslOptions;
+};
+export type BindOptionsByProtocol = BindOptionsByKnownProtocol | BindOptions;
+export type HostKind = BindParams["kind"];
+export declare class Host {
+    readonly options: {
+        effects: Effects;
+        kind: HostKind;
+        id: string;
+    };
+    constructor(options: {
+        effects: Effects;
+        kind: HostKind;
+        id: string;
+    });
+    /**
+     * @description Use this function to bind the host to an internal port and configured options for protocol, security, and external port.
+     *
+     * @param internalPort - The internal port to be bound.
+     * @param options - The protocol options for this binding.
+     * @returns A multi-origin that is capable of exporting one or more service interfaces.
+     * @example
+     * In this example, we bind a previously created multi-host to port 80, then select the http protocol and request an external port of 8332.
+     *
+     * ```
+      const uiMultiOrigin = await uiMulti.bindPort(80, {
+        protocol: 'http',
+        preferredExternalPort: 8332,
+      })
+     * ```
+     */
+    bindPort(internalPort: number, options: BindOptionsByProtocol): Promise<Origin<this>>;
+    private bindPortForUnknown;
+    private bindPortForKnown;
+    private getSslProto;
+}
+export declare class MultiHost extends Host {
+    constructor(options: {
+        effects: Effects;
+        id: string;
+    });
+}

package/base/lib/interfaces/Host.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiHost = exports.Host = exports.knownProtocols = void 0;
+const ts_matches_1 = require("ts-matches");
+const Origin_1 = require("./Origin");
+exports.knownProtocols = {
+    http: {
+        secure: null,
+        defaultPort: 80,
+        withSsl: "https",
+        alpn: { specified: ["http/1.1"] },
+    },
+    https: {
+        secure: { ssl: true },
+        defaultPort: 443,
+    },
+    ws: {
+        secure: null,
+        defaultPort: 80,
+        withSsl: "wss",
+        alpn: { specified: ["http/1.1"] },
+    },
+    wss: {
+        secure: { ssl: true },
+        defaultPort: 443,
+    },
+    ssh: {
+        secure: { ssl: false },
+        defaultPort: 22,
+    },
+    bitcoin: {
+        secure: { ssl: false },
+        defaultPort: 8333,
+    },
+    lightning: {
+        secure: { ssl: true },
+        defaultPort: 9735,
+    },
+    grpc: {
+        secure: { ssl: true },
+        defaultPort: 50051,
+    },
+    dns: {
+        secure: { ssl: false },
+        defaultPort: 53,
+    },
+};
+const hasStringProtocol = (0, ts_matches_1.object)({
+    protocol: ts_matches_1.string,
+}).test;
+class Host {
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * @description Use this function to bind the host to an internal port and configured options for protocol, security, and external port.
+     *
+     * @param internalPort - The internal port to be bound.
+     * @param options - The protocol options for this binding.
+     * @returns A multi-origin that is capable of exporting one or more service interfaces.
+     * @example
+     * In this example, we bind a previously created multi-host to port 80, then select the http protocol and request an external port of 8332.
+     *
+     * ```
+      const uiMultiOrigin = await uiMulti.bindPort(80, {
+        protocol: 'http',
+        preferredExternalPort: 8332,
+      })
+     * ```
+     */
+    async bindPort(internalPort, options) {
+        if (hasStringProtocol(options)) {
+            return await this.bindPortForKnown(options, internalPort);
+        }
+        else {
+            return await this.bindPortForUnknown(internalPort, options);
+        }
+    }
+    async bindPortForUnknown(internalPort, options) {
+        const binderOptions = {
+            kind: this.options.kind,
+            id: this.options.id,
+            internalPort,
+            ...options,
+        };
+        await this.options.effects.bind(binderOptions);
+        return new Origin_1.Origin(this, internalPort, null, null);
+    }
+    async bindPortForKnown(options, internalPort) {
+        const protoInfo = exports.knownProtocols[options.protocol];
+        const preferredExternalPort = options.preferredExternalPort ||
+            exports.knownProtocols[options.protocol].defaultPort;
+        const sslProto = this.getSslProto(options, protoInfo);
+        const addSsl = sslProto && "alpn" in protoInfo
+            ? {
+                // addXForwardedHeaders: null,
+                preferredExternalPort: exports.knownProtocols[sslProto].defaultPort,
+                scheme: sslProto,
+                alpn: protoInfo.alpn,
+                ...("addSsl" in options ? options.addSsl : null),
+            }
+            : null;
+        const secure = !protoInfo.secure ? null : { ssl: false };
+        await this.options.effects.bind({
+            kind: this.options.kind,
+            id: this.options.id,
+            internalPort,
+            preferredExternalPort,
+            addSsl,
+            secure,
+        });
+        return new Origin_1.Origin(this, internalPort, options.protocol, sslProto);
+    }
+    getSslProto(options, protoInfo) {
+        if (inObject("noAddSsl", options) && options.noAddSsl)
+            return null;
+        if ("withSsl" in protoInfo && protoInfo.withSsl)
+            return protoInfo.withSsl;
+        return null;
+    }
+}
+exports.Host = Host;
+function inObject(key, obj) {
+    return key in obj;
+}
+// export class StaticHost extends Host {
+//   constructor(options: { effects: Effects; id: string }) {
+//     super({ ...options, kind: "static" })
+//   }
+// }
+// export class SingleHost extends Host {
+//   constructor(options: { effects: Effects; id: string }) {
+//     super({ ...options, kind: "single" })
+//   }
+// }
+class MultiHost extends Host {
+    constructor(options) {
+        super({ ...options, kind: "multi" });
+    }
+}
+exports.MultiHost = MultiHost;
+//# sourceMappingURL=Host.js.map

package/base/lib/interfaces/Host.js.map

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

package/base/lib/interfaces/Origin.d.ts

@@ -0,0 +1,31 @@
+import { AddressInfo } from "../types";
+import { AddressReceipt } from "./AddressReceipt";
+import { Host, Scheme } from "./Host";
+import { ServiceInterfaceBuilder } from "./ServiceInterfaceBuilder";
+export declare class Origin<T extends Host> {
+    readonly host: T;
+    readonly internalPort: number;
+    readonly scheme: string | null;
+    readonly sslScheme: string | null;
+    constructor(host: T, internalPort: number, scheme: string | null, sslScheme: string | null);
+    build({ username, path, search, schemeOverride }: BuildOptions): AddressInfo;
+    /**
+     * @description A function to register a group of origins (<PROTOCOL> :// <HOSTNAME> : <PORT>) with StartOS
+     *
+     *   The returned addressReceipt serves as proof that the addresses were registered
+     *
+     * @param addressInfo
+     * @returns
+     */
+    export(serviceInterfaces: ServiceInterfaceBuilder[]): Promise<AddressInfo[] & AddressReceipt>;
+}
+type BuildOptions = {
+    schemeOverride: {
+        ssl: Scheme;
+        noSsl: Scheme;
+    } | null;
+    username: string | null;
+    path: string;
+    search: Record<string, string>;
+};
+export {};

package/base/lib/interfaces/Origin.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Origin = void 0;
+class Origin {
+    constructor(host, internalPort, scheme, sslScheme) {
+        this.host = host;
+        this.internalPort = internalPort;
+        this.scheme = scheme;
+        this.sslScheme = sslScheme;
+    }
+    build({ username, path, search, schemeOverride }) {
+        const qpEntries = Object.entries(search)
+            .map(([key, val]) => `${encodeURIComponent(key)}=${encodeURIComponent(val)}`)
+            .join("&");
+        const qp = qpEntries.length ? `?${qpEntries}` : "";
+        return {
+            hostId: this.host.options.id,
+            internalPort: this.internalPort,
+            scheme: schemeOverride ? schemeOverride.noSsl : this.scheme,
+            sslScheme: schemeOverride ? schemeOverride.ssl : this.sslScheme,
+            suffix: `${path}${qp}`,
+            username,
+        };
+    }
+    /**
+     * @description A function to register a group of origins (<PROTOCOL> :// <HOSTNAME> : <PORT>) with StartOS
+     *
+     *   The returned addressReceipt serves as proof that the addresses were registered
+     *
+     * @param addressInfo
+     * @returns
+     */
+    async export(serviceInterfaces) {
+        const addressesInfo = [];
+        for (let serviceInterface of serviceInterfaces) {
+            const { name, description, hasPrimary, id, type, username, path, search, schemeOverride, masked, } = serviceInterface.options;
+            const addressInfo = this.build({
+                username,
+                path,
+                search,
+                schemeOverride,
+            });
+            await serviceInterface.options.effects.exportServiceInterface({
+                id,
+                name,
+                description,
+                hasPrimary,
+                addressInfo,
+                type,
+                masked,
+            });
+            addressesInfo.push(addressInfo);
+        }
+        return addressesInfo;
+    }
+}
+exports.Origin = Origin;
+//# sourceMappingURL=Origin.js.map

package/base/lib/interfaces/Origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Origin.js","sourceRoot":"","sources":["../../../../base/lib/interfaces/Origin.ts"],"names":[],"mappings":";;;AAKA,MAAa,MAAM;IACjB,YACW,IAAO,EACP,YAAoB,EACpB,MAAqB,EACrB,SAAwB;QAHxB,SAAI,GAAJ,IAAI,CAAG;QACP,iBAAY,GAAZ,YAAY,CAAQ;QACpB,WAAM,GAAN,MAAM,CAAe;QACrB,cAAS,GAAT,SAAS,CAAe;IAChC,CAAC;IAEJ,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAgB;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;aACrC,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CACxE;aACA,IAAI,CAAC,GAAG,CAAC,CAAA;QAEZ,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAElD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAC5B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM;YAC3D,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS;YAC/D,MAAM,EAAE,GAAG,IAAI,GAAG,EAAE,EAAE;YACtB,QAAQ;SACT,CAAA;IACH,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,iBAA4C;QAE5C,MAAM,aAAa,GAAG,EAAE,CAAA;QACxB,KAAK,IAAI,gBAAgB,IAAI,iBAAiB,EAAE;YAC9C,MAAM,EACJ,IAAI,EACJ,WAAW,EACX,UAAU,EACV,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,cAAc,EACd,MAAM,GACP,GAAG,gBAAgB,CAAC,OAAO,CAAA;YAE5B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC;gBAC7B,QAAQ;gBACR,IAAI;gBACJ,MAAM;gBACN,cAAc;aACf,CAAC,CAAA;YAEF,MAAM,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC;gBAC5D,EAAE;gBACF,IAAI;gBACJ,WAAW;gBACX,UAAU;gBACV,WAAW;gBACX,IAAI;gBACJ,MAAM;aACP,CAAC,CAAA;YAEF,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;SAChC;QAED,OAAO,aAA+C,CAAA;IACxD,CAAC;CACF;AA3ED,wBA2EC"}

package/base/lib/interfaces/ServiceInterfaceBuilder.d.ts

@@ -0,0 +1,48 @@
+import { ServiceInterfaceType } from "../types";
+import { Effects } from "../Effects";
+import { Scheme } from "./Host";
+/**
+ * A helper class for creating a Network Interface
+ *
+ * Network Interfaces are collections of web addresses that expose the same API or other resource,
+ * display to the user with under a common name and description.
+ *
+ * All URIs on an interface inherit the same ui: bool, basic auth credentials, path, and search (query) params
+ *
+ * @param options
+ * @returns
+ */
+export declare class ServiceInterfaceBuilder {
+    readonly options: {
+        effects: Effects;
+        name: string;
+        id: string;
+        description: string;
+        hasPrimary: boolean;
+        type: ServiceInterfaceType;
+        username: string | null;
+        path: string;
+        search: Record<string, string>;
+        schemeOverride: {
+            ssl: Scheme;
+            noSsl: Scheme;
+        } | null;
+        masked: boolean;
+    };
+    constructor(options: {
+        effects: Effects;
+        name: string;
+        id: string;
+        description: string;
+        hasPrimary: boolean;
+        type: ServiceInterfaceType;
+        username: string | null;
+        path: string;
+        search: Record<string, string>;
+        schemeOverride: {
+            ssl: Scheme;
+            noSsl: Scheme;
+        } | null;
+        masked: boolean;
+    });
+}

package/base/lib/interfaces/ServiceInterfaceBuilder.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceInterfaceBuilder = void 0;
+/**
+ * A helper class for creating a Network Interface
+ *
+ * Network Interfaces are collections of web addresses that expose the same API or other resource,
+ * display to the user with under a common name and description.
+ *
+ * All URIs on an interface inherit the same ui: bool, basic auth credentials, path, and search (query) params
+ *
+ * @param options
+ * @returns
+ */
+class ServiceInterfaceBuilder {
+    constructor(options) {
+        this.options = options;
+    }
+}
+exports.ServiceInterfaceBuilder = ServiceInterfaceBuilder;
+//# sourceMappingURL=ServiceInterfaceBuilder.js.map

package/base/lib/interfaces/ServiceInterfaceBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceInterfaceBuilder.js","sourceRoot":"","sources":["../../../../base/lib/interfaces/ServiceInterfaceBuilder.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;GAUG;AACH,MAAa,uBAAuB;IAClC,YACW,OAYR;QAZQ,YAAO,GAAP,OAAO,CAYf;IACA,CAAC;CACL;AAhBD,0DAgBC"}

package/base/lib/interfaces/setupInterfaces.d.ts

@@ -0,0 +1,17 @@
+import * as T from "../types";
+import { AddressReceipt } from "./AddressReceipt";
+declare const UpdateServiceInterfacesProof: unique symbol;
+export type UpdateServiceInterfacesReceipt = {
+    [UpdateServiceInterfacesProof]: never;
+};
+export type ServiceInterfacesReceipt = Array<T.AddressInfo[] & AddressReceipt>;
+export type SetServiceInterfaces<Output extends ServiceInterfacesReceipt> = (opts: {
+    effects: T.Effects;
+}) => Promise<Output>;
+export type UpdateServiceInterfaces<Output extends ServiceInterfacesReceipt> = (opts: {
+    effects: T.Effects;
+}) => Promise<Output & UpdateServiceInterfacesReceipt>;
+export type SetupServiceInterfaces = <Output extends ServiceInterfacesReceipt>(fn: SetServiceInterfaces<Output>) => UpdateServiceInterfaces<Output>;
+export declare const NO_INTERFACE_CHANGES: UpdateServiceInterfacesReceipt;
+export declare const setupServiceInterfaces: SetupServiceInterfaces;
+export {};

package/base/lib/interfaces/setupInterfaces.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupServiceInterfaces = exports.NO_INTERFACE_CHANGES = void 0;
+const util_1 = require("../util");
+exports.NO_INTERFACE_CHANGES = {};
+const setupServiceInterfaces = (fn) => {
+    const cell = {
+        updater: (async (options) => []),
+    };
+    cell.updater = (async (options) => {
+        options.effects = {
+            ...options.effects,
+            constRetry: (0, util_1.once)(() => {
+                cell.updater(options);
+            }),
+        };
+        const bindings = [];
+        const interfaces = [];
+        const res = await fn({
+            effects: {
+                ...options.effects,
+                bind: (params) => {
+                    bindings.push({ id: params.id, internalPort: params.internalPort });
+                    return options.effects.bind(params);
+                },
+                exportServiceInterface: (params) => {
+                    interfaces.push(params.id);
+                    return options.effects.exportServiceInterface(params);
+                },
+            },
+        });
+        await options.effects.clearBindings({ except: bindings });
+        await options.effects.clearServiceInterfaces({ except: interfaces });
+        return res;
+    });
+    return cell.updater;
+};
+exports.setupServiceInterfaces = setupServiceInterfaces;
+//# sourceMappingURL=setupInterfaces.js.map

package/base/lib/interfaces/setupInterfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupInterfaces.js","sourceRoot":"","sources":["../../../../base/lib/interfaces/setupInterfaces.ts"],"names":[],"mappings":";;;AACA,kCAA8B;AAkBjB,QAAA,oBAAoB,GAAG,EAAoC,CAAA;AACjE,MAAM,sBAAsB,GAA2B,CAG5D,EAAgC,EAChC,EAAE;IACF,MAAM,IAAI,GAAG;QACX,OAAO,EAAE,CAAC,KAAK,EAAE,OAA+B,EAAE,EAAE,CAClD,EAAmB,CAAoC;KAC1D,CAAA;IACD,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,OAA+B,EAAE,EAAE;QACxD,OAAO,CAAC,OAAO,GAAG;YAChB,GAAG,OAAO,CAAC,OAAO;YAClB,UAAU,EAAE,IAAA,WAAI,EAAC,GAAG,EAAE;gBACpB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACvB,CAAC,CAAC;SACH,CAAA;QACD,MAAM,QAAQ,GAAe,EAAE,CAAA;QAC/B,MAAM,UAAU,GAA2B,EAAE,CAAA;QAC7C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACnB,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,IAAI,EAAE,CAAC,MAAoB,EAAE,EAAE;oBAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;oBACnE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACrC,CAAC;gBACD,sBAAsB,EAAE,CAAC,MAAsC,EAAE,EAAE;oBACjE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;oBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAA;gBACvD,CAAC;aACF;SACF,CAAC,CAAA;QACF,MAAM,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;QACzD,MAAM,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QACpE,OAAO,GAAG,CAAA;IACZ,CAAC,CAAoC,CAAA;IACrC,OAAO,IAAI,CAAC,OAAO,CAAA;AACrB,CAAC,CAAA;AApCY,QAAA,sBAAsB,0BAoClC"}

package/base/lib/osBindings/AcceptSigners.d.ts

@@ -0,0 +1,8 @@
+import type { AnyVerifyingKey } from "./AnyVerifyingKey";
+export type AcceptSigners = {
+    signer: AnyVerifyingKey;
+} | {
+    any: Array<AcceptSigners>;
+} | {
+    all: Array<AcceptSigners>;
+};

package/base/lib/osBindings/AcceptSigners.js

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

package/base/lib/osBindings/AcceptSigners.js.map

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

package/base/lib/osBindings/ActionId.d.ts

@@ -0,0 +1 @@
+export type ActionId = string;

package/base/lib/osBindings/ActionId.js

@@ -0,0 +1,4 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ActionId.js.map

package/base/lib/osBindings/ActionId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionId.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionId.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/ActionInput.d.ts

@@ -0,0 +1,4 @@
+export type ActionInput = {
+    spec: Record<string, unknown>;
+    value: Record<string, unknown> | null;
+};

package/base/lib/osBindings/ActionInput.js

@@ -0,0 +1,4 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ActionInput.js.map

package/base/lib/osBindings/ActionInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionInput.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionInput.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/ActionMetadata.d.ts

@@ -0,0 +1,11 @@
+import type { ActionVisibility } from "./ActionVisibility";
+import type { AllowedStatuses } from "./AllowedStatuses";
+export type ActionMetadata = {
+    name: string;
+    description: string;
+    warning: string | null;
+    visibility: ActionVisibility;
+    allowedStatuses: AllowedStatuses;
+    hasInput: boolean;
+    group: string | null;
+};

package/base/lib/osBindings/ActionMetadata.js

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

package/base/lib/osBindings/ActionMetadata.js.map

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

package/base/lib/osBindings/ActionRequest.d.ts

@@ -0,0 +1,13 @@
+import type { ActionId } from "./ActionId";
+import type { ActionRequestInput } from "./ActionRequestInput";
+import type { ActionRequestTrigger } from "./ActionRequestTrigger";
+import type { ActionSeverity } from "./ActionSeverity";
+import type { PackageId } from "./PackageId";
+export type ActionRequest = {
+    packageId: PackageId;
+    actionId: ActionId;
+    severity: ActionSeverity;
+    reason?: string;
+    when?: ActionRequestTrigger;
+    input?: ActionRequestInput;
+};

package/base/lib/osBindings/ActionRequest.js

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

package/base/lib/osBindings/ActionRequest.js.map

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

package/base/lib/osBindings/ActionRequestCondition.d.ts

@@ -0,0 +1 @@
+export type ActionRequestCondition = "input-not-matches";

package/base/lib/osBindings/ActionRequestCondition.js

@@ -0,0 +1,4 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ActionRequestCondition.js.map

package/base/lib/osBindings/ActionRequestCondition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionRequestCondition.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionRequestCondition.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/ActionRequestEntry.d.ts

@@ -0,0 +1,5 @@
+import type { ActionRequest } from "./ActionRequest";
+export type ActionRequestEntry = {
+    request: ActionRequest;
+    active: boolean;
+};

package/base/lib/osBindings/ActionRequestEntry.js

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

package/base/lib/osBindings/ActionRequestEntry.js.map

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

package/base/lib/osBindings/ActionRequestInput.d.ts

@@ -0,0 +1,4 @@
+export type ActionRequestInput = {
+    kind: "partial";
+    value: Record<string, unknown>;
+};

package/base/lib/osBindings/ActionRequestInput.js

@@ -0,0 +1,4 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ActionRequestInput.js.map

package/base/lib/osBindings/ActionRequestInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionRequestInput.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionRequestInput.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/ActionRequestTrigger.d.ts

@@ -0,0 +1,5 @@
+import type { ActionRequestCondition } from "./ActionRequestCondition";
+export type ActionRequestTrigger = {
+    once: boolean;
+    condition: ActionRequestCondition;
+};