@start9labs/start-sdk 0.4.0-beta.1 → 0.4.0-beta.11

package/package/lib/test/output.sdk.d.ts

@@ -68,56 +68,6 @@ export declare const sdk: {
     };
     nullIfEmpty: typeof import("../util").nullIfEmpty;
     useEntrypoint: (overrideCmd?: string[]) => import("../types").UseEntrypoint;
-    runCommand: <A extends string>(effects: import("../types").Effects, image: {
-        imageId: "main";
-        sharedRun?: boolean;
-    }, command: import("../types").CommandType, options: import("../util/SubContainer").CommandOptions & {
-        mounts: import("../mainFn/Mounts").Mounts<{
-            id: "testOutput";
-            title: string;
-            license: string;
-            replaces: never[];
-            wrapperRepo: string;
-            upstreamRepo: string;
-            supportSite: string;
-            marketingSite: string;
-            donationUrl: null;
-            description: {
-                short: string;
-                long: string;
-            };
-            containers: {};
-            images: {
-                main: {
-                    source: {
-                        dockerTag: string;
-                    };
-                    arch: ["aarch64", "x86_64"];
-                    emulateMissingAs: "aarch64";
-                };
-            };
-            volumes: never[];
-            assets: never[];
-            alerts: {
-                install: null;
-                update: null;
-                uninstall: null;
-                restore: null;
-                start: null;
-                stop: null;
-            };
-            dependencies: {
-                "remote-test": {
-                    description: string;
-                    optional: false;
-                    s9pk: string;
-                };
-            };
-        }>;
-    }, name?: string) => Promise<{
-        stdout: string | Buffer;
-        stderr: string | Buffer;
-    }>;
     Action: {
         withInput: <Id extends import("../types").ActionId, InputSpecType extends Record<string, any> | import("../../../base/lib/actions/input/builder").InputSpec<any, any> | import("../../../base/lib/actions/input/builder").InputSpec<any, never>>(id: Id, metadata: import("../../../base/lib/actions/setupActions").MaybeFn<Omit<import("../types").ActionMetadata, "hasInput">>, inputSpec: InputSpecType, getInput: import("../../../base/lib/actions/setupActions").GetInput<InputSpecType>, run: import("../../../base/lib/actions/setupActions").Run<InputSpecType>) => import("../../../base/lib/actions/setupActions").Action<Id, unknown, InputSpecType>;
         withoutInput: <Id extends import("../types").ActionId>(id: Id, metadata: import("../../../base/lib/actions/setupActions").MaybeFn<Omit<import("../types").ActionMetadata, "hasInput">>, run: import("../../../base/lib/actions/setupActions").Run<{}>) => import("../../../base/lib/actions/setupActions").Action<Id, unknown, {}>;
@@ -170,7 +120,7 @@ export declare const sdk: {
             successMessage?: string | undefined;
             errorMessage?: string | undefined;
         }) => Promise<import("../health/checkFns").HealthCheckResult>;
