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

package/lib/Clients.js

@@ -0,0 +1,334 @@
+/**
+ * The run-time handles Archil bindings return. A disk or sandbox handle is
+ * the same shape whether it came from a deploy-time resource
+ * (`ExecDisk(Dataset)`, `ConnectSandbox(Preview)`) or was created at run
+ * time (`CreateDisk`, `CreateSandbox`), and takes Archil's own parameters.
+ */
+import * as archil from "@distilled.cloud/archil";
+import * as Objects from "@distilled.cloud/archil/Objects";
+import * as Process from "@distilled.cloud/archil/Process";
+import * as SandboxBase from "alchemy/Sandbox";
+import * as Data from "effect/Data";
+import * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientRequest from "effect/http/HttpClientRequest";
+import * as Option from "effect/Option";
+import * as Redacted from "effect/Redacted";
+import * as Stream from "effect/Stream";
+import { ensureBranch, toBranchAttributes } from "./Branch.js";
+import { addDiskUser, removeDiskUser, } from "./DiskUser.js";
+import { deleteSandbox, observeSandbox } from "./Sandbox.js";
+import { toEgressPolicy } from "./SandboxOptions.js";
+import { createPortToken, revokePortToken } from "./SandboxPortToken.js";
+/** The sandbox doesn't serve this port publicly (`exposePort` it first). */
+export class SandboxPortNotExposed extends Data.TaggedError("Archil.SandboxPortNotExposed") {
+}
+const toExecResult = (data) => ({
+    exitCode: data.exitCode,
+    stdout: data.stdout,
+    stderr: data.stderr,
+    timing: data.timing,
+});
+const unwrapToken = (value) => typeof value === "string" ? Redacted.make(value) : value;
+/** Serverless exec + grep on a disk whose id resolves at run time. */
+export const makeExecDiskClient = (diskId, authorize) => ({
+    exec: (command) => authorize(Effect.gen(function* () {
+        const id = yield* diskId;
+        const { data } = yield* archil.execDisk({ id, command });
+        return toExecResult(data);
+    })),
+    grep: (options) => authorize(Effect.gen(function* () {
+        const { data } = yield* archil.grepDisk({
+            id: yield* diskId,
+            directory: options.directory ?? "/",
+            pattern: options.pattern,
+            recursive: options.recursive,
+            maxDurationSeconds: options.maxDurationSeconds,
+            concurrency: options.concurrency,
+            maxResults: options.maxResults,
+        });
+        return data;
+    })),
+});
+/** Share URLs presigned with the client's own S3 user keys. */
+export const presignedShare = (run) => (ref, key, expiresInSeconds) => run(Objects.presignGetObject(ref, key, expiresInSeconds)).pipe(Effect.map(Redacted.make));
+/** Share URLs from Archil's control plane (needs the API key). */
+export const controlPlaneShare = (authorize) => (ref, key, expiresInSeconds) => authorize(Effect.gen(function* () {
+    const { data } = yield* archil.createShareUrl({
+        id: ref.disk,
+        key,
+        expiresIn: expiresInSeconds,
+    });
+    return unwrapToken(data.url);
+}));
+/** Object reads on a disk (or branch) whose id resolves at run time. */
+export const makeReadDiskClient = (ref, run, share) => ({
+    get: (key, options) => run(Effect.flatMap(ref, (r) => Objects.getObject(r, key, options))),
+    getText: (key) => run(Effect.flatMap(ref, (r) => Objects.getObjectText(r, key))),
+    getStream: (key) => run.stream(Stream.unwrap(Effect.map(ref, (r) => Objects.getObjectStream(r, key)))),
+    head: (key) => run(Effect.flatMap(ref, (r) => Objects.headObject(r, key))),
+    list: (prefix, options) => run.stream(Stream.unwrap(Effect.map(ref, (r) => Objects.listObjects(r, prefix, { recursive: options?.recursive })))),
+    share: (key, expiresInSeconds = 3600) => Effect.flatMap(ref, (r) => share(r, key, expiresInSeconds)),
+});
+const PART_SIZE = 8 * 1024 * 1024;
+const concatBytes = (chunks) => {
+    const out = new Uint8Array(chunks.reduce((n, c) => n + c.byteLength, 0));
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+};
+/** Object writes on a disk (or branch) whose id resolves at run time. */
+export const makeWriteDiskClient = (ref, run) => ({
+    put: (key, body, options) => run(Effect.flatMap(ref, (r) => Objects.putObject(r, key, body, options))),
+    append: (key, body) => run(Effect.flatMap(ref, (r) => Objects.appendObject(r, key, body))),
+    delete: (key) => run(Effect.flatMap(ref, (r) => Objects.deleteObject(r, key))),
+    deleteMany: (keys) => run(Effect.flatMap(ref, (r) => Objects.deleteObjects(r, keys))),
+    copy: (sourceKey, key) => run(Effect.flatMap(ref, (r) => Objects.copyObject(r, sourceKey, key)).pipe(Effect.map(({ etag }) => ({ etag })))),
+    upload: (key, body, options) => run(Effect.gen(function* () {
+        const r = yield* ref;
+        const { uploadId } = yield* Objects.createMultipartUpload(r, key, options);
+        const parts = [];
+        const sendPart = (bytes) => Objects.uploadPart(r, key, uploadId, parts.length + 1, bytes).pipe(Effect.map((part) => void parts.push(part)));
+        return yield* Effect.gen(function* () {
+            const rest = yield* Stream.runFoldEffect(body, () => [], (pending, chunk) => {
+                const next = [...pending, chunk];
+                const size = next.reduce((n, c) => n + c.byteLength, 0);
+                if (size < PART_SIZE)
+                    return Effect.succeed(next);
+                const bytes = concatBytes(next);
+                return Effect.as(sendPart(bytes.subarray(0, PART_SIZE)), [bytes.subarray(PART_SIZE)]);
+            });
+            const last = concatBytes(rest);
+            // S3 needs at least one part; an empty body is one empty part.
+            if (last.byteLength > 0 || parts.length === 0)
+                yield* sendPart(last);
+            return yield* Objects.completeMultipartUpload(r, key, uploadId, parts);
+        }).pipe(Effect.onError(() => Objects.abortMultipartUpload(r, key, uploadId).pipe(Effect.ignore)), Effect.map(({ etag }) => ({ etag })));
+    })),
+});
+/** Write delegations on a disk whose id resolves at run time (needs the API key). */
+export const makeDiskDelegationsClient = (ref, authorize) => ({
+    delegations: () => authorize(Effect.gen(function* () {
+        const { disk } = yield* ref;
+        const { data } = yield* archil.listDelegations({ id: disk });
+        return data.delegations;
+    })),
+    revokeDelegation: (delegation) => authorize(Effect.gen(function* () {
+        const { disk } = yield* ref;
+        yield* archil.revokeDelegation({
+            id: disk,
+            clientId: delegation.clientId,
+            inodeId: delegation.inodeId,
+        });
+    })),
+});
+/** Branches of a disk whose id resolves at run time. */
+export const makeBranchDiskClient = (diskId, authorize) => ({
+    branch: (options) => authorize(Effect.gen(function* () {
+        const id = yield* diskId;
+        return yield* ensureBranch({
+            disk: id,
+            name: options.name,
+            fromCheckpoint: options.fromCheckpoint,
+            fromBranch: options.fromBranch,
+        });
+    })),
+    getBranch: (name) => authorize(Effect.gen(function* () {
+        const id = yield* diskId;
+        return yield* archil.getBranch({ id, name }).pipe(Effect.map(({ data }) => toBranchAttributes(data)), Effect.catchTag("NotFound", () => Effect.undefined));
+    })),
+    listBranches: () => authorize(Effect.gen(function* () {
+        const id = yield* diskId;
+        const { data } = yield* archil.listBranches({ id });
+        return data.map(toBranchAttributes);
+    })),
+});
+/** A full handle on a disk known by id and name. */
+export const makeDiskHandle = (disk, authorize) => {
+    const diskId = Effect.succeed(disk.diskId);
+    const ref = Effect.succeed({ disk: disk.diskId });
+    return {
+        diskId: disk.diskId,
+        name: disk.name,
+        ...makeExecDiskClient(diskId, authorize),
+        ...makeReadDiskClient(ref, authorize.objects, controlPlaneShare(authorize)),
+        ...makeWriteDiskClient(ref, authorize.objects),
+        ...makeDiskDelegationsClient(ref, authorize),
+        ...makeBranchDiskClient(diskId, authorize),
+        createToken: (nickname, options) => authorize(addDiskUser(disk.diskId, { nickname, ...options })),
+        removeToken: (identifier) => authorize(removeDiskUser({ diskId: disk.diskId, type: "token", identifier })),
+    };
+};
+/** Single-quote a value for `sh`. */
+const shellQuote = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
+const commandLine = (command) => typeof command === "string" ? command : command.map(shellQuote).join(" ");
+const runOptions = (options) => ({
+    cwd: options?.cwd,
+    env: options?.env === undefined ? undefined : { ...options.env },
+    timeoutSeconds: options?.timeout === undefined ? undefined : Math.ceil(Duration.toSeconds(options.timeout)),
+});
+const utf8 = new TextDecoder();
+const toExit = (exit) => ({
+    exitCode: exit.exitCode ?? -1,
+    status: exit.status,
+    exitReason: exit.exitReason,
+    cursor: exit.cursor,
+});
+const entryType = (kind) => kind.includes("directory")
+    ? "directory"
+    : kind.includes("symbolic link")
+        ? "symlink"
+        : kind.includes("regular")
+            ? "file"
+            : "other";
+/** Parse `stat -c '%F\t%s\t%n'` lines; names are joined to `dir` when given. */
+const parseEntries = (out, dir) => out
+    .split("\n")
+    .filter((line) => line.length > 0)
+    .map((line) => {
+    const [kind = "", size = "0", ...name] = line.split("\t");
+    const base = name.join("\t");
+    return {
+        path: dir === undefined ? base : `${dir.replace(/\/+$/, "")}/${base}`,
+        type: entryType(kind),
+        size: Number(size),
+    };
+});
+/**
+ * Everything a run-time client can do to the sandbox `sid` resolves to.
+ * `forkName` maps a fork's name (a binding puts its owner prefix on it,
+ * like on the sandboxes it creates).
+ */
+export const makeSandboxOps = (sid, authorize, forkName = Effect.succeed) => {
+    // A paused sandbox (idle TTL) refuses process connections with
+    // `sandbox_terminated`; resume it and try once more.
+    const awake = (use) => authorize(Effect.flatMap(sid, (id) => use(id).pipe(Effect.catchIf((e) => e._tag === "SandboxTerminated", (e) => archil
+        .getSandbox({ sid: id })
+        .pipe(Effect.flatMap(({ data }) => data.status === "paused"
+        ? archil.resumeSandbox({ sid: id, wait: true }).pipe(Effect.andThen(use(id)))
+        : Effect.fail(e)))))));
+    const call = (use) => authorize(Effect.flatMap(sid, use));
+    const attrs = (use) => call((id) => use(id).pipe(Effect.flatMap(({ data }) => observeSandbox(data))));
+    const toProcess = (process) => ({
+        id: process.id,
+        output: process.output.pipe(Stream.map((chunk) => ({ fd: chunk.stream, data: chunk.data, offset: chunk.offset }))),
+        write: (data) => process.write(data),
+        closeStdin: process.closeStdin,
+        kill: () => awake((id) => Process.kill(id, process.id)),
+        wait: Effect.map(process.exit, toExit),
+    });
+    // A shell command whose non-zero exit is a failure with its stderr.
+    const sh = (command, what) => awake((id) => Process.exec(id, command)).pipe(Effect.flatMap((result) => result.exitCode === 0
+        ? Effect.succeed(result.stdout)
+        : Effect.fail(Process.ProcessError.make({
+            message: `${what} failed (exit ${result.exitCode ?? result.status}): ${result.stderr.trim()}`,
+        }))));
+    const files = {
+        read: (path) => awake((id) => Process.downloadFile(id, path)),
+        readText: (path) => awake((id) => Process.downloadFile(id, path)).pipe(Effect.map((bytes) => utf8.decode(bytes))),
+        write: (path, data, options) => awake((id) => Process.uploadFile(id, path, data, options)),
+        list: (path) => sh(`cd ${shellQuote(path)} && for f in * .[!.]* ..?*; do [ -e "$f" ] || [ -L "$f" ] || continue; stat -c '%F\t%s\t%n' -- "$f"; done`, `list ${path}`).pipe(Effect.map((out) => parseEntries(out, path))),
+        stat: (path) => sh(`stat -c '%F\t%s\t%n' -- ${shellQuote(path)}`, `stat ${path}`).pipe(Effect.map((out) => ({ ...parseEntries(out, undefined)[0], path }))),
+        remove: (path) => sh(`rm -rf -- ${shellQuote(path)}`, `remove ${path}`).pipe(Effect.asVoid),
+        makeDir: (path) => sh(`mkdir -p -- ${shellQuote(path)}`, `makeDir ${path}`).pipe(Effect.asVoid),
+    };
+    const ops = {
+        refresh: () => attrs((id) => archil.getSandbox({ sid: id })),
+        exec: (command, options) => options?.stdin === undefined
+            ? awake((id) => Process.exec(id, commandLine(command), runOptions(options)))
+            : awake((id) => Effect.scoped(Effect.gen(function* () {
+                const process = yield* Process.run(id, commandLine(command), runOptions(options));
+                yield* process.write(options.stdin);
+                yield* process.closeStdin;
+                const out = new TextDecoder();
+                const err = new TextDecoder();
+                let stdout = "";
+                let stderr = "";
+                yield* process.output.pipe(Stream.runForEach((chunk) => Effect.sync(() => {
+                    if (chunk.stream === "stdout")
+                        stdout += out.decode(chunk.data, { stream: true });
+                    else
+                        stderr += err.decode(chunk.data, { stream: true });
+                })));
+                const exit = yield* process.exit;
+                return {
+                    ...exit,
+                    stdout: stdout + out.decode(),
+                    stderr: stderr + err.decode(),
+                };
+            }))),
+        start: (command, options) => awake((id) => Process.run(id, commandLine(command), runOptions(options))).pipe(Effect.map(toProcess)),
+        attach: (processId, offset) => awake((id) => Process.attach(id, processId, offset)).pipe(Effect.map(toProcess)),
+        files,
+        pty: {
+            open: (options) => awake((id) => Process.run(id, commandLine(options.command ?? "bash"), {
+                cwd: options.cwd,
+                env: options.env === undefined ? undefined : { ...options.env },
+                terminal: { cols: options.cols, rows: options.rows },
+            })).pipe(Effect.map((process) => ({
+                id: process.id,
+                output: process.output.pipe(Stream.map((chunk) => chunk.data)),
+                write: (data) => process.write(data),
+                resize: (size) => awake((id) => Process.resize(id, process.id, size)),
+                kill: () => awake((id) => Process.kill(id, process.id)),
+                wait: Effect.map(process.exit, toExit),
+            }))),
+        },
+        getTcpPort: (port) => call((id) => Effect.gen(function* () {
+            const { data } = yield* archil.listSandboxPorts({ sid: id });
+            const endpoint = (data.ports ?? []).find((p) => p.port === port);
+            if (endpoint === undefined) {
+                return yield* new SandboxPortNotExposed({
+                    port,
+                    message: `Port ${port} isn't served publicly; call exposePort(${port}) first.`,
+                });
+            }
+            const url = `https://${endpoint.hostname}`;
+            // Archil's edge routes by hostname, so the caller's Host header
+            // (a Worker's own, when proxying) is replaced by the port's.
+            const send = (request) => {
+                const source = new URL(request.url, "http://sandbox");
+                return HttpClient.HttpClient.pipe(Effect.flatMap((client) => client.execute(request.pipe(HttpClientRequest.setUrl(`${url}${source.pathname}${source.search}`), HttpClientRequest.removeHeader("host")))), Effect.provide(FetchHttpClient.layer));
+            };
+            return {
+                port,
+                hostname: endpoint.hostname,
+                url,
+                fetch: SandboxBase.portFetch(send),
+            };
+        })),
+        boot: () => attrs((id) => archil.startSandbox({ sid: id, wait: true })),
+        stop: () => attrs((id) => archil.stopSandbox({ sid: id })),
+        pause: () => attrs((id) => archil.pauseSandbox({ sid: id })),
+        resume: () => attrs((id) => archil.resumeSandbox({ sid: id })),
+        fork: (options) => call((id) => forkName(options?.name).pipe(Effect.flatMap((name) => archil.forkSandbox({ sid: id, wait: true, name, checkpoint: options?.checkpoint })))).pipe(Effect.map(({ data }) => makeSandboxHandle({ sandboxId: data.sandbox_id, name: data.name }, authorize, forkName))),
+        setTimeout: (options) => attrs((id) => archil.setSandboxTimeout({
+            sid: id,
+            timeout: options.timeoutSeconds,
+            idle_ttl_seconds: options.idleTtlSeconds,
+        })),
+        exposePort: (port) => call((id) => archil.exposeSandboxPort({ sid: id, port })).pipe(Effect.map(({ data }) => ({ port: data.port, hostname: data.hostname }))),
+        unexposePort: (port) => call((id) => archil.deleteSandboxPort({ sid: id, port })).pipe(Effect.asVoid),
+        ports: () => call((id) => archil.listSandboxPorts({ sid: id })).pipe(Effect.map(({ data }) => (data.ports ?? []).map((p) => ({ port: p.port, hostname: p.hostname })))),
+        createPortToken: (port, ttl) => call((id) => createPortToken(id, port, ttl)),
+        revokePortToken: (tokenId) => call((id) => revokePortToken(id, tokenId)),
+        listPortTokens: () => authorize.stream(Stream.unwrap(Effect.map(sid, (id) => Stream.paginate(undefined, (cursor) => archil
+            .listSandboxPortTokens({ sid: id, cursor })
+            .pipe(Effect.map(({ data, nextCursor }) => [data.tokens, Option.fromNullishOr(nextCursor)])))))),
+        setEgress: (egress) => call((id) => archil.updateSandboxNetwork({ sid: id, egress: toEgressPolicy(egress) })).pipe(Effect.asVoid),
+        delete: () => call((id) => deleteSandbox(id)),
+    };
+    return ops;
+};
+/** A full handle on a sandbox known by id and name. */
+export const makeSandboxHandle = (sandbox, authorize, forkName) => ({
+    sandboxId: sandbox.sandboxId,
+    name: sandbox.name,
+    ...makeSandboxOps(Effect.succeed(sandbox.sandboxId), authorize, forkName),
+});
+//# sourceMappingURL=Clients.js.map

