@sponson/sim 0.0.0-stage → 0.5.0

package/dist/routes/neon.js

@@ -0,0 +1,184 @@
+/**
+ * Simulated Neon: branches, their endpoints, databases and connection strings.
+ *
+ * Assumptions about the real API that this fake encodes, each marked with how far it is checked. "Verified" means
+ * against Neon's published OpenAPI document (https://neon.tech/api_spec/release/v2.json, fetched 2026-10-10); see
+ * docs/api-verification.md:
+ *   N1. Branch deletion is synchronous here: the branch is gone when DELETE returns. Contradicted in part: the
+ *       spec says "the deletion completes after all operations finish" and DELETE answers with `operations`.
+ *       Whether the list still shows the branch meanwhile is unverified: needs a live account.
+ *   N2. Branch creation runs async operations (verified: the create answer carries `operations`): for chaos
+ *       `neon_op_ms` (default 0) after a create, further creates in the project and writes to the new branch
+ *       answer 423 Locked, which the spec documents as safe to retry (verified). Which requests are locked, and
+ *       that the endpoint is usable at once, are unverified: needs a live account.
+ *   N3. A root branch has one database `neondb` owned by role `neondb_owner` (a new project's defaults); a child
+ *       copies its parent's. The adapter no longer relies on these names: it reads them from
+ *       GET /projects/:id/branches/:id/databases (verified), and connection_uri requires both (verified).
+ *       Branches carry `default: true` on the project's root branch (verified; `primary` is deprecated).
+ *   N4. Pagination (chaos `page_size`): `{ branches, pagination: { next } }` with `?cursor=`, cursors opaque
+ *       (verified: CursorPagination). Without `limit` the list is not paged here; the spec says a paged read
+ *       starts with `limit`, and the adapter follows `next` either way.
+ *   N5. Creating a branch whose name exists answers 409. Unverified: the spec documents only the generic error.
+ */
+import { page, Reply, route, router } from "../provider.js";
+/** Simulated Neon (projects, branches, operations); see the assumptions at the top of this file. */
+export const neonSim = {
+    env: { token: "NEON_API_KEY", url: "NEON_API_URL", testToken: "tok_neon" },
+    defaultSeed: { projects: { proj_demo: { branches: [{ name: "main" }] } } },
+    reset(core, seed) {
+        const state = { projects: {} };
+        for (const [id, p] of Object.entries(seed?.projects ?? {})) {
+            const project = { branches: [], opUntil: 0 };
+            state.projects[id] = project;
+            for (const b of p.branches) {
+                const parent = b.parent ? project.branches.find((x) => x.name === b.parent) : undefined;
+                const branch = createBranch(core, project, b.name, parent?.id ?? null, "sim");
+                // The first root branch is the project's default, like the one Neon creates with the project.
+                if (!branch.parent_id && !project.branches.some((x) => x.default))
+                    branch.default = true;
+            }
+        }
+        return state;
+    },
+    /** `branch.<name>`: "delete" | "recreate". */
+    drift(core, state, { key, rest, value, only }) {
+        if (!rest.startsWith("branch."))
+            return false;
+        const name = rest.slice("branch.".length);
+        if (value !== "delete" && value !== "recreate")
+            throw new Error(`drift ${key}: only "delete" and "recreate" are supported`);
+        for (const [id, p] of Object.entries(state.projects)) {
+            if (only !== undefined && id !== only)
+                continue;
+            const hit = p.branches.filter((b) => b.name === name);
+            p.branches = p.branches.filter((b) => !hit.includes(b));
+            if (value === "recreate")
+                for (const b of hit)
+                    createBranch(core, p, b.name, b.parent_id, "sim");
+        }
+        return true;
+    },
+    routes(core, state, req) {
+        return routes(core, state, req);
+    },
+};
+const routes = router([
+    route("GET", "/projects/:project/branches", ({ core, state, params, url }) => {
+        const p = state.projects[params.project];
+        if (!p)
+            return notFound("project");
+        const pg = page(core, p.branches, url.searchParams.get("cursor"));
+        return new Reply(200, { branches: pg.items.map(publicBranch), pagination: pg.next === null ? {} : { next: String(pg.next) } });
+    }),
+    route("POST", "/projects/:project/branches", ({ core, state, params, body }) => {
+        const p = state.projects[params.project];
+        if (!p)
+            return notFound("project");
+        if (Date.now() < p.opUntil)
+            return locked();
+        const b = (body ?? {});
+        const name = b.branch?.name;
+        if (!name)
+            return new Reply(400, { code: "", message: "branch.name required" });
+        if (p.branches.some((x) => x.name === name))
+            return new Reply(409, { code: "", message: "branch already exists" });
+        const parentId = b.branch?.parent_id ?? null;
+        if (parentId && !p.branches.some((x) => x.id === parentId))
+            return notFound("parent branch");
+        const branch = createBranch(core, p, name, parentId, "api");
+        if (core.chaos.neon_op_ms > 0)
+            branch.opUntil = p.opUntil = Date.now() + core.chaos.neon_op_ms;
+        // CreatedBranch: branch, endpoints, operations, roles, databases and (one database and role) connection_uris.
+        return new Reply(201, {
+            branch: publicBranch(branch),
+            endpoints: [publicEndpoint(branch)],
+            operations: [{ id: core.nextId("op-"), branch_id: branch.id, action: "create_branch", status: core.chaos.neon_op_ms > 0 ? "running" : "finished" }],
+            roles: [{ branch_id: branch.id, name: branch.database.owner_name }],
+            databases: [publicDatabase(branch)],
+            connection_uris: [{ connection_uri: connectionUri(branch), connection_parameters: { database: branch.database.name, role: branch.database.owner_name, host: branch.endpoint.host } }],
+        });
+    }),
+    route("GET", "/projects/:project/branches/:branch/endpoints", ({ state, params }) => {
+        const b = branchOf(state, params.project, params.branch);
+        return b ? new Reply(200, { endpoints: [publicEndpoint(b)] }) : notFound("branch");
+    }),
+    route("GET", "/projects/:project/branches/:branch/databases", ({ state, params }) => {
+        const b = branchOf(state, params.project, params.branch);
+        return b ? new Reply(200, { databases: [publicDatabase(b)] }) : notFound("branch");
+    }),
+    route("GET", "/projects/:project/connection_uri", ({ state, params, url }) => {
+        const b = branchOf(state, params.project, url.searchParams.get("branch_id"));
+        if (!b)
+            return notFound("branch");
+        // Both are required query parameters in the spec.
+        const database = url.searchParams.get("database_name");
+        const role = url.searchParams.get("role_name");
+        if (!database || !role)
+            return new Reply(400, { code: "", message: "database_name and role_name are required" });
+        if (database !== b.database.name)
+            return notFound(`database ${database}`);
+        if (role !== b.database.owner_name)
+            return notFound(`role ${role}`);
+        return new Reply(200, { uri: connectionUri(b) });
+    }),
+    route("DELETE", "/projects/:project/branches/:branch", ({ core, state, params }) => {
+        const p = state.projects[params.project];
+        const b = branchOf(state, params.project, params.branch);
+        if (!p || !b)
+            return notFound("branch");
+        if (Date.now() < b.opUntil)
+            return locked();
+        // The real deletion "completes after all operations finish" (assumption N1); the sim removes it at once.
+        p.branches = p.branches.filter((x) => x !== b);
+        return new Reply(200, { branch: publicBranch(b), operations: [{ id: core.nextId("op-"), branch_id: b.id, action: "delete_timeline", status: "finished" }] });
+    }),
+], () => notFound("route"));
+/** A branch of a project by id; undefined when either does not exist. */
+function branchOf(state, project, branchId) {
+    return state.projects[project]?.branches.find((x) => x.id === branchId);
+}
+/**
+ * Add a branch to a project as Neon would (ids, timestamps, default flag). Tests use it to seed "someone else's"
+ * branch.
+ */
+export function createBranch(core, project, name, parentId, createdBy) {
+    const id = core.nextId("br-");
+    const branch = {
+        id,
+        name,
+        parent_id: parentId,
+        default: false,
+        opUntil: 0,
+        created_at: new Date().toISOString(),
+        endpoint: { id: core.nextId("ep-"), host: `${id}.sim.neon.tech` },
+        database: { ...(project.branches.find((b) => b.id === parentId)?.database ?? { name: DATABASE, owner_name: ROLE }) },
+        createdAt: Date.now(),
+        createdBy,
+    };
+    project.branches.push(branch);
+    return branch;
+}
+/** A root branch's database and its owner: a new Neon project's defaults. */
+const DATABASE = "neondb";
+const ROLE = "neondb_owner";
+/** The connection string Neon would hand out for a branch. */
+export function connectionUri(branch) {
+    return `postgres://${branch.database.owner_name}:pw_${branch.id}@${branch.endpoint.host}/${branch.database.name}`;
+}
+function publicEndpoint(b) {
+    return { id: b.endpoint.id, host: b.endpoint.host, branch_id: b.id, type: "read_write" };
+}
+function publicDatabase(b) {
+    return { id: 1, branch_id: b.id, name: b.database.name, owner_name: b.database.owner_name, created_at: b.created_at, updated_at: b.created_at };
+}
+/** Neon's GeneralError: `{ code, message }`. */
+function notFound(what) {
+    return new Reply(404, { code: "", message: `${what} not found` });
+}
+function publicBranch(b) {
+    return { id: b.id, name: b.name, parent_id: b.parent_id, default: b.default, current_state: "ready", created_at: b.created_at };
+}
+function locked() {
+    return new Reply(423, { code: "", message: "project already has running conflicting operations, scheduling of new ones is prohibited" });
+}
+//# sourceMappingURL=neon.js.map

package/dist/routes/neon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neon.js","sourceRoot":"","sources":["../../src/routes/neon.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>;