Vercel

Local emulators. Real API contracts. Part of Mockingbird.

projects, deployments, domains, env vars, users, teams, file uploads, protection bypass, blob storage. Runs through Mockingbird's portable Fetch runtime with SQLite persistence, namespaces, checkpoints, faults and admin controls.

#Install

npm install @crvouga/mockingbird-service-vercel

#Usage

import { Vercel } from "@vercel/sdk"
import { HTTPClient } from "@vercel/sdk/lib/http.js"
import { createRuntime } from "@crvouga/mockingbird-service-vercel"

// Test setup: the emulator, seeded with one synthetic project.
const emulator = createRuntime({ fixtures: { projects: [{ name: "fixture-app", framework: "nextjs" }] } })

// The app's own Vercel client. Only its HTTP client changes: requests reach the
// emulator in this process instead of api.vercel.com.
const vercel = new Vercel({
  bearerToken: "fixture-token",
  httpClient: new HTTPClient({
    fetcher: (input: RequestInfo | URL, init?: RequestInit) => emulator.fetch(new Request(input, init)),
  }),
})
const domain = await vercel.projects.addProjectDomain({
  idOrName: "fixture-app",
  requestBody: { name: "fixture.example.com" },
})
console.log(domain.verified) // false
const { domains } = await vercel.projects.getProjectDomains({ idOrName: "fixture-app" })
console.log(domains.map((each) => each.name)) // ["fixture.example.com"]

@vercel/sdk validates every response against Vercel's full schema. With 1.28 the domain, user, team and deployment-list calls pass; createProject, getProjects, filterProjectEnvs, createProjectEnv and createDeployment reach the emulator but fail the SDK's response validation.

#API

• VercelAPI: portable provider instance; accepts SQLite, namespace, clock, fixtures and baseUrl.
• createRuntime: shared runtime, including native namespace and checkpoint controls.
• VERCEL_NAMESPACE: default storage namespace.
• document, operationIds, supportedOperationIds: registered provider route inventory.
• createServer, DEFAULT_PORT, serveTarget from /server: loopback listener and CLI configuration.

fixtures accepts synthetic provider seed records. reset() restores defaults. Emulate 0.12.1 is a test oracle only, never a runtime dependency. Vendor handlers ported under Apache-2.0 retain their license and attribution; see LICENSE_EMULATE and THIRD_PARTY_NOTICES.md.

See SUPPORT.md for coverage and limits and API_EVIDENCE.md for validation status.