@heyditto/cli 2.4.1 → 2.5.0

package/dist/teleport/pull.js.map

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

package/dist/teleport/push.d.ts

@@ -0,0 +1,49 @@
+import * as tapi from "./api.js";
+import { type HarnessKind, type Manifest } from "./types.js";
+export interface PushInput {
+    root: string;
+    capsuleId: string;
+    parentGeneration: number | null;
+    /** Previous generation's manifest, for thin bundles. */
+    previousManifest?: Manifest;
+    harness: {
+        kind: HarnessKind;
+        sessionId?: string;
+        cwd?: string;
+    };
+    ignoredIncludes: string[];
+    rootName: string;
+    rootKind: "repo" | "folder";
+    /** Who is committing: the CLI on a user's machine, or the Ditto Code runner. */
+    committedBy?: tapi.CommittedBy;
+}
+export interface PushOutput {
+    generation: number;
+    bytesTotal: number;
+    dedupedBytes: number;
+    chunkCount: number;
+    uploaded: number;
+    reused: number;
+    /** Bytes actually sent to storage this push. */
+    uploadedBytes: number;
+    /** Bytes the generation references in total (every chunk, counted once per reference). */
+    logicalBytes: number;
+    /** logicalBytes − uploadedBytes: what dedup against earlier pushes saved. */
+    reusedBytes: number;
+    /** reusedBytes / logicalBytes, 0 when nothing was referenced. */
+    savingsRatio: number;
+}
+/**
+ * Builds a generation, negotiates which chunks are missing, uploads them via
+ * presigned PUTs, then commits the manifest. The manifest is content-addressed
+ * too, so a re-push with no changes uploads nothing.
+ *
+ * Every generation's manifest carries each repo's complete pack chain (the
+ * basis packs by reference plus this generation's thin pack), so a pull of any
+ * generation rebuilds full history from that one manifest. When the server no
+ * longer holds a referenced basis chunk, the affected repos are re-bundled in
+ * full and the push retried once.
+ */
+export declare function pushCapsule(input: PushInput, forceFull?: Set<string>): Promise<PushOutput>;
+/** The Ditto Code runner authenticates with a ditto_agent_ token and pins the harness session via env. */
+export declare function detectCommitter(): tapi.CommittedBy;

package/dist/teleport/push.js

