@sponson/adapters 0.0.0-stage → 0.5.0

package/dist/planetscale.js

@@ -0,0 +1,311 @@
+/**
+ * PlanetScale adapter (Vitess / MySQL databases): a development branch per scope, and a password for it whose
+ * plaintext PlanetScale shows only once. The API assumptions this relies on are numbered PS1… at the top of
+ * packages/sim/src/routes/planetscale.ts and checked in docs/api-verification.md.
+ */
+import { setTimeout as sleep } from "node:timers/promises";
+import { SponsonError, canonicalJson, markerKind, sha256 } from "@sponson/core";
+import { ABSENT, assertNoPending, clientFor, deleteIgnoringNotFound, desiredSide, optionalEnv, paramError, requireEnv, requireProvider, stringParam } from "./common.js";
+import { isProviderError, listAll, obj, records, ShapeError } from "./http.js";
+const ADAPTER = "planetscale";
+/**
+ * The environment PlanetScale reads; declared once, used by the code below and by the generated docs. A service
+ * token is two values, sent as `Authorization: <id>:<token>` (PS1).
+ */
+const ABOUT = { credentialEnv: "PLANETSCALE_SERVICE_TOKEN", extraCredentialEnv: ["PLANETSCALE_SERVICE_TOKEN_ID"], baseUrlEnv: "PLANETSCALE_API_URL", title: "PlanetScale", category: "databases", detect: { deps: ["@planetscale/"], env: ["PLANETSCALE_*"], dbHosts: [".psdb.cloud"] } };
+/** PlanetScale's API base URL; `PLANETSCALE_API_URL` overrides it (the sim and tests use that). */
+export const PLANETSCALE_DEFAULT_API_URL = "https://api.planetscale.com/v1";
+/** How often a new branch is polled until it is ready, and for how long at most; both overridable from the environment. */
+const POLL_MS = { env: "SPONSON_PLANETSCALE_POLL_MS", fallback: 2000 };
+const READY_TIMEOUT_MS = { env: "SPONSON_PLANETSCALE_READY_TIMEOUT_MS", fallback: 10 * 60 * 1000 };
+/** The query a connection string ends with by default: the form PlanetScale documents for Node.js drivers. */
+const DEFAULT_CONNECTION_PARAMS = 'ssl={"rejectUnauthorized":true}';
+function client(actx) {
+    const id = requireEnv(actx.env, ABOUT.extraCredentialEnv[0], ADAPTER);
+    const secret = requireEnv(actx.env, ABOUT.credentialEnv, ADAPTER);
+    const organization = requireProvider(actx, "organization", ADAPTER);
+    const database = requireProvider(actx, "database", ADAPTER);
+    const api = clientFor(actx, ADAPTER, { baseUrl: optionalEnv(actx.env, ABOUT.baseUrlEnv) ?? PLANETSCALE_DEFAULT_API_URL, token: `${id}:${secret}`, authHeader: "header:authorization" });
+    return { api, base: `/organizations/${enc(organization)}/databases/${enc(database)}`, database };
+}
+function enc(s) {
+    return encodeURIComponent(s);
+}
+function msFromEnv(env, s) {
+    const raw = optionalEnv(env, s.env);
+    const n = Number(raw);
+    return raw !== undefined && Number.isFinite(n) && n >= 0 ? n : s.fallback;
+}
+/** `sponson-<env>-<scope>`, lowercase letters, digits and dashes only (PS14). */
+function defaultName(ctx) {
+    return `sponson-${ctx.env}-${ctx.scope}`
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-{2,}/g, "-")
+        .replace(/^-|-$/g, "");
+}
+function parseBranch(v, what) {
+    const [b] = records([v], what, ["id", "name"]);
+    const parent = b.parent_branch;
+    if (parent !== undefined && parent !== null && typeof parent !== "string")
+        throw new ShapeError(`expected ${what}.parent_branch to be a string or null`);
+    return { id: b.id, name: b.name, parent_branch: parent ?? null, production: b.production === true, ready: b.ready === true };
+}
+/** One page of a PlanetScale list: `{ data, next_page }`, the next page being `?page=<next_page>` (PS3). */
+function pageOf(body, parse) {
+    const o = obj(body, "the list");
+    if (!Array.isArray(o.data))
+        throw new ShapeError("expected `data` to be an array");
+    const items = o.data.map((v, i) => parse(v, `\`data\`[${i}]`));
+    return { items, next: typeof o.next_page === "number" ? { page: String(o.next_page) } : null };
+}
+/** The branch by name (PS2), or null when it does not exist. */
+async function getBranch(c, name) {
+    try {
+        return await c.api.get(`${c.base}/branches/${enc(name)}`, (b) => parseBranch(b, "the branch"));
+    }
+    catch (e) {
+        if (isProviderError(e, "PROVIDER_NOT_FOUND"))
+            return null;
+        throw e;
+    }
+}
+/** Poll the branch until it reports `ready` (PS4). Reads only. */
+async function waitReady(actx, c, name) {
+    const deadline = Date.now() + msFromEnv(actx.env, READY_TIMEOUT_MS);
+    for (;;) {
+        const b = await getBranch(c, name);
+        if (!b)
+            throw new SponsonError("PROVIDER_NOT_FOUND", `planetscale: branch ${name} disappeared while waiting for it to become ready`, { adapter: ADAPTER, branch: name });
+        if (b.ready)
+            return b;
+        if (Date.now() > deadline) {
+            throw new SponsonError("WAIT_TIMEOUT", `planetscale: branch ${name} is not ready after ${msFromEnv(actx.env, READY_TIMEOUT_MS)}ms (${READY_TIMEOUT_MS.env}); run again to keep waiting`, { adapter: ADAPTER, branch: name });
+        }
+        actx.log(`branch ${name} not ready yet`);
+        await sleep(msFromEnv(actx.env, POLL_MS));
+    }
+}
+const BRANCH_PREFIX = "branch:";
+/** Identity hash: name and parent, the two things that define a branch for us (as `neon.branch`). */
+function branchRecord(b) {
+    return { key: `${BRANCH_PREFIX}${b.name}`, id: b.id, hash: sha256(canonicalJson({ name: b.name, parent_branch: b.parent_branch })), label: `PlanetScale branch ${b.name}` };
+}
+function branchOutputs(b) {
+    return { name: b.name, branch_id: b.id };
+}
+/** Create the branch, or find it when it exists already (a lost answer of ours, or someone else's). */
+async function createBranch(actx, c, name, parent) {
+    try {
+        await c.api.post(`${c.base}/branches`, { name, parent_branch: parent }, (b) => parseBranch(b, "the created branch"));
+        return { branch: await waitReady(actx, c, name), created: true };
+    }
+    catch (e) {
+        // PS5: a duplicate name answers 422 (perhaps 409). Whatever the wording, the branch existing is what matters.
+        if (!isProviderError(e, ["PROVIDER_CONFLICT", "PROVIDER_INVALID"]))
+            throw e;
+        const found = await getBranch(c, name);
+        if (!found)
+            throw e;
+        // Not created by this call; the engine claims it when an earlier intent of ours named it.
+        return { branch: found.ready ? found : await waitReady(actx, c, name), created: false };
+    }
+}
+const branch = {
+    outputs: {
+        name: { available: "immediate" },
+        branch_id: { available: "immediate" },
+    },
+    defaults(params, ctx) {
+        return { parent: "main", name: defaultName(ctx), ...params };
+    },
+    async read(actx, params) {
+        if (markerKind(params.name) !== null)
+            return null;
+        const c = client(actx);
+        const found = await getBranch(c, stringParam(params, "name", ADAPTER));
+        return found ? { resources: [branchRecord(found)], outputs: branchOutputs(found) } : null;
+    },
+    diff(live, params) {
+        const name = params.name;
+        if (markerKind(name) !== null)
+            return [{ key: `${BRANCH_PREFIX}(pending)`, kind: "create", label: "PlanetScale branch", before: ABSENT, after: desiredSide(name, false) }];
+        const key = `${BRANCH_PREFIX}${String(name)}`;
+        const current = live?.resources.find((r) => r.key === key);
+        // A branch's identity is its name; re-parenting is not possible, so an existing branch is unchanged whatever `parent` says.
+        if (current)
+            return [{ key, kind: "unchanged", label: current.label ?? key }];
+        return [{ key, kind: "create", label: `PlanetScale branch ${String(name)}`, before: ABSENT, after: desiredSide(name, false) }];
+    },
+    async apply(actx, params, live) {
+        assertNoPending(params, ADAPTER);
+        const name = stringParam(params, "name", ADAPTER);
+        const key = `${BRANCH_PREFIX}${name}`;
+        if (live?.resources.some((r) => r.key === key))
+            return { resources: live.resources, outputs: live.outputs, created: [] };
+        const c = client(actx);
+        const parent = stringParam(params, "parent", ADAPTER, "main");
+        if (!(await getBranch(c, parent)))
+            throw paramError(ADAPTER, `parent branch \`${parent}\` not found in database ${c.database}`, "parent");
+        await actx.intend([key]);
+        actx.log(`create branch ${name} from ${parent}`);
+        const r = await createBranch(actx, c, name, parent);
+        return { resources: [branchRecord(r.branch)], outputs: branchOutputs(r.branch), created: r.created ? [key] : [] };
+    },
+    /** Deletes by name (PS2), and only the branch the ledger recorded: one re-created under that name by someone else is left alone. */
+    async destroy(actx, resources) {
+        const c = client(actx);
+        for (const r of resources) {
+            const name = r.key.slice(BRANCH_PREFIX.length);
+            const live = await getBranch(c, name);
+            if (!live || (r.id && live.id !== r.id))
+                continue;
+            await deleteIgnoringNotFound(c.api, `${c.base}/branches/${enc(name)}`);
+        }
+    },
+    /** Every development branch: production branches are never a scope's. */
+    async listScope(actx) {
+        const c = client(actx);
+        const all = await listAll(c.api, `${c.base}/branches`, (body) => pageOf(body, parseBranch));
+        return all.filter((b) => !b.production).map(branchRecord);
+    },
+    /** One line per branch, naming it: the line then manages exactly that branch. */
+    adopt(resources) {
+        return resources.map((r) => {
+            const name = r.key.slice(BRANCH_PREFIX.length);
+            return { id: `db-${name}`, params: { name }, keys: [r.key] };
+        });
+    },
+};
+function parsePassword(v, what) {
+    const [p] = records([v], what, ["id", "role", "username", "access_host_url"]);
+    return { id: p.id, name: typeof p.name === "string" ? p.name : "", role: p.role, username: p.username, host: p.access_host_url };
+}
+/** The create answer: the password, and its plaintext, which no other answer carries (PS8). */
+function parseCreatedPassword(v) {
+    const p = parsePassword(v, "the created password");
+    const plain = v.plain_text;
+    if (typeof plain !== "string" || plain === "")
+        throw new ShapeError("expected `plain_text` to be a non-empty string in the create answer");
+    return { ...p, plainText: plain };
+}
+const PASSWORD_PREFIX = "password:";
+/** The branch is part of the key: two branches may each have a password of the same name. */
+function passwordKey(branchName, name) {
+    return `${PASSWORD_PREFIX}${enc(branchName)}/${name}`;
+}
+function branchOfKey(key) {
+    const rest = key.slice(PASSWORD_PREFIX.length);
+    return decodeURIComponent(rest.slice(0, rest.indexOf("/")));
+}
+function passwordHash(name, role) {
+    return sha256(canonicalJson({ name, role }));
+}
+function passwordRecord(branchName, p) {
+    return { key: passwordKey(branchName, p.name), id: p.id, hash: passwordHash(p.name, p.role), label: `PlanetScale password ${p.name} on branch ${branchName}` };
+}
+function passwordOutputs(p) {
+    return { id: p.id, username: p.username, host: p.host, role: p.role };
+}
+/** The passwords of a branch named `name`; null when the branch does not exist. */
+async function findPassword(c, branchName, name) {
+    let all;
+    try {
+        all = await listAll(c.api, `${c.base}/branches/${enc(branchName)}/passwords`, (body) => pageOf(body, parsePassword));
+    }
+    catch (e) {
+        if (isProviderError(e, "PROVIDER_NOT_FOUND"))
+            return null;
+        throw e;
+    }
+    const named = all.filter((p) => p.name === name);
+    // PS9: names are not unique. Guessing could hand a dependent the wrong credential's identity.
+    if (named.length > 1) {
+        throw new SponsonError("PROVIDER_CONFLICT", `planetscale: branch ${branchName} has ${named.length} passwords named ${name}; delete the extra ones in PlanetScale, then run again`, { adapter: ADAPTER, branch: branchName, name });
+    }
+    return named[0] ?? null;
+}
+function passwordParams(params) {
+    return { branch: stringParam(params, "branch", ADAPTER), name: stringParam(params, "name", ADAPTER), role: stringParam(params, "role", ADAPTER, "admin") };
+}
+/** `mysql://<username>:<plaintext>@<access host>/<database>?<params>`, as PlanetScale documents it (PS8). */
+function connectionString(p, database, query) {
+    return `mysql://${enc(p.username)}:${enc(p.plainText)}@${p.host}/${enc(database)}${query ? `?${query}` : ""}`;
+}
+function roleChangeError(p, liveRole) {
+    return paramError(ADAPTER, `password ${p.name} on branch ${p.branch} has role ${liveRole}; PlanetScale cannot change a password's role in place, and Sponson does not replace a password on its own. ` +
+        `Give the line a new \`name\` to create a ${p.role} password (dependents then receive its value), or set \`role: ${liveRole}\`.`, "role");
+}
+const password = {
+    outputs: {
+        id: { available: "immediate" },
+        username: { available: "immediate" },
+        host: { available: "immediate" },
+        role: { available: "immediate" },
+        password: { available: "immediate", sensitive: true, once: true },
+        connection_string: { available: "immediate", sensitive: true, once: true },
+    },
+    defaults(params, ctx) {
+        return { name: defaultName(ctx), role: "admin", ...params };
+    },
+    async read(actx, params) {
+        if (markerKind(params.branch) !== null || markerKind(params.name) !== null)
+            return null;
+        const p = passwordParams(params);
+        const c = client(actx);
+        const found = await findPassword(c, p.branch, p.name);
+        // The plaintext is never readable (PS8): `password` and `connection_string` exist only in the run that creates it.
+        return found ? { resources: [passwordRecord(p.branch, found)], outputs: passwordOutputs(found) } : null;
+    },
+    diff(live, params) {
+        if (markerKind(params.branch) !== null || markerKind(params.name) !== null) {
+            return [{ key: `${PASSWORD_PREFIX}(pending)`, kind: "create", label: "PlanetScale password", before: ABSENT, after: desiredSide(params.name, false) }];
+        }
+        const p = passwordParams(params);
+        const key = passwordKey(p.branch, p.name);
+        const label = `PlanetScale password ${p.name} on branch ${p.branch}`;
+        const current = live?.resources.find((r) => r.key === key);
+        if (!current)
+            return [{ key, kind: "create", label, before: ABSENT, after: { state: "literal", value: p.role } }];
+        if (current.hash === passwordHash(p.name, p.role))
+            return [{ key, kind: "unchanged", label }];
+        // PS10: the only way to another role is a new password, and that is the plan's decision, never Sponson's.
+        throw roleChangeError(p, String(live?.outputs.role ?? "another role"));
+    },
+    async apply(actx, params, live) {
+        assertNoPending(params, ADAPTER);
+        const p = passwordParams(params);
+        const key = passwordKey(p.branch, p.name);
+        const current = live?.resources.find((r) => r.key === key);
+        if (current) {
+            if (current.hash !== passwordHash(p.name, p.role))
+                throw roleChangeError(p, String(live?.outputs.role ?? "another role"));
+            return { resources: live.resources, outputs: live.outputs, created: [] };
+        }
+        const c = client(actx);
+        if (!(await getBranch(c, p.branch)))
+            throw paramError(ADAPTER, `branch \`${p.branch}\` not found in database ${c.database}`, "branch");
+        // PS12: a password needs a ready branch; a branch an earlier run left provisioning is waited for here.
+        await waitReady(actx, c, p.branch);
+        await actx.intend([key]);
+        actx.log(`create password ${p.name} (${p.role}) on branch ${p.branch}`);
+        const created = await c.api.post(`${c.base}/branches/${enc(p.branch)}/passwords`, { name: p.name, role: p.role }, parseCreatedPassword);
+        const query = stringParam(params, "connection_params", ADAPTER, DEFAULT_CONNECTION_PARAMS);
+        const record = passwordRecord(p.branch, { ...created, name: p.name });
+        const outputs = { ...passwordOutputs(created), password: created.plainText, connection_string: connectionString(created, c.database, query) };
+        return { resources: [record], outputs, created: [key] };
+    },
+    async destroy(actx, resources) {
+        const c = client(actx);
+        for (const r of resources)
+            await deleteIgnoringNotFound(c.api, `${c.base}/branches/${enc(branchOfKey(r.key))}/passwords/${enc(r.id)}`);
+    },
+};
+/**
+ * PlanetScale (Vitess / MySQL databases): op `branch` creates a development branch per scope and waits until it
+ * is ready; op `password` creates a password on it whose `connection_string` and `password` outputs (sensitive)
+ * exist only in the run that creates it (`once`). Needs `PLANETSCALE_SERVICE_TOKEN_ID`,
+ * `PLANETSCALE_SERVICE_TOKEN` and `providers.planetscale.{organization,database}`.
+ */
+export const planetscaleAdapter = { name: ADAPTER, ops: { branch, password }, about: ABOUT };
+//# sourceMappingURL=planetscale.js.map

