@start9labs/start-sdk 0.4.0-beta.9 → 1.0.0

package/base/lib/types.d.ts

@@ -1,131 +1,154 @@
-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 * as inputSpecTypes from './actions/input/inputSpecTypes';
+export { CurrentDependenciesResult, OptionalDependenciesOf as OptionalDependencies, RequiredDependenciesOf as RequiredDependencies, } from './dependencies/setupDependencies';
+export * from './osBindings';
+export { SDKManifest } from './types/ManifestTypes';
 export { Effects };
-export * from "./osBindings";
-export { SDKManifest } from "./types/ManifestTypes";
-export { RequiredDependenciesOf as RequiredDependencies, OptionalDependenciesOf as OptionalDependencies, CurrentDependenciesResult, } from "./dependencies/setupDependencies";
-export type ExposedStorePaths = string[] & Affine<"ExposedStorePaths">;
+import { InputSpec as InputSpecClass } from './actions/input/builder/inputSpec';
+import { Action, Actions } from './actions/setupActions';
+import { Effects } from './Effects';
+import { ExtendedVersion, VersionRange } from './exver';
+import { ActionId, DependencyRequirement, Manifest, NamedHealthCheckResult, ServiceInterface } from './osBindings';
+import { StringObject, ToKebab } from './util';
+/** An object that can be built into a terminable daemon process. */
 export type DaemonBuildable = {
     build(): Promise<{
         term(): Promise<void>;
     }>;
 };
-export type ServiceInterfaceType = "ui" | "p2p" | "api";
+/** The three categories of service network interfaces. */
+export type ServiceInterfaceType = 'ui' | 'p2p' | 'api';
+/** A Node.js signal name (e.g. `"SIGTERM"`, `"SIGKILL"`). */
 export type Signals = NodeJS.Signals;
+/** The SIGTERM signal — used for graceful daemon termination. */
 export declare const SIGTERM: Signals;
+/** The SIGKILL signal — used for forceful daemon termination. */
 export declare const SIGKILL: Signals;
+/** Sentinel value (`-1`) indicating that no timeout should be applied. */
 export declare const NO_TIMEOUT = -1;
+/** A function that builds an absolute file path from a volume name and relative path. */
 export type PathMaker = (options: {
     volume: string;
     path: string;
 }) => string;
+/** A value that may or may not be wrapped in a `Promise`. */
 export type MaybePromise<A> = Promise<A> | A;
