@spacefast/wpcloud-sdk 0.0.2

package/README.md

@@ -0,0 +1,38 @@
+# `@spacefast/wpcloud-sdk`
+
+Generated TypeScript client for the WP.Cloud API.
+
+Use this package to call WP.Cloud from TypeScript services, automation, and
+infrastructure tools without hand-writing request serialization or response
+unwrapping code.
+
+## Install
+
+```bash
+npm install @spacefast/wpcloud-sdk
+```
+
+## Runtime Configuration
+
+```ts
+import { createClientConfig } from "@spacefast/wpcloud-sdk/runtime";
+import { createClient } from "@spacefast/wpcloud-sdk/generated/client.gen";
+
+const client = createClient(
+  createClientConfig({
+    baseUrl: "https://wp.cloud/api",
+    headers: {
+      Authorization: `Bearer ${process.env.WPCLOUD_TOKEN}`,
+    },
+  }),
+);
+```
+
+`createClientConfig` configures the generated client for WP.Cloud request and
+response conventions, including form-encoded request bodies, response envelope
+unwrapping, and timeout-aware fetch errors.
+
+## Documentation
+
+- [WP.Cloud](https://wp.cloud)
+- [WP.Cloud API docs](https://wp.cloud/docs/api)

package/dist/fake/index.d.ts

@@ -0,0 +1,4 @@
+export { makeFakeAtomic, defaultFakeFetch } from "./server.js";
+export { FakeAtomicStore, type FakeSite } from "./store.js";
+export { routeFakeRequest, type FakeResult } from "./router.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fake/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/fake/index.js

@@ -0,0 +1,3 @@
+export { makeFakeAtomic, defaultFakeFetch } from "./server.js";
+export { FakeAtomicStore } from "./store.js";
+export { routeFakeRequest } from "./router.js";

package/dist/fake/router.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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 { FakeAtomicStore } from "./store.js";
+export type FakeResult = {
+    status: number;
+    body: unknown;
+};
+/**
+ * @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 declare function routeFakeRequest(store: FakeAtomicStore, method: string, path: string, body: Record<string, unknown>): FakeResult;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/fake/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AA0C3D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,UAAU,CAmJZ"}

package/dist/fake/router.js

@@ -0,0 +1,188 @@
+/**
+ * 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 { 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 isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function asStringMap(value) {
+    const out = {};
+    if (isRecord(value)) {
+        for (const [k, v] of Object.entries(value))
+            out[k] = String(v);
+    }
+    return out;
+}
+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
+    }
+    // --- sites lifecycle ------------------------------------------------------------------------
+    // GET /get-sites/{client}[/+_data]?limit=… — one page is enough (the client stops below pageSize)
+    if (method === "GET" && head === "get-sites") {
+        return ok(store.list().map((site) => store.listEntry(site)));
+    }
+    // POST /create-site/{client}
+    if (method === "POST" && head === "create-site") {
+        const meta = asStringMap(body.meta);
+        const domainName = String(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]
+    if (method === "GET" && head === "get-site") {
+        const site = store.get(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}
+    if (method === "POST" && head === "site-persist-data") {
+        const data = isRecord(body.data) ? store.applyPersistentData(seg[1] ?? "", body.data) : null;
+        if (!data)
+            return fail(404, "Site not found.");
+        return ok({
+            response_ticket_id: "fake-persist-ticket",
+            job_id: store.nextJobId(),
+            data,
+        });
+    }
+    // /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 ?? "", String(body.value ?? ""));
+            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([]);
+        }
+    }
+    // /edge-cache/{id}/{op}/{host} — lean: benign success so publish/serve never trips on it.
+    // Real edge-cache behavior is covered by the gated `direct/` suites, not the fake.
+    if (head === "edge-cache") {
+        const op = seg[2];
+        if (op === "on" || op === "off" || op === "purge")
+            return ok([]);
+        if (op === "get")
+            return ok({ state: "enabled", status_code: 200, ddos_until: null });
+    }
+    // /ssl-info/{host} — lean: not provisioned (loadWpCloudSslInfo tolerates null). SSL = direct suites.
+    if (head === "ssl-info")
+        return fail(404, "Site not found.");
+    // 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({ keys: [] });
+        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, String(body.value));
+            return ok([]);
+        }
+    }
+    // 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

@@ -0,0 +1,10 @@
+/**
+ * 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 type { WpCloudFakeFetch } from "../runtime.js";
+export declare function makeFakeAtomic(): WpCloudFakeFetch;
+/** Process-global fake for `WP_CLOUD_PROVIDER_MODE=fake` (no per-suite override installed). */
+export declare const defaultFakeFetch: WpCloudFakeFetch;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/fake/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA6CtD,wBAAgB,cAAc,IAAI,gBAAgB,CAiBjD;AAED,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB,EAAE,gBAAmC,CAAC"}

package/dist/fake/server.js

@@ -0,0 +1,62 @@
+import { routeFakeRequest } from "./router.js";
+import { FakeAtomicStore } from "./store.js";
+/** 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) : {};
+}
+export function makeFakeAtomic() {
+    const store = new FakeAtomicStore();
+    return 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 } = routeFakeRequest(store, method, path, body);
+        return new Response(JSON.stringify(payload), {
+            status,
+            headers: { "content-type": "application/json" },
+        });
+    };
+}
+/** Process-global fake for `WP_CLOUD_PROVIDER_MODE=fake` (no per-suite override installed). */
+export const defaultFakeFetch = makeFakeAtomic();

package/dist/fake/store.d.ts

@@ -0,0 +1,67 @@
+/**
+ * In-memory state for the lean wp.cloud fake. Models only the lifecycle we captured real shapes for
+ * (sites, jobs, aliases, meta) — see internal-docs/testing-system-plan.html §4. Edge-cache / SSL /
+ * domain-claim are answered leniently by the router but not modelled here; their real behavior lives
+ * in the gated `direct/` suites.
+ */
+export type FakeSite = {
+    atomicSiteId: string;
+    domainName: string;
+    meta: Record<string, string>;
+    persistentData: Record<string, string>;
+    aliases: Set<string>;
+};
+export type FakeSiteSnapshot = {
+    atomicSiteId: string;
+    domainName: string;
+    meta: Record<string, string>;
+    persistentData: Record<string, string>;
+    aliases: string[];
+};
+export declare class FakeAtomicStore {
+    private readonly sites;
+    private readonly clientMeta;
+    private siteSeq;
+    private jobSeq;
+    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>;
+        aliases?: Iterable<string>;
+    }): FakeSite;
+    snapshot(): FakeSiteSnapshot[];
+    get(id: 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;
+    addAlias(id: string, domain: string): void;
+    removeAlias(id: string, domain: string): void;
+    aliases(id: string): string[];
+    accessLogs(id: string): Array<Record<string, unknown>> | null;
+    setClientMeta(key: string, value: string): void;
+    getClientMeta(key: string): string | undefined;
+    deleteClientMeta(key: string): boolean;
+    applyPersistentData(id: string, operations: Record<string, unknown>): Record<string, string> | 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}?meta=_data` entry shape — carries `_data` so findWpCloudSiteByTargetId works. */
+    listEntry(site: FakeSite): Record<string, unknown>;
+}
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/fake/store.js

@@ -0,0 +1,174 @@
+/**
+ * In-memory state for the lean wp.cloud fake. Models only the lifecycle we captured real shapes for
+ * (sites, jobs, aliases, meta) — see internal-docs/testing-system-plan.html §4. Edge-cache / SSL /
+ * domain-claim are answered leniently by the router but not modelled here; their real behavior lives
+ * in the gated `direct/` suites.
+ */
+const DATACENTERS = ["ams", "bur", "dca", "dfw"];
+const PHP_VERSIONS = ["8.2", "8.3", "8.4", "8.5"];
+function formFlag(value) {
+    return value === true || value === 1 || value === "1" || value === "true" || value === "on";
+}
+export class FakeAtomicStore {
+    sites = new Map();
+    clientMeta = new Map();
+    siteSeq = 151_000_000;
+    jobSeq = 154_000_000;
+    datacenters() {
+        return [...DATACENTERS];
+    }
+    phpVersions() {
+        return [...PHP_VERSIONS];
+    }
+    nextJobId() {
+        return ++this.jobSeq;
+    }
+    createSite(input) {
+        const atomicSiteId = String(++this.siteSeq);
+        this.sites.set(atomicSiteId, {
+            atomicSiteId,
+            domainName: input.domainName,
+            meta: { ...input.meta },
+            persistentData: {},
+            aliases: new Set(),
+        });
+        return {
+            job_id: this.nextJobId(),
+            atomic_site_id: Number(atomicSiteId),
+            domain_name: input.domainName,
+        };
+    }
+    ensureSite(input) {
+        const existing = this.sites.get(input.atomicSiteId);
+        if (existing)
+            return existing;
+        this.siteSeq = Math.max(this.siteSeq, Number(input.atomicSiteId) || this.siteSeq);
+        const site = {
+            atomicSiteId: input.atomicSiteId,
+            domainName: input.domainName,
+            meta: input.meta ? { ...input.meta } : {},
+            persistentData: input.persistentData ? { ...input.persistentData } : {},
+            aliases: new Set(input.aliases ?? []),
+        };
+        this.sites.set(input.atomicSiteId, site);
+        return site;
+    }
+    snapshot() {
+        return [...this.sites.values()].map((site) => ({
+            atomicSiteId: site.atomicSiteId,
+            domainName: site.domainName,
+            meta: { ...site.meta },
+            persistentData: { ...site.persistentData },
+            aliases: [...site.aliases],
+        }));
+    }
+    get(id) {
+        return this.sites.get(id);
+    }
+    delete(id) {
+        this.sites.delete(id);
+        return { job_id: this.nextJobId() };
+    }
+    list() {
+        return [...this.sites.values()];
+    }
+    setMeta(id, key, value) {
+        const site = this.sites.get(id);
+        if (site)
+            site.meta[key] = value;
+    }
+    getMeta(id, key) {
+        return this.sites.get(id)?.meta[key];
+    }
+    addAlias(id, domain) {
+        this.sites.get(id)?.aliases.add(domain);
+    }
+    removeAlias(id, domain) {
+        this.sites.get(id)?.aliases.delete(domain);
+    }
+    aliases(id) {
+        return [...(this.sites.get(id)?.aliases ?? [])];
+    }
+    accessLogs(id) {
+        const site = this.sites.get(id);
+        if (!site)
+            return null;
+        const host = [...site.aliases][0] ?? site.domainName;
+        return [
+            {
+                timestamp: Math.floor(Date.now() / 1000),
+                http_host: host,
+                request_type: "GET",
+                request_url: "/",
+                status: 200,
+                response_bytes: 1024,
+            },
+        ];
+    }
+    setClientMeta(key, value) {
+        this.clientMeta.set(key, value);
+    }
+    getClientMeta(key) {
+        return this.clientMeta.get(key);
+    }
+    deleteClientMeta(key) {
+        return this.clientMeta.delete(key);
+    }
+    applyPersistentData(id, operations) {
+        const site = this.sites.get(id);
+        if (!site)
+            return null;
+        for (const [key, operation] of Object.entries(operations)) {
+            if (!operation || typeof operation !== "object" || Array.isArray(operation))
+                continue;
+            const record = operation;
+            if (formFlag(record.delete)) {
+                delete site.persistentData[key];
+                continue;
+            }
+            site.persistentData[key] = String(record.value ?? "");
+        }
+        return this.persistentData(id);
+    }
+    persistentData(id) {
+        const site = this.sites.get(id);
+        if (!site)
+            return null;
+        return { ...site.persistentData };
+    }
+    /** `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) {
+        return {
+            atomic_site_id: site.atomicSiteId,
+            wpcom_blog_id: null,
+            domain_name: site.domainName,
+            server_pool_id: "146",
+            atomic_client_id: "168",
+            chroot_path: "/client-chroot/generic/web",
+            chroot_ssh_path: "/client-chroot/generic/ssh",
+            burst_php_conns: Number(site.meta.burst_php_conns ?? 0),
+            cache_prefix: "fake00000000000000000000000000000",
+            canonicalize_aliases: site.meta.canonicalize_aliases ?? "false",
+            db_charset: "utf8mb4",
+            db_collate: "utf8mb4_general_ci",
+            db_pass: "[REDACTED]",
+            default_php_conns: Number(site.meta.default_php_conns ?? 10),
+            php_fs_permissions: site.meta.php_fs_permissions ?? "RW",
+            php_memory_limit: Number(site.meta.php_memory_limit ?? 512),
+            php_version: site.meta.php_version ?? "8.4",
+            site_api_key: "[REDACTED]",
+            static_file_404: site.meta.static_file_404 ?? "wordpress",
+            wp_admin_user: `stattic-${site.atomicSiteId}`.slice(0, 32),
+            wp_version: "latest",
+        };
+    }
+    /** `GET /get-sites/{client}?meta=_data` entry shape — carries `_data` so findWpCloudSiteByTargetId works. */
+    listEntry(site) {
+        return {
+            atomic_site_id: Number(site.atomicSiteId),
+            domain_name: site.domainName,
+            _data: site.meta._data ?? null,
+        };
+    }
+}

package/dist/generated/client/client.gen.d.ts

@@ -0,0 +1,3 @@
+import type { Client, Config } from "./types.gen";
+export declare const createClient: (config?: Config) => Client;
+//# sourceMappingURL=client.gen.d.ts.map

package/dist/generated/client/client.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.gen.d.ts","sourceRoot":"","sources":["../../../src/generated/client/client.gen.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAA0C,MAAM,aAAa,CAAC;AAgB1F,eAAO,MAAM,YAAY,GAAI,SAAQ,MAAW,KAAG,MA2PlD,CAAC"}