pinnace 0.0.0 → 0.2.0

package/dist/rpc/kubo-rpc-client.js

@@ -0,0 +1,207 @@
+/**
+ * A typed, per-node Kubo RPC client. It wraps `POST {baseUrl}/api/v0/<path>`
+ * with an `Authorization: Bearer <token>` header on EVERY call. No Kubo binary
+ * runs on the client — all interaction is HTTP.
+ *
+ * This is the seam every host-agnostic pinnace operation (deploy, publish,
+ * status, site management) speaks. It is deliberately PER-NODE (one base URL +
+ * one token); multi-target fan-out lives in the deploy task, not here.
+ *
+ * Behaviour ported (not copied) from the reference prototype
+ * `~/searches/ipfs-hetzner/deploy-car.mjs`: the exact query params
+ * (`files/mkdir?arg=/sites&parents=true`, `dag/import?pin-roots=true`, ...) and
+ * the throw-on-`!ok` error handling.
+ */
+/**
+ * A loud error carrying the endpoint + HTTP status of a non-2xx Kubo response,
+ * so a caller (and a log) can see exactly which call failed and how.
+ */
+export class KuboRpcError extends Error {
+    endpoint;
+    status;
+    bodyText;
+    constructor(
+    /** The `/api/v0/<endpoint>` path that failed. */
+    endpoint, 
+    /** The HTTP status returned. */
+    status, 
+    /** The response body text (for diagnostics). */
+    bodyText) {
+        super(`Kubo RPC ${endpoint} failed: ${status} ${bodyText}`);
+        this.endpoint = endpoint;
+        this.status = status;
+        this.bodyText = bodyText;
+        this.name = 'KuboRpcError';
+    }
+}
+export class KuboRpcClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    constructor(options) {
+        // Normalise: strip trailing slashes so path joining is unambiguous.
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.token = options.token;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    }
+    /**
+     * The core request primitive: POST `/api/v0/<endpoint>?<query>` with the
+     * bearer token. Throws {@link KuboRpcError} on any non-2xx. Returns the raw
+     * {@link Response} so callers can decode JSON or bytes as they need.
+     */
+    async request(endpoint, query, body, extraHeaders) {
+        const qs = query && [...query.keys()].length > 0 ? `?${query.toString()}` : '';
+        const url = `${this.baseUrl}/api/v0/${endpoint}${qs}`;
+        const res = await this.fetchImpl(url, {
+            method: 'POST',
+            headers: { authorization: `Bearer ${this.token}`, ...(extraHeaders ?? {}) },
+            body,
+        });
+        if (!res.ok) {
+            const text = await safeText(res);
+            throw new KuboRpcError(endpoint, res.status, text);
+        }
+        return res;
+    }
+    /** POST an endpoint and parse the JSON response body. */
+    async requestJson(endpoint, query, body, extraHeaders) {
+        const res = await this.request(endpoint, query, body, extraHeaders);
+        return (await res.json());
+    }
+    /** `id` — the node's identity (PeerID etc.). */
+    id() {
+        return this.requestJson('id');
+    }
+    /**
+     * `add` — add raw bytes (returned shape is Kubo-defined). Kubo requires the
+     * payload as a `multipart/form-data` `file` part, NOT a raw body, so we send
+     * a {@link FormData} and let `fetch` set the multipart boundary itself (see
+     * {@link fileUpload}).
+     */
+    add(data) {
+        return this.fileUpload('add', undefined, data);
+    }
+    /** `dag/import?pin-roots=true` — import a CAR and pin its roots. */
+    dagImport(car) {
+        const q = new URLSearchParams({ 'pin-roots': 'true' });
+        return this.fileUpload('dag/import', q, car);
+    }
+    /**
+     * `pin/rm?arg=<cid>` — UNPIN content so Kubo can garbage-collect it and
+     * reclaim storage. The counterpart to `dag/import?pin-roots=true`: removing a
+     * site unpins its CID here so it stops being served/announced. `arg` takes a
+     * bare CID (or an `/ipfs/<cid>` path); callers pass the CID from `files/stat`.
+     */
+    pinRm(cid) {
+        return this.requestJson('pin/rm', new URLSearchParams({ arg: cid }));
+    }
+    /** `files/mkdir?arg=<path>[&parents=true]`. */
+    async filesMkdir(path, options = {}) {
+        const q = new URLSearchParams({ arg: path });
+        if (options.parents)
+            q.set('parents', 'true');
+        await this.request('files/mkdir', q);
+    }
+    /** `files/rm?arg=<path>[&recursive=true][&force=true]`. */
+    async filesRm(path, options = {}) {
+        const q = new URLSearchParams({ arg: path });
+        if (options.recursive)
+            q.set('recursive', 'true');
+        if (options.force)
+            q.set('force', 'true');
+        await this.request('files/rm', q);
+    }
+    /** `files/cp?arg=<from>&arg=<to>`. */
+    async filesCp(from, to) {
+        const q = new URLSearchParams();
+        q.append('arg', from);
+        q.append('arg', to);
+        await this.request('files/cp', q);
+    }
+    /** `files/stat?arg=<path>` — returns the MFS entry stat (Hash, Type, ...). */
+    filesStat(path) {
+        return this.requestJson('files/stat', new URLSearchParams({ arg: path }));
+    }
+    /** `files/ls?arg=<path>[&l=true]` — list an MFS directory. */
+    filesLs(path, long = true) {
+        const q = new URLSearchParams({ arg: path });
+        if (long)
+            q.set('long', 'true');
+        return this.requestJson('files/ls', q);
+    }
+    /** `key/list?l=true` — list keystore keys with their IPNS ids. */
+    keyList() {
+        return this.requestJson('key/list', new URLSearchParams({ l: 'true' }));
+    }
+    /** `key/gen?arg=<name>&type=ed25519` — generate a new keystore key. */
+    keyGen(name) {
+        const q = new URLSearchParams({ arg: name, type: 'ed25519' });
+        return this.requestJson('key/gen', q);
+    }
+    /**
+     * `key/import?arg=<name>` — import key MATERIAL (libp2p/protobuf bytes) into
+     * the keystore. The node, not the client, signs records with it.
+     */
+    keyImport(name, keyBytes) {
+        const q = new URLSearchParams({ arg: name });
+        return this.fileUpload('key/import', q, keyBytes);
+    }
+    /**
+     * Kubo's file-upload endpoints require the payload as a `multipart/form-data`
+     * body with the bytes as a named file part (confirmed by the Kubo RPC docs'
+     * `-F <field>=@…` cURL examples and a live daemon). A raw
+     * `application/octet-stream` body is rejected with
+     * `400 file argument '<field>' is required`.
+     *
+     * The field name is endpoint-specific: `add`, `dag/import` and `key/import`
+     * expect `file` (the default), while `routing/put` expects `value-file`.
+     *
+     * We build a {@link FormData} and pass it as the body WITHOUT a hand-set
+     * `content-type`: `fetch` serialises the FormData and sets
+     * `content-type: multipart/form-data; boundary=…` itself. Setting it manually
+     * would omit/override the boundary and break the request.
+     */
+    fileUpload(endpoint, query, bytes, field = 'file') {
+        const form = new FormData();
+        form.append(field, new Blob([bytes]), field);
+        return this.requestJson(endpoint, query, form);
+    }
+    /** `name/publish?arg=<cidPath>&key=<key>&lifetime=..&ttl=..` — sign+publish IPNS. */
+    namePublish(options) {
+        const q = new URLSearchParams({ arg: options.cidPath, key: options.key });
+        if (options.lifetime)
+            q.set('lifetime', options.lifetime);
+        if (options.ttl)
+            q.set('ttl', options.ttl);
+        if (options.allowOffline)
+            q.set('allow-offline', 'true');
+        return this.requestJson('name/publish', q);
+    }
+    /** `routing/get?arg=<ipnsPath>` — fetch the raw signed record for a name. */
+    async routingGet(ipnsPath) {
+        const res = await this.request('routing/get', new URLSearchParams({ arg: ipnsPath }));
+        return new Uint8Array(await res.arrayBuffer());
+    }
+    /**
+     * `routing/put?arg=<ipnsPath>` — (re-)announce a signed record body. Kubo's
+     * `routing/put` takes the record as a `multipart/form-data` file part named
+     * **`value-file`** (NOT the generic `file` the other upload endpoints use); a
+     * raw `application/octet-stream` body is rejected with
+     * `400 file argument 'value-file' is required`. Goes through {@link fileUpload}
+     * so `fetch` owns the multipart boundary (no hand-set content-type).
+     */
+    async routingPut(ipnsPath, record) {
+        const q = new URLSearchParams({ arg: ipnsPath });
+        await this.fileUpload('routing/put', q, record, 'value-file');
+    }
+}
+/** Read a response body as text without throwing (best-effort for errors). */
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=kubo-rpc-client.js.map