+/**
+ * Namespace defining the required exports for a StartOS service package.
+ * Every package must export implementations matching these types.
+ */
 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: {
+    type init = (options: {
         effects: Effects;
+        kind: 'install' | 'update' | 'restore' | null;
     }) => 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: {
+    type uninit = (options: {
         effects: Effects;
-        nextVersion: null | string;
+        target: ExtendedVersion | VersionRange | null;
     }) => Promise<unknown>;
+    /** The package manifest describing the service's metadata, dependencies, and interfaces. */
     type manifest = Manifest;
-    type actions = Actions<any, Record<ActionId, Action<ActionId, any, any>>>;
+    /** The map of user-invocable actions defined by this service. */
+    type actions = Actions<Record<ActionId, Action<ActionId, any>>>;
 }
+/**
+ * The complete ABI (Application Binary Interface) for a StartOS service package.
+ * Maps all required exports to their expected types.
+ */
 export type ABI = {
     createBackup: ExpectedExports.createBackup;
-    restoreBackup: ExpectedExports.restoreBackup;
     main: ExpectedExports.main;
-    afterShutdown: ExpectedExports.afterShutdown;
-    containerInit: ExpectedExports.containerInit;
-    packageInit: ExpectedExports.packageInit;
-    packageUninit: ExpectedExports.packageUninit;
+    init: ExpectedExports.init;
+    uninit: ExpectedExports.uninit;
     manifest: ExpectedExports.manifest;
     actions: ExpectedExports.actions;
 };
+/** A time value in milliseconds. */
 export type TimeMs = number;
+/** A version string in string form. */
 export type VersionString = string;
 declare const DaemonProof: unique symbol;
+/** Opaque branded type proving that a daemon was started. Cannot be constructed directly. */
 export type DaemonReceipt = {
     [DaemonProof]: never;
 };
+/** A running daemon with methods to wait for completion or terminate it. */
 export type Daemon = {
+    /** Waits for the daemon to exit and returns its exit message. */
     wait(): Promise<string>;
+    /** Terminates the daemon. */
     term(): Promise<null>;
     [DaemonProof]: never;
 };
-export type HealthStatus = NamedHealthCheckResult["result"];
+/** The result status of a health check (extracted from `NamedHealthCheckResult`). */
+export type HealthStatus = NamedHealthCheckResult['result'];
+/** SMTP mail server configuration values. */
 export type SmtpValue = {
-    server: string;
+    host: string;
     port: number;
     from: string;
-    login: string;
+    username: string;
     password: string | null | undefined;
+    security: 'starttls' | 'tls';
 };
+/**
+ * Marker class indicating that a container should use its own built-in entrypoint
+ * rather than a custom command. Optionally accepts an override command array.
+ */
 export declare class UseEntrypoint {
     readonly overridCmd?: string[] | undefined;
+    readonly USE_ENTRYPOINT = "USE_ENTRYPOINT";
     constructor(overridCmd?: string[] | undefined);
 }
-export type CommandType = string | [string, ...string[]] | UseEntrypoint;
+/** Type guard that checks if a {@link CommandType} is a {@link UseEntrypoint} instance. */
+export declare function isUseEntrypoint(command: CommandType): command is UseEntrypoint;
+/**
+ * The ways to specify a command to run in a container:
+ * - A shell string (run via `sh -c`)
+ * - An explicit argv array
+ * - A {@link UseEntrypoint} to use the container's built-in entrypoint
+ */
+export type CommandType = string | [string, ...string[]] | readonly [string, ...string[]] | UseEntrypoint;
+/** The return type from starting a daemon — provides `wait()` and `term()` controls. */
 export type DaemonReturned = {
+    /** Waits for the daemon process to exit. */
     wait(): Promise<unknown>;
+    /** Sends a signal to terminate the daemon. If it doesn't exit within `timeout` ms, sends SIGKILL. */
     term(options?: {
         signal?: Signals;
         timeout?: number;
     }): Promise<null>;
 };
 export declare const hostName: unique symbol;
+/** A branded string type for hostnames (e.g. `.onion` addresses or IP addresses). */
 export type Hostname = string & {
     [hostName]: never;
 };
+/** A string identifier for a service network interface. */
 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;
-};
+/** Maps effect method names to their kebab-case RPC equivalents. */
 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];
