@alchemy.run/archil 0.0.0 → 2.0.0-beta.86

package/lib/internal/DeployerKey.d.ts

@@ -0,0 +1,21 @@
+import { Credentials } from "@distilled.cloud/archil/Credentials";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Redacted from "effect/Redacted";
+import type { Providers } from "../Providers.ts";
+export interface DeployerKeyAttributes {
+    /** The API key the stack deploys with. */
+    apiKey: Redacted.Redacted<string>;
+    /** Archil region the key acts in. */
+    region: string;
+}
+/**
+ * The deploying account's API key, recorded so bindings can hand it to
+ * their host. Archil only mints API keys from a console session (an API
+ * key gets a 401), and its keys can't be scoped, so a host gets the same
+ * key the stack deploys with. Rotating the deploy key updates every host.
+ */
+export type DeployerKey = Resource<"Archil.DeployerKey", {}, DeployerKeyAttributes, never, Providers>;
+export declare const DeployerKey: import("alchemy").ResourceClass<DeployerKey>;
+export declare const DeployerKeyProvider: () => import("effect/Layer").Layer<Provider.Provider<DeployerKey>, never, Credentials>;
+//# sourceMappingURL=DeployerKey.d.ts.map

package/lib/internal/DeployerKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeployerKey.d.ts","sources":["../../src/internal/DeployerKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAChC,oBAAoB,EACpB,EAAE,EACF,qBAAqB,EACrB,KAAK,EACL,SAAS,CACV,CAAC;AAEF,eAAO,MAAM,WAAW,8CAA8C,CAAC;AAOvE,eAAO,MAAM,mBAAmB,wFA2B7B,CAAC"}

package/lib/internal/DeployerKey.js

@@ -0,0 +1,34 @@
+import { Credentials, DEFAULT_REGION } from "@distilled.cloud/archil/Credentials";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+export const DeployerKey = Resource("Archil.DeployerKey");
+const current = Effect.gen(function* () {
+    const { apiKey, region } = yield* yield* Credentials;
+    return { apiKey, region: region ?? DEFAULT_REGION };
+});
+export const DeployerKeyProvider = () => Provider.effect(DeployerKey, Effect.gen(function* () {
+    return {
+        // Nothing lives in Archil: the key belongs to the deployer.
+        nuke: { skip: true },
+        diff: Effect.fn(function* ({ output }) {
+            if (output === undefined)
+                return undefined;
+            const next = yield* current;
+            if (Redacted.value(next.apiKey) !== Redacted.value(output.apiKey) ||
+                next.region !== output.region) {
+                return { action: "update" };
+            }
+            return undefined;
+        }),
+        read: Effect.fn(function* ({ output }) {
+            return output;
+        }),
+        reconcile: Effect.fn(function* () {
+            return yield* current;
+        }),
+        delete: () => Effect.void,
+    };
+}));
+//# sourceMappingURL=DeployerKey.js.map

package/lib/internal/DeployerKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeployerKey.js","sources":["../../src/internal/DeployerKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAwB5C,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAc,oBAAoB,CAAC,CAAC;AAEvE,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC;IACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,cAAc,EAAkC,CAAC;AACtF,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,QAAQ,CAAC,MAAM,CACb,WAAW,EACX,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,OAAO;QACL,4DAA4D;QAC5D,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE;YACnC,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;YAC5B,IACE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;gBAC7D,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAC7B,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAW,CAAC;YACvC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC;QACF,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE;YACnC,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QACF,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC;YAC5B,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;KAC1B,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}