package/lib/Clients.js.map

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

package/lib/ConnectSandbox.d.ts

@@ -0,0 +1,69 @@
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { type SandboxOps } from "./Clients.ts";
+import type { Sandbox } from "./Sandbox.ts";
+/**
+ * The handle on a deploy-time sandbox: a {@link SandboxHandle} whose id and
+ * name resolve at run time.
+ */
+export interface ConnectSandboxClient extends SandboxOps {
+    readonly sandboxId: Effect.Effect<string, never, RuntimeContext>;
+    readonly name: Effect.Effect<string, never, RuntimeContext>;
+}
+/**
+ * Act on a sandbox declared at deploy time from a Worker, Lambda, or any
+ * other host: run commands, start background processes and terminals,
+ * move files, pause and resume, fork it into a new sandbox, open ports,
+ * and change its network policy. A program sandbox (`Archil.Sandbox` with
+ * `main`) is a sandbox too.
+ *
+ * ### Driving a Dev Box
+ * **Example:** Build on the dev box, fork a preview per pull request
+ * ```typescript
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const devbox = yield* Archil.ConnectSandbox(DevBox);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         yield* devbox.exec("git pull && pnpm build", { cwd: "/workspace" });
+ *         yield* devbox.files.write("/workspace/.env", "PREVIEW=1\n");
+ *         const preview = yield* devbox.fork({ name: "pr-42" });
+ *         const port = yield* preview.exposePort(3000);
+ *         return HttpServerResponse.text(`https://${port.hostname}`);
+ *       }),
+ *     };
+ *   }).pipe(Effect.provide(Archil.ConnectSandboxHttp)),
+ * ) {}
+ * ```
+ *
+ * ### Proxying to a Port
+ * **Example:** A Worker in front of the dev box's server
+ * ```typescript
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const devbox = yield* Archil.ConnectSandbox(DevBox);
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const port = yield* devbox.getTcpPort(3000);
+ *         return yield* port.fetch(yield* HttpServerRequest);
+ *       }),
+ *     };
+ *   }).pipe(Effect.provide(Archil.ConnectSandboxHttp)),
+ * ) {}
+ * ```
+ *
+ * @binding
+ * @product Sandbox
+ */
+export interface ConnectSandbox extends Binding.Service<ConnectSandbox, "Archil.ConnectSandbox", (sandbox: Sandbox) => Effect.Effect<ConnectSandboxClient>> {
+}
+export declare const ConnectSandbox: ConnectSandbox;
+/** {@link ConnectSandbox} over Archil's HTTP API, usable from any host. */
+export declare const ConnectSandboxHttp: Layer.Layer<ConnectSandbox, never, never>;
+//# sourceMappingURL=ConnectSandbox.d.ts.map