-        runHealthScript: (runCommand: string[], subcontainer: import("..").SubContainer, { timeout, errorMessage, message, }?: {
+        runHealthScript: <Manifest extends import("../types").SDKManifest>(runCommand: string[], subcontainer: import("..").SubContainer<Manifest>, { timeout, errorMessage, message, }?: {
             timeout?: number | undefined;
             errorMessage?: string | undefined;
             message?: ((res: string) => string) | undefined;
@@ -796,7 +746,7 @@ export declare const sdk: {
                     s9pk: string;
                 };
             };
-        }>;
+        }, never>;
     };
     Backups: {
         volumes: (...volumeNames: never[]) => import("../backup/Backups").Backups<{
@@ -989,14 +939,134 @@ export declare const sdk: {
         of(effects: import("../types").Effects, image: {
             imageId: "main";
             sharedRun?: boolean;
-        }, name: string): Promise<import("..").SubContainer>;
-        with<T>(effects: import("../types").Effects, image: {
+        }, mounts: import("../mainFn/Mounts").Mounts<{
+            id: "testOutput";
+            title: string;
+            license: string;
+            replaces: never[];
+            wrapperRepo: string;
+            upstreamRepo: string;
+            supportSite: string;
+            marketingSite: string;
+            donationUrl: null;
+            description: {
+                short: string;
+                long: string;
+            };
+            containers: {};
+            images: {
+                main: {
+                    source: {
+                        dockerTag: string;
+                    };
+                    arch: ["aarch64", "x86_64"];
+                    emulateMissingAs: "aarch64";
+                };
+            };
+            volumes: never[];
+            assets: never[];
+            alerts: {
+                install: null;
+                update: null;
+                uninstall: null;
+                restore: null;
+                start: null;
+                stop: null;
+            };
+            dependencies: {
+                "remote-test": {
+                    description: string;
+                    optional: false;
+                    s9pk: string;
+                };
+            };
+        }, never> | null, name: string): Promise<import("..").SubContainer<import("../types").SDKManifest, import("../types").Effects>>;
+        withTemp<T>(effects: import("../types").Effects, image: {
             imageId: "main";
             sharedRun?: boolean;
-        }, mounts: {
-            options: import("../util/SubContainer").MountOptions;
-            mountpoint: string;
-        }[], name: string, fn: (subContainer: import("..").SubContainer) => Promise<T>): Promise<T>;
+        }, mounts: import("../mainFn/Mounts").Mounts<{
+            id: "testOutput";
+            title: string;
+            license: string;
+            replaces: never[];
+            wrapperRepo: string;
+            upstreamRepo: string;
+            supportSite: string;
+            marketingSite: string;
+            donationUrl: null;
+            description: {
+                short: string;
+                long: string;
+            };
+            containers: {};
+            images: {
+                main: {
+                    source: {
+                        dockerTag: string;
+                    };
+                    arch: ["aarch64", "x86_64"];
+                    emulateMissingAs: "aarch64";
+                };
+            };
+            volumes: never[];
+            assets: never[];
+            alerts: {
+                install: null;
+                update: null;
+                uninstall: null;
+                restore: null;
+                start: null;
+                stop: null;
+            };
+            dependencies: {
+                "remote-test": {
+                    description: string;
+                    optional: false;
+                    s9pk: string;
+                };
+            };
+        }, never> | null, name: string, fn: (subContainer: import("..").SubContainer<{
+            id: "testOutput";
+            title: string;
+            license: string;
+            replaces: never[];
+            wrapperRepo: string;
+            upstreamRepo: string;
+            supportSite: string;
+            marketingSite: string;
+            donationUrl: null;
+            description: {
+                short: string;
+                long: string;
+            };
+            containers: {};
+            images: {
+                main: {
+                    source: {
+                        dockerTag: string;
+                    };
+                    arch: ["aarch64", "x86_64"];
+                    emulateMissingAs: "aarch64";
+                };
+            };
+            volumes: never[];
+            assets: never[];
+            alerts: {
+                install: null;
+                update: null;
+                uninstall: null;
+                restore: null;
+                start: null;
+                stop: null;
+            };
+            dependencies: {
+                "remote-test": {
+                    description: string;
+                    optional: false;
+                    s9pk: string;
+                };
+            };
+        }, import("../types").Effects>) => Promise<T>): Promise<T>;
     };
     List: {
         text: typeof import("../../../base/lib/actions/input/builder").List.text;

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

@@ -5,6 +5,7 @@ export declare abstract class Drop {
     private id;
     private ref;
     protected constructor();
+    protected register(): void;
     protected weak(): this;
     abstract onDrop(): void;
     drop(): void;

package/package/lib/util/Drop.js

@@ -5,9 +5,20 @@ class Drop {
     constructor() {
         this.id = Drop.idCtr++;
         this.ref = { id: this.id };
-        Drop.weak[this.id] = this.weak();
-        Drop.registry.register(this, this.id, this);
+        const weak = this.weak();
+        Drop.weak[this.id] = weak;
+        Drop.registry.register(this.ref, this.id, this.ref);
+        return new Proxy(this, {
+            set(target, prop, value) {
+                if (prop === "ref")
+                    return false;
+                target[prop] = value;
+                weak[prop] = value;
+                return true;
+            },
+        });
     }
+    register() { }
     weak() {
         const weak = Object.assign(Object.create(Object.getPrototypeOf(this)), this);
         weak.ref = new WeakRef(this.ref);
@@ -15,14 +26,16 @@ class Drop {
     }
     drop() {
         this.onDrop();
-        Drop.registry.unregister(this);
+        Drop.registry.unregister(this.ref);
         delete Drop.weak[this.id];
     }
 }
 exports.Drop = Drop;
 Drop.weak = {};
 Drop.registry = new FinalizationRegistry((id) => {
-    Drop.weak[id].drop();
+    const weak = Drop.weak[id];
+    if (weak)
+        weak.drop();
 });
 Drop.idCtr = 0;
 //# sourceMappingURL=Drop.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Drop.js","sourceRoot":"","sources":["../../../../package/lib/util/Drop.ts"],"names":[],"mappings":";;;AAAA,MAAsB,IAAI;IAQxB;QACE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QACtB,IAAI,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAA;QAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAChC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAC7C,CAAC;IACS,IAAI;QACZ,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC5E,IAAI,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,EAAE,CAAA;QACb,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;;AAxBH,oBAyBC;AAxBgB,SAAI,GAA2B,EAAE,CAAA;AACjC,aAAQ,GAAG,IAAI,oBAAoB,CAAC,CAAC,EAAU,EAAE,EAAE;IAChE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;AACtB,CAAC,CAAC,CAAA;AACa,UAAK,GAAW,CAAC,CAAA"}
+{"version":3,"file":"Drop.js","sourceRoot":"","sources":["../../../../package/lib/util/Drop.ts"],"names":[],"mappings":";;;AAAA,MAAsB,IAAI;IASxB;QACE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QACtB,IAAI,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAA;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACxB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAA;QACzB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;QAEnD,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE;YACrB,GAAG,CAAC,MAAW,EAAE,IAAI,EAAE,KAAK;gBAC1B,IAAI,IAAI,KAAK,KAAK;oBAAE,OAAO,KAAK,CAAA;gBAChC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CACnB;gBAAC,IAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;gBAC5B,OAAO,IAAI,CAAA;YACb,CAAC;SACF,CAAC,CAAA;IACJ,CAAC;IACS,QAAQ,KAAI,CAAC;IACb,IAAI;QACZ,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC5E,IAAI,CAAC,GAAG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,EAAE,CAAA;QACb,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3B,CAAC;;AApCH,oBAqCC;AApCgB,SAAI,GAA2B,EAAE,CAAA;AACjC,aAAQ,GAAG,IAAI,oBAAoB,CAAC,CAAC,EAAU,EAAE,EAAE;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC1B,IAAI,IAAI;QAAE,IAAI,CAAC,IAAI,EAAE,CAAA;AACvB,CAAC,CAAC,CAAA;AACa,UAAK,GAAW,CAAC,CAAA"}

package/package/lib/util/GetSslCertificate.js

@@ -31,10 +31,15 @@ class GetSslCertificate {
      * Watches the SSL Certificate for the given hostnames if permitted. Returns an async iterator that yields whenever the value changes
      */
     async *watch() {
-        while (true) {
-            let callback;
+        const resolveCell = { resolve: () => { } };
+        this.effects.onLeaveContext(() => {
+            resolveCell.resolve();
+        });
+        while (this.effects.isInContext) {
+            let callback = () => { };
             const waitForNext = new Promise((resolve) => {
                 callback = resolve;
+                resolveCell.resolve = resolve;
             });
             yield await this.effects.getSslCertificate({
                 hostnames: this.hostnames,

package/package/lib/util/GetSslCertificate.js.map

@@ -1 +1 @@
-{"version":3,"file":"GetSslCertificate.js","sourceRoot":"","sources":["../../../../package/lib/util/GetSslCertificate.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;IAC5B,YACW,OAAgB,EAChB,SAAmB,EACnB,SAAuB;QAFvB,YAAO,GAAP,OAAO,CAAS;QAChB,cAAS,GAAT,SAAS,CAAU;QACnB,cAAS,GAAT,SAAS,CAAc;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EACN,IAAI,CAAC,OAAO,CAAC,UAAU;gBACvB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;SAC/D,CAAC,CAAA;IACJ,CAAC;IACD;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,KAAK;QACV,OAAO,IAAI,EAAE,CAAC;YACZ,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,iBAAiB,CAAC;gBACzC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE;aAC3B,CAAC,CAAA;YACF,MAAM,WAAW,CAAA;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,QAGyB;QAEzB,CAAC;QAAA,CAAC,KAAK,IAAI,EAAE;YACX,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAA;gBACvB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CACX,+DAA+D,EAC/D,CAAC,CACF,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE;aACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;aAC/B,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACX,OAAO,CAAC,KAAK,CACX,+DAA+D,EAC/D,CAAC,CACF,CACF,CAAA;IACL,CAAC;CACF;AA5ED,8CA4EC"}
+{"version":3,"file":"GetSslCertificate.js","sourceRoot":"","sources":["../../../../package/lib/util/GetSslCertificate.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;IAC5B,YACW,OAAgB,EAChB,SAAmB,EACnB,SAAuB;QAFvB,YAAO,GAAP,OAAO,CAAS;QAChB,cAAS,GAAT,SAAS,CAAU;QACnB,cAAS,GAAT,SAAS,CAAc;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EACN,IAAI,CAAC,OAAO,CAAC,UAAU;gBACvB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;SAC/D,CAAC,CAAA;IACJ,CAAC;IACD;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,KAAK;QACV,MAAM,WAAW,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAA;QACzC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE;YAC/B,WAAW,CAAC,OAAO,EAAE,CAAA;QACvB,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAChC,IAAI,QAAQ,GAAe,GAAG,EAAE,GAAE,CAAC,CAAA;YACnC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAChD,QAAQ,GAAG,OAAO,CAAA;gBAClB,WAAW,CAAC,OAAO,GAAG,OAAO,CAAA;YAC/B,CAAC,CAAC,CAAA;YACF,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC;gBACzC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE;aAC3B,CAAC,CAAA;YACF,MAAM,WAAW,CAAA;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,QAGyB;QAEzB,CAAC;QAAA,CAAC,KAAK,IAAI,EAAE;YACX,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAA;gBACvB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CACX,+DAA+D,EAC/D,CAAC,CACF,CAAA;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE;aACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;aAC/B,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACX,OAAO,CAAC,KAAK,CACX,+DAA+D,EAC/D,CAAC,CACF,CACF,CAAA;IACL,CAAC;CACF;AAjFD,8CAiFC"}

package/package/lib/util/SubContainer.d.ts

@@ -1,6 +1,9 @@
 import * as T from "../../../base/lib/types";
 import * as cp from "child_process";
 import { Buffer } from "node:buffer";
+import { Drop } from "./Drop";
+import { Mounts } from "../mainFn/Mounts";
+import { BackupEffects } from "../backup/Backups";
 export declare const execFile: typeof cp.execFile.__promisify__;
 type ExecResults = {
     exitCode: number | null;
@@ -20,6 +23,10 @@ export type ExecOptions = {
 export interface ExecSpawnable {
     get destroy(): undefined | (() => Promise<null>);
     exec(command: string[], options?: CommandOptions & ExecOptions, timeoutMs?: number | null): Promise<ExecResults>;
+    execFail(command: string[], options?: CommandOptions & ExecOptions, timeoutMs?: number | null): Promise<{
+        stdout: string | Buffer;
+        stderr: string | Buffer;
+    }>;
     spawn(command: string[], options?: CommandOptions & StdioOptions): Promise<cp.ChildProcess>;
 }
 /**
@@ -28,37 +35,66 @@ export interface ExecSpawnable {
  * Implements:
  * @see {@link ExecSpawnable}
  */
-export declare class SubContainer implements ExecSpawnable {
-    readonly effects: T.Effects;
+export declare class SubContainer<Manifest extends T.SDKManifest, Effects extends T.Effects = T.Effects> extends Drop implements ExecSpawnable {
+    readonly effects: Effects;
     readonly imageId: T.ImageId;
     readonly rootfs: string;
     readonly guid: T.Guid;
-    private static finalizationEffects;
-    private static registry;
+    private destroyed;
     private leader;
     private leaderExited;
     private waitProc;
     private constructor();
-    static of(effects: T.Effects, image: {
-        imageId: T.ImageId;
+    static of<Manifest extends T.SDKManifest, Effects extends T.Effects>(effects: Effects, image: {
+        imageId: keyof Manifest["images"] & T.ImageId;
         sharedRun?: boolean;
-    }, name: string): Promise<SubContainer>;
-    static with<T>(effects: T.Effects, image: {
-        imageId: T.ImageId;
+    }, mounts: (Effects extends BackupEffects ? Mounts<Manifest, {
+        subpath: string | null;
+        mountpoint: string;
+    }> : Mounts<Manifest, never>) | null, name: string): Promise<SubContainer<T.SDKManifest, Effects>>;
+    static withTemp<Manifest extends T.SDKManifest, T, Effects extends T.Effects>(effects: Effects, image: {
+        imageId: keyof Manifest["images"] & T.ImageId;
         sharedRun?: boolean;
-    }, mounts: {
-        options: MountOptions;
+    }, mounts: (Effects extends BackupEffects ? Mounts<Manifest, {
+        subpath: string | null;
+        mountpoint: string;
+    }> : Mounts<Manifest, never>) | null, name: string, fn: (subContainer: SubContainer<Manifest, Effects>) => Promise<T>): Promise<T>;
+    mount(mounts: Effects extends BackupEffects ? Mounts<Manifest, {
+        subpath: string | null;
         mountpoint: string;
-    }[], name: string, fn: (subContainer: SubContainer) => Promise<T>): Promise<T>;
-    mount(options: MountOptions, path: string): Promise<SubContainer>;
+    }> : Mounts<Manifest, never>): Promise<SubContainer<Manifest, Effects>>;
     private killLeader;
     get destroy(): () => Promise<null>;
+    onDrop(): void;
+    /**
+     * @description run a command inside this subcontainer
+     * DOES NOT THROW ON NONZERO EXIT CODE (see execFail)
+     * @param commands an array representing the command and args to execute
+     * @param options
+     * @param timeoutMs how long to wait before killing the command in ms
+     * @returns
+     */
     exec(command: string[], options?: CommandOptions & ExecOptions, timeoutMs?: number | null): Promise<{
+        throw: () => {
+            stdout: string | Buffer;
+            stderr: string | Buffer;
+        };
         exitCode: number | null;
         exitSignal: NodeJS.Signals | null;
         stdout: string | Buffer;
         stderr: string | Buffer;
     }>;
+    /**
+     * @description run a command inside this subcontainer, throwing on non-zero exit status
+     * @param commands an array representing the command and args to execute
+     * @param options
+     * @param timeoutMs how long to wait before killing the command in ms
+     * @returns
+     */
+    execFail(command: string[], options?: CommandOptions & ExecOptions, timeoutMs?: number | null): Promise<{
+        stdout: string | Buffer;
+        stderr: string | Buffer;
+    }>;
     launch(command: string[], options?: CommandOptions): Promise<cp.ChildProcessWithoutNullStreams>;
     spawn(command: string[], options?: CommandOptions & StdioOptions): Promise<cp.ChildProcess>;
 }
@@ -72,13 +108,26 @@ export declare class SubContainerHandle implements ExecSpawnable {
     constructor(subContainer: ExecSpawnable);
     get destroy(): undefined;
     exec(command: string[], options?: CommandOptions, timeoutMs?: number | null): Promise<ExecResults>;
+    execFail(command: string[], options?: CommandOptions & ExecOptions, timeoutMs?: number | null): Promise<{
+        stdout: string | Buffer;
+        stderr: string | Buffer;
+    }>;
     spawn(command: string[], options?: CommandOptions & StdioOptions): Promise<cp.ChildProcess>;
 }
 export type CommandOptions = {
+    /**
+     * Environment variables to set for this command
+     */
     env?: {
         [variable: string]: string;
     };
+    /**
+     * the working directory to run this command in
+     */
     cwd?: string;
+    /**
+     * the user to run this command as
+     */
     user?: string;
 };
 export type StdioOptions = {