@sponson/sim 0.0.0-stage → 0.4.0

package/dist/routes/clerk.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Simulated Clerk: the instance's allowed redirect URLs.
+ *
+ * Assumptions about the real API that this fake encodes, each marked with how far it is checked. "Verified" means
+ * against Clerk's published Backend API OpenAPI document (github.com/clerk/openapi-specs, bapi/2026-05-12.yml,
+ * identical for /redirect_urls back to 2021-02-05; fetched 2026-10-10); see docs/api-verification.md:
+ *   C1. A duplicate redirect URL answers 422 (ClerkErrors body). Unverified: the spec documents 400 and 422 for
+ *       POST /redirect_urls without saying which a duplicate gets. The adapter checks the list after either.
+ *   C2. GET /redirect_urls is a bare JSON array (verified); with `paginated=true` it is `{ data, total_count }`
+ *       paged by `offset`/`limit` (limit 1–500, default 10: verified parameters). The envelope is not in the
+ *       spec; it is how Clerk's own SDKs (clerk/javascript RedirectUrlApi, clerk-sdk-go redirecturl) call and
+ *       decode it. Chaos `page_size` caps the page further.
+ *   C3. A redirect URL is `{ object: "redirect_url", id, url, created_at, updated_at }` and DELETE answers a
+ *       DeletedObject `{ object, id, deleted }` (verified).
+ */
+import { type CreatedBy, type ProviderSim } from "../provider.js";
+/** One allow-listed redirect URL. */
+export interface ClerkRedirect {
+    id: string;
+    url: string;
+    createdAt: number;
+    createdBy: CreatedBy;
+}
+/** Simulated Clerk: the instance's redirect allow-list. */
+export interface ClerkState {
+    redirect_urls: ClerkRedirect[];
+}
+/** Initial Clerk state. */
+export interface ClerkSeed {
+    redirect_urls: string[];
+}
+/** Simulated Clerk (redirect URL allow-list); see the assumptions at the top of this file. */
+export declare const clerkSim: ProviderSim<ClerkState, ClerkSeed>;

package/dist/routes/clerk.js

@@ -0,0 +1,85 @@
+/**
+ * Simulated Clerk: the instance's allowed redirect URLs.
+ *
+ * Assumptions about the real API that this fake encodes, each marked with how far it is checked. "Verified" means
+ * against Clerk's published Backend API OpenAPI document (github.com/clerk/openapi-specs, bapi/2026-05-12.yml,
+ * identical for /redirect_urls back to 2021-02-05; fetched 2026-10-10); see docs/api-verification.md:
+ *   C1. A duplicate redirect URL answers 422 (ClerkErrors body). Unverified: the spec documents 400 and 422 for
+ *       POST /redirect_urls without saying which a duplicate gets. The adapter checks the list after either.
+ *   C2. GET /redirect_urls is a bare JSON array (verified); with `paginated=true` it is `{ data, total_count }`
+ *       paged by `offset`/`limit` (limit 1–500, default 10: verified parameters). The envelope is not in the
+ *       spec; it is how Clerk's own SDKs (clerk/javascript RedirectUrlApi, clerk-sdk-go redirecturl) call and
+ *       decode it. Chaos `page_size` caps the page further.
+ *   C3. A redirect URL is `{ object: "redirect_url", id, url, created_at, updated_at }` and DELETE answers a
+ *       DeletedObject `{ object, id, deleted }` (verified).
+ */
+import { page, Reply, route, router } from "../provider.js";
+/** Simulated Clerk (redirect URL allow-list); see the assumptions at the top of this file. */
+export const clerkSim = {
+    env: { token: "CLERK_SECRET_KEY", url: "CLERK_API_URL", testToken: "tok_clerk" },
+    defaultSeed: { redirect_urls: [] },
+    reset(core, seed) {
+        const now = Date.now();
+        return { redirect_urls: (seed?.redirect_urls ?? []).map((url) => redirect(core, url, now, "sim")) };
+    },
+    /** `redirect.<url>`: "delete" | "recreate". Clerk has one instance per key, so there is no `clerk:<project>.` form. */
+    drift(core, state, { key, rest, value, only }) {
+        if (only !== undefined || !rest.startsWith("redirect."))
+            return false;
+        const url = rest.slice("redirect.".length);
+        if (value !== "delete" && value !== "recreate")
+            throw new Error(`drift ${key}: only "delete" and "recreate" are supported`);
+        const hit = state.redirect_urls.filter((r) => r.url === url);
+        state.redirect_urls = state.redirect_urls.filter((r) => !hit.includes(r));
+        if (value === "recreate")
+            for (const r of hit)
+                state.redirect_urls.push(redirect(core, r.url, Date.now(), "sim"));
+        return true;
+    },
+    routes(core, state, req) {
+        return routes(core, state, req);
+    },
+};
+const routes = router([
+    route("GET", "/redirect_urls", ({ core, state, url }) => {
+        const all = state.redirect_urls.map(publicRedirect);
+        if (url.searchParams.get("paginated") !== "true")
+            return new Reply(200, all);
+        const limit = url.searchParams.get("limit");
+        const offset = url.searchParams.get("offset");
+        if ((limit !== null && !/^\d+$/.test(limit)) || (offset !== null && !/^\d+$/.test(offset)) || Number(limit ?? 10) < 1 || Number(limit ?? 10) > 500) {
+            return clerkError(422, "form_param_format_invalid", "limit must be 1–500 and offset ≥ 0");
+        }
+        const pg = page(core, all, offset, Number(limit ?? 10));
+        return new Reply(200, { data: pg.items, total_count: all.length });
+    }),
+    route("POST", "/redirect_urls", ({ core, state, body }) => {
+        const b = (body ?? {});
+        if (!b.url)
+            return clerkError(422, "form_param_missing", "url is required");
+        if (state.redirect_urls.some((r) => r.url === b.url))
+            return clerkError(422, "duplicate_record", "redirect url already exists");
+        const r = redirect(core, b.url, Date.now(), "api");
+        state.redirect_urls.push(r);
+        return new Reply(200, publicRedirect(r));
+    }),
+    route("DELETE", "/redirect_urls/:id", ({ state, params }) => {
+        const r = state.redirect_urls.find((x) => x.id === params.id);
+        if (!r)
+            return clerkError(404, "resource_not_found", "not found");
+        state.redirect_urls = state.redirect_urls.filter((x) => x !== r);
+        return new Reply(200, { id: r.id, object: "redirect_url", deleted: true });
+    }),
+], () => clerkError(404, "resource_not_found", "not found"));
+/** The spec's RedirectURL: `object`, `id`, `url`, `created_at`, `updated_at` (all required). */
+function publicRedirect(r) {
+    return { object: "redirect_url", id: r.id, url: r.url, created_at: r.createdAt, updated_at: r.createdAt };
+}
+/** The spec's ClerkErrors body. */
+function clerkError(status, code, message) {
+    return new Reply(status, { errors: [{ code, message, long_message: message }] });
+}
+function redirect(core, url, createdAt, createdBy) {
+    return { id: core.nextId("ru_"), url, createdAt, createdBy };
+}
+//# sourceMappingURL=clerk.js.map