package/lib/ConnectSandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectSandbox.d.ts","sources":["../src/ConnectSandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,WAAW,cAAe,SAAQ,OAAO,CAAC,OAAO,CACrD,cAAc,EACd,uBAAuB,EACvB,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAC1D;CAAG;AAEJ,eAAO,MAAM,cAAc,gBAA2D,CAAC;AAEvF,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,2CAe9B,CAAC"}

package/lib/ConnectSandbox.js

@@ -0,0 +1,21 @@
+import * as Binding from "alchemy/Binding";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { ApiAccess } from "./ArchilBindings.js";
+import { makeSandboxOps } from "./Clients.js";
+export const ConnectSandbox = Binding.Service("Archil.ConnectSandbox");
+/** {@link ConnectSandbox} over Archil's HTTP API, usable from any host. */
+export const ConnectSandboxHttp = Layer.effect(ConnectSandbox, Effect.gen(function* () {
+    const access = yield* ApiAccess;
+    return Effect.fn(function* (sandbox) {
+        const authorize = yield* access();
+        const sandboxId = yield* sandbox.sandboxId;
+        const name = yield* sandbox.name;
+        return {
+            sandboxId,
+            name,
+            ...makeSandboxOps(sandboxId, authorize),
+        };
+    });
+}));
+//# sourceMappingURL=ConnectSandbox.js.map