package/dist/rpc/kubo-rpc-client.js.map

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

package/dist/rpc/mock-kubo.d.ts

@@ -0,0 +1,87 @@
+/**
+ * A mock Kubo HTTP API for tests: it RECORDS every incoming request (method,
+ * path, query, headers, body) and returns canned responses, so a test can
+ * assert the exact call shape a `KuboRpcClient` produced WITHOUT a live daemon.
+ *
+ * This is the primary test boundary for every host-agnostic pinnace operation
+ * (deploy, publish, status, site management). It is exposed from the package's
+ * test surface so sibling tasks (deploy-multi-target, status-report, ...) reuse
+ * it rather than re-inventing a Kubo fake.
+ */
+/** One multipart file part the mock extracted from a `FormData` body. */
+export interface RecordedFilePart {
+    /** The multipart field name (Kubo's file-upload endpoints expect `file`). */
+    field: string;
+    /** The optional filename the part was appended with. */
+    filename?: string;
+    /** The part's bytes. */
+    bytes: Uint8Array;
+}
+/** One recorded RPC request as the mock observed it. */
+export interface RecordedRequest {
+    /** The HTTP method (Kubo RPC is always POST). */
+    method: string;
+    /** The `/api/v0/...` path, WITHOUT the base URL or query string. */
+    path: string;
+    /** Parsed query parameters (multi-valued: `arg` can repeat). */
+    query: URLSearchParams;
+    /** Lower-cased header name → value, as fetch delivered them. */
+    headers: Record<string, string>;
+    /** The raw request body as text (empty string if none). */
+    bodyText: string;
+    /**
+     * The effective request `content-type`. For a `FormData` body this is
+     * `multipart/form-data` (real `fetch` sets it, WITH a boundary, when it
+     * serialises FormData) even though the caller must NOT hand-set it — the
+     * mock derives it here so tests can assert the multipart contract Kubo
+     * requires for its file-upload endpoints.
+     */
+    contentType?: string;
+    /**
+     * When the body was a `FormData` (a `multipart/form-data` upload), the file
+     * parts it carried. Empty/undefined for non-multipart bodies. Kubo's
+     * `add`, `dag/import` and `key/import` require at least one file part under
+     * the field name `file`.
+     */
+    fileParts?: RecordedFilePart[];
+    /** The full URL that was fetched. */
+    url: string;
+}
+/** A canned response for a given `/api/v0/<path>` (path without query). */
+export interface MockResponseSpec {
+    /** HTTP status to return (default 200). */
+    status?: number;
+    /** JSON body to return; serialised and sent with content-type application/json. */
+    json?: unknown;
+    /** Raw text body to return (takes precedence over `json` if both set). */
+    text?: string;
+}
+/**
+ * A recording mock Kubo API. Install it with {@link fetchImpl} as the `fetch`
+ * a {@link KuboRpcClient} uses; inspect {@link requests} afterwards.
+ */
+export declare class MockKuboApi {
+    readonly baseUrl: string;
+    /** Every request the mock received, in order. */
+    readonly requests: RecordedRequest[];
+    /** path (no query) → canned response. */
+    private readonly responses;
+    /** The base URL this mock pretends to be (only its path/query are used). */
+    constructor(baseUrl?: string);
+    /** Register a canned response for a Kubo `/api/v0/<path>` (path without query). */
+    on(path: string, spec: MockResponseSpec): this;
+    /** The most recent recorded request, or undefined if none. */
+    get lastRequest(): RecordedRequest | undefined;
+    /** All recorded requests whose path equals `path`. */
+    requestsFor(path: string): RecordedRequest[];
+    /**
+     * A `fetch`-compatible function that records the request and returns the
+     * canned (or a default empty-JSON 200) response. Pass this to the client.
+     */
+    readonly fetchImpl: (input: string | URL, init?: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+    }) => Promise<Response>;
+}
+//# sourceMappingURL=mock-kubo.d.ts.map