@@ -0,0 +1,261 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { packageVersion } from "../config.js";
+import * as tapi from "./api.js";
+import { basisFromPrevious, createBundle, readRepoState } from "./bundle.js";
+import { chunkFile, dedupedBytes, readChunk, sha256 } from "./chunks.js";
+import { discoverRepos } from "./discover.js";
+import { captureHarness, locateHarness } from "./harness.js";
+import { captureWorktree, dirtyPaths, pickCompression } from "./worktree.js";
+import { DEFAULT_EXCLUDES, MANIFEST_VERSION, machineInfo, } from "./types.js";
+const PUT_CONCURRENCY = 4;
+const NEGOTIATE_BATCH = 200;
+/** Thin packs chained past this length are compacted into a fresh full bundle. */
+const MAX_PACK_CHAIN = 8;
+/**
+ * Builds a generation, negotiates which chunks are missing, uploads them via
+ * presigned PUTs, then commits the manifest. The manifest is content-addressed
+ * too, so a re-push with no changes uploads nothing.
+ *
+ * Every generation's manifest carries each repo's complete pack chain (the
+ * basis packs by reference plus this generation's thin pack), so a pull of any
+ * generation rebuilds full history from that one manifest. When the server no
+ * longer holds a referenced basis chunk, the affected repos are re-bundled in
+ * full and the push retried once.
+ */
+export async function pushCapsule(input, forceFull = new Set()) {
+    const tmp = await mkdtemp(path.join(os.tmpdir(), "teleport-push-"));
+    const compression = pickCompression();
+    const generation = (input.parentGeneration ?? 0) + 1;
+    const sources = new Map();
+    /** Chunks referenced from a previous generation (no local bytes) → their repo. */
+    const carried = new Map();
+    const allChunks = [];
+    try {
+        const discovery = await discoverRepos(input.root);
+        const prevByRel = new Map();
+        for (const r of input.previousManifest?.repos ?? [])
+            prevByRel.set(r.relPath, r);
+        const repos = [];
+        for (const rel of discovery.repos) {
+            const repoDir = rel === "." ? discovery.root : path.join(discovery.root, rel);
+            const state = readRepoState(repoDir);
+            const prev = prevByRel.get(rel);
+            // Thin against the previous generation unless forced, unless there is no
+            // usable basis, or unless the chain is long enough that a restore would
+            // crawl; those cases compact into a fresh full bundle.
+            const useBasis = !forceFull.has(rel) && !!prev && prev.packs.length > 0 && prev.packs.length < MAX_PACK_CHAIN;
+            const basis = useBasis ? basisFromPrevious(prev) : [];
+            const bundleFile = path.join(tmp, `bundle-${safe(rel)}.bundle`);
+            const bundle = await createBundle(repoDir, bundleFile, basis, Object.keys(state.upstreamTips).map((u) => `refs/remotes/${u}`));
+            const packs = [];
+            if (useBasis && (bundle === null || bundle.kind === "thin")) {
+                // Carry the basis chain by reference: the server already holds these
+                // chunks and dedups them, and a pull needs them to rebuild history.
+                for (const pack of prev.packs) {
+                    packs.push(pack);
+                    for (const c of pack.chunks) {
+                        allChunks.push(c);
+                        if (!sources.has(c.sha256))
+                            carried.set(c.sha256, rel);
+                    }
+                }
+            }
+            const packChunks = bundle ? await addFileChunks(bundle.file, sources, allChunks) : [];
+            for (const c of packChunks)
+                carried.delete(c.sha256);
+            const dirty = dirtyPaths(repoDir, input.ignoredIncludes);
+            const wtFile = path.join(tmp, `worktree-${safe(rel)}.tar`);
+            const capture = await captureWorktree(repoDir, dirty, wtFile, compression);
+            const wtChunks = capture ? await addFileChunks(capture.file, sources, allChunks) : [];
+            if (bundle) {
+                const pack = { kind: bundle.kind, chunks: packChunks };
+                if (bundle.kind === "thin" && input.parentGeneration)
+                    pack.basisGeneration = input.parentGeneration;
+                packs.push(pack);
+            }
+            const repo = {
+                head: state.head,
+                relPath: rel,
+                remotes: state.remotes,
+                packs,
+                worktree: capture
+                    ? { chunks: wtChunks, entries: capture.entries, bytes: bundleBytes(wtChunks) }
+                    : { chunks: [], entries: 0, bytes: 0 },
+            };
+            if (state.branches.length)
+                repo.branches = state.branches;
+            if (state.tags.length)
+                repo.tags = state.tags;
+            // Per-branch upstreams, restricted to remotes the manifest carries so a
+            // restore can always recreate the tracking ref.
+            const remoteNames = new Set(state.remotes.map((r) => r.name));
+            const upstreams = {};
+            for (const [b, up] of Object.entries(state.branchUpstreams)) {
+                if (remoteNames.has(up.split("/")[0]))
+                    upstreams[b] = up;
+            }
+            if (Object.keys(upstreams).length)
+                repo.branchUpstreams = upstreams;
+            // Remote-tracking tips for every upstream the manifest names.
+            const tips = {};
+            for (const up of new Set([...(state.head.upstream ? [state.head.upstream] : []), ...Object.values(upstreams)])) {
+                const tip = state.upstreamTips[up];
+                if (tip && remoteNames.has(up.split("/")[0]))
+                    tips[up] = tip;
+            }
+            if (Object.keys(tips).length)
+                repo.upstreamTips = tips;
+            if (state.stashes.length)
+                repo.stashes = state.stashes;
+            if (input.ignoredIncludes.length)
+                repo.ignoredIncludes = input.ignoredIncludes;
+            repos.push(repo);
+        }
+        // Harness transcript.
+        const harness = { kind: input.harness.kind, chunks: [] };
+        if (input.harness.sessionId)
+            harness.sessionId = input.harness.sessionId;
+        if (input.harness.cwd)
+            harness.cwd = input.harness.cwd;
+        if (input.harness.kind !== "none" && input.harness.sessionId && input.harness.cwd) {
+            const loc = await locateHarness(input.harness.kind, input.harness.sessionId, input.harness.cwd);
+            if (loc) {
+                const hFile = path.join(tmp, "harness.tar");
+                const cap = await captureHarness(loc, hFile, compression);
+                if (cap)
+                    harness.chunks = await addFileChunks(cap.file, sources, allChunks);
+            }
+        }
+        const bytesTotal = allChunks.reduce((n, c) => n + c.size, 0);
+        const manifest = {
+            v: MANIFEST_VERSION,
+            capsuleId: input.capsuleId,
+            generation,
+            parentGeneration: input.parentGeneration ?? 0,
+            createdAt: new Date().toISOString(),
+            machine: machineInfo(packageVersion),
+            root: { kind: input.rootKind, name: input.rootName },
+            repos,
+            excludes: [...DEFAULT_EXCLUDES],
+            harness,
+            totals: { chunks: allChunks.length, bytes: bytesTotal, dedupedBytes: dedupedBytes(allChunks) },
+        };
+        // The manifest is itself a chunk: write it, hash it, and negotiate it with
+        // the rest so commit can reference it by sha256.
+        const manifestBytes = Buffer.from(JSON.stringify(manifest));
+        const manifestSha256 = sha256(manifestBytes);
+        const manifestFile = path.join(tmp, "manifest.json");
+        await writeFile(manifestFile, manifestBytes);
+        const manifestRef = { sha256: manifestSha256, size: manifestBytes.length };
+        allChunks.push(manifestRef);
+        if (!sources.has(manifestSha256))
+            sources.set(manifestSha256, { file: manifestFile, index: 0, size: manifestBytes.length });
+        // Distinct chunks, negotiate in batches of ≤ 200.
+        const distinct = new Map();
+        for (const c of allChunks)
+            distinct.set(c.sha256, c);
+        const wanted = [...distinct.values()];
+        let uploaded = 0;
+        let uploadedBytes = 0;
+        for (let i = 0; i < wanted.length; i += NEGOTIATE_BATCH) {
+            const batch = wanted.slice(i, i + NEGOTIATE_BATCH);
+            const neg = await tapi.negotiate(input.capsuleId, batch.map((c) => ({ sha256: c.sha256, size: c.size })));
+            // A basis chunk the server no longer has cannot be re-sent by reference:
+            // rebuild those repos with a full bundle and push again (once).
+            const lost = neg.missing.filter((m) => !sources.has(m.sha256) && carried.has(m.sha256));
+            if (lost.length > 0) {
+                const repos = new Set(lost.map((m) => carried.get(m.sha256)));
+                if ([...repos].every((r) => forceFull.has(r))) {
+                    throw new Error(`server is missing basis chunks for ${[...repos].join(", ")} even after a full re-bundle`);
+                }
+                await rm(tmp, { recursive: true, force: true });
+                return pushCapsule(input, new Set([...forceFull, ...repos]));
+            }
+            await uploadMissing(neg.missing, sources);
+            uploaded += neg.missing.length;
+            for (const m of neg.missing)
+                uploadedBytes += m.size ?? distinct.get(m.sha256)?.size ?? 0;
+        }
+        const committed = await tapi.commit(input.capsuleId, {
+            manifest,
+            manifestSha256,
+            committedBy: input.committedBy ?? detectCommitter(),
+        });
+        const logicalBytes = allChunks.reduce((n, c) => n + c.size, 0);
+        const reusedBytes = Math.max(0, logicalBytes - uploadedBytes);
+        return {
+            // The server's generation record is authoritative for the number.
+            generation: committed.generation?.generation ?? generation,
+            bytesTotal,
+            dedupedBytes: manifest.totals.dedupedBytes ?? 0,
+            chunkCount: distinct.size,
+            uploaded,
+            reused: distinct.size - uploaded,
+            uploadedBytes,
+            logicalBytes,
+            reusedBytes,
+            savingsRatio: logicalBytes > 0 ? reusedBytes / logicalBytes : 0,
+        };
+    }
+    finally {
+        await rm(tmp, { recursive: true, force: true });
+    }
+}
+async function addFileChunks(file, sources, all) {
+    const refs = await chunkFile(file);
+    refs.forEach((r, index) => {
+        all.push(r);
+        if (!sources.has(r.sha256))
+            sources.set(r.sha256, { file, index, size: r.size });
+    });
+    return refs;
+}
+async function uploadMissing(missing, sources) {
+    let cursor = 0;
+    const workers = Array.from({ length: Math.min(PUT_CONCURRENCY, missing.length) }, async () => {
+        for (;;) {
+            const i = cursor++;
+            if (i >= missing.length)
+                return;
+            const item = missing[i];
+            const src = sources.get(item.sha256);
+            if (!src)
+                throw new Error(`server asked for an unknown chunk ${item.sha256}`);
+            const body = await readChunk(src.file, src.index);
+            await putWithRetry(item.putUrl, body);
+        }
+    });
+    await Promise.all(workers);
+}
+async function putWithRetry(url, body, attempts = 4) {
+    let delay = 400;
+    for (let attempt = 1;; attempt++) {
+        const res = await fetch(url, { method: "PUT", body });
+        if (res.ok)
+            return;
+        if (attempt >= attempts || (res.status < 500 && res.status !== 429)) {
+            throw new Error(`chunk upload failed: HTTP ${res.status}`);
+        }
+        await sleep(delay);
+        delay *= 2;
+    }
+}
+/** The Ditto Code runner authenticates with a ditto_agent_ token and pins the harness session via env. */
+export function detectCommitter() {
+    const key = process.env.DITTO_API_KEY ?? "";
+    if (key.startsWith("ditto_agent_") || process.env.TELEPORT_HARNESS_SESSION_ID)
+        return "runner";
+    return "cli";
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function bundleBytes(chunks) {
+    return chunks.reduce((n, c) => n + c.size, 0);
+}
+function safe(rel) {
+    return rel.replace(/[^A-Za-z0-9._-]/g, "_") || "root";
+}
+//# sourceMappingURL=push.js.map

package/dist/teleport/push.js.map

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

package/dist/teleport/restore.d.ts

@@ -0,0 +1,16 @@
+import type { Manifest } from "./types.js";
+export interface RestoreResult {
+    root: string;
+    repos: string[];
+    harnessSessionId: string | null;
+    harnessCwd: string | null;
+}
+/**
+ * Rebuilds a capsule from its manifest and the downloaded chunk files (keyed by
+ * sha256). Each repo is reconstructed from its bundle(s), branches and
+ * upstreams are restored, the dirty worktree is untarred over the checkout, and
+ * the harness transcript (if any) is placed under the restored cwd.
+ */
+export declare function restoreCapsule(manifest: Manifest, chunkPath: (sha256: string) => string, destRoot: string, opts?: {
+    restoreHarness?: boolean;
+}): Promise<RestoreResult>;

package/dist/teleport/restore.js

@@ -0,0 +1,163 @@
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { git, gitOrThrow, isGitRepo } from "./git.js";
+import { restoreClaudeTranscript } from "./harness.js";
+import { detectCompression, extractWorktree } from "./worktree.js";
+/**
+ * Rebuilds a capsule from its manifest and the downloaded chunk files (keyed by
+ * sha256). Each repo is reconstructed from its bundle(s), branches and
+ * upstreams are restored, the dirty worktree is untarred over the checkout, and
+ * the harness transcript (if any) is placed under the restored cwd.
+ */
+export async function restoreCapsule(manifest, chunkPath, destRoot, opts = {}) {
+    await mkdir(destRoot, { recursive: true });
+    const tmp = await mkdtemp(path.join(os.tmpdir(), "teleport-restore-"));
+    try {
+        const repos = [];
+        for (const repo of manifest.repos) {
+            const repoDest = path.resolve(destRoot, repo.relPath);
+            await mkdir(repoDest, { recursive: true });
+            await restoreRepo(repo, chunkPath, repoDest, tmp);
+            repos.push(repo.relPath);
+        }
+        let harnessCwd = null;
+        if (opts.restoreHarness && manifest.harness.kind !== "none" && manifest.harness.chunks.length > 0) {
+            const tar = path.join(tmp, "harness.tar");
+            await concatChunks(manifest.harness.chunks.map((c) => c.sha256), chunkPath, tar);
+            const originalCwd = manifest.harness.cwd ?? destRoot;
+            const targetCwd = manifest.root.kind === "repo" ? path.resolve(destRoot, manifest.repos[0]?.relPath ?? ".") : destRoot;
+            const compression = detectCompression(tar);
+            if (manifest.harness.kind === "claude-code" && manifest.harness.sessionId) {
+                await restoreClaudeTranscript(tar, compression, manifest.harness.sessionId, originalCwd, targetCwd);
+            }
+            else {
+                // Codex keys transcripts on absolute cwd inside a shared home; extract as-is.
+                extractWorktree(tar, os.homedir(), compression);
+            }
+            harnessCwd = targetCwd;
+        }
+        return { root: destRoot, repos, harnessSessionId: manifest.harness.sessionId ?? null, harnessCwd };
+    }
+    finally {
+        await rm(tmp, { recursive: true, force: true });
+    }
+}
+async function restoreRepo(repo, chunkPath, repoDest, tmp) {
+    const hasBundle = repo.packs.some((p) => p.chunks.length > 0);
+    if (hasBundle) {
+        // Reassemble every pack into one bare prerequisite repo, then clone from it
+        // (a fetch into a repo whose branch is checked out is refused by git).
+        const bundleDir = path.join(tmp, `bundles-${sanitize(repo.relPath)}`);
+        await mkdir(bundleDir, { recursive: true });
+        const scratch = path.join(tmp, `scratch-${sanitize(repo.relPath)}`);
+        gitOrThrow(["init", "--bare", scratch], tmp);
+        // Full packs first, then thin packs oldest basis → newest, so every
+        // bundle's prerequisites are present before it is fetched.
+        const ordered = [...repo.packs].sort((a, b) => {
+            if (a.kind !== b.kind)
+                return a.kind === "full" ? -1 : 1;
+            return (a.basisGeneration ?? 0) - (b.basisGeneration ?? 0);
+        });
+        for (let i = 0; i < ordered.length; i++) {
+            const bundleFile = path.join(bundleDir, `pack-${i}.bundle`);
+            await concatChunks(ordered[i].chunks.map((c) => c.sha256), chunkPath, bundleFile);
+            gitOrThrow(["fetch", "--tags", bundleFile, "+refs/*:refs/*"], scratch);
+        }
+        // Clone the bare repo into the destination: this copies every branch and
+        // tag with a real working tree, without a fetch-into-checked-out-branch.
+        gitOrThrow(["clone", scratch, repoDest], tmp);
+        // Local tracking branches for every branch the capsule carried, so a later
+        // checkout of any of them works offline.
+        for (const branch of repo.branches ?? []) {
+            if (git(["rev-parse", "--verify", `refs/heads/${branch}`], repoDest).ok)
+                continue;
+            git(["branch", "--no-track", branch, `refs/remotes/origin/${branch}`], repoDest);
+        }
+        git(["remote", "remove", "origin"], repoDest);
+    }
+    else if (!isGitRepo(repoDest)) {
+        gitOrThrow(["init", repoDest], tmp);
+    }
+    // Remotes.
+    for (const remote of repo.remotes) {
+        if (git(["remote", "get-url", remote.name], repoDest).ok) {
+            git(["remote", "set-url", remote.name, remote.url], repoDest);
+        }
+        else {
+            git(["remote", "add", remote.name, remote.url], repoDest);
+        }
+    }
+    // Check out the recorded HEAD/branch and re-establish upstream tracking.
+    if (repo.head.branch && (repo.branches ?? []).includes(repo.head.branch)) {
+        gitOrThrow(["checkout", "-f", repo.head.branch], repoDest);
+        if (repo.head.upstream)
+            restoreUpstream(repoDest, repo, repo.head.branch, repo.head.upstream);
+    }
+    else if (repo.head.sha) {
+        gitOrThrow(["checkout", "-f", repo.head.sha], repoDest);
+    }
+    // Every other branch that tracked a remote gets its tracking ref back too.
+    for (const [branch, upstream] of Object.entries(repo.branchUpstreams ?? {})) {
+        if (branch === repo.head.branch && repo.head.upstream)
+            continue;
+        if (!git(["rev-parse", "--verify", `refs/heads/${branch}`], repoDest).ok)
+            continue;
+        restoreUpstream(repoDest, repo, branch, upstream);
+    }
+    // Dirty worktree over the checkout.
+    if (repo.worktree?.chunks?.length) {
+        const tar = path.join(tmp, `worktree-${sanitize(repo.relPath)}.tar`);
+        await concatChunks(repo.worktree.chunks.map((c) => c.sha256), chunkPath, tar);
+        extractWorktree(tar, repoDest);
+    }
+}
+/**
+ * Recreates `<remote>/<branch>` tracking without a network fetch. The clone we
+ * restore from has no remote-tracking refs (its origin was the scratch repo),
+ * so `branch --set-upstream-to` would fail; instead the tracking ref is
+ * pointed at the branch tip the capsule recorded, then the upstream is set.
+ * The tip is the last state this machine knew of the upstream, so ahead/behind
+ * reads 0 until the next fetch. Any failure here is a hard error: silently
+ * losing tracking is exactly the bug this guards against.
+ */
+function restoreUpstream(repoDest, repo, branch, upstream) {
+    const remote = repo.remotes.find((r) => upstream === r.name || upstream.startsWith(`${r.name}/`));
+    if (!remote) {
+        throw new Error(`cannot restore upstream ${upstream} for ${branch}: remote is not in the capsule (${repo.remotes.map((r) => r.name).join(", ") || "none"})`);
+    }
+    const remoteBranch = upstream.slice(remote.name.length + 1);
+    if (!remoteBranch)
+        throw new Error(`cannot restore upstream ${upstream}: no branch component`);
+    const tip = repo.upstreamTips?.[upstream];
+    if (tip) {
+        // The real remote-tracking sha captured at push time; its objects rode in
+        // the bundle, so ahead/behind is exactly what the source machine saw.
+        gitOrThrow(["update-ref", `refs/remotes/${remote.name}/${remoteBranch}`, tip], repoDest);
+        gitOrThrow(["branch", `--set-upstream-to=${upstream}`, branch], repoDest);
+        return;
+    }
+    // Older capsules carry no tip: configure the upstream but never fabricate the
+    // tracking ref — offload treats "configured, ref missing" as unknown.
+    gitOrThrow(["config", `branch.${branch}.remote`, remote.name], repoDest);
+    gitOrThrow(["config", `branch.${branch}.merge`, `refs/heads/${remoteBranch}`], repoDest);
+}
+async function concatChunks(shas, chunkPath, outFile) {
+    const { createWriteStream } = await import("node:fs");
+    const { readFile } = await import("node:fs/promises");
+    const ws = createWriteStream(outFile);
+    try {
+        for (const sha of shas) {
+            const buf = await readFile(chunkPath(sha));
+            await new Promise((resolve, reject) => ws.write(buf, (err) => (err ? reject(err) : resolve())));
+        }
+    }
+    finally {
+        await new Promise((resolve) => ws.end(resolve));
+    }
+    void writeFile; // keep import set stable if unused in future edits
+}
+function sanitize(rel) {
+    return rel.replace(/[^A-Za-z0-9._-]/g, "_") || "root";
+}
+//# sourceMappingURL=restore.js.map

package/dist/teleport/restore.js.map

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

package/dist/teleport/storage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Bring-your-own buckets that capsules can mirror to, managed through the
+ * teleport API (`/api/v5/teleport/buckets`), which accepts the CLI's
+ * ditto_mcp_ key. Any S3-compatible endpoint works (AWS S3, R2, B2, MinIO,
+ * Hippius); `providerKind` is detected server-side from the endpoint.
+ */
+export interface StorageBucket {
+    id: string;
+    name?: string;
+    providerKind?: "s3" | "hippius";
+    bucket: string;
+    endpoint: string;
+    region: string;
+    enabled: boolean;
+    default: boolean;
+    teleportMirror?: boolean;
+    keyHint?: string;
+    credentialState?: string;
+}
+export interface AddBucketInput {
+    name?: string;
+    providerKind?: "s3" | "hippius";
+    accessKeyID: string;
+    secretAccessKey: string;
+    bucket: string;
+    endpoint: string;
+    region?: string;
+    enabled?: boolean;
+    default?: boolean;
+    teleportMirror?: boolean;
+}
+export interface UpdateBucketInput {
+    name?: string;
+    enabled?: boolean;
+    default?: boolean;
+    teleportMirror?: boolean;
+}
+export interface TestResult {
+    ok: boolean;
+    error?: string;
+}
+export declare function listBuckets(): Promise<StorageBucket[]>;
+export declare function addBucket(input: AddBucketInput): Promise<StorageBucket>;
+export declare function updateBucket(id: string, input: UpdateBucketInput): Promise<StorageBucket>;
+export declare function removeBucket(id: string): Promise<void>;
+/** Tests a stored bucket's credentials. */
+export declare function testBucket(id: string): Promise<TestResult>;
+/** Tests credentials before they are saved. */
+export declare function testDraft(input: AddBucketInput): Promise<TestResult>;
+/** Resolves a bucket by id or by its friendly name (or, failing that, the bucket name). */
+export declare function resolveBucket(ref: string): Promise<StorageBucket>;
+/** Human summary of where a bucket lives, for `storage list`. */
+export declare function bucketEndpointLabel(b: StorageBucket): string;

package/dist/teleport/storage.js

@@ -0,0 +1,43 @@
+import { apiBase, apiFetch } from "../api.js";
+const BUCKETS = "/api/v5/teleport/buckets";
+export async function listBuckets() {
+    const res = await apiFetch(BUCKETS);
+    return res.buckets ?? [];
+}
+export async function addBucket(input) {
+    return apiFetch(BUCKETS, { method: "POST", body: input });
+}
+export async function updateBucket(id, input) {
+    return apiFetch(`${BUCKETS}/${encodeURIComponent(id)}`, { method: "PATCH", body: input });
+}
+export async function removeBucket(id) {
+    await apiFetch(`${BUCKETS}/${encodeURIComponent(id)}`, { method: "DELETE" });
+}
+/** Tests a stored bucket's credentials. */
+export async function testBucket(id) {
+    return apiFetch(`${BUCKETS}/test`, { method: "POST", body: { bucketId: id } });
+}
+/** Tests credentials before they are saved. */
+export async function testDraft(input) {
+    return apiFetch(`${BUCKETS}/test`, { method: "POST", body: { settings: input } });
+}
+/** Resolves a bucket by id or by its friendly name (or, failing that, the bucket name). */
+export async function resolveBucket(ref) {
+    const buckets = await listBuckets();
+    const hit = buckets.find((b) => b.id === ref) ??
+        buckets.find((b) => b.name === ref) ??
+        buckets.find((b) => b.bucket === ref);
+    if (!hit)
+        throw new Error(`no bucket named "${ref}"; see \`heyditto storage list\``);
+    return hit;
+}
+/** Human summary of where a bucket lives, for `storage list`. */
+export function bucketEndpointLabel(b) {
+    try {
+        return new URL(b.endpoint).host;
+    }
+    catch {
+        return b.endpoint || apiBase();
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/teleport/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/teleport/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AA+C9C,MAAM,OAAO,GAAG,0BAA0B,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAgC,OAAO,CAAC,CAAC;IACnE,OAAO,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,OAAO,QAAQ,CAAgB,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU,EAAE,KAAwB;IACrE,OAAO,QAAQ,CAAgB,GAAG,OAAO,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EAAU;IAC3C,MAAM,QAAQ,CAAO,GAAG,OAAO,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAU;IACzC,OAAO,QAAQ,CAAa,GAAG,OAAO,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AAC7F,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,OAAO,QAAQ,CAAa,GAAG,OAAO,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AAChG,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IACpC,MAAM,GAAG,GACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,kCAAkC,CAAC,CAAC;IACrF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CAAC,CAAgB;IAClD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC;IACjC,CAAC;AACH,CAAC"}