package/lib/ConnectSandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectSandbox.js","sources":["../src/ConnectSandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAmB,MAAM,cAAc,CAAC;AAmE/D,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAiB,uBAAuB,CAAC,CAAC;AAEvF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAC5C,cAAc,EACd,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC;IAChC,OAAO,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAgB;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;QAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACjC,OAAO;YACL,SAAS;YACT,IAAI;YACJ,GAAG,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC;SACT,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC"}

package/lib/Contributions.d.ts

@@ -0,0 +1,7 @@
+import * as Contributions from "alchemy/Contributions";
+declare const _default: {
+    readonly name: "archil";
+    readonly auth: Contributions.Lazy<import("effect/Layer").Layer<never, never, import("alchemy").AuthProviders | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("effect/crypto/SecureRandom").SecureRandom>>;
+};
+export default _default;
+//# sourceMappingURL=Contributions.d.ts.map

package/lib/Contributions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Contributions.d.ts","sources":["../src/Contributions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,uBAAuB,CAAC;;;;;AAEvD,wBAMG"}

package/lib/Contributions.js

@@ -0,0 +1,6 @@
+import * as Contributions from "alchemy/Contributions";
+export default Contributions.make({
+    name: "archil",
+    auth: Contributions.lazy(() => import("./AuthProvider.js"), (module) => module.ArchilAuth),
+});
+//# sourceMappingURL=Contributions.js.map