package/lib/internal/archil.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Shared Archil helpers: physical names, lookups by name, readiness waits.
+ * Archil has no tags or labels, so ownership is the engine-generated
+ * physical name (stack, stage, logical id and instance suffix).
+ */
+import * as archil from "@distilled.cloud/archil";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+/** Disk names: letters, digits, `-` and `_`, at most 100 characters. */
+export declare const diskName: (id: string, name: string | undefined) => Effect.Effect<string, never, import("alchemy").ResourceContext | import("alchemy").Stack | import("alchemy").Stage>;
+/** Lowercase letters, digits and single `-`, trimmed of leading/trailing `-`. */
+export declare const toDnsLabel: (value: string) => string;
+/** Sandbox names: lowercase letters, digits and `-`, at most 63 characters. */
+export declare const sandboxName: (id: string, name: string | undefined) => Effect.Effect<string, never, import("alchemy").ResourceContext | import("alchemy").Stack | import("alchemy").Stage>;
+/** API token names. */
+export declare const tokenName: (id: string, name: string | undefined) => Effect.Effect<string, never, import("alchemy").ResourceContext | import("alchemy").Stack | import("alchemy").Stage>;
+/**
+ * Whether a name was generated by Alchemy's physical-name scheme: it ends
+ * with a delimiter and a base32 instance suffix.
+ */
+export declare const isAlchemyName: (name: string | undefined) => boolean;
+/**
+ * Whether a name carries a run-time client's owner prefix,
+ * `alc-<id>-<hash of stack/stage/id>-` (see `runtimePrefix`). `list` (and so
+ * `pnpm nuke`) finds disks and sandboxes created at run time by it.
+ */
+export declare const isRuntimeObjectName: (name: string | undefined) => boolean;
+declare const ArchilNotReady_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Archil.NotReady";
+} & Readonly<A>;
+/** A resource didn't reach a usable state within its time budget. */
+export declare class ArchilNotReady extends ArchilNotReady_base<{
+    readonly resource: string;
+    readonly id: string;
+    readonly status: string;
+    readonly message: string;
+}> {
+}
+declare const ArchilFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Archil.Failed";
+} & Readonly<A>;
+/** A resource reached a terminal failure state. */
+export declare class ArchilFailed extends ArchilFailed_base<{
+    readonly resource: string;
+    readonly id: string;
+    readonly status: string;
+    readonly message: string;
+}> {
+}
+/**
+ * Poll `observe` every 2 s (at most ~90 s) until `check` returns a value;
+ * `check` returns `undefined` to keep waiting or fails on a terminal state.
+ */
+export declare const pollUntil: <A, B, E extends {
+    readonly _tag: string;
+}, R>(observe: Effect.Effect<A, E, R>, check: (value: A) => Effect.Effect<B | undefined, ArchilFailed>, pending: (value: A) => ArchilNotReady) => Effect.Effect<B, E | ArchilFailed | ArchilNotReady, R>;
+/** Every disk (or every disk with this exact name), following `nextCursor`. */
+export declare const listAllDisks: (name?: string) => Stream.Stream<archil.DiskResponse, archil.ArchilOpError, archil.ArchilOpContext>;
+/**
+ * Find a live disk by exact name. Archil keeps listing a deleted disk under
+ * its name for a while, so those are skipped.
+ */
+export declare const findDiskByName: (name: string) => Effect.Effect<archil.DiskResponse | undefined, archil.ArchilOpError, archil.ArchilOpContext>;
+/** Get a disk by id; `undefined` when it doesn't exist. */
+export declare const getDisk: (id: string) => Effect.Effect<archil.DiskResponse | undefined, archil.ArchilParseError | archil.BadGateway | import("@distilled.cloud/core/errors").BadRequest | archil.BadRequest | archil.ConfigError | import("@distilled.cloud/core/errors").Conflict | import("@distilled.cloud/core/errors").Forbidden | archil.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | archil.InternalServerError | import("@distilled.cloud/core/protocol-http").InvalidInput | archil.Locked | import("@distilled.cloud/core/sdk-error").SdkError | archil.ServiceUnavailable | archil.TooManyRequests | archil.Unauthorized | archil.UnknownArchilError | archil.UnprocessableEntity, archil.ArchilOpContext>;
+/** Wait until a disk is `available`. */
+export declare const waitForDisk: (id: string) => Effect.Effect<archil.DiskResponse, ArchilFailed | ArchilNotReady | archil.GetDiskError, archil.ArchilOpContext>;
+/** Wait until a disk is gone after a delete. */
+export declare const waitForDiskGone: (id: string) => Effect.Effect<void, ArchilFailed | ArchilNotReady | archil.ArchilParseError | archil.BadGateway | import("@distilled.cloud/core/errors").BadRequest | archil.BadRequest | archil.ConfigError | import("@distilled.cloud/core/errors").Conflict | import("@distilled.cloud/core/errors").Forbidden | archil.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | archil.InternalServerError | import("@distilled.cloud/core/protocol-http").InvalidInput | archil.Locked | import("@distilled.cloud/core/sdk-error").SdkError | archil.ServiceUnavailable | archil.TooManyRequests | archil.Unauthorized | archil.UnknownArchilError | archil.UnprocessableEntity, archil.ArchilOpContext>;
+/** Every sandbox in the account (optionally only those mounting a disk). */
+export declare const listSandboxes: (filesystem?: string | undefined) => Effect.Effect<archil.ApiResponseSandboxListDataSandboxesList, archil.ListSandboxesError, archil.ArchilOpContext>;
+/** Find a sandbox by exact name. */
+export declare const findSandboxByName: (name: string) => Effect.Effect<archil.Sandbox | undefined, archil.ListSandboxesError, archil.ArchilOpContext>;
+/** Get a sandbox by id; `undefined` when it doesn't exist. */
+export declare const getSandbox: (sid: string) => Effect.Effect<archil.Sandbox | undefined, archil.ArchilParseError | archil.BadGateway | import("@distilled.cloud/core/errors").BadRequest | archil.ConfigError | import("@distilled.cloud/core/errors").Conflict | import("@distilled.cloud/core/errors").Forbidden | archil.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | archil.InternalServerError | import("@distilled.cloud/core/protocol-http").InvalidInput | archil.Locked | import("@distilled.cloud/core/sdk-error").SdkError | archil.ServiceUnavailable | archil.TooManyRequests | archil.Unauthorized | archil.UnknownArchilError | archil.UnprocessableEntity, archil.ArchilOpContext>;
+/** Wait until a sandbox leaves its transitional states. */
+export declare const waitForSandbox: (sid: string) => Effect.Effect<archil.Sandbox, ArchilFailed | ArchilNotReady | archil.GetSandboxError, archil.ArchilOpContext>;
+/** States a sandbox can be deleted from. */
+export declare const deletableSandboxStates: Set<string>;
+/** Wait until a stopping sandbox is stopped (or exited, or failed). */
+export declare const waitForSandboxStopped: (sid: string) => Effect.Effect<void, ArchilFailed | ArchilNotReady | archil.ArchilParseError | archil.BadGateway | import("@distilled.cloud/core/errors").BadRequest | archil.ConfigError | import("@distilled.cloud/core/errors").Conflict | import("@distilled.cloud/core/errors").Forbidden | archil.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | archil.InternalServerError | import("@distilled.cloud/core/protocol-http").InvalidInput | archil.Locked | import("@distilled.cloud/core/sdk-error").SdkError | archil.ServiceUnavailable | archil.TooManyRequests | archil.Unauthorized | archil.UnknownArchilError | archil.UnprocessableEntity, archil.ArchilOpContext>;
+/** Wait until a sandbox is gone after a delete. */
+export declare const waitForSandboxGone: (sid: string) => Effect.Effect<void, ArchilFailed | ArchilNotReady | archil.ArchilParseError | archil.BadGateway | import("@distilled.cloud/core/errors").BadRequest | archil.ConfigError | import("@distilled.cloud/core/errors").Conflict | import("@distilled.cloud/core/errors").Forbidden | archil.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | archil.InternalServerError | import("@distilled.cloud/core/protocol-http").InvalidInput | archil.Locked | import("@distilled.cloud/core/sdk-error").SdkError | archil.ServiceUnavailable | archil.TooManyRequests | archil.Unauthorized | archil.UnknownArchilError | archil.UnprocessableEntity, archil.ArchilOpContext>;
+/** Wait until an image build finishes. */
+export declare const waitForImage: (imageId: string) => Effect.Effect<archil.Image, ArchilFailed | ArchilNotReady | archil.GetImageError, archil.ArchilOpContext>;
+export {};
+//# sourceMappingURL=archil.d.ts.map

