@sponson/adapters 0.4.0 → 0.5.0

package/dist/launchdarkly.js

@@ -0,0 +1,337 @@
+/**
+ * LaunchDarkly adapter: op `flag_target` serves one variation of a feature flag to one individual target (a context
+ * key of a context kind, such as a preview URL or `pr-42`) in one environment, and removes exactly that target on
+ * destroy. Writes are LaunchDarkly semantic patches (`addTargets` / `removeTargets`); the API assumptions are
+ * numbered LD1… at the top of packages/sim/src/routes/launchdarkly.ts and checked in docs/api-verification.md.
+ */
+import { SponsonError, canonicalJson, markerKind, sha256 } from "@sponson/core";
+import { assertNoPending, clientFor, desiredSide, optionalEnv, paramError, requireEnv, requireProvider, stringParam } from "./common.js";
+import { ShapeError, isObject, isProviderError, obj, records } from "./http.js";
+const ADAPTER = "launchdarkly";
+/** The environment LaunchDarkly reads; declared once, used by the code below and by the generated docs (`about`). */
+const ABOUT = { credentialEnv: "LAUNCHDARKLY_ACCESS_TOKEN", baseUrlEnv: "LAUNCHDARKLY_API_URL", title: "LaunchDarkly", category: "flags", detect: { deps: ["@launchdarkly/", "launchdarkly-node-server-sdk", "launchdarkly-js-client-sdk", "launchdarkly-react-client-sdk"], env: ["LAUNCHDARKLY_*"] } };
+/** LaunchDarkly's REST API base URL (LD1). `LAUNCHDARKLY_API_URL` overrides it: the sim, or a federal or EU instance. */
+export const LAUNCHDARKLY_DEFAULT_API_URL = "https://app.launchdarkly.com/api/v2";
+/** The media type that makes a PATCH body a semantic patch rather than a JSON patch (LD4). */
+const SEMANTIC_PATCH = "application/json; domain-model=launchdarkly.semanticpatch";
+/** A concurrent change answers 409, to be retried (LD6); the instructions are idempotent, so they are re-sent. */
+const CONFLICT_ATTEMPTS = 3;
+/** The context kind of a target when the line does not name one, as in LaunchDarkly itself (LD5). */
+const DEFAULT_CONTEXT_KIND = "user";
+function api(actx) {
+    const token = requireEnv(actx.env, ABOUT.credentialEnv, ADAPTER);
+    // LD1: the token is the whole Authorization value, no `Bearer`.
+    return clientFor(actx, ADAPTER, { baseUrl: optionalEnv(actx.env, ABOUT.baseUrlEnv) ?? LAUNCHDARKLY_DEFAULT_API_URL, token, authHeader: "header:authorization" });
+}
+function targetOf(actx, params) {
+    return {
+        project: requireProvider(actx, "project", ADAPTER),
+        environment: requireProvider(actx, "environment", ADAPTER),
+        flag: stringParam(params, "flag", ADAPTER),
+        contextKind: stringParam(params, "context_kind", ADAPTER, DEFAULT_CONTEXT_KIND),
+        key: stringParam(params, "key", ADAPTER),
+    };
+}
+const KEY_PREFIX = "target:";
+/**
+ * `target:<flag>:<contextKind>:<key>`. The project and environment are not repeated: they are the provider block
+ * (`providers.launchdarkly`), which the ledger already keys every resource by, and `diff` (which must name the key
+ * of a target that does not exist yet) only sees the line's params. LaunchDarkly flag keys and context kinds never
+ * contain `:`, so the context key (a URL may) is everything after the second separator.
+ */
+function resourceKey(t) {
+    return `${KEY_PREFIX}${t.flag}:${t.contextKind}:${t.key}`;
+}
+function parseKey(key) {
+    if (!key.startsWith(KEY_PREFIX))
+        return null;
+    const [flag, contextKind, ...rest] = key.slice(KEY_PREFIX.length).split(":");
+    if (!flag || !contextKind || rest.length === 0)
+        return null;
+    return { flag, contextKind, key: rest.join(":") };
+}
+function flagPath(t) {
+    return `/flags/${encodeURIComponent(t.project)}/${encodeURIComponent(t.flag)}`;
+}
+function targetId(contextKind, key) {
+    return `${contextKind}\u0000${key}`;
+}
+// ---------------------------------------------------------------------------
+// Reading a flag (LD2, LD3)
+// ---------------------------------------------------------------------------
+function parseVariations(v) {
+    return records(v, "`variations`", ["_id"]).map((x) => ({ _id: x._id, value: x.value, ...(typeof x.name === "string" ? { name: x.name } : {}) }));
+}
+/** `targets` and `contextTargets` of one environment, merged; empty placeholder entries carry nothing (LD3). */
+function parseTargets(env, variations) {
+    const out = new Map();
+    for (const field of ["targets", "contextTargets"]) {
+        const list = env[field] ?? [];
+        if (!Array.isArray(list))
+            throw new ShapeError(`expected \`${field}\` to be an array`);
+        list.forEach((item, i) => {
+            const t = obj(item, `${field}[${i}]`);
+            const kind = typeof t.contextKind === "string" && t.contextKind !== "" ? t.contextKind : DEFAULT_CONTEXT_KIND;
+            if (!Array.isArray(t.values) || t.values.some((v) => typeof v !== "string"))
+                throw new ShapeError(`expected ${field}[${i}].values to be a list of strings`);
+            if (typeof t.variation !== "number" || !Number.isInteger(t.variation) || t.variation < 0 || t.variation >= variations)
+                throw new ShapeError(`expected ${field}[${i}].variation to index \`variations\``);
+            for (const key of t.values)
+                out.set(targetId(kind, key), t.variation);
+        });
+    }
+    return out;
+}
+/** The flag with `environment`'s targets; an environment the answer lacks is not found (LD2). */
+function flagShape(environment, flagKey) {
+    return (body) => {
+        const b = obj(body, "the flag");
+        const variations = parseVariations(b.variations);
+        const envs = obj(b.environments ?? {}, "`environments`");
+        const env = envs[environment];
+        if (env === undefined)
+            return { missingEnvironment: true };
+        if (!isObject(env))
+            throw new ShapeError(`expected environments.${environment} of flag ${flagKey} to be an object`);
+        return { variations, targets: parseTargets(env, variations.length) };
+    };
+}
+function checkFlag(t, f) {
+    if ("missingEnvironment" in f)
+        throw new SponsonError("PROVIDER_NOT_FOUND", `${ADAPTER}: flag ${t.flag} in project ${t.project} has no environment ${t.environment}`, { adapter: ADAPTER, environment: t.environment });
+    return f;
+}
+async function loadFlag(client, t) {
+    return checkFlag(t, await client.get(`${flagPath(t)}?env=${encodeURIComponent(t.environment)}`, flagShape(t.environment, t.flag)));
+}
+function currentVariation(f, t) {
+    const i = f.targets.get(targetId(t.contextKind, t.key));
+    return i === undefined ? undefined : f.variations[i];
+}
+// ---------------------------------------------------------------------------
+// Choosing a variation
+// ---------------------------------------------------------------------------
+/**
+ * Does `v` answer to the plan's `variation`? A string matches a variation's name; any value matches a variation
+ * whose value is equal (a string also matches the JSON spelling of a non-string value: `"true"`, `"42"`).
+ */
+function matches(v, wanted) {
+    if (typeof wanted === "string" && (v.name === wanted || (typeof v.value !== "string" && canonicalJson(v.value) === wanted)))
+        return true;
+    return canonicalJson(v.value) === canonicalJson(wanted);
+}
+function resolveVariation(f, t, wanted) {
+    const found = f.variations.filter((v) => matches(v, wanted));
+    if (found.length === 1)
+        return found[0];
+    const known = f.variations.map(describe).join(", ");
+    const why = found.length === 0 ? "has no variation" : "has several variations matching";
+    throw paramError(ADAPTER, `flag ${t.flag} ${why} ${canonicalJson(wanted)} (variations: ${known})`, "variation");
+}
+function describe(v) {
+    const value = canonicalJson(v.value);
+    return v.name ? `${v.name} (${value})` : value;
+}
+/** What the plan asks for; `true` when absent (turn a boolean flag on for the target). */
+function wantedVariation(params) {
+    return params.variation ?? true;
+}
+// ---------------------------------------------------------------------------
+// Records and outputs
+// ---------------------------------------------------------------------------
+/**
+ * The hash covers the one field the plan controls: which variation the target is served, by its stable `_id`. The
+ * id is the target itself (not the variation), so a target moved to another variation is `changed` drift rather
+ * than "replaced".
+ */
+function record(t, v) {
+    return { key: resourceKey(t), id: `${t.contextKind}:${t.key}`, hash: sha256(canonicalJson({ variation: v._id })), label: `LaunchDarkly ${t.flag} → ${t.contextKind} ${t.key}` };
+}
+function outputsOf(v) {
+    return { variation_id: v._id, variation_name: v.name ?? "", variation_value: canonicalJson(v.value) };
+}
+function stateOf(t, v) {
+    return { resources: [record(t, v)], outputs: outputsOf(v) };
+}
+function instruction(kind, t, v) {
+    return { kind, contextKind: t.contextKind, values: [t.key], variationId: v._id };
+}
+/** One semantic patch. A 405 means the environment needs an approval request, which Sponson does not open (LD6). */
+async function patch(actx, client, t, instructions) {
+    const body = { environmentKey: t.environment, instructions, comment: `sponson ${actx.ctx.scope}` };
+    try {
+        // Add and remove are set operations, so sending them twice is harmless (LD5): retried like a GET.
+        return checkFlag(t, await client.patch(flagPath(t), body, flagShape(t.environment, t.flag), { idempotent: true, contentType: SEMANTIC_PATCH }));
+    }
+    catch (e) {
+        if (isProviderError(e) && e.details.status === 405) {
+            throw new SponsonError("PROVIDER_INVALID", `${ADAPTER}: environment ${t.environment} requires approval for changes to flag ${t.flag}; Sponson does not open approval requests. Use an environment without required approvals for previews.`, { ...e.details });
+        }
+        throw e;
+    }
+}
+/** Run `step` again when LaunchDarkly reports a concurrent change (409, LD6); each step re-reads the flag. */
+async function retryingConflicts(step) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await step();
+        }
+        catch (e) {
+            if (!isProviderError(e, "PROVIDER_CONFLICT") || attempt >= CONFLICT_ATTEMPTS)
+                throw e;
+        }
+    }
+}
+function confirm(t, after, desired) {
+    const now = currentVariation(after, t);
+    if ((desired === null && now === undefined) || (desired !== null && now?._id === desired._id))
+        return;
+    throw new SponsonError("PROVIDER_RESPONSE", `${ADAPTER}: PATCH ${flagPath(t)} succeeded but ${t.contextKind} ${t.key} is ${now ? `served ${describe(now)}` : "not targeted"} afterwards`, { adapter: ADAPTER });
+}
+// ---------------------------------------------------------------------------
+// The op
+// ---------------------------------------------------------------------------
+function pending(params) {
+    return ["flag", "key", "context_kind"].some((p) => markerKind(params[p]) !== null);
+}
+function diffTarget(live, params) {
+    const t = { flag: part(params.flag), contextKind: part(params.context_kind) || DEFAULT_CONTEXT_KIND, key: part(params.key) };
+    const key = resourceKey(t);
+    const current = live?.resources.find((r) => r.key === key);
+    const wanted = wantedVariation(params);
+    const label = `LaunchDarkly ${t.flag} → ${t.contextKind} ${t.key}`;
+    const marker = markerKind(wanted);
+    if (marker === "keep") {
+        if (current)
+            return { key, kind: "unchanged", label };
+        throw paramError(ADAPTER, `${label} is declared \`variation: { keep: true }\` but is not targeted, so there is no variation to keep`, "variation");
+    }
+    const after = marker === null ? { state: "literal", value: canonicalJson(wanted) } : desiredSide(wanted, false);
+    if (!current || !live)
+        return { key, kind: "create", label, before: { state: "absent" }, after };
+    const liveVariation = { name: String(live.outputs.variation_name ?? "") || undefined, value: JSON.parse(String(live.outputs.variation_value)) };
+    if (marker === null && matches(liveVariation, wanted))
+        return { key, kind: "unchanged", label };
+    return { key, kind: "update", label, before: { state: "literal", value: describe(liveVariation) }, after };
+}
+function part(v) {
+    if (v === undefined || v === null || v === "")
+        return "";
+    return markerKind(v) !== null ? "(pending)" : String(v);
+}
+/** A LaunchDarkly environment key that names a production environment unless the block says otherwise. */
+const PRODUCTION_KEY = /prod/i;
+/**
+ * Whether the block's environment is production, for Sponson's approval gate: `production: true|false` when the block
+ * says, else whether the environment key looks like one (`production`, `prod`, `prod-eu`). A key that only looks like
+ * one (`preprod`) opts out with `production: false`. Only `providers.launchdarkly` decides; LaunchDarkly's own
+ * "critical environment" setting is not read, since the gate runs before any provider call.
+ */
+function writesEnvironment(_params, _ctx, provider = {}) {
+    const declared = provider.production;
+    if (declared !== undefined && typeof declared !== "boolean") {
+        throw new SponsonError("PLAN_INVALID", `${ADAPTER}: providers.launchdarkly.production must be true or false`, { adapter: ADAPTER, key: "providers.launchdarkly.production" });
+    }
+    const production = declared ?? (typeof provider.environment === "string" && PRODUCTION_KEY.test(provider.environment));
+    return production ? "production" : null;
+}
+const flag_target = {
+    outputs: { variation_id: { available: "immediate" }, variation_name: { available: "immediate" }, variation_value: { available: "immediate" } },
+    writesEnvironment,
+    /** The target key defaults to the scope (`pr-42`); the context kind to `user`; the variation to `true`. */
+    defaults(params, ctx) {
+        return { key: ctx.scope, context_kind: DEFAULT_CONTEXT_KIND, variation: true, ...params };
+    },
+    async read(actx, params) {
+        // The target key may come from a line not yet applied (a preview URL): nothing to read yet.
+        if (pending(params))
+            return null;
+        const t = targetOf(actx, params);
+        const f = await loadFlag(api(actx), t);
+        const wanted = wantedVariation(params);
+        // An unknown or ambiguous variation is a plan error, reported at plan time.
+        if (markerKind(wanted) === null)
+            resolveVariation(f, t, wanted);
+        const v = currentVariation(f, t);
+        return v ? stateOf(t, v) : null;
+    },
+    diff(live, params) {
+        return [diffTarget(live, params)];
+    },
+    async apply(actx, params) {
+        assertNoPending(params, ADAPTER);
+        const t = targetOf(actx, params);
+        const client = api(actx);
+        const wanted = wantedVariation(params);
+        return retryingConflicts(async () => {
+            // Always from a fresh read: `live` may be stale, and a target can only be in one variation at a time.
+            const f = await loadFlag(client, t);
+            const current = currentVariation(f, t);
+            const desired = markerKind(wanted) === "keep" ? current : resolveVariation(f, t, wanted);
+            if (!desired)
+                throw paramError(ADAPTER, `${t.contextKind} ${t.key} is declared \`variation: { keep: true }\` but flag ${t.flag} does not target it`, "variation");
+            if (current?._id === desired._id)
+                return { ...stateOf(t, current), created: [] };
+            const instructions = current ? [instruction("removeTargets", t, current), instruction("addTargets", t, desired)] : [instruction("addTargets", t, desired)];
+            // Announce the create before sending it: a crash or a lost response must not orphan the target.
+            if (!current)
+                await actx.intend([resourceKey(t)]);
+            actx.log(`${current ? "move" : "target"} ${t.contextKind} ${t.key} → ${describe(desired)} on ${t.flag}`);
+            confirm(t, await patch(actx, client, t, instructions), desired);
+            return { ...stateOf(t, desired), created: current ? [] : [resourceKey(t)] };
+        });
+    },
+    /** Removes exactly the recorded target, from whichever variation serves it now; a gone flag or target is success. */
+    async destroy(actx, resources) {
+        const client = api(actx);
+        for (const r of resources) {
+            const parsed = parseKey(r.key);
+            if (!parsed)
+                throw new SponsonError("INTERNAL", `${ADAPTER}: cannot destroy ${r.key}: not a flag_target key`, { adapter: ADAPTER, key: r.key });
+            const t = { project: requireProvider(actx, "project", ADAPTER), environment: requireProvider(actx, "environment", ADAPTER), ...parsed };
+            await retryingConflicts(async () => {
+                let f;
+                try {
+                    f = await loadFlag(client, t);
+                }
+                catch (e) {
+                    if (isProviderError(e, "PROVIDER_NOT_FOUND"))
+                        return;
+                    throw e;
+                }
+                const current = currentVariation(f, t);
+                if (!current)
+                    return;
+                actx.log(`untarget ${t.contextKind} ${t.key} on ${t.flag}`);
+                confirm(t, await patch(actx, client, t, [instruction("removeTargets", t, current)]), null);
+            });
+        }
+    },
+    /** Every individual target of the line's flag in the environment, for drift (`unmanaged`) and `sponson init`. */
+    async listScope(actx, params) {
+        if (markerKind(params.flag) !== null)
+            return [];
+        const base = targetOf(actx, { ...params, key: "-" });
+        const f = await loadFlag(api(actx), base);
+        return [...f.targets].map(([id, i]) => {
+            const [contextKind, key] = id.split("\u0000");
+            return record({ ...base, contextKind, key }, f.variations[i]);
+        });
+    },
+    /** One line per target; the variation it is served now is kept, not copied. */
+    adopt(resources) {
+        return resources.flatMap((r) => {
+            const t = parseKey(r.key);
+            if (!t)
+                return [];
+            return [{ id: "flag_target", params: { flag: t.flag, key: t.key, context_kind: t.contextKind, variation: { keep: true } }, keys: [r.key] }];
+        });
+    },
+};
+/**
+ * The LaunchDarkly adapter (`adapter: launchdarkly` in a plan): op `flag_target` serves a flag variation to one
+ * context key (a preview URL, `pr-42`) in one environment. Registered in `createRegistry()`; needs
+ * `LAUNCHDARKLY_ACCESS_TOKEN` and `providers.launchdarkly.project` / `.environment`.
+ */
+export const launchdarklyAdapter = { name: ADAPTER, ops: { flag_target }, about: ABOUT };
+//# sourceMappingURL=launchdarkly.js.map

