@start9labs/start-sdk 0.4.0-beta.2 → 0.4.0-beta.21

package/package/lib/test/output.sdk.js

@@ -46,6 +46,5 @@ exports.sdk = StartSdk_1.StartSdk.of()
         },
     },
 }))
-    .withStore()
     .build(true);
 //# sourceMappingURL=output.sdk.js.map

package/package/lib/test/output.sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.sdk.js","sourceRoot":"","sources":["../../../../package/lib/test/output.sdk.ts"],"names":[],"mappings":";;;AACA,0CAAsC;AACtC,6DAAyD;AAI5C,QAAA,GAAG,GAAG,mBAAQ,CAAC,EAAE,EAAE;KAC7B,YAAY,CACX,IAAA,6BAAa,EAAC;IACZ,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,EAAE;IAChB,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE;QACX,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE;KACT;IACD,UAAU,EAAE,EAAE;IACd,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,MAAM,EAAE;gBACN,SAAS,EAAE,oBAAoB;aAChC;YACD,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;YAC3B,gBAAgB,EAAE,SAAS;SAC5B;KACF;IACD,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;KACX;IACD,YAAY,EAAE;QACZ,aAAa,EAAE;YACb,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,sCAAsC;SAC7C;KACF;CACF,CAAC,CACH;KACA,SAAS,EAAyC;KAClD,KAAK,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"output.sdk.js","sourceRoot":"","sources":["../../../../package/lib/test/output.sdk.ts"],"names":[],"mappings":";;;AAAA,0CAAsC;AACtC,6DAAyD;AAI5C,QAAA,GAAG,GAAG,mBAAQ,CAAC,EAAE,EAAE;KAC7B,YAAY,CACX,IAAA,6BAAa,EAAC;IACZ,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,EAAE;IAChB,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,IAAI;IACjB,WAAW,EAAE;QACX,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,EAAE;KACT;IACD,UAAU,EAAE,EAAE;IACd,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,MAAM,EAAE;gBACN,SAAS,EAAE,oBAAoB;aAChC;YACD,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;YAC3B,gBAAgB,EAAE,SAAS;SAC5B;KACF;IACD,OAAO,EAAE,EAAE;IACX,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;KACX;IACD,YAAY,EAAE;QACZ,aAAa,EAAE;YACb,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,sCAAsC;SAC7C;KACF;CACF,CAAC,CACH;KACA,KAAK,CAAC,IAAI,CAAC,CAAA"}

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,84 +1,197 @@
 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;
-    exitSignal: NodeJS.Signals | null;
-    stdout: string | Buffer;
-    stderr: string | Buffer;
-};
 export type ExecOptions = {
     input?: string | Buffer;
 };
-/**
- * This is the type that is going to describe what an subcontainer could do. The main point of the
- * subcontainer is to have commands that run in a chrooted environment. This is useful for running
- * commands in a containerized environment. But, I wanted the destroy to sometimes be doable, for example the
- * case where the subcontainer isn't owned by the process, the subcontainer shouldn't be destroyed.
- */
-export interface ExecSpawnable {
-    get destroy(): undefined | (() => Promise<null>);
-    exec(command: string[], options?: CommandOptions & ExecOptions, timeoutMs?: number | null): Promise<ExecResults>;
+export interface SubContainer<Manifest extends T.SDKManifest, Effects extends T.Effects = T.Effects> extends Drop {
+    readonly imageId: keyof Manifest["images"] & T.ImageId;
+    readonly rootfs: string;
+    readonly guid: T.Guid;
+    mount(mounts: Effects extends BackupEffects ? Mounts<Manifest, {
+        subpath: string | null;
+        mountpoint: string;
+    }> : Mounts<Manifest, never>): Promise<this>;
+    destroy: () => Promise<null>;
+    /**
+     * @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>;
+    rc(): SubContainerRc<Manifest, Effects>;
 }
 /**
  * Want to limit what we can do in a container, so we want to launch a container with a specific image and the mounts.
- *
- * Implements:
- * @see {@link ExecSpawnable}
  */
-export declare class SubContainer implements ExecSpawnable {
-    readonly effects: T.Effects;
-    readonly imageId: T.ImageId;
+export declare class SubContainerOwned<Manifest extends T.SDKManifest, Effects extends T.Effects = T.Effects> extends Drop implements SubContainer<Manifest, Effects> {
+    readonly effects: Effects;
+    readonly imageId: keyof Manifest["images"] & T.ImageId;
     readonly rootfs: string;
     readonly guid: T.Guid;
-    private static finalizationEffects;
-    private static registry;
+    private destroyed;
+    rcs: number;
     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<SubContainerOwned<Manifest, 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<this>;
     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>;
+    rc(): SubContainerRc<Manifest, Effects>;
 }
-/**
- * Take an subcontainer but remove the ability to add the mounts and the destroy function.
- * Lets other functions, like health checks, to not destroy the parents.
- *
- */
-export declare class SubContainerHandle implements ExecSpawnable {
-    private subContainer;
-    constructor(subContainer: ExecSpawnable);
-    get destroy(): undefined;
-    exec(command: string[], options?: CommandOptions, timeoutMs?: number | null): Promise<ExecResults>;
+export declare class SubContainerRc<Manifest extends T.SDKManifest, Effects extends T.Effects = T.Effects> extends Drop implements SubContainer<Manifest, Effects> {
+    private readonly subcontainer;
+    get imageId(): keyof Manifest["images"] & string;
+    get rootfs(): string;
+    get guid(): string;
+    private destroyed;
+    constructor(subcontainer: SubContainerOwned<Manifest, Effects>);
+    static of<Manifest extends T.SDKManifest, Effects extends T.Effects>(effects: Effects, image: {
+        imageId: keyof Manifest["images"] & T.ImageId;
+        sharedRun?: boolean;
+    }, mounts: (Effects extends BackupEffects ? Mounts<Manifest, {
+        subpath: string | null;
+        mountpoint: string;
+    }> : Mounts<Manifest, never>) | null, name: string): Promise<SubContainerRc<Manifest, Effects>>;
+    static withTemp<Manifest extends T.SDKManifest, T, Effects extends T.Effects>(effects: Effects, image: {
+        imageId: keyof Manifest["images"] & T.ImageId;
+        sharedRun?: boolean;
+    }, 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;
+    }> : Mounts<Manifest, never>): Promise<this>;
+    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>;
+    rc(): SubContainerRc<Manifest, Effects>;
 }
 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 = {
@@ -87,13 +200,15 @@ export type StdioOptions = {
 export type MountOptions = MountOptionsVolume | MountOptionsAssets | MountOptionsPointer | MountOptionsBackup;
 export type MountOptionsVolume = {
     type: "volume";
-    id: string;
+    volumeId: string;
     subpath: string | null;
     readonly: boolean;
+    filetype: "file" | "directory" | "infer";
 };
 export type MountOptionsAssets = {
     type: "assets";
     subpath: string | null;
+    filetype: "file" | "directory" | "infer";
 };
 export type MountOptionsPointer = {
     type: "pointer";
@@ -101,10 +216,12 @@ export type MountOptionsPointer = {
     volumeId: string;
     subpath: string | null;
     readonly: boolean;
+    filetype: "file" | "directory" | "infer";
 };
 export type MountOptionsBackup = {
     type: "backup";
     subpath: string | null;
+    filetype: "file" | "directory" | "infer";
 };
 export declare class ExitError extends Error {
     readonly command: string;
@@ -121,4 +238,3 @@ export declare class ExitError extends Error {
         stderr: string | Buffer;
     });
 }
-export {};