+/** Options for rsync-based file synchronization (used in backup/restore). */
 export type SyncOptions = {
     /** delete files that exist in the target directory, but not in the source directory */
     delete: boolean;
@@ -149,22 +172,53 @@ export type Metadata = {
     gid: number;
     mode: number;
 };
+/** Result type for setting a service's dependency configuration and restart signal. */
 export type SetResult = {
     dependsOn: DependsOn;
     signal: Signals;
 };
+/** A string identifier for a StartOS package (e.g. `"bitcoind"`). */
 export type PackageId = string;
+/** A user-facing message string. */
 export type Message = string;
-export type DependencyKind = "running" | "exists";
+/** Whether a dependency needs to be actively running or merely installed. */
+export type DependencyKind = 'running' | 'exists';
+/**
+ * Maps package IDs to the health check IDs that must pass before this service considers
+ * the dependency satisfied.
+ */
 export type DependsOn = {
     [packageId: string]: string[] | readonly string[];
 };
+/**
+ * A typed error that can be displayed to the user.
+ * Either a plain error message string, or a structured error code with description.
+ */
 export type KnownError = {
     error: string;
 } | {
     errorCode: [number, string] | readonly [number, string];
 };
+/** An array of dependency requirements for a service. */
 export type Dependencies = Array<DependencyRequirement>;
-export type DeepPartial<T> = T extends unknown[] ? T : T extends {} ? {
+/** Recursively makes all properties of `T` optional. */
+export type DeepPartial<T> = T extends [infer A, ...infer Rest] ? [DeepPartial<A>, ...DeepPartial<Rest>] : T extends {} ? {
     [P in keyof T]?: DeepPartial<T[P]>;
 } : T;
+/** Recursively removes all `readonly` modifiers from `T`. */
+export type DeepWritable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+/** Casts a value to {@link DeepWritable} (identity at runtime, removes `readonly` at the type level). */
+export declare function writable<T>(value: T): DeepWritable<T>;
+/** Recursively makes all properties of `T` readonly. */
+export type DeepReadonly<T> = {
+    readonly [P in keyof T]: DeepReadonly<T[P]>;
+};
+/** Casts a value to {@link DeepReadonly} (identity at runtime, adds `readonly` at the type level). */
+export declare function readonly<T>(value: T): DeepReadonly<T>;
+/** Accepts either a mutable or deeply-readonly version of `T`. */
+export type AllowReadonly<T> = T | {
+    readonly [P in keyof T]: AllowReadonly<T[P]>;
+};
+export type InputSpec<Type extends StaticValidatedAs, StaticValidatedAs extends Record<string, unknown> = Type> = InputSpecClass<Type, StaticValidatedAs>;

package/base/lib/types.js

@@ -37,19 +37,46 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UseEntrypoint = exports.ExpectedExports = exports.NO_TIMEOUT = exports.SIGKILL = exports.SIGTERM = exports.inputSpecTypes = void 0;
+exports.isUseEntrypoint = isUseEntrypoint;
+exports.writable = writable;
+exports.readonly = readonly;
 exports.inputSpecTypes = __importStar(require("./actions/input/inputSpecTypes"));
 __exportStar(require("./osBindings"), exports);
-exports.SIGTERM = "SIGTERM";
-exports.SIGKILL = "SIGKILL";
+/** The SIGTERM signal — used for graceful daemon termination. */
+exports.SIGTERM = 'SIGTERM';
+/** The SIGKILL signal — used for forceful daemon termination. */
+exports.SIGKILL = 'SIGKILL';
+/** Sentinel value (`-1`) indicating that no timeout should be applied. */
 exports.NO_TIMEOUT = -1;
+/**
+ * Namespace defining the required exports for a StartOS service package.
+ * Every package must export implementations matching these types.
+ */
 var ExpectedExports;
 (function (ExpectedExports) {
     version: 1;
 })(ExpectedExports || (exports.ExpectedExports = ExpectedExports = {}));
+/**
+ * Marker class indicating that a container should use its own built-in entrypoint
+ * rather than a custom command. Optionally accepts an override command array.
+ */
 class UseEntrypoint {
     constructor(overridCmd) {
         this.overridCmd = overridCmd;
+        this.USE_ENTRYPOINT = 'USE_ENTRYPOINT';
     }
 }
 exports.UseEntrypoint = UseEntrypoint;
+/** Type guard that checks if a {@link CommandType} is a {@link UseEntrypoint} instance. */
+function isUseEntrypoint(command) {
+    return typeof command === 'object' && 'USE_ENTRYPOINT' in command;
+}
+/** Casts a value to {@link DeepWritable} (identity at runtime, removes `readonly` at the type level). */
+function writable(value) {
+    return value;
+}
+/** Casts a value to {@link DeepReadonly} (identity at runtime, adds `readonly` at the type level). */
+function readonly(value) {
+    return value;
+}
 //# sourceMappingURL=types.js.map

package/base/lib/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../base/lib/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,iFAAgE;AAahE,+CAA4B;AAkBf,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,+BAAf,eAAe,QAsD/B;AAkCD,MAAa,aAAa;IACxB,YAAqB,UAAqB;QAArB,eAAU,GAAV,UAAU,CAAW;IAAG,CAAC;CAC/C;AAFD,sCAEC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../base/lib/types.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuIA,0CAIC;AAmHD,4BAEC;AAQD,4BAEC;AA1QD,iFAAgE;AAMhE,+CAA4B;AA4B5B,iEAAiE;AACpD,QAAA,OAAO,GAAY,SAAS,CAAA;AACzC,iEAAiE;AACpD,QAAA,OAAO,GAAY,SAAS,CAAA;AACzC,0EAA0E;AAC7D,QAAA,UAAU,GAAG,CAAC,CAAC,CAAA;AAM5B;;;GAGG;AACH,IAAiB,eAAe,CAiC/B;AAjCD,WAAiB,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAA;AAgCZ,CAAC,EAjCgB,eAAe,+BAAf,eAAe,QAiC/B;AA4CD;;;GAGG;AACH,MAAa,aAAa;IAExB,YAAqB,UAAqB;QAArB,eAAU,GAAV,UAAU,CAAW;QADjC,mBAAc,GAAG,gBAAgB,CAAA;IACG,CAAC;CAC/C;AAHD,sCAGC;AACD,2FAA2F;AAC3F,SAAgB,eAAe,CAC7B,OAAoB;IAEpB,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,gBAAgB,IAAI,OAAO,CAAA;AACnE,CAAC;AAkHD,yGAAyG;AACzG,SAAgB,QAAQ,CAAI,KAAQ;IAClC,OAAO,KAAK,CAAA;AACd,CAAC;AAOD,sGAAsG;AACtG,SAAgB,QAAQ,CAAI,KAAQ;IAClC,OAAO,KAAK,CAAA;AACd,CAAC"}

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

@@ -0,0 +1,7 @@
+export declare class AbortedError extends Error {
+    readonly muteUnhandled: true;
+    cause?: unknown;
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}

package/base/lib/util/AbortedError.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbortedError = void 0;
+class AbortedError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.muteUnhandled = true;
+        this.name = 'AbortedError';
+        if (options?.cause !== undefined)
+            this.cause = options.cause;
+    }
+}
+exports.AbortedError = AbortedError;
+//# sourceMappingURL=AbortedError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbortedError.js","sourceRoot":"","sources":["../../../../base/lib/util/AbortedError.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAa,SAAQ,KAAK;IAIrC,YAAY,OAAgB,EAAE,OAA6B;QACzD,KAAK,CAAC,OAAO,CAAC,CAAA;QAJP,kBAAa,GAAG,IAAa,CAAA;QAKpC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;QAC1B,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IAC9D,CAAC;CACF;AATD,oCASC"}

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