package/dist/rpc/mock-kubo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-kubo.d.ts","sourceRoot":"","sources":["../../src/rpc/mock-kubo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAChC,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,KAAK,EAAE,UAAU,CAAC;CAClB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC/B,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,EAAE,eAAe,CAAC;IACvB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAChC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,qBAAa,WAAW;IAQX,QAAQ,CAAC,OAAO,EAAE,MAAM;IAPpC,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAM;IAE1C,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IAEjE,4EAA4E;gBACvD,OAAO,GAAE,MAAoC;IAElE,mFAAmF;IACnF,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAK9C,8DAA8D;IAC9D,IAAI,WAAW,IAAI,eAAe,GAAG,SAAS,CAE7C;IAED,sDAAsD;IACtD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAI5C;;;OAGG;IACH,QAAQ,CAAC,SAAS,GACjB,OAAO,MAAM,GAAG,GAAG,EACnB,OAAO;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAC,KACxE,OAAO,CAAC,QAAQ,CAAC,CAgClB;CACF"}

package/dist/rpc/mock-kubo.js

@@ -0,0 +1,129 @@
+/**
+ * A mock Kubo HTTP API for tests: it RECORDS every incoming request (method,
+ * path, query, headers, body) and returns canned responses, so a test can
+ * assert the exact call shape a `KuboRpcClient` produced WITHOUT a live daemon.
+ *
+ * This is the primary test boundary for every host-agnostic pinnace operation
+ * (deploy, publish, status, site management). It is exposed from the package's
+ * test surface so sibling tasks (deploy-multi-target, status-report, ...) reuse
+ * it rather than re-inventing a Kubo fake.
+ */
+/**
+ * A recording mock Kubo API. Install it with {@link fetchImpl} as the `fetch`
+ * a {@link KuboRpcClient} uses; inspect {@link requests} afterwards.
+ */
+export class MockKuboApi {
+    baseUrl;
+    /** Every request the mock received, in order. */
+    requests = [];
+    /** path (no query) → canned response. */
+    responses = new Map();
+    /** The base URL this mock pretends to be (only its path/query are used). */
+    constructor(baseUrl = 'https://node.example.test') {
+        this.baseUrl = baseUrl;
+    }
+    /** Register a canned response for a Kubo `/api/v0/<path>` (path without query). */
+    on(path, spec) {
+        this.responses.set(path, spec);
+        return this;
+    }
+    /** The most recent recorded request, or undefined if none. */
+    get lastRequest() {
+        return this.requests[this.requests.length - 1];
+    }
+    /** All recorded requests whose path equals `path`. */
+    requestsFor(path) {
+        return this.requests.filter((r) => r.path === path);
+    }
+    /**
+     * A `fetch`-compatible function that records the request and returns the
+     * canned (or a default empty-JSON 200) response. Pass this to the client.
+     */
+    fetchImpl = async (input, init) => {
+        const url = new URL(typeof input === 'string' ? input : input.toString());
+        const path = url.pathname.replace(/^\/api\/v0\//, '');
+        const headers = {};
+        for (const [k, v] of Object.entries(init?.headers ?? {})) {
+            headers[k.toLowerCase()] = v;
+        }
+        const { bodyText, contentType, fileParts } = await inspectBody(init?.body, headers);
+        this.requests.push({
+            method: init?.method ?? 'GET',
+            path,
+            query: new URLSearchParams(url.search),
+            headers,
+            bodyText,
+            contentType,
+            fileParts,
+            url: url.toString(),
+        });
+        const spec = this.responses.get(path);
+        const status = spec?.status ?? 200;
+        if (spec?.text !== undefined) {
+            return new Response(spec.text, { status });
+        }
+        const payload = spec?.json ?? {};
+        return new Response(JSON.stringify(payload), {
+            status,
+            headers: { 'content-type': 'application/json' },
+        });
+    };
+}
+/**
+ * Inspect a fetch body the way a real `fetch` would surface it to Kubo:
+ * derive the effective `content-type` and, for a `multipart/form-data`
+ * (`FormData`) body, extract the file parts. This is what lets the mock
+ * ENFORCE Kubo's real upload contract (multipart + a `file` part) instead of
+ * merely recording raw bytes — the fidelity gap that let raw octet-stream
+ * uploads ship and then fail against a live daemon.
+ */
+async function inspectBody(body, headers) {
+    if (body instanceof FormData) {
+        // Real `fetch` serialises a FormData as `multipart/form-data; boundary=…`
+        // and IGNORES any hand-set content-type. Model that here.
+        const fileParts = [];
+        const textLines = [];
+        // This TS `lib` (dom) types FormData without `entries()`/an iterator, so
+        // collect the parts via `forEach` (which IS typed) then process them.
+        const entries = [];
+        body.forEach((value, field) => {
+            entries.push([field, value]);
+        });
+        for (const [field, value] of entries) {
+            if (value instanceof Blob) {
+                const bytes = new Uint8Array(await value.arrayBuffer());
+                const filename = typeof value.name === 'string'
+                    ? value.name
+                    : undefined;
+                fileParts.push({ field, filename, bytes });
+            }
+            else {
+                textLines.push(`${field}=${String(value)}`);
+            }
+        }
+        return {
+            bodyText: textLines.join('&'),
+            contentType: 'multipart/form-data',
+            fileParts,
+        };
+    }
+    return {
+        bodyText: await bodyToText(body),
+        contentType: headers['content-type'],
+    };
+}
+/** Best-effort stringify of a non-multipart fetch body for recording. */
+async function bodyToText(body) {
+    if (body === undefined || body === null)
+        return '';
+    if (typeof body === 'string')
+        return body;
+    if (body instanceof Blob)
+        return await body.text();
+    if (body instanceof URLSearchParams)
+        return body.toString();
+    if (body instanceof Uint8Array)
+        return Buffer.from(body).toString('utf8');
+    return String(body);
+}
+//# sourceMappingURL=mock-kubo.js.map

package/dist/rpc/mock-kubo.js.map

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

package/dist/site/site-management.d.ts

@@ -0,0 +1,126 @@
+/**
+ * First-class **site management** — the `site` namespace (spec user stories 4,
+ * 15; CONTEXT.md `gateway warming`). Sites are auto-discovered from MFS
+ * `/sites/*` (that is how `gateway warming`, IPNS republish, and `status` find
+ * them), so managing the sites a node serves = managing those MFS entries + the
+ * pins that back them. This module gives the operator explicit verbs for that
+ * lifecycle instead of leaving it an implicit side-effect of `deploy`:
+ *
+ *   - **list**   — enumerate `/sites/*` with each site's current CID and, when a
+ *                  same-`id` keystore key exists, its IPNS id.
+ *   - **remove** — `files/rm /sites/<id>` (the entry drops out of
+ *                  warm/republish/status auto-discovery) AND `pin/rm <cid>` so
+ *                  the content stops being served/announced and its storage is
+ *                  reclaimed.
+ *   - **add**    — place an already-imported `/ipfs/<cid>` into MFS
+ *                  `/sites/<id>` (mkdir parents / rm old / cp). See the
+ *                  DESIGN NOTE below on its relationship to `deploy`.
+ *
+ * Every verb speaks ONLY the Kubo RPC seam (MFS + pin endpoints), so the same
+ * core is usable both as a TypeScript API and behind the thin `pinnace site
+ * <verb>` CLI (CONTEXT.md `core vs cli`). Tests drive it through the recording
+ * `MockKuboApi`, never a live daemon (spec Testing Decisions).
+ *
+ * DESIGN NOTE (add vs deploy) — recorded per the task's "decide during build".
+ * `add` is a DISTINCT verb, not an alias over `deploy`. `deploy` (see
+ * `deploy-multi-target`) builds a fresh CAR, imports+pins it on every node, and
+ * THEN performs this MFS-placement step. `add` is exactly that final placement
+ * step in isolation: it takes an EXISTING CID (already imported/pinned, e.g. a
+ * known-good historical CID, or one imported out of band) and makes the node
+ * serve it under a site name, WITHOUT building or importing a CAR. Adding a site
+ * from an existing CID is a meaningful operation deploy does not cover (no fresh
+ * artifact), so it earns its own verb. Deploy is expected to REUSE
+ * {@link placeInMfs} for its placement step when it lands, keeping a single
+ * implementation of the mkdir/rm/cp sequence rather than forking it. This is
+ * NOT a new domain concept: `add` sits at the same layer as the other explicit
+ * client verbs and reuses the existing `/sites/<name>` MFS convention.
+ */
+import type { KuboRpcClient } from '../rpc/kubo-rpc-client.js';
+/** The three site-management verbs, under the `site` namespace. */
+export type SiteVerb = 'list' | 'remove' | 'add';
+/** The verbs, in a stable order (for help text / iteration). */
+export declare const SITE_VERBS: readonly SiteVerb[];
+/** One site as listed: its MFS `id`, current CID, and IPNS id if a key exists. */
+export interface SiteListing {
+    /** The site's single `id` (its MFS entry under `/sites/`). */
+    id: string;
+    /** The current content root CID (`files/stat --hash`). */
+    cid: string;
+    /** The IPNS id, if a same-`id` keystore key exists (ipfs-mode sites lack one). */
+    ipns?: string;
+}
+/** Inputs shared by every site-management verb. */
+interface SiteBaseInput {
+    /** The Kubo RPC client for the node whose sites are being managed. */
+    client: KuboRpcClient;
+    /** The MFS directory sites live under (default `/sites`). */
+    sitesDir?: string;
+}
+/** Inputs to {@link listSites}. */
+export type ListSitesInput = SiteBaseInput;
+/** Inputs to {@link removeSite}. */
+export interface RemoveSiteInput extends SiteBaseInput {
+    /** The site `id` (its MFS entry `/sites/<id>`) to remove. */
+    id: string;
+}
+/** The outcome of {@link removeSite}. */
+export interface RemoveSiteResult {
+    /** The site `id` that was removed. */
+    id: string;
+    /** The CID that backed it (undefined if it had no resolvable content). */
+    cid?: string;
+    /** True when the content was unpinned (storage reclaimed); false if unpin failed. */
+    unpinned: boolean;
+}
+/** Inputs to {@link addSite}. */
+export interface AddSiteInput extends SiteBaseInput {
+    /** The site `id` to expose it under (its MFS entry `/sites/<id>`). */
+    id: string;
+    /** The already-imported content root CID to place into MFS. */
+    cid: string;
+}
+/** The outcome of {@link addSite}. */
+export interface AddSiteResult {
+    /** The site `id` that was placed. */
+    id: string;
+    /** The CID that now backs it in MFS. */
+    cid: string;
+}
+/**
+ * **list** — enumerate the sites the node currently serves (MFS `/sites/*`),
+ * annotating each with its current CID (from `files/stat`) and, when a keystore
+ * key of the same name exists, its IPNS id (from `key/list -l`). A fresh box
+ * with no `/sites` dir yields an empty list, not an error.
+ */
+export declare function listSites(input: ListSitesInput): Promise<SiteListing[]>;
+/**
+ * **remove** — delete a site: `files/rm /sites/<name>` FIRST (so it immediately
+ * drops out of MFS auto-discovery and stops being served/announced/warmed),
+ * THEN `pin/rm <cid>` to unpin the content so its storage is reclaimed. The CID
+ * is resolved up-front with `files/stat` so we know what to unpin after the
+ * entry is gone.
+ *
+ * The MFS removal is the load-bearing step and is always attempted. The unpin
+ * is best-effort: if the content was never pinned (or is pinned indirectly),
+ * `pin/rm` errors, which is REPORTED (`unpinned: false`) rather than thrown, so
+ * a partially-pinned site still removes cleanly.
+ */
+export declare function removeSite(input: RemoveSiteInput): Promise<RemoveSiteResult>;
+/**
+ * **add** — expose an existing CID as a served site by placing it into MFS at
+ * `/sites/<name>` (the discoverable location warm/republish/status read). This
+ * is deploy's MFS-placement step in isolation (see the module DESIGN NOTE): it
+ * does NOT build or import a CAR and does NOT pin (the CID is assumed already
+ * imported/pinned on the node).
+ */
+export declare function addSite(input: AddSiteInput): Promise<AddSiteResult>;
+/**
+ * The MFS-placement step: `files/mkdir /sites --parents`, `files/rm
+ * /sites/<id> --recursive --force` (clear any prior content), then `files/cp
+ * /ipfs/<cid> /sites/<id>`. Ported from the reference prototype's deploy MFS
+ * placement (`~/searches/ipfs-hetzner/deploy-car.mjs`). Exported so `deploy`
+ * can REUSE this exact sequence rather than forking it.
+ */
+export declare function placeInMfs(client: KuboRpcClient, sitesDir: string, id: string, cid: string): Promise<void>;
+export {};
+//# sourceMappingURL=site-management.d.ts.map

package/dist/site/site-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-management.d.ts","sourceRoot":"","sources":["../../src/site/site-management.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,2BAA2B,CAAC;AAE7D,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEjD,gEAAgE;AAChE,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAA8B,CAAC;AAKzE,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC3B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,UAAU,aAAa;IACtB,sEAAsE;IACtE,MAAM,EAAE,aAAa,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mCAAmC;AACnC,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAE3C,oCAAoC;AACpC,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACrD,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;CACX;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAChC,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,YAAa,SAAQ,aAAa;IAClD,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC7B,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAa7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAC/B,KAAK,EAAE,eAAe,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAIzE;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC/B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAIf"}