@sponson/sim 0.4.0 → 0.6.0

package/dist/routes/launchdarkly.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Simulated LaunchDarkly: feature flags per project, with each environment's individual targets (a context key of a
+ * context kind served one variation).
+ *
+ * Assumptions about the real API that this fake encodes, each marked with how far it is checked. "Verified" means
+ * against LaunchDarkly's published REST API reference (fetched 2026-10-11): the API overview
+ * https://launchdarkly.com/docs/api, "Get feature flag" https://launchdarkly.com/docs/api/feature-flags/get-feature-flag
+ * and "Update feature flag" https://launchdarkly.com/docs/api/feature-flags/patch-feature-flag; see
+ * docs/api-verification.md:
+ *   LD1. The access token is the whole `Authorization` value, with no `Bearer` prefix (verified: "The value of the
+ *        `Authorization` header must be your access token"). The base URL is https://app.launchdarkly.com/api/v2
+ *        (verified from the OpenAPI document's location; federal and EU instances use other hosts). The sim
+ *        refuses a `Bearer` header with 401.
+ *   LD2. `GET /flags/{projectKey}/{featureFlagKey}?env=<key>` answers the flag with `variations[]` (`_id`, `value`,
+ *        optional `name`) and `environments.<key>` restricted to that environment (verified). An unknown project or
+ *        flag is 404 (verified: "Invalid resource identifier"). An environment the project lacks is absent from
+ *        `environments` (unverified: whether LaunchDarkly answers 404 or an empty map instead; the adapter
+ *        reports either as not found).
+ *   LD3. An environment's individual targets are `targets[]` (context kind `user`) and `contextTargets[]` (every
+ *        other kind), items `{ contextKind, values, variation }` where `variation` is an index into `variations`
+ *        (verified). `contextTargets` also lists, for each variation with user targets, a placeholder
+ *        `{ contextKind: "user", values: [] }` (unverified, observed behaviour reported by SDK users; the adapter
+ *        reads both arrays and ignores empty entries, so it does not depend on it).
+ *   LD4. `PATCH /flags/{projectKey}/{featureFlagKey}` with `Content-Type: application/json;
+ *        domain-model=launchdarkly.semanticpatch` and `{ environmentKey, instructions, comment? }` applies the
+ *        instructions; without that media type the body is read as a JSON patch and a semantic patch is 400
+ *        (verified). It answers 200 with the whole flag (verified). Instructions are all or nothing: one invalid
+ *        instruction and nothing changes (verified).
+ *   LD5. `addTargets { contextKind, values, variationId }` (`contextKind` defaults to `user`) is refused (400)
+ *        when it would make a context key targeted by two variations (verified that it is an error; the status
+ *        is unverified). Adding a key already targeted by the same variation changes nothing and succeeds
+ *        (unverified: the docs say only that a semantic patch updates the flag "only where needed"; pinned by the
+ *        contract suite). `removeTargets` with the same fields does nothing for a key not targeted (verified).
+ *   LD6. An environment that requires approvals answers 405 to a flag change (verified); a concurrent change
+ *        answers 409, to be retried (verified). The error body is `{ code, message }` (verified).
+ *   LD7. The PATCH takes effect at once: the next GET shows it (unverified; pinned by the contract suite).
+ */
+import { type CreatedBy, type ProviderSim } from "../provider.js";
+/** The media type of a semantic patch (LD4). */
+export declare const LAUNCHDARKLY_SEMANTIC_PATCH = "application/json; domain-model=launchdarkly.semanticpatch";
+/** One variation of a flag. */
+export interface LaunchdarklyVariation {
+    _id: string;
+    value: unknown;
+    name?: string;
+}
+/** One individual target: a context key of a kind, served the variation at `variation` (an index). */
+export interface LaunchdarklyTarget {
+    contextKind: string;
+    key: string;
+    variation: number;
+    createdBy: CreatedBy;
+}
+/** A flag's configuration in one environment, as far as the sim models it. */
+export interface LaunchdarklyFlagEnv {
+    on: boolean;
+    version: number;
+    targets: LaunchdarklyTarget[];
+}
+/** One feature flag. */
+export interface LaunchdarklyFlag {
+    key: string;
+    variations: LaunchdarklyVariation[];
+    version: number;
+    environments: Record<string, LaunchdarklyFlagEnv>;
+}
+/** One project: its environments (and which need approvals) and its flags. */
+export interface LaunchdarklyProject {
+    environments: string[];
+    approvals: string[];
+    flags: Record<string, LaunchdarklyFlag>;
+}
+/** The simulated LaunchDarkly's state: projects by key. */
+export interface LaunchdarklyState {
+    projects: Record<string, LaunchdarklyProject>;
+}
+/** What a scenario or test seeds the simulated LaunchDarkly with (`seed: { launchdarkly: … }`). */
+export interface LaunchdarklySeed {
+    projects: Record<string, {
+        environments?: string[];
+        /** Environments whose flag changes need an approval request (LD6). */
+        approvals?: string[];
+        flags?: Record<string, {
+            variations?: Array<{
+                value: unknown;
+                name?: string;
+            }>;
+            /** Environment key → targets that exist already (made "by a human", so unmanaged). */
+            targets?: Record<string, Array<{
+                contextKind?: string;
+                key: string;
+                variation: number;
+            }>>;
+        }>;
+    }>;
+}
+/** The simulated LaunchDarkly API, registered in `PROVIDERS` (packages/sim/src/state.ts) and served under `/launchdarkly`. */
+export declare const launchdarklySim: ProviderSim<LaunchdarklyState, LaunchdarklySeed>;

package/dist/routes/launchdarkly.js

@@ -0,0 +1,213 @@
+/**
+ * Simulated LaunchDarkly: feature flags per project, with each environment's individual targets (a context key of a
+ * context kind served one variation).
+ *
+ * Assumptions about the real API that this fake encodes, each marked with how far it is checked. "Verified" means
+ * against LaunchDarkly's published REST API reference (fetched 2026-10-11): the API overview
+ * https://launchdarkly.com/docs/api, "Get feature flag" https://launchdarkly.com/docs/api/feature-flags/get-feature-flag
+ * and "Update feature flag" https://launchdarkly.com/docs/api/feature-flags/patch-feature-flag; see
+ * docs/api-verification.md:
+ *   LD1. The access token is the whole `Authorization` value, with no `Bearer` prefix (verified: "The value of the
+ *        `Authorization` header must be your access token"). The base URL is https://app.launchdarkly.com/api/v2
+ *        (verified from the OpenAPI document's location; federal and EU instances use other hosts). The sim
+ *        refuses a `Bearer` header with 401.
+ *   LD2. `GET /flags/{projectKey}/{featureFlagKey}?env=<key>` answers the flag with `variations[]` (`_id`, `value`,
+ *        optional `name`) and `environments.<key>` restricted to that environment (verified). An unknown project or
+ *        flag is 404 (verified: "Invalid resource identifier"). An environment the project lacks is absent from
+ *        `environments` (unverified: whether LaunchDarkly answers 404 or an empty map instead; the adapter
+ *        reports either as not found).
+ *   LD3. An environment's individual targets are `targets[]` (context kind `user`) and `contextTargets[]` (every
+ *        other kind), items `{ contextKind, values, variation }` where `variation` is an index into `variations`
+ *        (verified). `contextTargets` also lists, for each variation with user targets, a placeholder
+ *        `{ contextKind: "user", values: [] }` (unverified, observed behaviour reported by SDK users; the adapter
+ *        reads both arrays and ignores empty entries, so it does not depend on it).
+ *   LD4. `PATCH /flags/{projectKey}/{featureFlagKey}` with `Content-Type: application/json;
+ *        domain-model=launchdarkly.semanticpatch` and `{ environmentKey, instructions, comment? }` applies the
+ *        instructions; without that media type the body is read as a JSON patch and a semantic patch is 400
+ *        (verified). It answers 200 with the whole flag (verified). Instructions are all or nothing: one invalid
+ *        instruction and nothing changes (verified).
+ *   LD5. `addTargets { contextKind, values, variationId }` (`contextKind` defaults to `user`) is refused (400)
+ *        when it would make a context key targeted by two variations (verified that it is an error; the status
+ *        is unverified). Adding a key already targeted by the same variation changes nothing and succeeds
+ *        (unverified: the docs say only that a semantic patch updates the flag "only where needed"; pinned by the
+ *        contract suite). `removeTargets` with the same fields does nothing for a key not targeted (verified).
+ *   LD6. An environment that requires approvals answers 405 to a flag change (verified); a concurrent change
+ *        answers 409, to be retried (verified). The error body is `{ code, message }` (verified).
+ *   LD7. The PATCH takes effect at once: the next GET shows it (unverified; pinned by the contract suite).
+ */
+import { Reply, route, router } from "../provider.js";
+/** The media type of a semantic patch (LD4). */
+export const LAUNCHDARKLY_SEMANTIC_PATCH = "application/json; domain-model=launchdarkly.semanticpatch";
+const BOOLEAN = [
+    { value: true, name: "on" },
+    { value: false, name: "off" },
+];
+/** The simulated LaunchDarkly API, registered in `PROVIDERS` (packages/sim/src/state.ts) and served under `/launchdarkly`. */
+export const launchdarklySim = {
+    env: { token: "LAUNCHDARKLY_ACCESS_TOKEN", url: "LAUNCHDARKLY_API_URL", testToken: "api-sim-launchdarkly" },
+    // LD1: the token alone in Authorization; a `Bearer` header is refused, so an adapter that sends one fails its tests.
+    authorized: (headers) => /^\S+$/.test(headers.authorization ?? "") && !/^Bearer$/i.test(headers.authorization ?? ""),
+    defaultSeed: { projects: { demo: { environments: ["preview", "production"], flags: { "new-checkout": {} } } } },
+    reset(core, seed) {
+        const projects = {};
+        for (const [key, p] of Object.entries(seed?.projects ?? {})) {
+            const environments = p.environments ?? ["preview", "production"];
+            const flags = {};
+            for (const [flagKey, f] of Object.entries(p.flags ?? {}))
+                flags[flagKey] = flag(core, flagKey, environments, f);
+            projects[key] = { environments, approvals: p.approvals ?? [], flags };
+        }
+        return { projects };
+    },
+    /**
+     * `target.<flag>/<environment>/<contextKind>/<key>` (or `launchdarkly:<project>.target.…`): "delete", or a
+     * variation name or index to move the target to — what a human in the LaunchDarkly console would do.
+     */
+    drift(_core, state, { key, rest, value, only }) {
+        if (!rest.startsWith("target."))
+            return false;
+        const [flagKey, envKey, kind, ...target] = rest.slice("target.".length).split("/");
+        const contextKey = target.join("/");
+        let hit = false;
+        for (const [id, p] of Object.entries(state.projects)) {
+            if (only !== undefined && id !== only)
+                continue;
+            const f = p.flags[flagKey ?? ""];
+            const env = f?.environments[envKey ?? ""];
+            const t = env?.targets.find((x) => x.contextKind === kind && x.key === contextKey);
+            if (!f || !env || !t)
+                continue;
+            hit = true;
+            if (value === "delete")
+                env.targets = env.targets.filter((x) => x !== t);
+            else
+                t.variation = variationIndex(f, value, key);
+            env.version++;
+        }
+        if (!hit)
+            throw new Error(`drift ${key}: no such target`);
+        return true;
+    },
+    routes(core, state, req) {
+        return routes(core, state, req);
+    },
+};
+function variationIndex(f, value, key) {
+    const byName = f.variations.findIndex((v) => v.name === value);
+    if (byName >= 0)
+        return byName;
+    if (/^\d+$/.test(value) && Number(value) < f.variations.length)
+        return Number(value);
+    throw new Error(`drift ${key}: flag ${f.key} has no variation ${value}`);
+}
+/** The API, one route per method and path, under `/api/v2` (part of the base URL). */
+const routes = router([
+    route("GET", "/flags/:project/:flag", ({ state, params, url }) => {
+        const f = state.projects[params.project]?.flags[params.flag];
+        if (!f)
+            return ldError(404, "not_found", "Unknown resource");
+        return new Reply(200, publicFlag(f, url.searchParams.get("env")));
+    }),
+    route("PATCH", "/flags/:project/:flag", ({ state, params, body, headers }) => {
+        if (!(headers["content-type"] ?? "").replace(/\s+/g, "").includes("domain-model=launchdarkly.semanticpatch")) {
+            return ldError(400, "invalid_request", "Invalid JSON patch: expected an array of operations");
+        }
+        const p = state.projects[params.project];
+        const f = p?.flags[params.flag];
+        if (!p || !f)
+            return ldError(404, "not_found", "Unknown resource");
+        const b = (body ?? {});
+        if (typeof b.environmentKey !== "string" || !f.environments[b.environmentKey])
+            return ldError(400, "invalid_request", "environmentKey is required and must name an environment");
+        if (!Array.isArray(b.instructions) || b.instructions.length === 0)
+            return ldError(400, "invalid_request", "instructions are required");
+        if (p.approvals.includes(b.environmentKey))
+            return ldError(405, "method_not_allowed", "This environment requires approval for changes to flags");
+        const env = f.environments[b.environmentKey];
+        // All or nothing (LD4): work on a copy, keep it only if every instruction was valid.
+        const next = env.targets.map((t) => ({ ...t }));
+        for (const ins of b.instructions) {
+            const problem = applyInstruction(f, next, ins);
+            if (problem)
+                return ldError(400, "invalid_request", problem);
+        }
+        if (JSON.stringify(next) !== JSON.stringify(env.targets)) {
+            env.targets = next;
+            env.version++;
+            f.version++;
+        }
+        return new Reply(200, publicFlag(f, null));
+    }),
+], () => ldError(404, "not_found", "Unknown resource"));
+/** One `addTargets` / `removeTargets` instruction against `targets`; a message when it is invalid. */
+function applyInstruction(f, targets, ins) {
+    const i = parseInstruction(f, ins);
+    if (typeof i === "string")
+        return i;
+    const { contextKind, variation } = i;
+    for (const key of i.values) {
+        const at = targets.findIndex((t) => t.contextKind === contextKind && t.key === key);
+        if (i.kind === "removeTargets") {
+            if (at >= 0 && targets[at].variation === variation)
+                targets.splice(at, 1);
+            continue;
+        }
+        if (at >= 0 && targets[at].variation !== variation)
+            return `${contextKind} ${key} is already targeted by another variation`;
+        if (at < 0)
+            targets.push({ contextKind, key, variation, createdBy: "api" });
+    }
+    return null;
+}
+/** One instruction, validated; a message when it is not one the sim implements or is malformed. */
+function parseInstruction(f, ins) {
+    const i = (ins ?? {});
+    if (i.kind !== "addTargets" && i.kind !== "removeTargets")
+        return `unsupported instruction kind ${String(i.kind)}`;
+    const variation = f.variations.findIndex((v) => v._id === i.variationId);
+    if (variation < 0)
+        return `unknown variationId ${String(i.variationId)}`;
+    if (!Array.isArray(i.values) || i.values.some((v) => typeof v !== "string"))
+        return "values must be a list of context keys";
+    const contextKind = typeof i.contextKind === "string" && i.contextKind !== "" ? i.contextKind : "user";
+    return { kind: i.kind, contextKind, values: i.values, variation };
+}
+/** The flag representation (LD2, LD3), restricted to one environment when `env` names one. */
+function publicFlag(f, env) {
+    const environments = {};
+    for (const [key, e] of Object.entries(f.environments)) {
+        if (env !== null && key !== env)
+            continue;
+        const user = groups(e.targets.filter((t) => t.contextKind === "user"));
+        const other = groups(e.targets.filter((t) => t.contextKind !== "user"));
+        const placeholders = user.map((g) => ({ contextKind: "user", values: [], variation: g.variation }));
+        environments[key] = { on: e.on, version: e.version, _environmentName: key, targets: user, contextTargets: [...other, ...placeholders] };
+    }
+    return { key: f.key, _version: f.version, variations: f.variations, environments };
+}
+/** Targets grouped the way LaunchDarkly lists them: one entry per (kind, variation). */
+function groups(targets) {
+    const out = [];
+    for (const t of targets) {
+        const g = out.find((x) => x.contextKind === t.contextKind && x.variation === t.variation);
+        if (g)
+            g.values.push(t.key);
+        else
+            out.push({ contextKind: t.contextKind, values: [t.key], variation: t.variation });
+    }
+    return out;
+}
+function flag(core, key, environments, seed) {
+    const variations = (seed.variations ?? BOOLEAN).map((v) => ({ _id: core.nextId("var_"), value: v.value, ...(v.name !== undefined ? { name: v.name } : {}) }));
+    const envs = {};
+    for (const e of environments) {
+        const targets = (seed.targets?.[e] ?? []).map((t) => ({ contextKind: t.contextKind ?? "user", key: t.key, variation: t.variation, createdBy: "sim" }));
+        envs[e] = { on: true, version: 1, targets };
+    }
+    return { key, variations, version: 1, environments: envs };
+}
+/** LaunchDarkly's error body (LD6). */
+function ldError(status, code, message) {
+    return new Reply(status, { code, message });
+}
+//# sourceMappingURL=launchdarkly.js.map

package/dist/routes/launchdarkly.js.map

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

package/dist/routes/netlify.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Simulated Netlify: site environment variables (one object per key, one value per deploy context) and deploys.
+ *
+ * Assumptions about the real API that this fake encodes. "Verified" means against Netlify's OpenAPI document
+ * (https://github.com/netlify/open-api/blob/master/swagger.yml, rendered at https://open-api.netlify.com/) or its
+ * docs (cited), fetched 2026-10-11; docs/api-verification.md has the per-call table. scenarios/contract.test.ts pins
+ * the risky ones against a live account (`pnpm test:live`). NL, not N: N… are Neon's.
+ *   NL1. Base URL https://api.netlify.com/api/v1, bearer token (OpenAPI `host`, `basePath`; the API guide's
+ *        `Authorization: Bearer`). Verified.
+ *   NL2. Site variables live under /accounts/{account_id}/env with `?site_id=`: GET lists them (getEnvVars), POST
+ *        creates a list of them (createEnvVars, 201), GET/PATCH/DELETE /accounts/{account_id}/env/{key} read one,
+ *        set one context's value (setEnvVarValue, 201: "updates or creates a new value for an existing
+ *        environment variable") and delete the variable (204); DELETE …/env/{key}/value/{id} deletes one value
+ *        (deleteEnvVarValue, 204). Verified (OpenAPI paths, statuses; the docs' API guide). `{account_id}` may be
+ *        the account slug (verified: the API guide). GET /sites/{site_id} carries `account_id`, `account_slug` and
+ *        `name` (verified field names; that `name` is the `<name>.netlify.app` subdomain is the docs' example, not a
+ *        statement: unverified, pinned).
+ *   NL3. A variable is `{ key, scopes, values: [{ id, value, context, context_parameter }], is_secret, updated_at }`;
+ *        `context` is all | dev | dev-server | branch-deploy | deploy-preview | production | branch, and `branch`
+ *        needs the branch name in `context_parameter` (verified: envVar / envVarValue definitions). Omitting
+ *        `scopes` gives all scopes (verified: "By default, environment variables apply to all scopes", env var
+ *        overview). Unverified: that PATCH leaves the other contexts' values (and their ids) alone and keeps the id
+ *        of the value it replaces (the sim keeps it; the adapter re-reads ids from the answer anyway).
+ *   NL4. Secret values (`is_secret`) are write-only except in the `dev` context (verified: Secrets Controller
+ *        docs). How a masked value is returned is not documented; the sim omits `value` (unverified; the adapter
+ *        ignores `value` of a secret either way).
+ *   NL5. POST of a key that already exists is refused with 400 and writes nothing (unverified: status not
+ *        documented). A variable with an `all` value and a context value together is refused with 400
+ *        (unverified). The adapter re-lists after a 400/409 and never writes next to an `all` value.
+ *   NL6. A variable whose last value is deleted stays, with no values (unverified; the adapter deletes it then, and
+ *        a 404 on the follow-up read is fine).
+ *   NL7. GET /sites/{site_id}/deploys lists deploys newest first, `page`/`per_page` (verified: the API guide;
+ *        order unverified, the adapter sorts by `created_at`). A deploy carries `id`, `state`, `context`,
+ *        `commit_ref`, `review_id`, `branch`, `created_at` (verified field names); `context` is production |
+ *        deploy-preview | branch-deploy (unverified: no enum in the spec) and `review_id` is the pull request
+ *        number (unverified).
+ *   NL8. Deploy states: new, pending_review, accepted, rejected, enqueued, building, uploading, uploaded,
+ *        preparing, prepared, processing, processed, ready, error, retrying (verified: the `state` filter's enum).
+ *        The sim uses enqueued → building → ready, or error.
+ *   NL9. URLs: `<deploy id>--<site name>.netlify.app` is a deploy's permalink and `deploy-preview-<n>--<site
+ *        name>.netlify.app` the Deploy Preview of pull request n (verified: deploy overview docs).
+ *   NL10. A build reads the variable values set when it started ("Environment variable changes require a build
+ *        and deploy to take effect": verified, env var docs); `updated_at` is when a variable's values last
+ *        changed (verified field; that a PATCH bumps it is unverified, pinned).
+ *   NL11. POST /sites/{site_id}/builds starts a build of the production branch, or with `?branch=` a branch deploy
+ *        of that branch's head (verified: createSiteBuild's `branch` description). Unverified: that it works for
+ *        a branch whose branch deploys are not enabled in the site's settings. Deploy Previews cannot be rebuilt
+ *        through the documented API.
+ *   NL12. A `branch` value applies to "deploy permalinks, Deploy Previews, and branch deploys for the specified
+ *        branch" (verified: env var overview), so a pull request's Deploy Preview reads its head branch's value.
+ *
+ * The git integration is modelled by `pushes` in the seed: the first deploy list of a site deploys every push it
+ * has not deployed yet (a pull request push as a Deploy Preview, `main` as production, other branches as branch
+ * deploys), following chaos `deploy` (ok | never | fail | stale | delay:<s>) and `deploy_ms` as Vercel's sim does.
+ */
+import { type CreatedBy, type ProviderSim } from "../provider.js";
+/** One value of a simulated variable. */
+export interface NetlifyEnvValue {
+    id: string;
+    value: string;
+    context: string;
+    context_parameter?: string;
+}
+/** One simulated site variable. */
+export interface NetlifyEnvVar {
+    key: string;
+    is_secret: boolean;
+    values: NetlifyEnvValue[];
+    updatedAt: number;
+    createdBy: CreatedBy;
+}
+/** One simulated deploy. */
+export interface NetlifyDeploy {
+    id: string;
+    state: string;
+    context: "production" | "deploy-preview" | "branch-deploy";
+    branch: string;
+    commit_ref: string;
+    review_id: number | null;
+    createdAt: number;
+    /** While building: `building` until `readyAt`, then `finalState`. */
+    readyAt?: number;
+    finalState?: string;
+    createdBy: CreatedBy;
+}
+/** A commit the git integration has seen: what Netlify would build on its own. */
+export interface NetlifyPush {
+    sha: string;
+    branch: string;
+    pr?: number;
+}
+/** One simulated site. */
+export interface NetlifySite {
+    name: string;
+    accountId: string;
+    accountSlug: string;
+    envs: NetlifyEnvVar[];
+    deploys: NetlifyDeploy[];
+    pushes: NetlifyPush[];
+    /** Pushes already deployed by the git integration (by `<sha> <branch>`). */
+    built: string[];
+}
+/** The simulated Netlify's state: sites by id. */
+export interface NetlifyState {
+    sites: Record<string, NetlifySite>;
+}
+/** What a scenario or test seeds the simulated Netlify with (`seed: { netlify: … }`). */
+export interface NetlifySeed {
+    sites: Record<string, {
+        name?: string;
+        account?: string;
+        /** Variables that exist already (set "by a human", so unmanaged). */
+        envs?: Array<{
+            key: string;
+            is_secret?: boolean;
+            values: Array<{
+                context: string;
+                value: string;
+                context_parameter?: string;
+            }>;
+        }>;
+        pushes?: NetlifyPush[];
+    }>;
+}
+/** The simulated Netlify API (env vars, deploys), registered in `PROVIDERS` and served under `/netlify`. */
+export declare const netlifySim: ProviderSim<NetlifyState, NetlifySeed>;