@@ -0,0 +1,47 @@
+declare const dropId: unique symbol;
+export type DropRef = {
+    [dropId]: number;
+};
+export declare abstract class Drop {
+    private static weak;
+    private static registry;
+    private static idCtr;
+    private dropId?;
+    private dropRef?;
+    protected constructor();
+    protected register(): void;
+    private weak;
+    abstract onDrop(): void;
+    drop(): void;
+    leak(): this;
+}
+export declare class DropPromise<T> implements Promise<T> {
+    private readonly promise;
+    private static dropFns;
+    private static registry;
+    private static idCtr;
+    private dropId;
+    private dropRef;
+    [Symbol.toStringTag]: string;
+    private constructor();
+    static of<T>(promise: Promise<T>, dropFn?: () => void): DropPromise<T>;
+    static ref<T>(promise: Promise<T>, dropRef: DropRef): DropPromise<T>;
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null | undefined): Promise<T | TResult>;
+    finally(onfinally?: (() => void) | null | undefined): Promise<T>;
+}
+export declare class DropGenerator<T = unknown, TReturn = any, TNext = unknown> implements AsyncGenerator<T, TReturn, TNext> {
+    private readonly generator;
+    private static dropFns;
+    private static registry;
+    private static idCtr;
+    private dropId;
+    private dropRef;
+    [Symbol.asyncIterator]: () => this;
+    private constructor();
+    static of<T, TReturn, TNext>(generator: AsyncGenerator<T, TReturn, TNext>, dropFn?: () => void): DropGenerator<T, TReturn, TNext>;
+    next(...args: [] | [TNext]): Promise<IteratorResult<T, TReturn>>;
+    return(value: TReturn | PromiseLike<TReturn>): Promise<IteratorResult<T, TReturn>>;
+    throw(e: any): Promise<IteratorResult<T, TReturn>>;
+}
+export {};

package/base/lib/util/Drop.js