package/lib/Contributions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Contributions.js","sources":["../src/Contributions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,uBAAuB,CAAC;AAEvD,eAAe,aAAa,CAAC,IAAI,CAAC;IAChC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,aAAa,CAAC,IAAI,CACtB,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,EACjC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAC9B;CACF,CAAC,CAAC"}

package/lib/CreateDisk.d.ts

@@ -0,0 +1,90 @@
+import * as archil from "@distilled.cloud/archil";
+import * as Binding from "alchemy/Binding";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { type DiskHandle } from "./Clients.ts";
+import { deleteDisk, type DiskStorage } from "./Disk.ts";
+import type { ArchilFailed, ArchilNotReady } from "./internal/archil.ts";
+export interface CreateDiskOptions {
+    /**
+     * Where disks created by this client keep their files. Omit for
+     * Archil-managed storage. A run-time `create` can override it.
+     */
+    storage?: DiskStorage;
+}
+export type CreateDiskError = archil.CreateDiskError | archil.GetDiskError | archil.ListDisksError | ArchilFailed | ArchilNotReady;
+export interface CreateDiskClient {
+    /**
+     * The name prefix this client puts on everything it creates,
+     * `alc-<id>-<hash of stack/stage/id>`.
+     */
+    readonly prefix: string;
+    /**
+     * Create a disk (or return the one that already has this name). Names
+     * are stamped with this binding's prefix, so `create({ name: "user-1" })`
+     * is the same disk on every call.
+     */
+    create(name: string, options?: {
+        readonly storage?: DiskStorage;
+    }): Effect.Effect<DiskHandle, CreateDiskError, RuntimeContext>;
+    /** A disk this client created, or `undefined`. */
+    get(name: string): Effect.Effect<DiskHandle | undefined, archil.ListDisksError, RuntimeContext>;
+    /** Every disk this client created. */
+    list(): Effect.Effect<DiskHandle[], archil.ListDisksError, RuntimeContext>;
+    /** Delete a disk this client created. Deleting a missing disk succeeds. */
+    delete(name: string): Effect.Effect<void, archil.ListDisksError | Effect.Error<ReturnType<typeof deleteDisk>>, RuntimeContext>;
+}
+/**
+ * Create disks at run time, one per user, session, or task, by name. This
+ * is how most apps use Archil: a disk mounts in about 50 ms, so it can
+ * belong to a single request. The client returns full disk handles (exec,
+ * grep, objects, branches, disk tokens), the same shape the deploy-time
+ * bindings return.
+ *
+ * Objects created at run time are tagged with the stack, stage and binding
+ * (`alchemy::stack`, `alchemy::stage`, `alchemy::id`) and are not deleted
+ * when the stack is destroyed. List them by those tags to clean them up.
+ * Archil has no tags, labels or descriptions, so the tags are a name
+ * prefix, `alc-<id>-<hash of stack/stage/id>`: every name this client
+ * creates is `<prefix>-<name>`, and `prefix` on the client is the value.
+ *
+ * ### Disks per User
+ * **Example:** A home disk for each user
+ * ```typescript
+ * export default class Api extends Cloudflare.Worker<Api>()(
+ *   "Api",
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     const disks = yield* Archil.CreateDisk();
+ *     return {
+ *       fetch: Effect.gen(function* () {
+ *         const request = yield* HttpServerRequest;
+ *         const user = request.headers["x-user"] ?? "anonymous";
+ *         const home = yield* disks.create(`user-${user}`);
+ *         const result = yield* home.exec("ls -la /mnt/archil");
+ *         return HttpServerResponse.text(result.stdout);
+ *       }),
+ *     };
+ *   }).pipe(Effect.provide(Archil.CreateDiskHttp)),
+ * ) {}
+ * ```
+ *
+ * ### Cleaning Up
+ * **Example:** Delete the disks one binding created
+ * ```typescript
+ * const disks = yield* Archil.CreateDisk();
+ * for (const disk of yield* disks.list()) {
+ *   yield* disks.delete(disk.name.slice(disks.prefix.length + 1));
+ * }
+ * ```
+ *
+ * @binding
+ * @product Disk
+ */
+export interface CreateDisk extends Binding.Service<CreateDisk, "Archil.CreateDisk", (options?: CreateDiskOptions) => Effect.Effect<CreateDiskClient>> {
+}
+export declare const CreateDisk: CreateDisk;
+/** {@link CreateDisk} over Archil's HTTP API, usable from any host. */
+export declare const CreateDiskHttp: Layer.Layer<CreateDisk, never, never>;
+//# sourceMappingURL=CreateDisk.d.ts.map

package/lib/CreateDisk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateDisk.d.ts","sources":["../src/CreateDisk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAc,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGzE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GACvB,MAAM,CAAC,eAAe,GACtB,MAAM,CAAC,YAAY,GACnB,MAAM,CAAC,cAAc,GACrB,YAAY,GACZ,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAA;KAAE,GAC3C,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;IAC9D,kDAAkD;IAClD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAChG,sCAAsC;IACtC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAC3E,2EAA2E;IAC3E,MAAM,CACJ,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,CACd,IAAI,EACJ,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,EACnE,cAAc,CACf,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,UAAW,SAAQ,OAAO,CAAC,OAAO,CACjD,UAAU,EACV,mBAAmB,EACnB,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CACjE;CAAG;AAEJ,eAAO,MAAM,UAAU,YAAmD,CAAC;AAE3E,uEAAuE;AACvE,eAAO,MAAM,cAAc,uCAoD1B,CAAC"}