package/dist/routes/clerk.js.map

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

package/dist/routes/neon.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 { type CreatedBy, type ProviderSim, type SimCore } from "../provider.js";
+/** One simulated Neon branch. */
+export interface NeonBranch {
+    id: string;
+    name: string;
+    parent_id: string | null;
+    /** The project's root branch (Neon's `default`, formerly `primary`). */
+    default: boolean;
+    /** Async operations started by the create are running until this time: writes to the branch answer 423. */
+    opUntil: number;
+    created_at: string;
+    endpoint: {
+        id: string;
+        host: string;
+    };
+    /** The branch's one database and the role owning it; a child branch copies its parent's. */
+    database: {
+        name: string;
+        owner_name: string;
+    };
+    createdAt: number;
+    createdBy: CreatedBy;
+}
+/** One simulated Neon project and its branches. */
+export interface NeonProject {
+    branches: NeonBranch[];
+    /** A branch create's operations are running until this time: further creates answer 423. */
+    opUntil: number;
+}
+/** Simulated Neon: projects by id. */
+export interface NeonState {
+    projects: Record<string, NeonProject>;
+}
+/** Initial Neon state. */
+export interface NeonSeed {
+    projects: Record<string, {
+        branches: Array<{
+            name: string;
+            parent?: string;
+        }>;
+    }>;
+}
+/** Simulated Neon (projects, branches, operations); see the assumptions at the top of this file. */
+export declare const neonSim: ProviderSim<NeonState, NeonSeed>;
+/**
+ * Add a branch to a project as Neon would (ids, timestamps, default flag). Tests use it to seed "someone else's"
+ * branch.
+ */
+export declare function createBranch(core: SimCore, project: NeonProject, name: string, parentId: string | null, createdBy: CreatedBy): NeonBranch;
+/** The connection string Neon would hand out for a branch. */
+export declare function connectionUri(branch: NeonBranch): string;

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":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAkD,MAAM,gBAAgB,CAAC;AAoC5G,oGAAoG;AACpG,MAAM,CAAC,MAAM,OAAO,GAAqC;IACvD,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE;IAC1E,WAAW,EAAE,EAAE,QAAQ,EAAE,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;IAE1E,KAAK,CAAC,IAAI,EAAE,IAAI;QACd,MAAM,KAAK,GAAc,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3D,MAAM,OAAO,GAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACxF,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC9E,8FAA8F;gBAC9F,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;oBAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3F,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;QAC3C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,8CAA8C,CAAC,CAAC;QAC5H,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI;gBAAE,SAAS;YAChD,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YACtD,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACxD,IAAI,KAAK,KAAK,UAAU;gBAAE,KAAK,MAAM,CAAC,IAAI,GAAG;oBAAE,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACnG,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG;QACrB,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,GAAG,MAAM,CACnB;IACE,KAAK,CAAC,KAAK,EAAE,6BAA6B,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;QAC3E,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClE,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACjI,CAAC,CAAC;IAEF,KAAK,CAAC,MAAM,EAAE,6BAA6B,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;QAC7E,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO;YAAE,OAAO,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAuD,CAAC;QAC7E,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAChF,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACnH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI,CAAC;QAC7C,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC;YAAE,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QAC/F,8GAA8G;QAC9G,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE;YACpB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;YAC5B,SAAS,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACnC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;YACnJ,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YACnE,SAAS,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YACnC,eAAe,EAAE,CAAC,EAAE,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,qBAAqB,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;SACtL,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,KAAK,CAAC,KAAK,EAAE,+CAA+C,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAClF,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrF,CAAC,CAAC;IAEF,KAAK,CAAC,KAAK,EAAE,+CAA+C,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QAClF,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrF,CAAC,CAAC;IAEF,KAAK,CAAC,KAAK,EAAE,mCAAmC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;QAC3E,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAClC,kDAAkD;QAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC,CAAC;QACjH,IAAI,QAAQ,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI;YAAE,OAAO,QAAQ,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAC;QAC1E,IAAI,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU;YAAE,OAAO,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,KAAK,CAAC,QAAQ,EAAE,qCAAqC,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACjF,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO;YAAE,OAAO,MAAM,EAAE,CAAC;QAC5C,yGAAyG;QACzG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/J,CAAC,CAAC;CACH,EACD,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CACxB,CAAC;AAEF,yEAAyE;AACzE,SAAS,QAAQ,CAAC,KAAgB,EAAE,OAAe,EAAE,QAAuB;IAC1E,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,OAAoB,EAAE,IAAY,EAAE,QAAuB,EAAE,SAAoB;IAC3H,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAe;QACzB,EAAE;QACF,IAAI;QACJ,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,gBAAgB,EAAE;QACjE,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,QAAQ,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE;QACpH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,SAAS;KACV,CAAC;IACF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAC1B,MAAM,IAAI,GAAG,cAAc,CAAC;AAE5B,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC9C,OAAO,cAAc,MAAM,CAAC,QAAQ,CAAC,UAAU,OAAO,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACpH,CAAC;AAED,SAAS,cAAc,CAAC,CAAa;IACnC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AAC3F,CAAC;AAED,SAAS,cAAc,CAAC,CAAa;IACnC,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;AAClJ,CAAC;AAED,gDAAgD;AAChD,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,YAAY,CAAC,CAAa;IACjC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;AAClI,CAAC;AAED,SAAS,MAAM;IACb,OAAO,IAAI,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,0FAA0F,EAAE,CAAC,CAAC;AAC3I,CAAC"}