@@ -0,0 +1,130 @@
+"use strict";
+var _a, _b;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DropGenerator = exports.DropPromise = exports.Drop = void 0;
+const dropId = Symbol('id');
+class Drop {
+    constructor() {
+        this.dropId = Drop.idCtr++;
+        this.dropRef = { [dropId]: this.dropId };
+        const weak = this.weak();
+        Drop.weak[this.dropId] = weak;
+        Drop.registry.register(this.dropRef, this.dropId, this.dropRef);
+        return new Proxy(this, {
+            set(target, prop, value) {
+                if (prop === 'dropRef' || prop == 'dropId')
+                    return false;
+                target[prop] = value;
+                weak[prop] = value;
+                return true;
+            },
+        });
+    }
+    register() { }
+    weak() {
+        const weak = Object.assign(Object.create(Object.getPrototypeOf(this)), this);
+        if (this.dropRef)
+            weak.ref = new WeakRef(this.dropRef);
+        return weak;
+    }
+    drop() {
+        if (!this.dropRef || !this.dropId)
+            return;
+        this.onDrop();
+        this.leak();
+    }
+    leak() {
+        if (!this.dropRef || !this.dropId)
+            return this;
+        Drop.registry.unregister(this.dropRef);
+        delete Drop.weak[this.dropId];
+        delete this.dropRef;
+        delete this.dropId;
+        return this;
+    }
+}
+exports.Drop = Drop;
+Drop.weak = {};
+Drop.registry = new FinalizationRegistry((id) => {
+    const weak = Drop.weak[id];
+    if (weak)
+        weak.drop();
+});
+Drop.idCtr = 0;
+class DropPromise {
+    constructor(promise, dropFnOrRef) {
+        this.promise = promise;
+        this[_a] = 'DropPromise';
+        if (dropFnOrRef && dropId in dropFnOrRef) {
+            this.dropId = dropFnOrRef[dropId];
+            this.dropRef = dropFnOrRef;
+            return;
+        }
+        this.dropId = DropPromise.idCtr++;
+        this.dropRef = { [dropId]: this.dropId };
+        if (dropFnOrRef)
+            DropPromise.dropFns[this.dropId] = dropFnOrRef;
+        DropPromise.registry.register(this.dropRef, this.dropId, this.dropRef);
+    }
+    static of(promise, dropFn) {
+        return new DropPromise(promise, dropFn);
+    }
+    static ref(promise, dropRef) {
+        return new DropPromise(promise, dropRef);
+    }
+    then(onfulfilled, onrejected) {
+        return DropPromise.ref(this.promise.then(onfulfilled, onrejected), this.dropRef);
+    }
+    catch(onrejected) {
+        return DropPromise.ref(this.promise.catch(onrejected), this.dropRef);
+    }
+    finally(onfinally) {
+        return DropPromise.ref(this.promise.finally(onfinally), this.dropRef);
+    }
+}
+exports.DropPromise = DropPromise;
+_a = Symbol.toStringTag;
+DropPromise.dropFns = {};
+DropPromise.registry = new FinalizationRegistry((id) => {
+    const drop = DropPromise.dropFns[id];
+    if (drop) {
+        drop();
+        delete DropPromise.dropFns[id];
+    }
+});
+DropPromise.idCtr = 0;
+class DropGenerator {
+    constructor(generator, dropFn) {
+        this.generator = generator;
+        this[_b] = () => this;
+        this.dropId = DropGenerator.idCtr++;
+        this.dropRef = { [dropId]: this.dropId };
+        if (dropFn)
+            DropGenerator.dropFns[this.dropId] = dropFn;
+        DropGenerator.registry.register(this.dropRef, this.dropId, this.dropRef);
+    }
+    static of(generator, dropFn) {
+        return new DropGenerator(generator, dropFn);
+    }
+    next(...args) {
+        return DropPromise.ref(this.generator.next(...args), this.dropRef);
+    }
+    return(value) {
+        return DropPromise.ref(this.generator.return(value), this.dropRef);
+    }
+    throw(e) {
+        return DropPromise.ref(this.generator.throw(e), this.dropRef);
+    }
+}
+exports.DropGenerator = DropGenerator;
+_b = Symbol.asyncIterator;
+DropGenerator.dropFns = {};
+DropGenerator.registry = new FinalizationRegistry((id) => {
+    const drop = DropGenerator.dropFns[id];
+    if (drop) {
+        drop();
+        delete DropGenerator.dropFns[id];
+    }
+});
+DropGenerator.idCtr = 0;
+//# sourceMappingURL=Drop.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { Effects } from '../Effects';
+import { PackageId } from '../osBindings';
+import { Watchable } from './Watchable';
+export declare class GetContainerIp extends Watchable<string> {
+    readonly opts: {
+        packageId?: PackageId;
+    };
+    protected readonly label = "GetContainerIp";
+    constructor(effects: Effects, opts?: {
+        packageId?: PackageId;
+    });
+    protected fetch(callback?: () => void): Promise<string>;
+}

package/base/lib/util/GetContainerIp.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetContainerIp = void 0;
+const Watchable_1 = require("./Watchable");
+class GetContainerIp extends Watchable_1.Watchable {
+    constructor(effects, opts = {}) {
+        super(effects);
+        this.opts = opts;
+        this.label = 'GetContainerIp';
+    }
+    fetch(callback) {
+        return this.effects.getContainerIp({ ...this.opts, callback });
+    }
+}
+exports.GetContainerIp = GetContainerIp;
+//# sourceMappingURL=GetContainerIp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GetContainerIp.js","sourceRoot":"","sources":["../../../../base/lib/util/GetContainerIp.ts"],"names":[],"mappings":";;;AAEA,2CAAuC;AAEvC,MAAa,cAAe,SAAQ,qBAAiB;IAGnD,YACE,OAAgB,EACP,OAAkC,EAAE;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAA;QAFL,SAAI,GAAJ,IAAI,CAAgC;QAJ5B,UAAK,GAAG,gBAAgB,CAAA;IAO3C,CAAC;IAES,KAAK,CAAC,QAAqB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IAChE,CAAC;CACF;AAbD,wCAaC"}

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