package/lib/internal/archil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archil.d.ts","sources":["../../src/internal/archil.ts"],"names":[],"mappings":"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"}

package/lib/internal/archil.js

@@ -0,0 +1,154 @@
+/**
+ * Shared Archil helpers: physical names, lookups by name, readiness waits.
+ * Archil has no tags or labels, so ownership is the engine-generated
+ * physical name (stack, stage, logical id and instance suffix).
+ */
+import * as archil from "@distilled.cloud/archil";
+import { createPhysicalName } from "alchemy/PhysicalName";
+import * as Data from "effect/Data";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Schedule from "effect/Schedule";
+import * as Stream from "effect/Stream";
+/** Disk names: letters, digits, `-` and `_`, at most 100 characters. */
+export const diskName = (id, name) => name ? Effect.succeed(name) : createPhysicalName({ id, maxLength: 100, delimiter: "-" });
+/** Lowercase letters, digits and single `-`, trimmed of leading/trailing `-`. */
+export const toDnsLabel = (value) => value
+    .toLowerCase()
+    .replace(/[^a-z0-9-]+/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+/** Sandbox names: lowercase letters, digits and `-`, at most 63 characters. */
+export const sandboxName = (id, name) => name
+    ? Effect.succeed(name)
+    : createPhysicalName({ id, maxLength: 63, delimiter: "-", lowercase: true }).pipe(Effect.map(toDnsLabel));
+/** API token names. */
+export const tokenName = (id, name) => name ? Effect.succeed(name) : createPhysicalName({ id, maxLength: 64, delimiter: "-" });
+/**
+ * Whether a name was generated by Alchemy's physical-name scheme: it ends
+ * with a delimiter and a base32 instance suffix.
+ */
+export const isAlchemyName = (name) => name !== undefined && /[-_][a-z2-7]{16}$/i.test(name);
+/**
+ * Whether a name carries a run-time client's owner prefix,
+ * `alc-<id>-<hash of stack/stage/id>-` (see `runtimePrefix`). `list` (and so
+ * `pnpm nuke`) finds disks and sandboxes created at run time by it.
+ */
+export const isRuntimeObjectName = (name) => name !== undefined && /^alc-[a-z0-9-]{1,14}-[0-9a-f]{8}-/.test(name);
+/** A resource didn't reach a usable state within its time budget. */
+export class ArchilNotReady extends Data.TaggedError("Archil.NotReady") {
+}
+/** A resource reached a terminal failure state. */
+export class ArchilFailed extends Data.TaggedError("Archil.Failed") {
+}
+/**
+ * Poll `observe` every 2 s (at most ~90 s) until `check` returns a value;
+ * `check` returns `undefined` to keep waiting or fails on a terminal state.
+ */
+export const pollUntil = (observe, check, pending) => observe.pipe(Effect.flatMap((value) => check(value).pipe(Effect.flatMap((done) => done === undefined ? Effect.fail(pending(value)) : Effect.succeed(done)))), Effect.retry({
+    while: (e) => e._tag === "Archil.NotReady",
+    schedule: Schedule.spaced(Duration.seconds(2)),
+    times: 45,
+}));
+/** Every disk (or every disk with this exact name), following `nextCursor`. */
+export const listAllDisks = (name) => Stream.paginate(undefined, (cursor) => archil
+    .listDisks({ name, cursor, limit: 1000 })
+    .pipe(Effect.map(({ data, nextCursor }) => [data, Option.fromNullishOr(nextCursor)])));
+/**
+ * Find a live disk by exact name. Archil keeps listing a deleted disk under
+ * its name for a while, so those are skipped.
+ */
+export const findDiskByName = Effect.fn(function* (name) {
+    return Option.getOrUndefined(yield* listAllDisks(name).pipe(Stream.filter((disk) => disk.name === name && disk.status !== "deleted"), Stream.runHead));
+});
+/** Get a disk by id; `undefined` when it doesn't exist. */
+export const getDisk = (id) => archil.getDisk({ id }).pipe(Effect.map(({ data }) => (data.status === "deleted" ? undefined : data)), Effect.catchTag("NotFound", () => Effect.undefined));
+/** Wait until a disk is `available`. */
+export const waitForDisk = (id) => pollUntil(archil.getDisk({ id }).pipe(Effect.map(({ data }) => data)), (disk) => disk.status === "available"
+    ? Effect.succeed(disk)
+    : disk.status === "failed"
+        ? Effect.fail(new ArchilFailed({
+            resource: "Disk",
+            id,
+            status: disk.status,
+            message: `Disk ${disk.name} failed to provision`,
+        }))
+        : Effect.undefined, (disk) => new ArchilNotReady({
+    resource: "Disk",
+    id,
+    status: disk.status,
+    message: `Disk ${disk.name} is ${disk.status}`,
+}));
+/** Wait until a disk is gone after a delete. */
+export const waitForDiskGone = (id) => pollUntil(getDisk(id), (disk) => (disk === undefined ? Effect.succeed(true) : Effect.undefined), (disk) => new ArchilNotReady({
+    resource: "Disk",
+    id,
+    status: disk?.status ?? "deleted",
+    message: `Disk ${disk?.name ?? id} is still ${disk?.status}`,
+})).pipe(Effect.asVoid);
+/** Every sandbox in the account (optionally only those mounting a disk). */
+export const listSandboxes = Effect.fn(function* (filesystem) {
+    const { data } = yield* archil.listSandboxes({ filesystem });
+    return data.sandboxes ?? [];
+});
+/** Find a sandbox by exact name. */
+export const findSandboxByName = Effect.fn(function* (name) {
+    return (yield* listSandboxes()).find((sandbox) => sandbox.name === name && sandbox.status !== "deleted");
+});
+/** Get a sandbox by id; `undefined` when it doesn't exist. */
+export const getSandbox = (sid) => archil.getSandbox({ sid }).pipe(Effect.map(({ data }) => (data.status === "deleted" ? undefined : data)), Effect.catchTag("NotFound", () => Effect.undefined));
+const settledSandboxStates = new Set(["running", "paused", "stopped", "exited"]);
+/** Wait until a sandbox leaves its transitional states. */
+export const waitForSandbox = (sid) => pollUntil(archil.getSandbox({ sid }).pipe(Effect.map(({ data }) => data)), (sandbox) => settledSandboxStates.has(sandbox.status)
+    ? Effect.succeed(sandbox)
+    : sandbox.status === "failed"
+        ? Effect.fail(new ArchilFailed({
+            resource: "Sandbox",
+            id: sid,
+            status: sandbox.status,
+            message: `Sandbox ${sandbox.name} failed${sandbox.exit_reason ? `: ${sandbox.exit_reason}` : ""}`,
+        }))
+        : Effect.undefined, (sandbox) => new ArchilNotReady({
+    resource: "Sandbox",
+    id: sid,
+    status: sandbox.status,
+    message: `Sandbox ${sandbox.name} is ${sandbox.status}`,
+}));
+/** States a sandbox can be deleted from. */
+export const deletableSandboxStates = new Set(["stopped", "exited", "failed"]);
+/** Wait until a stopping sandbox is stopped (or exited, or failed). */
+export const waitForSandboxStopped = (sid) => pollUntil(getSandbox(sid), (sandbox) => sandbox === undefined || deletableSandboxStates.has(sandbox.status)
+    ? Effect.succeed(true)
+    : Effect.undefined, (sandbox) => new ArchilNotReady({
+    resource: "Sandbox",
+    id: sid,
+    status: sandbox?.status ?? "deleted",
+    message: `Sandbox ${sandbox?.name ?? sid} is still ${sandbox?.status}`,
+})).pipe(Effect.asVoid);
+/** Wait until a sandbox is gone after a delete. */
+export const waitForSandboxGone = (sid) => pollUntil(getSandbox(sid), (sandbox) => sandbox === undefined || sandbox.status === "deleting"
+    ? Effect.succeed(true)
+    : Effect.undefined, (sandbox) => new ArchilNotReady({
+    resource: "Sandbox",
+    id: sid,
+    status: sandbox?.status ?? "deleted",
+    message: `Sandbox ${sandbox?.name ?? sid} is still ${sandbox?.status}`,
+})).pipe(Effect.asVoid);
+/** Wait until an image build finishes. */
+export const waitForImage = (imageId) => pollUntil(archil.getImage({ image_id: imageId }).pipe(Effect.map(({ data }) => data)), (image) => image.status === "ready"
+    ? Effect.succeed(image)
+    : image.status === "failed"
+        ? Effect.fail(new ArchilFailed({
+            resource: "Image",
+            id: imageId,
+            status: `failed${image.failure_reason ? ` (${image.failure_reason})` : ""}`,
+            message: `Image ${image.source} failed to build${image.failure_reason ? `: ${image.failure_reason}` : ""}`,
+        }))
+        : Effect.undefined, (image) => new ArchilNotReady({
+    resource: "Image",
+    id: imageId,
+    status: image.status,
+    message: `Image ${image.source} is ${image.status}`,
+}));
+//# sourceMappingURL=archil.js.map

package/lib/internal/archil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archil.js","sources":["../../src/internal/archil.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,IAAwB,EAAE,EAAE,CAC/D,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;AAE3F,iFAAiF;AACjF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CAC1C,KAAK;KACF,WAAW,EAAE;KACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;KAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;KACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAE3B,+EAA+E;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,IAAwB,EAAE,EAAE,CAClE,IAAI;IACF,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAC7E,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CACvB,CAAC;AAER,uBAAuB;AACvB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAU,EAAE,IAAwB,EAAE,EAAE,CAChE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;AAE1F;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAwB,EAAW,EAAE,CACjE,IAAI,KAAK,SAAS,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAwB,EAAW,EAAE,CACvE,IAAI,KAAK,SAAS,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEvE,qEAAqE;AACrE,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAKpE;CAAG;AAEL,mDAAmD;AACnD,MAAM,OAAO,YAAa,SAAQ,IAAI,CAAC,WAAW,CAAC,eAAe,CAKhE;CAAG;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,OAA+B,EAC/B,KAA+D,EAC/D,OAAqC,EACmB,EAAE,CAC1D,OAAO,CAAC,IAAI,CACV,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACvB,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CACf,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACtB,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CACxE,CACF,CACF,EACD,MAAM,CAAC,KAAK,CAAC;IACX,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB;IAC1C,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,KAAK,EAAE,EAAE;CACV,CAAC,CACH,CAAC;AAEJ,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAa,EAAE,EAAE,CAC5C,MAAM,CAAC,QAAQ,CAAC,SAA+B,EAAE,CAAC,MAAM,EAAE,EAAE,CAC1D,MAAM;KACH,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACxC,IAAI,CACH,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAU,CAAC,CACxF,CACJ,CAAC;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAY;IAC7D,OAAO,MAAM,CAAC,cAAc,CAC1B,KAAK,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,EACxE,MAAM,CAAC,OAAO,CACf,CACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,EAAE,CACpC,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CACzB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EACxE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CACpD,CAAC;AAEJ,wCAAwC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,EAAE,CACxC,SAAS,CACP,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAC3D,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,MAAM,KAAK,WAAW;IACzB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,IAAI,YAAY,CAAC;YACf,QAAQ,EAAE,MAAM;YAChB,EAAE;YACF,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,QAAQ,IAAI,CAAC,IAAI,sBAAsB;SACjD,CAAC,CACH;QACH,CAAC,CAAC,MAAM,CAAC,SAAS,EACxB,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,cAAc,CAAC;IACjB,QAAQ,EAAE,MAAM;IAChB,EAAE;IACF,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,OAAO,EAAE,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,EAAE;CAC/C,CAAC,CACL,CAAC;AAEJ,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,EAAE,CAC5C,SAAS,CACP,OAAO,CAAC,EAAE,CAAC,EACX,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EACjF,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,cAAc,CAAC;IACjB,QAAQ,EAAE,MAAM;IAChB,EAAE;IACF,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,SAAS;IACjC,OAAO,EAAE,QAAQ,IAAI,EAAE,IAAI,IAAI,EAAE,aAAa,IAAI,EAAE,MAAM,EAAE;CAC7D,CAAC,CACL,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAExB,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,UAAmB;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAY;IAChE,OAAO,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,IAAI,CAClC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CACnE,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CACxC,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EACxE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CACpD,CAAC;AAEJ,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEjF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE,CAC5C,SAAS,CACP,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAC/D,CAAC,OAAO,EAAE,EAAE,CACV,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;IACtC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACzB,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ;QAC3B,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,IAAI,YAAY,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,EAAE,EAAE,GAAG;YACP,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,WAAW,OAAO,CAAC,IAAI,UAAU,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SAClG,CAAC,CACH;QACH,CAAC,CAAC,MAAM,CAAC,SAAS,EACxB,CAAC,OAAO,EAAE,EAAE,CACV,IAAI,cAAc,CAAC;IACjB,QAAQ,EAAE,SAAS;IACnB,EAAE,EAAE,GAAG;IACP,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,OAAO,EAAE,WAAW,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,MAAM,EAAE;CACxD,CAAC,CACL,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE/E,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,GAAW,EAAE,EAAE,CACnD,SAAS,CACP,UAAU,CAAC,GAAG,CAAC,EACf,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,KAAK,SAAS,IAAI,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;IACjE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAa,CAAC;IAC/B,CAAC,CAAC,MAAM,CAAC,SAAS,EACtB,CAAC,OAAO,EAAE,EAAE,CACV,IAAI,cAAc,CAAC;IACjB,QAAQ,EAAE,SAAS;IACnB,EAAE,EAAE,GAAG;IACP,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,SAAS;IACpC,OAAO,EAAE,WAAW,OAAO,EAAE,IAAI,IAAI,GAAG,aAAa,OAAO,EAAE,MAAM,EAAE;CACvE,CAAC,CACL,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAExB,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAE,EAAE,CAChD,SAAS,CACP,UAAU,CAAC,GAAG,CAAC,EACf,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU;IACpD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAa,CAAC;IAC/B,CAAC,CAAC,MAAM,CAAC,SAAS,EACtB,CAAC,OAAO,EAAE,EAAE,CACV,IAAI,cAAc,CAAC;IACjB,QAAQ,EAAE,SAAS;IACnB,EAAE,EAAE,GAAG;IACP,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,SAAS;IACpC,OAAO,EAAE,WAAW,OAAO,EAAE,IAAI,IAAI,GAAG,aAAa,OAAO,EAAE,MAAM,EAAE;CACvE,CAAC,CACL,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAExB,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE,CAC9C,SAAS,CACP,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAC3E,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,MAAM,KAAK,OAAO;IACtB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IACvB,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ;QACzB,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,IAAI,YAAY,CAAC;YACf,QAAQ,EAAE,OAAO;YACjB,EAAE,EAAE,OAAO;YACX,MAAM,EAAE,SAAS,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3E,OAAO,EAAE,SAAS,KAAK,CAAC,MAAM,mBAAmB,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SAC3G,CAAC,CACH;QACH,CAAC,CAAC,MAAM,CAAC,SAAS,EACxB,CAAC,KAAK,EAAE,EAAE,CACR,IAAI,cAAc,CAAC;IACjB,QAAQ,EAAE,OAAO;IACjB,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,KAAK,CAAC,MAAM;IACpB,OAAO,EAAE,SAAS,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,EAAE;CACpD,CAAC,CACL,CAAC"}

package/lib/internal/hosted.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Bundling and deploying the program of an `Archil.Sandbox` with `main`: a
+ * Node process run as an Archil sandbox service (`archil-sandbox services
+ * create`), which restarts when it crashes and starts whenever the sandbox
+ * boots.
+ */
+import * as archil from "@distilled.cloud/archil";
+import * as Process from "@distilled.cloud/archil/Process";
+import * as Bundle from "alchemy/Bundle/Bundle";
+import { type PackageInstall } from "alchemy/Bundle/InstalledPackages";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type * as rolldown from "rolldown";
+declare const ProgramDeployFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Archil.ProgramDeployFailed";
+} & Readonly<A>;
+/** A sandbox program failed to deploy or never started serving. */
+export declare class ProgramDeployFailed extends ProgramDeployFailed_base<{
+    readonly program: string;
+    readonly message: string;
+}> {
+}
+/** Bundler options for a program, plus packages installed instead of bundled. */
+export interface ProgramBuildOptions extends Bundle.BundleConfig {
+    /**
+     * Packages to `npm install` next to the program instead of bundling them
+     * (native modules, or frameworks that load files at run time).
+     */
+    readonly install?: PackageInstall;
+}
+/** A host directory (or file) uploaded with the program. */
+export interface ProgramExtraFile {
+    readonly source: string;
+    /** Destination relative to the program's directory; `"."` is the root. */
+    readonly destination: string;
+}
+export interface HostedProgramProps {
+    readonly main: string;
+    readonly handler?: string;
+    readonly isExternal?: boolean;
+    readonly build?: ProgramBuildOptions;
+    readonly extraFiles?: ReadonlyArray<ProgramExtraFile>;
+}
+type ProgramFile = {
+    readonly path: string;
+    readonly content: Uint8Array;
+};
+export interface BundledProgram {
+    readonly files: ReadonlyArray<ProgramFile>;
+    readonly hash: string;
+    /** The entry `node` runs, relative to the program's directory. */
+    readonly entryRel: string;
+    /** Whether the program has a `package.json` to `npm install`. */
+    readonly install: boolean;
+}
+/**
+ * Pack `main` into the files of a Node program.
+ *
+ * - The Effect form bundles `main` behind the package bootstrap.
+ * - The async form bundles `main` behind a `node:http` server for its
+ *   `fetch(request, env)`.
+ * - With `extraFiles`, `main` is already a complete Node program (a
+ *   framework's server entry): it is uploaded as built, with its tree.
+ */
+export declare const bundleProgram: (props: HostedProgramProps, virtualEntryPlugin: (content: (importPath: string) => string) => rolldown.Plugin) => Effect.Effect<{
+    files: ProgramFile[];
+    hash: string;
+    entryRel: string;
+    install: boolean;
+}, Bundle.BundleError | import("effect/PlatformError").PlatformError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | FileSystem.FileSystem | Path.Path>;
+/** Boot a sandbox that is paused or stopped, and wait until it runs. */
+export declare const ensureRunning: (sid: string) => Effect.Effect<undefined, import("./archil.ts").ArchilFailed | import("./archil.ts").ArchilNotReady | archil.ArchilParseError | archil.BadGateway | import("@distilled.cloud/core/errors").BadRequest | archil.BadRequest | archil.ConfigError | import("@distilled.cloud/core/errors").Conflict | import("@distilled.cloud/core/errors").Forbidden | archil.GatewayTimeout | import("effect/http/HttpClientError").HttpClientError | archil.InternalServerError | import("@distilled.cloud/core/protocol-http").InvalidInput | archil.Locked | import("@distilled.cloud/core/errors").NotFound | archil.NotFound | ProgramDeployFailed | archil.SandboxMountsWhileActive | archil.SandboxPausing | archil.SandboxStopping | archil.SandboxTerminated | import("@distilled.cloud/core/sdk-error").SdkError | archil.ServiceUnavailable | archil.TooManyRequests | archil.Unauthorized | archil.UnknownArchilError | archil.UnprocessableEntity, archil.ArchilOpContext>;
+/** The directory a program lives in. */
+export declare const programDir: (name: string) => string;
+/**
+ * Upload the program, (re)define its service, and wait until it answers on
+ * `port` inside the sandbox.
+ */
+export declare const deployProgram: (input: {
+    readonly sid: string;
+    readonly name: string;
+    readonly port: number;
+    readonly program: BundledProgram;
+    readonly env: Record<string, unknown>;
+}) => Effect.Effect<undefined, import("./archil.ts").ArchilFailed | import("./archil.ts").ArchilNotReady | archil.BadRequest | Process.ProcessError | ProgramDeployFailed | archil.SandboxMountsWhileActive | archil.SandboxPausing | archil.SandboxStopping | archil.CreateSandboxConnectionError, archil.ArchilOpContext>;
+/** Stop the program and remove its files. Removing a missing one succeeds. */
+export declare const removeProgram: (sid: string, name: string) => Effect.Effect<void, import("./archil.ts").ArchilFailed | import("./archil.ts").ArchilNotReady | archil.BadRequest | Process.ProcessError | ProgramDeployFailed | archil.SandboxMountsWhileActive | archil.SandboxPausing | archil.SandboxStopping | archil.CreateSandboxConnectionError, archil.ArchilOpContext>;
+export {};
+//# sourceMappingURL=hosted.d.ts.map

package/lib/internal/hosted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted.d.ts","sources":["../../src/internal/hosted.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,iCAAiC,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAC;AAa1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,KAAK,QAAQ,MAAM,UAAU,CAAC;;;;AAG1C,mEAAmE;AACnE,qBAAa,mBAAoB,SAAQ,yBAA+C;IACtF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;AAEL,iFAAiF;AACjF,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,YAAY;IAC9D;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CACvD;AAED,KAAK,WAAW,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AA0GD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,4DAEM,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,KAAK,QAAQ,CAAC,MAAM;;;;;2KA2EhF,CAAC;AAYH,wEAAwE;AACxE,eAAO,MAAM,aAAa,y7BAkBxB,CAAC;AAcH,wCAAwC;AACxC,eAAO,MAAM,UAAU,SAAU,MAAM,WAA2B,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,aAAa;kBACV,MAAM;mBACL,MAAM;mBACN,MAAM;sBACH,cAAc;kBAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;2TAkErC,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,aAAa,iVAUxB,CAAC"}