package/dist/routes/vercel.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Simulated Vercel: project env vars and deployments.
+ *
+ * Assumptions about the real API that this fake encodes, each marked with how far it is checked. "Verified" means
+ * against Vercel's published OpenAPI document (https://openapi.vercel.sh/, fetched 2026-10-10); see
+ * docs/api-verification.md for the per-call table. A local fake cannot prove the rest; scenarios/contract.test.ts
+ * pins the critical ones against live accounts (`pnpm test:live`):
+ *   V1. Env writes are visible to the next deployment immediately (no propagation delay). Lists are
+ *       read-your-writes here; the real list may lag a write, so adapters trust write responses instead.
+ *       Unverified: needs a live account.
+ *   V2. GET /v7/deployments?projectId=&sha= filters by commit and returns newest first. The `sha` filter is
+ *       verified (a v7 query parameter; v6 is not in the spec); items carry `readyState` (required) and `state`
+ *       (optional), and `url` may be null until the upload completes (verified). The order is unverified: the
+ *       adapter sorts by createdAt anyway.
+ *   V3. GET /v10/projects/:id/env?decrypt=true returns plaintext with `decrypted: true`; without `decrypt`,
+ *       `encrypted` values are opaque. `decrypt` (deprecated), `decrypted` and GET /v1/projects/:id/env/:id
+ *       ("Retrieve the decrypted value") are verified; whether the deprecated parameter still decrypts is
+ *       unverified, so the adapter falls back to the per-variable GET. `sensitive` values are never returned
+ *       (the GET /v1 variant without `value`), so those always diff as `update`.
+ *   V4. POST /v10/projects/:id/env?upsert=true answers 201 with `{ created, failed }` (verified: `upsert`, the
+ *       status, `created` as one object or a list, `failed[].error` with `code`, `message`, `key`/`envVarKey`).
+ *       Unverified: that `created` lists every entry written (new or updated, `createdAt === updatedAt` only for
+ *       new ones), and that an entry whose key+gitBranch exists with an overlapping but different target set
+ *       fails the whole request with 400 `ENV_CONFLICT`. Entries named in chaos `env_upsert_fail` come back under
+ *       `failed` and are not written. Without `upsert` a duplicate answers 403 (verified: documented 403 reason).
+ *   V5. POST /v13/deployments: `project` overrides `name` and a GitHub `gitSource` needs `ref` plus `repoId` (or
+ *       `org` + `repo`) — both verified, as is `forceNew`. Deployments go QUEUED → BUILDING → READY over chaos
+ *       `deploy_ms` (default 0: READY at once; the real API also passes through INITIALIZING, which the adapter
+ *       handles as in progress). Every deployment has its own URL (verified: "the unique URL of the deployment").
+ *       `deploy: cancel` cancels a branch's in-progress builds when a new one starts (unverified).
+ *   V6. Pagination (chaos `page_size`): `{ envs, pagination: { count, next, prev } }` (verified: the spec's
+ *       Pagination schema). The `?until=` page parameter is unverified for the env list, which documents no page
+ *       parameter; the adapter drops repeated records, so an API that ignores it costs one extra request.
+ *   V7. GET /v9/projects/:id carries `link`, the connected repository (`type`, `repoId`, …); verified.
+ *   V8. GET /v7/deployments accepts `target` (`production` | `preview`) and each item's `target` is `production`,
+ *       a custom environment name such as `staging`, or null for a preview; verified against the spec's
+ *       `/v7/deployments` parameters and item schema. The git integration builds previews; production builds
+ *       of a commit exist separately.
+ */
+import { type CreatedBy, type ProviderSim, type SimCore } from "../provider.js";
+/** One simulated Vercel environment variable. */
+export interface VercelEnv {
+    id: string;
+    key: string;
+    value: string;
+    target: string[];
+    type: "encrypted" | "plain";
+    gitBranch?: string;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: CreatedBy;
+}
+/** Vercel's deployment states, as its API reports them. */
+export type DeploymentState = "QUEUED" | "BUILDING" | "READY" | "ERROR" | "CANCELED";
+/** One simulated deployment. */
+export interface VercelDeployment {
+    uid: string;
+    url: string;
+    state: DeploymentState;
+    createdAt: number;
+    /** While in progress: QUEUED until `buildingAt`, BUILDING until `readyAt`, then `finalState`. */
+    buildingAt?: number;
+    readyAt?: number;
+    finalState?: DeploymentState;
+    meta: {
+        githubCommitSha: string;
+        githubCommitRef?: string;
+    };
+    /** `production` for production deployments, null for previews. */
+    target: "production" | null;
+    createdBy: CreatedBy;
+}
+/** The Git repository a project is connected to (`link` in GET /v9/projects/:id); null when it has none. */
+export interface VercelLink {
+    type: "github";
+    repoId: number;
+    org: string;
+    repo: string;
+    productionBranch: string;
+}
+/** One simulated Vercel project: its variables, deployments and Git connection. */
+export interface VercelProject {
+    envs: VercelEnv[];
+    deployments: VercelDeployment[];
+    link: VercelLink | null;
+}
+/** Simulated Vercel: projects by id. */
+export interface VercelState {
+    projects: Record<string, VercelProject>;
+}
+/** Initial Vercel state. */
+export interface VercelSeed {
+    projects: Record<string, {
+        envs: Array<{
+            key: string;
+            value: string;
+            target: string;
+            gitBranch?: string;
+        }>;
+    }>;
+}
+/** Simulated Vercel (env vars, deployments); see the assumptions at the top of this file. */
+export declare const vercelSim: ProviderSim<VercelState, VercelSeed>;
+/**
+ * Every deployment gets its own URL: the first one of a sha is `<project>-<sha8>.vercel.app`, later ones
+ * (redeploys) `-2`, `-3`, … `buildMs` > 0 starts it QUEUED and makes it reach `state` over that time.
+ */
+export declare function createDeployment(core: SimCore, projectId: string, project: VercelProject, sha: string, state: DeploymentState, createdAt: number, opts?: {
+    ref?: string;
+    buildMs?: number;
+    target?: "production";
+}): VercelDeployment;
+/** Advance in-progress deployments to the state their timings say they are in now. */
+export declare function refreshDeployments(list: VercelDeployment[], now?: number): void;