package/dist/planetscale.js.map

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

package/dist/providers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Every provider a repository's files can show it uses, with what to detect it by: first-class adapters from their
+ * `about` (title, category, detect), recipe providers from their file's `detect` block. `sponson init` detects from
+ * this list and the provider catalog (docs/providers.md) is generated from it, so declaring `detect` on an adapter
+ * or in a recipe file is all it takes for both; neither keeps a list of providers of its own.
+ */
+import type { ProviderDetect, Registry } from "@sponson/core";
+import { type Recipe } from "./recipes.js";
+/** A provider `sponson init` can detect: who manages it, what to detect it by, and the credential it reads. */
+export interface DetectableProvider {
+    /** The adapter's name, or the recipe's provider: what `init` reports as the finding's id. */
+    id: string;
+    /** As people write it (Vercel, Stripe). */
+    title: string;
+    /** A docs/coverage.yaml category id. */
+    category: string;
+    /** Managed by a first-class adapter, or by recipes of the generic `http` adapter. */
+    via: "adapter" | "recipe";
+    detect: ProviderDetect;
+    /** The variables its credential is read from when Sponson runs (never written into a plan). */
+    credentials: string[];
+    /** For a recipe provider, its recipe. */
+    recipe?: Recipe;
+}
+/** The detectable providers: the registry's adapters in registration order, then the recipes by provider. */
+export declare function detectableProviders(registry: Registry, recipes?: Recipe[]): DetectableProvider[];

