@spacefast/wpcloud-sdk 0.0.23 → 0.0.26

package/dist/fake/router.js

@@ -1,329 +0,0 @@
-/**
- * Routes a parsed wp.cloud request to the in-memory store and returns the `{message, data}` envelope
- * the real API uses. Errors are `{message, data: []}` + an HTTP status with NO machine code — exactly
- * what the captured fixtures show (the control plane classifies on status + message text).
- */
-import { createHash } from "node:crypto";
-import { FakeAtomicStore } from "./store.js";
-const ok = (data) => ({ status: 200, body: { message: "OK", data } });
-const fail = (status, message) => ({
-    status,
-    body: { message, data: [] },
-});
-const RESTRICTED_DOMAINS = new Set(["wordpress.com", "wp.com", "automattic.com"]);
-function asString(value, fallback = "") {
-    return typeof value === "string" ? value : fallback;
-}
-function asStringMap(value) {
-    const out = {};
-    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-        for (const [k, v] of Object.entries(value))
-            out[k] = String(v);
-    }
-    return out;
-}
-/** The `data` form field of `POST /site-persist-data/{site}` — a bag of per-key
- *  set/delete operations, matching `FakeAtomicStore#applyPersistentData`. */
-function isPersistDataOperations(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const READABLE_CLIENT_META_KEYS = new Set([
-    "webhook_url",
-    "client_ssh_default_from",
-    "client_ssh_force_from",
-    "client_ssh_firewall",
-    "default_privacy_model",
-    "max_space_quota",
-    "skip_force_backup_db",
-]);
-const WRITABLE_CLIENT_META_KEYS = new Set([
-    "webhook_url",
-    "webhook_secret_key",
-    "client_ssh_default_from",
-    "client_ssh_force_from",
-    "client_ssh_firewall",
-    "default_privacy_model",
-    "webhook_hmac_key",
-    "skip_force_backup_db",
-]);
-/**
- * @param path  the path after `/api/v1.0/`, e.g. `create-site/minipage` or `site-meta/151/_data/get`
- *              (segments still URL-encoded; this fn decodes the ones it needs)
- * @param body  the nested-decoded request body (form-urlencoded → object)
- */
-export function routeFakeRequest(store, method, path, body) {
-    const seg = path.split("/").filter(Boolean);
-    const head = seg[0] ?? "";
-    // --- static reads ---------------------------------------------------------------------------
-    if (method === "GET" && head === "get-available-datacenters")
-        return ok(store.datacenters());
-    if (method === "GET" && head === "get-php-versions")
-        return ok(store.phpVersions());
-    if (method === "GET" && head === "check-can-host-domain") {
-        const domain = decodeURIComponent(seg[2] ?? "");
-        if (RESTRICTED_DOMAINS.has(domain))
-            return fail(400, `Restricted domain [${domain}]`);
-        if (domain.endsWith("example.com")) {
-            return fail(400, `Domain name already used [${domain}]. TXT record verification is required to bypass this check.`);
-        }
-        return ok([]); // claimable
-    }
-    // GET /get-domain-verification-code/{client}/{domain} — `data` is the bare code string
-    // (docs/wpcloud/openapi.json). Deterministic per domain so repeated DNS refreshes hand
-    // out the same TXT value, like the real API's stable per-client+domain code.
-    if (method === "GET" && head === "get-domain-verification-code") {
-        const domain = decodeURIComponent(seg[2] ?? "");
-        if (!domain)
-            return fail(400, "Missing or invalid domain name");
-        return ok(`atomic-domain-${createHash("sha256").update(domain).digest("hex")}`);
-    }
-    // GET /get-ips/{client}[/{domain}] — client IPs/CIDRs; `suggested` is only present when a
-    // domain is supplied (docs/wpcloud/openapi.json example values).
-    if (method === "GET" && head === "get-ips") {
-        const domain = decodeURIComponent(seg[2] ?? "");
-        return ok({
-            ips: ["192.0.78.128/25"],
-            ...(domain ? { suggested: ["192.0.78.150", "192.0.78.200"] } : {}),
-        });
-    }
-    // --- sites lifecycle ------------------------------------------------------------------------
-    // GET /get-sites/{client}[/_data]?limit=… — only return requested meta,
-    // matching Atomic's slash-delimited additional-meta contract.
-    if (method === "GET" && head === "get-sites") {
-        const includeData = seg.slice(2).includes("_data");
-        return ok(store.list().map((site) => store.listEntry(site, { includeData })));
-    }
-    // POST /create-site/{client}
-    if (method === "POST" && head === "create-site") {
-        const meta = asStringMap(body.meta);
-        const domainName = asString(body.domain_name, `fake-${store.nextJobId()}.wpcomstaging.com`);
-        return ok(store.createSite({ domainName, meta }));
-    }
-    // POST /delete-site/{service}/{identifier}
-    if (method === "POST" && head === "delete-site") {
-        return ok(store.delete(seg[2] ?? ""));
-    }
-    // GET /get-site/{site}[/extra] — `{site}` is a site id OR any hostname the site
-    // answers to: its own domain, or one of its aliases (see `FakeAtomicStore#resolve`).
-    if (method === "GET" && head === "get-site") {
-        const site = store.resolve(decodeURIComponent(seg[1] ?? ""));
-        return site ? ok(store.siteExtra(site)) : fail(404, "Site not found.");
-    }
-    // GET /job-completion/{id} , GET /job-status/{id} — jobs settle immediately in the fake
-    if (method === "GET" && head === "job-completion")
-        return ok("success");
-    if (method === "GET" && head === "job-status")
-        return ok({ status: "success" });
-    // POST /site-persist-data/{site} — the only endpoint in the API that documents
-    // a 429: "Site data lock could not be acquired; retry after the Retry-After
-    // header value (10 seconds)." Contention is a per-site write lock, so the
-    // refusal comes before the write is applied.
-    if (method === "POST" && head === "site-persist-data") {
-        const retryAfterSeconds = store.takePersistDataLockRefusal();
-        if (retryAfterSeconds !== null) {
-            return {
-                ...fail(429, "Site data lock could not be acquired."),
-                headers: { "retry-after": String(retryAfterSeconds) },
-            };
-        }
-        const data = isPersistDataOperations(body.data)
-            ? store.applyPersistentData(seg[1] ?? "", body.data)
-            : null;
-        if (!data)
-            return fail(404, "Site not found.");
-        return ok({
-            // "response_ticket_id — Response ticket ID to check on the status of this
-            // request." Not marked required, so a test can ask for it to be absent.
-            // `job_id` rides along exactly as the real endpoint sends it, and stays
-            // documented as "Deprecated. Internal job ID; unreliable indicator of
-            // success."
-            ...(store.persistDataOmitsResponseTicket()
-                ? {}
-                : { response_ticket_id: store.openResponseTicket() }),
-            job_id: store.nextJobId(),
-            data,
-        });
-    }
-    // POST /response-ticket/get/summary — "Retrieve metadata about the response
-    // ticket." Body carries `response-ticket-id`; 200 returns
-    // {created, created_ts, response_count, status}, 202 means "Ticket has not yet
-    // received a response; retry after 1 second.", 404 "Ticket not found (and old
-    // enough to have been deleted)."
-    if (method === "POST" && head === "response-ticket" && seg[1] === "get" && seg[2] === "summary") {
-        const poll = store.pollResponseTicket(asString(body["response-ticket-id"]));
-        if (poll === null)
-            return fail(404, "Ticket not found.");
-        if (poll === "forbidden")
-            return fail(403, "Access denied.");
-        if (poll === "accepted") {
-            // The 202 is the one success-family body the spec declares OUTSIDE the
-            // `{message, data}` envelope: its schema is
-            // {"type":"object","properties":{"Accepted":{"type":"string",
-            //  "description":"Ticket has not yet received a response; retry after 1
-            //  second."}}}. Serve it exactly that way — a caller that assumes the
-            // envelope here breaks on the first poll of a pending ticket.
-            return {
-                status: 202,
-                body: { Accepted: "Ticket has not yet received a response; retry after 1 second." },
-            };
-        }
-        return ok({
-            created: new Date().toISOString().replace("T", " ").slice(0, 19),
-            created_ts: Math.floor(Date.now() / 1000),
-            response_count: poll === "running" ? 0 : 1,
-            status: poll,
-        });
-    }
-    // /site-meta/{site}/{key}/{action}
-    if (head === "site-meta") {
-        const [, id, key, action] = seg;
-        if (method === "GET" && action === "get") {
-            // envelope `data` is the raw value string (or null) — faithful to the captured _data/get
-            return ok(store.getMeta(id ?? "", key ?? "") ?? null);
-        }
-        if (method === "POST" && (action === "update" || action === "add")) {
-            store.setMeta(id ?? "", key ?? "", asString(body.value));
-            return ok([]);
-        }
-        if (method === "POST" && action === "remove") {
-            store.removeMeta(id ?? "", key ?? "");
-            return ok([]);
-        }
-    }
-    // /site-alias/{client}/{id}/{op}[/{domain}]
-    if (method === "GET" && head === "site-alias") {
-        const id = seg[2] ?? "";
-        const op = seg[3];
-        const domain = decodeURIComponent(seg[4] ?? "");
-        if (op === "list")
-            return ok({ domains: store.aliases(id) });
-        if (op === "add") {
-            store.addAlias(id, domain);
-            return ok({ domains: store.aliases(id) });
-        }
-        if (op === "remove") {
-            store.removeAlias(id, domain);
-            return ok([]);
-        }
-    }
-    // /crontab/{site}/add|list|update/{cron_id}|remove — matches the documented
-    // envelope exactly (docs/wpcloud/openapi.json): add/update return
-    // {cron_id}, list returns the array of entries verbatim, remove returns [].
-    if (head === "crontab") {
-        const id = seg[1] ?? "";
-        const action = seg[2];
-        if (method === "POST" && action === "add") {
-            const schedule = asString(body.schedule);
-            const command = asString(body.command);
-            if (!schedule || !command)
-                return fail(400, "Invalid or empty schedule or command.");
-            const cron = store.addCron(id, { schedule, command });
-            if (!cron)
-                return fail(404, "Site not found.");
-            return ok({ cron_id: cron.cronId });
-        }
-        if (method === "GET" && action === "list") {
-            if (!store.get(id))
-                return fail(404, "Site not found.");
-            return ok(store.listCrons(id).map((cron) => ({
-                cron_id: cron.cronId,
-                schedule: cron.schedule,
-                requested_schedule: cron.requestedSchedule,
-                command: cron.command,
-            })));
-        }
-        if (method === "POST" && action === "update") {
-            const cronId = Number(seg[3] ?? "");
-            const command = asString(body.command);
-            if (!command)
-                return fail(400, "Invalid or empty command.");
-            return store.updateCron(id, cronId, command)
-                ? ok({ cron_id: cronId })
-                : fail(404, "Cron entry not found.");
-        }
-        if (method === "POST" && action === "remove") {
-            const cronId = Number(body.cron_id ?? "");
-            return store.removeCron(id, cronId) ? ok([]) : fail(404, "Cron entry not found.");
-        }
-    }
-    // /edge-cache/{id}/{op}/{host} — Atomic falls back to the primary domain
-    // when `host` is not attached, so callers must avoid issuing that request.
-    if (head === "edge-cache") {
-        const op = seg[2];
-        if (op === "on" || op === "off" || op === "purge")
-            return ok([]);
-        if (op === "get")
-            return ok({ status: 1, status_name: "Enabled", ddos_until: 0 });
-    }
-    // /ssl-info/{host} — lean: not provisioned (loadWpCloudSslInfo tolerates null). SSL = direct suites.
-    if (head === "ssl-info")
-        return fail(404, "Site not found.");
-    // POST /site-phpmyadmin/{site} — a time-limited sign-in URL for the site's
-    // own MySQL (docs/wpcloud/openapi.json: `{ url }`, 404 when the site is
-    // unknown). The token is opaque and single-use upstream, so the fake mints a
-    // fresh one per call rather than a stable value a test could match on.
-    if (method === "POST" && head === "site-phpmyadmin") {
-        const site = store.resolve(decodeURIComponent(seg[1] ?? ""));
-        if (!site)
-            return fail(404, "Site not found.");
-        const token = createHash("sha256")
-            .update(`${site.atomicSiteId}:${store.nextJobId()}`)
-            .digest("hex");
-        return ok({ url: `https://phpmyadmin.wpcloud.test/?token=${token}` });
-    }
-    // POST /site-logs/{site} — enough provider shape for the control plane's
-    // access-log normalization and hostname filtering to run in full-lane tests.
-    if (method === "POST" && head === "site-logs") {
-        const logs = store.accessLogs(seg[1] ?? "");
-        return logs ? ok({ logs }) : fail(404, "Site not found.");
-    }
-    // /client-authorized-keys/{client}/{op}[/{id}] — deploy-key registration with the
-    // platform. The full lane's local-atomic node already trusts the test deploy key via
-    // its authorized_keys, so ack add/list/remove and let real SSH carry the deploy.
-    if (head === "client-authorized-keys") {
-        const op = seg[2];
-        if (op === "list")
-            return ok({});
-        return ok([]); // add / remove
-    }
-    // /client-meta/{client}/{key}/{action}
-    if (head === "client-meta") {
-        const [, , key, action] = seg.map((part) => decodeURIComponent(part));
-        if (!key)
-            return fail(400, "Invalid key");
-        if (method === "GET" && action === "get") {
-            if (!READABLE_CLIENT_META_KEYS.has(key))
-                return fail(400, "Invalid key");
-            const value = store.getClientMeta(key);
-            return value === undefined ? fail(404, "Not Found") : ok(value);
-        }
-        if (method === "GET" && action === "remove") {
-            if (!WRITABLE_CLIENT_META_KEYS.has(key))
-                return fail(400, "Invalid key");
-            store.deleteClientMeta(key);
-            return ok([]);
-        }
-        if (method === "POST" && (action === "update" || action === "add")) {
-            if (!WRITABLE_CLIENT_META_KEYS.has(key))
-                return fail(400, "Invalid key");
-            if (body.value === undefined || body.value === null || body.value === "") {
-                return fail(400, "A value must be provided");
-            }
-            if (action === "update" && store.getClientMeta(key) === undefined) {
-                return fail(404, "Not Found");
-            }
-            store.setClientMeta(key, asString(body.value));
-            return ok([]);
-        }
-    }
-    // POST /metrics/{type}/{key}[/summarize]
-    if (method === "POST" && head === "metrics") {
-        const type = decodeURIComponent(seg[1] ?? "");
-        const key = decodeURIComponent(seg[2] ?? "");
-        const summarize = seg[3] === "summarize";
-        store.recordMetricsRequest({ type, key, summarize, body });
-        return ok(store.metricsResponse(type, key));
-    }
-    // Anything the control plane calls that we don't model: surface it loudly, don't silently pass.
-    return fail(404, `fake_endpoint_not_implemented: ${method} /${path}`);
-}

package/dist/fake/server.d.ts

@@ -1,28 +0,0 @@
-import type { WpCloudFakeFetch } from "../runtime.js";
-import { FakeAtomicStore } from "./store.js";
-/**
- * Same fake as `makeFakeAtomic()`, but also hands back the underlying store
- * so a test can assert on recorded state directly (house rule: assert the
- * effect, not that a mock was called) — e.g. crontab registration, aliases,
- * persistent data.
- */
-export declare function makeFakeAtomicWithStore(options?: {
-    siteSequenceStart?: number;
-}): {
-    fetch: WpCloudFakeFetch;
-    store: FakeAtomicStore;
-};
-export declare function makeFakeAtomic(options?: {
-    siteSequenceStart?: number;
-}): WpCloudFakeFetch;
-/**
- * Process-global fake for `WP_CLOUD_PROVIDER_MODE=fake` (no per-suite override
- * installed). The site sequence starts at a per-process random offset: several
- * processes can share one database in fake mode (the e2e seed script on the
- * host, the control-plane container) and each runs its own store — with a
- * fixed base every process mints atomic_site_id 151000001 first and collides
- * on the DB's unique provider_ref index. Per-suite `makeFakeAtomic()` stores
- * keep the deterministic default.
- */
-export declare const defaultFakeFetch: WpCloudFakeFetch;
-//# sourceMappingURL=server.d.ts.map

package/dist/fake/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/fake/server.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA+D7C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG;IACrF,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,EAAE,eAAe,CAAC;CACxB,CAoBA;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,gBAAgB,CAE7F;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAE7B,CAAC"}

package/dist/fake/server.js

@@ -1,108 +0,0 @@
-/**
- * The lean wp.cloud fake exposed as a `fetch`-shaped function — the same seam `wpCloudRawFetch` uses.
- * `makeFakeAtomic()` gives a fresh, isolated store (per-suite use via `setWpCloudFakeFetch`);
- * `defaultFakeFetch` is a process-global instance for env-driven `WP_CLOUD_PROVIDER_MODE=fake`.
- */
-import { createHash, randomInt } from "node:crypto";
-import { routeFakeRequest } from "./router.js";
-import { FakeAtomicStore } from "./store.js";
-let fakeStoreOrdinal = 0;
-function defaultSiteSequenceStart() {
-    // Bun's isolated test worker updates `process.argv[1]` to the active test
-    // file. Hash that real file identity plus the process and store ordinal so
-    // DB-backed files sharing Postgres never restart at the same provider ref.
-    // This is deterministic input, not random test data; explicit starts remain
-    // available for tests that assert exact captured provider IDs.
-    const identity = [
-        process.env.GITHUB_RUN_ID ?? "local",
-        process.env.GITHUB_RUN_ATTEMPT ?? "0",
-        process.ppid,
-        process.pid,
-        process.argv[1] ?? "unknown",
-        fakeStoreOrdinal++,
-    ].join("\0");
-    const digest = createHash("sha256").update(identity).digest();
-    return 1_000_000_000_000 + digest.readUIntBE(0, 6);
-}
-/** Decode an `application/x-www-form-urlencoded` body, un-nesting `key[child]` / `key[]` keys. */
-function parseNestedForm(raw) {
-    const out = {};
-    for (const [rawKey, value] of new URLSearchParams(raw)) {
-        const segs = rawKey.replace(/\]/g, "").split("[");
-        let node = out;
-        for (let i = 0; i < segs.length; i++) {
-            const key = segs[i];
-            const last = i === segs.length - 1;
-            if (last) {
-                if (key === "" && Array.isArray(node))
-                    node.push(value);
-                else
-                    node[key] = value;
-            }
-            else {
-                const container = node;
-                const nextIsArray = segs[i + 1] === "";
-                container[key] ??= nextIsArray ? [] : {};
-                node = container[key];
-            }
-        }
-    }
-    return out;
-}
-async function readBody(input, init) {
-    let raw = "";
-    const body = init?.body;
-    if (typeof body === "string")
-        raw = body;
-    else if (body instanceof URLSearchParams)
-        raw = body.toString();
-    else if (input instanceof Request) {
-        try {
-            raw = await input.text();
-        }
-        catch {
-            raw = "";
-        }
-    }
-    return raw ? parseNestedForm(raw) : {};
-}
-/**
- * Same fake as `makeFakeAtomic()`, but also hands back the underlying store
- * so a test can assert on recorded state directly (house rule: assert the
- * effect, not that a mock was called) — e.g. crontab registration, aliases,
- * persistent data.
- */
-export function makeFakeAtomicWithStore(options = {}) {
-    const store = new FakeAtomicStore({
-        siteSequenceStart: options.siteSequenceStart ?? defaultSiteSequenceStart(),
-    });
-    const fetch = async (input, init) => {
-        const rawUrl = input instanceof Request ? input.url : String(input);
-        const url = new URL(rawUrl);
-        // path after /api/v1.0/, trailing slash trimmed; segments stay encoded (router decodes its own)
-        const path = url.pathname.replace(/^.*\/api\/v1\.0\//, "").replace(/\/+$/, "");
-        const method = (init?.method ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
-        const body = await readBody(input, init);
-        const { status, body: payload, headers } = routeFakeRequest(store, method, path, body);
-        return new Response(JSON.stringify(payload), {
-            status,
-            headers: { "content-type": "application/json", ...headers },
-        });
-    };
-    return { fetch, store };
-}
-export function makeFakeAtomic(options = {}) {
-    return makeFakeAtomicWithStore(options).fetch;
-}
-/**
- * Process-global fake for `WP_CLOUD_PROVIDER_MODE=fake` (no per-suite override
- * installed). The site sequence starts at a per-process random offset: several
- * processes can share one database in fake mode (the e2e seed script on the
- * host, the control-plane container) and each runs its own store — with a
- * fixed base every process mints atomic_site_id 151000001 first and collides
- * on the DB's unique provider_ref index. Per-suite `makeFakeAtomic()` stores
- * keep the deterministic default.
- */
-export const defaultFakeFetch = makeFakeAtomic({
-    siteSequenceStart: 151_000_000 + randomInt(0, 800_000) * 1_000,
-});

package/dist/fake/store.d.ts

@@ -1,157 +0,0 @@
-export type FakeCronEntry = {
-    cronId: number;
-    schedule: string;
-    requestedSchedule: string;
-    command: string;
-};
-export type FakeSite = {
-    atomicSiteId: string;
-    domainName: string;
-    meta: Record<string, string>;
-    persistentData: Record<string, string>;
-    persistentDataEnv: Record<string, boolean>;
-    aliases: Set<string>;
-    crons: FakeCronEntry[];
-};
-export type FakeSiteSnapshot = {
-    atomicSiteId: string;
-    domainName: string;
-    meta: Record<string, string>;
-    persistentData: Record<string, string>;
-    persistentDataEnv: Record<string, boolean>;
-    aliases: string[];
-};
-export type FakeMetricsRequest = {
-    type: string;
-    key: string;
-    summarize: boolean;
-    body: Record<string, unknown>;
-};
-/**
- * One outcome of a `POST /response-ticket/get/summary` poll.
- * `accepted` is the 202 — docs: "Ticket has not yet received a response; retry
- * after 1 second." The next four are the ticket `status` strings the API
- * enumerates on `POST /response-ticket/multi-status`: "Object mapping each
- * requested ticket ID to its status string ("success", "failure", "running",
- * or "unknown")." `forbidden` is the API-wide auth refusal (403 "Access
- * denied."), which the ticket endpoints do not document either way — it is the
- * unverified-authorization case the audit flagged.
- */
-export type FakeResponseTicketPoll = "accepted" | "running" | "unknown" | "success" | "failure" | "forbidden";
-export type FakePersistDataBehavior = {
-    /**
-     * Outcomes served to successive polls of every response ticket minted from
-     * here on; the last entry repeats. Default: the write is already applied when
-     * the fake answers, so its ticket reports success on the first poll.
-     */
-    ticketPolls: FakeResponseTicketPoll[];
-    /** Answer without `response_ticket_id` — the docs do not mark it required. */
-    omitResponseTicket: boolean;
-    /** Consecutive documented 429s to serve before accepting the write. */
-    lockRefusals: number;
-    /** `Retry-After` on those 429s. Docs say the provider asks for 10 seconds. */
-    retryAfterSeconds: number;
-};
-export declare class FakeAtomicStore {
-    private readonly sites;
-    private readonly clientMeta;
-    private readonly metricsResponses;
-    private readonly metricRequestLog;
-    private readonly responseTickets;
-    private persistDataBehavior;
-    private siteSeq;
-    private jobSeq;
-    private cronSeq;
-    private ticketSeq;
-    constructor(options?: {
-        siteSequenceStart?: number;
-    });
-    datacenters(): string[];
-    phpVersions(): string[];
-    nextJobId(): number;
-    createSite(input: {
-        domainName: string;
-        meta: Record<string, string>;
-    }): {
-        job_id: number;
-        atomic_site_id: number;
-        domain_name: string;
-    };
-    ensureSite(input: {
-        atomicSiteId: string;
-        domainName: string;
-        meta?: Record<string, string>;
-        persistentData?: Record<string, string>;
-        persistentDataEnv?: Record<string, boolean>;
-        aliases?: Iterable<string>;
-    }): FakeSite;
-    snapshot(): FakeSiteSnapshot[];
-    get(id: string): FakeSite | undefined;
-    /**
-     * Atomic's `get_site_by_site_id_or_domain`: an argument containing a dot is
-     * matched against `atomic_site.domain_name` first, then against the alias
-     * table (`atomic_domain` joined onto `atomic_site`); anything else is a site
-     * id. This is what lets one `get-site` call answer "who holds this hostname?".
-     */
-    resolve(idOrDomain: string): FakeSite | undefined;
-    delete(id: string): {
-        job_id: number;
-    };
-    list(): FakeSite[];
-    setMeta(id: string, key: string, value: string): void;
-    getMeta(id: string, key: string): string | undefined;
-    removeMeta(id: string, key: string): void;
-    addAlias(id: string, domain: string): void;
-    removeAlias(id: string, domain: string): void;
-    aliases(id: string): string[];
-    addCron(id: string, input: {
-        schedule: string;
-        command: string;
-    }): FakeCronEntry | null;
-    listCrons(id: string): FakeCronEntry[];
-    updateCron(id: string, cronId: number, command: string): boolean;
-    removeCron(id: string, cronId: number): boolean;
-    accessLogs(id: string): Array<Record<string, unknown>> | null;
-    setClientMeta(key: string, value: string): void;
-    getClientMeta(key: string): string | undefined;
-    deleteClientMeta(key: string): boolean;
-    setMetricsResponse(type: string, key: string, response: Record<string, unknown>): void;
-    metricsResponse(type: string, key: string): Record<string, unknown>;
-    recordMetricsRequest(request: FakeMetricsRequest): void;
-    metricsRequests(): FakeMetricsRequest[];
-    applyPersistentData(id: string, operations: Record<string, unknown>): Record<string, string> | null;
-    /** Shape the next `POST /site-persist-data/{site}` answers a test needs. */
-    setPersistDataBehavior(input: Partial<FakePersistDataBehavior>): void;
-    /**
-     * Consumes one pending lock refusal. Returns the `Retry-After` seconds to
-     * send with the documented 429, or null when the write should be accepted.
-     * Docs, `POST /site-persist-data/{site}` 429: "Site data lock could not be
-     * acquired; retry after the Retry-After header value (10 seconds)."
-     */
-    takePersistDataLockRefusal(): number | null;
-    persistDataOmitsResponseTicket(): boolean;
-    /**
-     * Mints a ticket id in the shape of the real capture at
-     * `e2e-tests/fixtures/wpcloud-snapshots/site-lifecycle/4a94e336931c035047b5c3b39e2832c5258c0095623100933c5345a812c4b9a8.json`,
-     * whose persist-data response carried
-     * `"response_ticket_id": "6a3aeb00aec214efed259911342.54f874b098adb09f.1"` —
-     * three dot-separated segments, not the two-segment `67a3f000.abc123` the
-     * OpenAPI example shows.
-     */
-    openResponseTicket(): string;
-    /**
-     * One `POST /response-ticket/get/summary` poll: consumes the head outcome,
-     * the last one repeating forever. null means the provider has no such ticket
-     * (the documented 404).
-     */
-    pollResponseTicket(id: string): FakeResponseTicketPoll | null;
-    persistentData(id: string): Record<string, string> | null;
-    /** `GET /get-site/{id}/extra` shape — note `_data` is intentionally ABSENT (faithful to the real
-     *  endpoint, which omits it; the marker lives only on the list + site-meta endpoints). */
-    siteExtra(site: FakeSite): Record<string, unknown>;
-    /** `GET /get-sites/{client}/_data/` entry shape. */
-    listEntry(site: FakeSite, options: {
-        includeData: boolean;
-    }): Record<string, unknown>;
-}
-//# sourceMappingURL=store.d.ts.map

package/dist/fake/store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/fake/store.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,GAC9B,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,GACT,SAAS,GACT,WAAW,CAAC;AAEhB,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,WAAW,EAAE,sBAAsB,EAAE,CAAC;IACtC,8EAA8E;IAC9E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAgBF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8C;IAC/E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA+C;IAC/E,OAAO,CAAC,mBAAmB,CAAiE;IAC5F,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;KAAO;IAIxD,WAAW,IAAI,MAAM,EAAE;IAGvB,WAAW,IAAI,MAAM,EAAE;IAGvB,SAAS,IAAI,MAAM;IAInB,UAAU,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;;;;;IAkBtE,UAAU,CAAC,KAAK,EAAE;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC5B,GAAG,QAAQ;IAiBZ,QAAQ,IAAI,gBAAgB,EAAE;IAW9B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIrC;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAUjD,MAAM,CAAC,EAAE,EAAE,MAAM;;;IAIjB,IAAI,IAAI,QAAQ,EAAE;IAGlB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI9C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAGpD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAIlC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAGnC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAGtC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE;IAI7B,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,GAAG,IAAI;IAYvF,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE;IAGtC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAMhE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAQ/C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI;IAgB7D,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAGxC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAG9C,gBAAgB,CAAC,GAAG,EAAE,MAAM;IAI5B,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAG/E,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGnE,oBAAoB,CAAC,OAAO,EAAE,kBAAkB;IAGhD,eAAe,IAAI,kBAAkB,EAAE;IAIvC,mBAAmB,CACjB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAmBhC,4EAA4E;IAC5E,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAI9D;;;;;OAKG;IACH,0BAA0B,IAAI,MAAM,GAAG,IAAI;IAM3C,8BAA8B,IAAI,OAAO;IAIzC;;;;;;;OAOG;IACH,kBAAkB,IAAI,MAAM;IAQ5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAM7D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzD;8FAC0F;IAC1F,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA0BlD,oDAAoD;IACpD,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOtF"}