package/dist/launchdarkly.js.map

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

package/dist/manual.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The built-in `manual` adapter: op `step`, a change a person makes by hand because no API can (a Google OAuth web
+ * client's redirect URIs, a Clerk webhook endpoint, a Stripe sandbox). The plan line says what to do; the engine
+ * shows it as `todo` until a person confirms it (`apply --confirm <line>`) or its verify request sees it done, and
+ * records who confirmed it and when (ADR 0021, `OpSpec.manual`). Nothing is ever sent to a provider except the
+ * optional verify GET, made with the generic `http` adapter's client against an API block under `providers.manual`.
+ */
+import { type ResourceAdapter } from "@sponson/core";
+/**
+ * The `manual` adapter (`adapter: manual` in a plan): op `step`, a change a person makes by hand, shown as a todo
+ * with its instructions until someone confirms it or its verify request sees it done (ADR 0021).
+ */
+export declare const manualAdapter: ResourceAdapter;

package/dist/manual.js

@@ -0,0 +1,201 @@
+/**
+ * The built-in `manual` adapter: op `step`, a change a person makes by hand because no API can (a Google OAuth web
+ * client's redirect URIs, a Clerk webhook endpoint, a Stripe sandbox). The plan line says what to do; the engine
+ * shows it as `todo` until a person confirms it (`apply --confirm <line>`) or its verify request sees it done, and
+ * records who confirmed it and when (ADR 0021, `OpSpec.manual`). Nothing is ever sent to a provider except the
+ * optional verify GET, made with the generic `http` adapter's client against an API block under `providers.manual`.
+ */
+import { SponsonError, canonicalJson, isFromRef, isKeepRef, isSecretRef, markerKind, sha256, walkParams } from "@sponson/core";
+import { paramError } from "./common.js";
+import { isObject } from "./http.js";
+import { httpClient, failedWith } from "./http-adapter-client.js";
+import { at, fillPath, parseApi, placeholders, pointerTokens } from "./http-adapter-spec.js";
+const ADAPTER = "manual";
+/** Where a verify request's API is configured; declared for the generated docs. Steps without `verify` need nothing. */
+const ABOUT = { credentialEnv: "none (verify: providers.manual.<api>.auth, optional)", baseUrlEnv: "providers.manual.<api>.base_url_env" };
+const PARAMS = ["title", "instructions", "undo", "vars", "verify"];
+const VERIFY_KEYS = ["api", "path", "match", "absent_status"];
+const KEY_PREFIX = "step:";
+function fail(message, param) {
+    return paramError(ADAPTER, message, param);
+}
+function textParam(params, name, required) {
+    const v = params[name];
+    if (v === undefined || v === null) {
+        if (required)
+            throw fail(`\`${name}\` is required`, name);
+        return undefined;
+    }
+    // Before resolution a `{ from }` stands for text; after it, a pending marker does.
+    if (typeof v !== "string" && !isFromRef(v))
+        throw fail(`\`${name}\` must be text (Markdown), or a \`{ from }\` reference to text`, name);
+    if (typeof v === "string" && markerKind(v) === null && v.trim() === "")
+        throw fail(`\`${name}\` must not be blank`, name);
+    return v;
+}
+function parseVerify(v) {
+    if (v === undefined || v === null)
+        return undefined;
+    if (!isObject(v))
+        throw fail("`verify` must be a map: `{ api, path, match?, absent_status? }`", "verify");
+    const extra = Object.keys(v).find((k) => !VERIFY_KEYS.includes(k));
+    if (extra)
+        throw fail(`\`verify.${extra}\` is not a verify key (known: ${VERIFY_KEYS.join(", ")})`, `verify.${extra}`);
+    if (typeof v.api !== "string" || v.api === "")
+        throw fail("`verify.api` is required: an API block under `providers.manual`", "verify.api");
+    if (typeof v.path !== "string" || !v.path.startsWith("/"))
+        throw fail("`verify.path` must be a path starting with \"/\" (relative to the API's base_url)", "verify.path");
+    const match = v.match ?? {};
+    if (!isObject(match) || Object.keys(match).some((p) => !p.startsWith("/")))
+        throw fail("`verify.match` must map JSON pointers (\"/status\") to the values the answer must have", "verify.match");
+    const absent = v.absent_status ?? [];
+    if (!Array.isArray(absent) || !absent.every((s) => Number.isInteger(s) && s >= 400 && s <= 599))
+        throw fail("`verify.absent_status` must be a list of HTTP error statuses (400–599)", "verify.absent_status");
+    return { api: v.api, path: v.path, match, absentStatus: absent };
+}
+function varsOf(params) {
+    const v = params.vars ?? {};
+    if (!isObject(v))
+        throw fail("`vars` must be a map of name → value", "vars");
+    return v;
+}
+/** Every param checked; refuses unknown params and, before anything resolves them, secret references. */
+function check(params) {
+    const extra = Object.keys(params).find((k) => !PARAMS.includes(k));
+    if (extra)
+        throw fail(`\`${extra}\` is not a parameter of manual.step (known: ${PARAMS.join(", ")})`, extra);
+    textParam(params, "title", true);
+    textParam(params, "instructions", true);
+    textParam(params, "undo", false);
+    const vars = varsOf(params);
+    const verify = parseVerify(params.verify);
+    for (const name of ["title", "instructions", "undo"]) {
+        const t = params[name];
+        if (typeof t === "string" && markerKind(t) === null)
+            usedVars(t, vars, name);
+    }
+    if (verify)
+        usedVars(verify.path, vars, "verify.path");
+}
+/** Placeholders `{name}` of a text must all be declared in `vars`, so a typo fails at plan time. */
+function usedVars(text, vars, param) {
+    const unknown = placeholders(text).find((n) => !(n in vars));
+    if (unknown)
+        throw fail(`\`${param}\` uses \`{${unknown}}\`, which is not declared in \`vars\``, param);
+}
+/** `text` with every `{name}` replaced by its value from `vars`; undefined while a value is pending. */
+function render(text, vars) {
+    const pending = placeholders(text).some((n) => markerKind(vars[n]) !== null);
+    if (pending)
+        return undefined;
+    return text.replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_m, n) => {
+        const v = vars[n];
+        if (typeof v === "object" && v !== null)
+            throw fail(`\`vars.${n}\` must be a single value to fill \`{${n}}\``, `vars.${n}`);
+        return String(v);
+    });
+}
+/** A text param rendered; undefined while it (or a value it uses) is still pending. */
+function rendered(params, name, vars) {
+    const t = params[name];
+    if (t === undefined || markerKind(t) !== null)
+        return undefined;
+    return render(String(t), vars);
+}
+/** The step as a person sees it, or null while anything it shows is still pending. */
+function stepOf(params) {
+    check(params);
+    const vars = varsOf(params);
+    const title = rendered(params, "title", vars);
+    const instructions = rendered(params, "instructions", vars);
+    const undo = params.undo === undefined ? undefined : rendered(params, "undo", vars);
+    if (title === undefined || instructions === undefined || (params.undo !== undefined && undo === undefined))
+        return null;
+    if (/[\r\n]/.test(title))
+        throw fail("`title` must be one line", "title");
+    return {
+        key: `${KEY_PREFIX}${title}`,
+        title,
+        instructions,
+        ...(undo !== undefined ? { undo } : {}),
+        hash: sha256(canonicalJson({ title, instructions })),
+        observable: params.verify !== undefined && params.verify !== null,
+    };
+}
+/** Whether the verify request sees the step done. A 404 (or an `absent_status`) means not yet. */
+async function verified(actx, verify, vars) {
+    const path = fillPath(verify.path, vars);
+    if (path === undefined)
+        return false;
+    const api = httpClient(actx, {}, { where: `providers.manual.${verify.api}`, authOptional: true, adapter: ADAPTER });
+    let body;
+    try {
+        body = await api.get(path);
+    }
+    catch (e) {
+        if (failedWith(e, "PROVIDER_NOT_FOUND", verify.absentStatus))
+            return false;
+        throw e;
+    }
+    return Object.entries(verify.match).every(([pointer, want]) => canonicalJson(at(body, pointerTokens(pointer)) ?? null) === canonicalJson(want));
+}
+/** `manual.step`: one change a person makes by hand, confirmed by a person or seen by a verify request. */
+const step = {
+    outputs: {},
+    /**
+     * Checked before anything resolves: a secret has no place in instructions a person reads (and `plan` would show
+     * them masked), so a `{ secret }` reference is refused here, before any provider call.
+     */
+    defaults(params) {
+        walkParams(params, [], (path, v) => {
+            const where = path.join(".");
+            if (isSecretRef(v))
+                throw fail(`\`${where}\` is a secret reference; a manual step's text is shown to people and kept in receipts, so it may not carry a secret`, where);
+            if (isKeepRef(v))
+                throw fail(`\`${where}\` is \`{ keep: true }\`; a manual step has no live value to keep`, where);
+        });
+        check(params);
+        return params;
+    },
+    /** The verify request's API block, `providers.manual.<verify.api>`; nothing for a step without one. */
+    providerFor(block, params) {
+        const verify = isObject(params.verify) ? params.verify : undefined;
+        if (!verify || typeof verify.api !== "string")
+            return {};
+        const cfg = block[verify.api];
+        if (!isObject(cfg)) {
+            const known = Object.keys(block);
+            throw new SponsonError("PLAN_INVALID", `${ADAPTER}: providers.manual.${verify.api}: no API \`${verify.api}\` is configured for the verify request (known: ${known.length ? known.join(", ") : "none"})`, { adapter: ADAPTER, key: `providers.manual.${verify.api}` });
+        }
+        parseApi(cfg, `providers.manual.${verify.api}`, { authOptional: true });
+        return cfg;
+    },
+    manual: (params) => stepOf(params),
+    /** Done, as far as an API can tell: only a step with `verify` is ever seen; any other is known done only by confirmation. */
+    async read(actx, params) {
+        const s = stepOf(params);
+        const verify = parseVerify(params.verify);
+        if (!s || !verify || !(await verified(actx, verify, varsOf(params))))
+            return null;
+        return { resources: [{ key: s.key, id: "manual", hash: s.hash, label: `manual step: ${s.title}` }], outputs: {} };
+    },
+    diff(live, params) {
+        const s = stepOf(params);
+        if (!s)
+            return [{ key: `${KEY_PREFIX}(pending)`, kind: "create", label: "manual step", before: { state: "absent" }, after: { state: "pending" } }];
+        const label = `manual step: ${s.title}`;
+        return [live ? { key: s.key, kind: "unchanged", label } : { key: s.key, kind: "create", label, before: { state: "absent" }, after: { state: "literal", value: s.title } }];
+    },
+    /** Never called: the engine records a manual step (OpSpec.manual). */
+    async apply() {
+        throw new SponsonError("INTERNAL", `${ADAPTER}: a manual step is done by a person and recorded by the engine; apply must not be called`, { adapter: ADAPTER });
+    },
+    /** Nothing to delete at any provider: undoing a step is a person's job (its `undo`), confirmed on destroy. */
+    async destroy() { },
+};
+/**
+ * The `manual` adapter (`adapter: manual` in a plan): op `step`, a change a person makes by hand, shown as a todo
+ * with its instructions until someone confirms it or its verify request sees it done (ADR 0021).
+ */
+export const manualAdapter = { name: ADAPTER, ops: { step }, about: ABOUT };
+//# sourceMappingURL=manual.js.map

package/dist/manual.js.map

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

package/dist/neon.js

@@ -2,7 +2,7 @@ import { canonicalJson, isPendingMarker, sha256 } from "@sponson/core";
 import { ABSENT, assertNoPending, clientFor, deleteIgnoringNotFound, desiredSide, optionalEnv, paramError, requireEnv, requireProvider, stringParam } from "./common.js";
 import { ShapeError, isProviderError, listAll, obj, records } from "./http.js";
 /** The environment neon reads; declared once, used by the code below and by the generated docs. */
-const ABOUT = { credentialEnv: "NEON_API_KEY", baseUrlEnv: "NEON_API_URL" };
+const ABOUT = { credentialEnv: "NEON_API_KEY", baseUrlEnv: "NEON_API_URL", title: "Neon", category: "databases", detect: { deps: ["@neondatabase/", "@prisma/adapter-neon", "neonctl"], env: ["NEON_*"], files: [".neon"], dbHosts: [".neon.tech"] } };
 /** Neon's API base URL; `NEON_API_URL` overrides it (the sim and tests use that). */
 export const NEON_DEFAULT_API_URL = "https://console.neon.tech/api/v2";
 function client(actx) {