package/dist/providers.js

@@ -0,0 +1,36 @@
+import { loadRecipes, recipeCredentialEnv } from "./recipes.js";
+/** The detectable providers: the registry's adapters in registration order, then the recipes by provider. */
+export function detectableProviders(registry, recipes = loadRecipes()) {
+    const out = [];
+    for (const name of registry.adapterNames()) {
+        const about = registry.adapter(name).about;
+        if (!about?.detect)
+            continue;
+        out.push({
+            id: name,
+            title: about.title ?? name,
+            category: about.category ?? "other",
+            via: "adapter",
+            detect: about.detect,
+            credentials: [...(about.extraCredentialEnv ?? []), about.credentialEnv],
+        });
+    }
+    const taken = new Set(out.map((p) => p.id));
+    for (const recipe of recipes) {
+        const d = recipe.detect;
+        // A provider a first-class adapter already detects keeps the adapter's lines (its recipe adds ops beside them).
+        if (!d || taken.has(recipe.provider))
+            continue;
+        out.push({
+            id: recipe.provider,
+            title: recipe.title,
+            category: recipe.category,
+            via: "recipe",
+            detect: { ...(d.deps ? { deps: d.deps } : {}), ...(d.env ? { env: d.env } : {}), ...(d.files ? { files: d.files } : {}), ...(d.db_hosts ? { dbHosts: d.db_hosts } : {}) },
+            credentials: recipeCredentialEnv(recipe),
+            recipe,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAe,MAAM,cAAc,CAAC;AAmB7E,6GAA6G;AAC7G,MAAM,UAAU,mBAAmB,CAAC,QAAkB,EAAE,UAAoB,WAAW,EAAE;IACvF,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,MAAM;YAAE,SAAS;QAC7B,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO;YACnC,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,WAAW,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;SACxE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACxB,gHAAgH;QAChH,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,SAAS;QAC/C,GAAG,CAAC,IAAI,CAAC;YACP,EAAE,EAAE,MAAM,CAAC,QAAQ;YACnB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,EAAE,QAAQ;YACb,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;YACzK,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACxC,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/recipes.d.ts

@@ -0,0 +1,167 @@
+/** Where the shipped recipe files are, in the source tree and in the published package alike. */
+export declare const RECIPES_DIR: string;
+/** The value types a recipe param takes. */
+export type RecipeParamType = "string" | "integer" | "number" | "boolean" | "list" | "map";
+/** One param a recipe op takes from the plan line. */
+export interface RecipeParam {
+    type: RecipeParamType;
+    description: string;
+    required?: boolean;
+    /** Used when the line leaves the param out. */
+    default?: unknown;
+    /** Allowed values. */
+    enum?: unknown[];
+    /** A regular expression concrete string values must match. */
+    pattern?: string;
+    /** The value the docs' example line and the recipe tests use. */
+    example?: unknown;
+}
+/** How the generic REST sim stands in for the provider in the recipe tests (`scenarios/recipes.test.ts`). */
+export interface RecipeSimHints {
+    /** The body field a create chooses the object's id with (a database name), when the provider takes one. */
+    id_from?: string;
+    /** The provider's ids are integers. */
+    numeric_ids?: boolean;
+    /** Objects to seed by path (placeholders filled from the example params): a list item's parent. */
+    objects?: Record<string, Record<string, unknown>>;
+    /** Request headers a create or update stores as fields (header → field), for an API that takes settings in headers. */
+    header_fields?: Record<string, string>;
+    /** For a create at `<collection>/{+param}`: the field the sim stores that path suffix in (an upsert by chosen id). */
+    suffix_field?: string;
+    /** The query parameter the provider names one object with, when objects are keyed by a value (`url`). */
+    item_query?: string;
+    /**
+     * The collection a resource lives in, when its create is posted to another path (Statsig adds a rule with
+     * `POST /gates/{id}/rule` and lists them at `/gates/{id}/rules`). Default: the create's path.
+     */
+    collection?: string;
+    /**
+     * A first-class sim to run the op against instead of the generic REST sim, for an API the REST sim cannot stand
+     * in for (a GraphQL API: `railway`, `fly`). Then `seed` is that sim's seed, `present` a JSON pointer into its state
+     * that exists once the op applied (and not after destroy), and `drift` its drift keys (without the provider
+     * prefix) that edit a declared field (`changed`) and remove what the op made (`missing`).
+     */
+    provider?: string;
+    /** With `provider`: the path under the sim that the API's base URL stands for (default `/<provider>`). */
+    base_path?: string;
+    seed?: Record<string, unknown>;
+    present?: string;
+    drift?: {
+        changed?: Record<string, string>;
+        missing: Record<string, string>;
+    };
+}
+/** One operation of a recipe: an `http.resource`, `http.list_item` or `http.action` spec with typed params. */
+export interface RecipeOp {
+    kind: "resource" | "list_item" | "action";
+    title: string;
+    summary: string;
+    /** The ids of the rows of docs/coverage.yaml this op covers. */
+    covers: string[];
+    params: Record<string, RecipeParam>;
+    /** The http op's params, minus `api`, `vars` and `destroy`; `{ param: <name> }` values and `{<name>}` placeholders. */
+    http: Record<string, unknown>;
+    /**
+     * What destroying a scope does with what the op made, when the line does not say (`destroy:`). Absent: delete it.
+     * `keep`: leave it (history shared beyond the scope, such as a release); a line may still say `destroy: delete`.
+     * `never`: the provider offers no way to delete it, so it is always left and `destroy: delete` is PARAM_INVALID.
+     */
+    destroy?: "keep" | "never";
+    sim?: RecipeSimHints;
+    /** For `pnpm test:live`: the environment variable supplying each param that has no usable example live. */
+    live?: {
+        params?: Record<string, string>;
+    };
+}
+/** One assumption a recipe makes about its provider's API, numbered, verified against a source or not. */
+export interface RecipeAssumption {
+    id: string;
+    text: string;
+    verified: boolean;
+    source?: string;
+}
+/** One provider's recipe file. */
+export interface Recipe {
+    provider: string;
+    title: string;
+    /** The id of a category of docs/coverage.yaml. */
+    category: string;
+    /** The date its API facts were checked against `docs`. */
+    verified_on: string;
+    docs: Array<{
+        title: string;
+        url: string;
+    }>;
+    assumptions: RecipeAssumption[];
+    /**
+     * The API block defaults: what `providers.http.<api>: { recipe: <provider> }` means. Absent for a recipe whose
+     * ops are all `http.action`s sent to an absolute `url` (the app's own endpoint): those use no API block.
+     */
+    api?: Record<string, unknown>;
+    /** For a per-account API (no default `base_url`): the base URL the docs' example block and the recipe tests use. */
+    base_url_example?: string;
+    /** How `sponson init` detects the provider, and the lines it writes for it (schema/recipe.schema.json, `detect`). */
+    detect?: RecipeDetect;
+    ops: Record<string, RecipeOp>;
+}
+/** A line `sponson init` writes for a detected recipe provider. */
+export interface RecipeStarter {
+    op: string;
+    /** The param that takes the preview's URL, as a whole value (`{ from: <deploy line>.preview_url }`). */
+    preview_url?: string;
+    /** Values written for these params (usually built from `${ctx.*}`). */
+    values?: Record<string, unknown>;
+}
+/** A recipe's `detect` block: the signals of the provider (names and files only), and init's lines for it. */
+export interface RecipeDetect {
+    deps?: string[];
+    env?: string[];
+    files?: string[];
+    db_hosts?: string[];
+    /** Default: one line for the first op. */
+    starter?: RecipeStarter[];
+    /** Where to find a param's value (`base_url` for a per-account API), by param name. */
+    where?: Record<string, string>;
+}
+/**
+ * The environment variables a recipe's API block reads its credential from, in the order the block names them.
+ * Empty for a recipe without an API block and for a token a command prints (`az`, `gcloud`: their own login).
+ */
+export declare function recipeCredentialEnv(recipe: Pick<Recipe, "api">): string[];
+/** The providers that have a recipe, sorted. */
+export declare function recipeNames(): string[];
+/**
+ * Make a recipe known for this process as if it were shipped, until the returned function is called. For tests of
+ * code that recipes drive (the adapter's own tests use it for a list item recipe); not exported by the package.
+ */
+export declare function useRecipe(recipe: Recipe): () => void;
+/** A provider's recipe; PARAM_INVALID naming the known ones when there is none. */
+export declare function loadRecipe(provider: string, param?: string): Recipe;
+/** Every shipped recipe. */
+export declare function loadRecipes(): Recipe[];
+/** A line's `recipe: <provider>.<op>`, located. */
+export declare function recipeOp(ref: unknown): {
+    recipe: Recipe;
+    name: string;
+    op: RecipeOp;
+};
+/** The API a line uses: its `api`, or for a recipe line without one, the recipe's provider. */
+export declare function lineApi(params: Record<string, unknown>): unknown;
+/** The value of every param the line sets or the recipe defaults, checked; PARAM_INVALID naming the param otherwise. */
+export declare function recipeValues(params: Record<string, unknown>): Record<string, unknown>;
+/**
+ * `tpl` with every `{ param: <name> }` replaced by its value (a param without one removes its map key or list
+ * item) and every `{ join: [...] }` by its parts joined.
+ */
+export declare function substitute(tpl: unknown, values: Record<string, unknown>): unknown;
+/**
+ * A line's params as the `http.<kind>` op reads them: unchanged without `recipe`, else the recipe's spec with the
+ * line's values filled in (`vars` holds every value, for the `{<name>}` path placeholders).
+ */
+export declare function expandRecipe(params: Record<string, unknown>, kind: RecipeOp["kind"]): Record<string, unknown>;
+/**
+ * A `providers.http.<api>` block with `recipe:`, resolved: the recipe's API defaults, then the block's own keys
+ * over them. Blocks without `recipe:` are returned as they are. The result never names the recipe, so it (and with
+ * it the ledger identity) is the same as a hand-written block with the same values.
+ */
+export declare function resolveRecipeApi(block: Record<string, unknown>, where: string): Record<string, unknown>;