@@ -0,0 +1,15 @@
+import { Effects } from '../Effects';
+import { Host, HostId, PackageId } from '../osBindings';
+import { Watchable } from './Watchable';
+export declare class GetHostInfo extends Watchable<Host | null> {
+    readonly opts: {
+        hostId: HostId;
+        packageId?: PackageId;
+    };
+    protected readonly label = "GetHostInfo";
+    constructor(effects: Effects, opts: {
+        hostId: HostId;
+        packageId?: PackageId;
+    });
+    protected fetch(callback?: () => void): Promise<Host | null>;
+}

package/base/lib/util/GetHostInfo.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetHostInfo = void 0;
+const Watchable_1 = require("./Watchable");
+class GetHostInfo extends Watchable_1.Watchable {
+    constructor(effects, opts) {
+        super(effects);
+        this.opts = opts;
+        this.label = 'GetHostInfo';
+    }
+    fetch(callback) {
+        return this.effects.getHostInfo({ ...this.opts, callback });
+    }
+}
+exports.GetHostInfo = GetHostInfo;
+//# sourceMappingURL=GetHostInfo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GetHostInfo.js","sourceRoot":"","sources":["../../../../base/lib/util/GetHostInfo.ts"],"names":[],"mappings":";;;AAEA,2CAAuC;AAEvC,MAAa,WAAY,SAAQ,qBAAsB;IAGrD,YACE,OAAgB,EACP,IAA+C;QAExD,KAAK,CAAC,OAAO,CAAC,CAAA;QAFL,SAAI,GAAJ,IAAI,CAA2C;QAJvC,UAAK,GAAG,aAAa,CAAA;IAOxC,CAAC;IAES,KAAK,CAAC,QAAqB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC7D,CAAC;CACF;AAbD,kCAaC"}

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

@@ -0,0 +1,7 @@
+import { Effects } from '../Effects';
+import { Watchable } from './Watchable';
+export declare class GetOutboundGateway extends Watchable<string> {
+    protected readonly label = "GetOutboundGateway";
+    constructor(effects: Effects);
+    protected fetch(callback?: () => void): Promise<string>;
+}

package/base/lib/util/GetOutboundGateway.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetOutboundGateway = void 0;
+const Watchable_1 = require("./Watchable");
+class GetOutboundGateway extends Watchable_1.Watchable {
+    constructor(effects) {
+        super(effects);
+        this.label = 'GetOutboundGateway';
+    }
+    fetch(callback) {
+        return this.effects.getOutboundGateway({ callback });
+    }
+}
+exports.GetOutboundGateway = GetOutboundGateway;
+//# sourceMappingURL=GetOutboundGateway.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GetOutboundGateway.js","sourceRoot":"","sources":["../../../../base/lib/util/GetOutboundGateway.ts"],"names":[],"mappings":";;;AACA,2CAAuC;AAEvC,MAAa,kBAAmB,SAAQ,qBAAiB;IAGvD,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;QAHG,UAAK,GAAG,oBAAoB,CAAA;IAI/C,CAAC;IAES,KAAK,CAAC,QAAqB;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;IACtD,CAAC;CACF;AAVD,gDAUC"}

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

@@ -0,0 +1,18 @@
+import { Effects } from '../Effects';
+import { Manifest, PackageId } from '../osBindings';
+import { Watchable } from './Watchable';
+export declare class GetServiceManifest<Mapped = Manifest | null> extends Watchable<Manifest | null, Mapped> {
+    readonly opts: {
+        packageId: PackageId;
+    };
+    protected readonly label = "GetServiceManifest";
+    constructor(effects: Effects, opts: {
+        packageId: PackageId;
+    }, options?: {
+        map?: (value: Manifest | null) => Mapped;
+        eq?: (a: Mapped, b: Mapped) => boolean;
+    });
+    protected fetch(callback?: () => void): Promise<Manifest>;
+}
+export declare function getServiceManifest(effects: Effects, packageId: PackageId): GetServiceManifest<Manifest | null>;
+export declare function getServiceManifest<Mapped>(effects: Effects, packageId: PackageId, map: (manifest: Manifest | null) => Mapped, eq?: (a: Mapped, b: Mapped) => boolean): GetServiceManifest<Mapped>;