Vercel API Emulator

Vercel API模拟器

Fully stateful Vercel REST API emulation with Vercel-style JSON responses and cursor-based pagination.

具备完整状态的Vercel REST API模拟工具，支持Vercel风格的JSON响应和基于游标分页功能。

Start

启动

bash

undefined

bash

undefined

Vercel only

仅启动Vercel模拟服务

npx emulate --service vercel

Default port

默认端口

http://localhost:4000


Or programmatically:

```typescript
import { createEmulator } from 'emulate'

const vercel = await createEmulator({ service: 'vercel', port: 4000 })
// vercel.url === 'http://localhost:4000'


或以编程方式启动：

```typescript
import { createEmulator } from 'emulate'

const vercel = await createEmulator({ service: 'vercel', port: 4000 })
// vercel.url === 'http://localhost:4000'

Auth

认证

Pass tokens as

Authorization: Bearer <token>

. All endpoints accept

teamId

or

slug

query params for team scoping.

bash

curl http://localhost:4000/v2/user \
  -H "Authorization: Bearer test_token_admin"

Team-scoped requests resolve the account from the

teamId

or

slug

query parameter. User-scoped requests resolve the account from the authenticated user.

通过

Authorization: Bearer <token>

传递令牌。所有端点均支持通过

teamId

或

slug

查询参数指定团队作用域。

bash

curl http://localhost:4000/v2/user \
  -H "Authorization: Bearer test_token_admin"

指定团队作用域的请求会通过

teamId

或

slug

查询参数解析账户信息。用户作用域的请求则通过已认证用户解析账户信息。

Pointing Your App at the Emulator

将应用指向模拟器

Environment Variable

环境变量配置

bash

VERCEL_EMULATOR_URL=http://localhost:4000

bash

VERCEL_EMULATOR_URL=http://localhost:4000

Vercel SDK / Custom Fetch

Vercel SDK / 自定义Fetch

typescript

const VERCEL_API = process.env.VERCEL_EMULATOR_URL ?? 'https://api.vercel.com'

const res = await fetch(`${VERCEL_API}/v10/projects`, {
  headers: { Authorization: `Bearer ${token}` },
})

typescript

const VERCEL_API = process.env.VERCEL_EMULATOR_URL ?? 'https://api.vercel.com'

const res = await fetch(`${VERCEL_API}/v10/projects`, {
  headers: { Authorization: `Bearer ${token}` },
})

OAuth URL Mapping

OAuth URL映射

Real Vercel URL Emulator URL

Real Vercel URL	Emulator URL
`https://vercel.com/integrations/oauth/authorize`	`$VERCEL_EMULATOR_URL/oauth/authorize`
`https://api.vercel.com/login/oauth/token`	`$VERCEL_EMULATOR_URL/login/oauth/token`
`https://api.vercel.com/login/oauth/userinfo`	`$VERCEL_EMULATOR_URL/login/oauth/userinfo`

https://vercel.com/integrations/oauth/authorize

$VERCEL_EMULATOR_URL/oauth/authorize

https://api.vercel.com/login/oauth/token

$VERCEL_EMULATOR_URL/login/oauth/token

https://api.vercel.com/login/oauth/userinfo

$VERCEL_EMULATOR_URL/login/oauth/userinfo

真实Vercel URL 模拟器URL

真实Vercel URL	模拟器URL
`https://vercel.com/integrations/oauth/authorize`	`$VERCEL_EMULATOR_URL/oauth/authorize`
`https://api.vercel.com/login/oauth/token`	`$VERCEL_EMULATOR_URL/login/oauth/token`
`https://api.vercel.com/login/oauth/userinfo`	`$VERCEL_EMULATOR_URL/login/oauth/userinfo`

https://vercel.com/integrations/oauth/authorize

$VERCEL_EMULATOR_URL/oauth/authorize

https://api.vercel.com/login/oauth/token

$VERCEL_EMULATOR_URL/login/oauth/token

https://api.vercel.com/login/oauth/userinfo

$VERCEL_EMULATOR_URL/login/oauth/userinfo

Auth.js / NextAuth.js

Auth.js / NextAuth.js配置

typescript

{
  id: 'vercel',
  name: 'Vercel',
  type: 'oauth',
  authorization: {
    url: `${process.env.VERCEL_EMULATOR_URL}/oauth/authorize`,
  },
  token: {
    url: `${process.env.VERCEL_EMULATOR_URL}/login/oauth/token`,
  },
  userinfo: {
    url: `${process.env.VERCEL_EMULATOR_URL}/login/oauth/userinfo`,
  },
  clientId: process.env.VERCEL_CLIENT_ID,
  clientSecret: process.env.VERCEL_CLIENT_SECRET,
  profile(profile) {
    return {
      id: profile.sub,
      name: profile.name,
      email: profile.email,
      image: profile.picture,
    }
  },
}

typescript

{
  id: 'vercel',
  name: 'Vercel',
  type: 'oauth',
  authorization: {
    url: `${process.env.VERCEL_EMULATOR_URL}/oauth/authorize`,
  },
  token: {
    url: `${process.env.VERCEL_EMULATOR_URL}/login/oauth/token`,
  },
  userinfo: {
    url: `${process.env.VERCEL_EMULATOR_URL}/login/oauth/userinfo`,
  },
  clientId: process.env.VERCEL_CLIENT_ID,
  clientSecret: process.env.VERCEL_CLIENT_SECRET,
  profile(profile) {
    return {
      id: profile.sub,
      name: profile.name,
      email: profile.email,
      image: profile.picture,
    }
  },
}

Seed Config

种子配置

yaml

tokens:
  test_token_admin:
    login: admin
    scopes: []

vercel:
  users:
    - username: developer
      name: Developer
      email: dev@example.com
  teams:
    - slug: my-team
      name: My Team
      description: Engineering team
  projects:
    - name: my-app
      team: my-team
      framework: nextjs
      buildCommand: next build
      outputDirectory: .next
      rootDirectory: null
      nodeVersion: "20.x"
      envVars:
        - key: DATABASE_URL
          value: postgres://localhost/mydb
          type: encrypted
          target: [production, preview]
  integrations:
    - client_id: oac_abc123
      client_secret: secret_abc123
      name: My Vercel App
      redirect_uris:
        - http://localhost:3000/api/auth/callback/vercel

yaml

tokens:
  test_token_admin:
    login: admin
    scopes: []

vercel:
  users:
    - username: developer
      name: Developer
      email: dev@example.com
  teams:
    - slug: my-team
      name: My Team
      description: Engineering team
  projects:
    - name: my-app
      team: my-team
      framework: nextjs
      buildCommand: next build
      outputDirectory: .next
      rootDirectory: null
      nodeVersion: "20.x"
      envVars:
        - key: DATABASE_URL
          value: postgres://localhost/mydb
          type: encrypted
          target: [production, preview]
  integrations:
    - client_id: oac_abc123
      client_secret: secret_abc123
      name: My Vercel App
      redirect_uris:
        - http://localhost:3000/api/auth/callback/vercel

Pagination

分页

Cursor-based pagination using

limit

,

since

, and

until

query params. Responses include a

pagination

object:

bash

curl "http://localhost:4000/v10/projects?limit=10" \
  -H "Authorization: Bearer $TOKEN"

使用

limit

、

since

和

until

查询参数实现基于游标的分页。响应结果包含

pagination

对象：

bash

curl "http://localhost:4000/v10/projects?limit=10" \
  -H "Authorization: Bearer $TOKEN"

API Endpoints

API端点

User & Teams

用户与团队

bash

undefined

bash

undefined

Registration check

注册检查

curl http://localhost:4000/registration

Authenticated user

获取已认证用户信息

curl http://localhost:4000/v2/user -H "Authorization: Bearer $TOKEN"

Update user

更新用户信息

curl -X PATCH http://localhost:4000/v2/user
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "New Name", "email": "new@example.com"}'

List teams (cursor paginated)

列出团队（游标分页）

curl http://localhost:4000/v2/teams -H "Authorization: Bearer $TOKEN"

Get team (by ID or slug)

获取团队信息（通过ID或slug）

curl http://localhost:4000/v2/teams/my-team -H "Authorization: Bearer $TOKEN"

Create team

创建团队

curl -X POST http://localhost:4000/v2/teams
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"slug": "new-team", "name": "New Team"}'

Update team (name, slug, description)

更新团队信息（名称、slug、描述）

curl -X PATCH http://localhost:4000/v2/teams/my-team
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "Updated Team", "description": "New description"}'

List members

列出团队成员

curl http://localhost:4000/v2/teams/my-team/members -H "Authorization: Bearer $TOKEN"

Add member (by uid or email, with role)

添加团队成员（通过uid或邮箱，指定角色）

curl -X POST "http://localhost:4000/v2/teams/team_id/members"
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"email": "dev@example.com", "role": "MEMBER"}'


Roles: `OWNER`, `MEMBER`, `DEVELOPER`, `VIEWER`.

curl -X POST "http://localhost:4000/v2/teams/team_id/members"
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"email": "dev@example.com", "role": "MEMBER"}'


角色选项：`OWNER`、`MEMBER`、`DEVELOPER`、`VIEWER`。

Projects

项目

bash

undefined

bash

undefined

Create project (with optional env vars, git, and build config)

创建项目（可配置环境变量、Git和构建参数）

curl -X POST http://localhost:4000/v11/projects
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "my-app", "framework": "nextjs", "buildCommand": "next build", "outputDirectory": ".next", "nodeVersion": "20.x", "environmentVariables": [{"key": "API_KEY", "value": "secret", "type": "encrypted", "target": ["production"]}]}'

List projects (search, cursor pagination)

列出项目（支持搜索、游标分页）

curl "http://localhost:4000/v10/projects?search=my-app"
-H "Authorization: Bearer $TOKEN"

Get project (includes env vars)

获取项目信息（包含环境变量）

curl http://localhost:4000/v9/projects/my-app
-H "Authorization: Bearer $TOKEN"

Update project (framework, buildCommand, devCommand, installCommand,

更新项目信息（框架、构建命令、开发命令、安装命令、

outputDirectory, rootDirectory, nodeVersion, serverlessFunctionRegion,

输出目录、根目录、Node版本、无服务器函数区域、

publicSource, autoAssignCustomDomains, gitForkProtection,

公开源码、自动分配自定义域名、Git分支保护、

commandForIgnoringBuildStep)

忽略构建步骤命令）

curl -X PATCH http://localhost:4000/v9/projects/my-app
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"framework": "remix"}'

Delete project (cascades deployments, domains, env vars, protection bypasses)

删除项目（会级联删除部署、域名、环境变量、防护绕过配置）

curl -X DELETE http://localhost:4000/v9/projects/my-app
-H "Authorization: Bearer $TOKEN"

Promote aliases status

提升别名状态

curl http://localhost:4000/v1/projects/my-app/promote/aliases
-H "Authorization: Bearer $TOKEN"

Protection bypass: generate, revoke, regenerate

防护绕过：生成、撤销、重新生成

curl -X PATCH http://localhost:4000/v1/projects/my-app/protection-bypass
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"generate": {"note": "CI preview", "scope": "deployment"}}'

Revoke protection bypass secrets

撤销防护绕过密钥

curl -X PATCH http://localhost:4000/v1/projects/my-app/protection-bypass
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"revoke": ["secret_to_revoke"]}'

Regenerate protection bypass secrets

重新生成防护绕过密钥

curl -X PATCH http://localhost:4000/v1/projects/my-app/protection-bypass
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"regenerate": ["old_secret"]}'

undefined

curl -X PATCH http://localhost:4000/v1/projects/my-app/protection-bypass
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"regenerate": ["old_secret"]}'

undefined

Deployments

部署

bash

undefined

bash

undefined

Create deployment (auto-transitions to READY)

创建部署（自动转换为READY状态）

curl -X POST http://localhost:4000/v13/deployments
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "my-app", "target": "production", "meta": {"commit": "abc123"}, "regions": ["iad1"], "gitSource": {"type": "github", "ref": "main", "sha": "abc123", "repoId": "123", "org": "my-org", "repo": "my-app", "message": "Deploy", "authorName": "dev", "commitAuthorName": "dev"}}'

Targets: "production", "preview", "staging"

目标环境选项："production"、"preview"、"staging"

Get deployment (by ID or URL)

获取部署信息（通过ID或URL）

curl http://localhost:4000/v13/deployments/dpl_abc123
-H "Authorization: Bearer $TOKEN"

List deployments (filter by projectId, app, target, state; cursor paginated)

列出部署（支持按projectId、应用、目标环境、状态过滤；游标分页）

curl "http://localhost:4000/v6/deployments?projectId=my-app&target=production&limit=10"
-H "Authorization: Bearer $TOKEN"

Delete deployment

删除部署

curl -X DELETE http://localhost:4000/v13/deployments/dpl_abc123
-H "Authorization: Bearer $TOKEN"

Cancel building deployment

取消正在构建的部署

curl -X PATCH http://localhost:4000/v12/deployments/dpl_abc123/cancel
-H "Authorization: Bearer $TOKEN"

List deployment aliases

列出部署别名

curl http://localhost:4000/v2/deployments/dpl_abc123/aliases
-H "Authorization: Bearer $TOKEN"

Get build events/logs (supports direction, limit)

获取构建事件/日志（支持方向、数量限制）

curl "http://localhost:4000/v3/deployments/dpl_abc123/events?direction=forward&limit=50"
-H "Authorization: Bearer $TOKEN"

List deployment files

列出部署文件

curl http://localhost:4000/v6/deployments/dpl_abc123/files
-H "Authorization: Bearer $TOKEN"

Upload file (by SHA digest)

上传文件（通过SHA摘要）

curl -X POST http://localhost:4000/v2/files
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/octet-stream"
-H "x-vercel-digest: sha256hash"
--data-binary @file.txt

undefined

curl -X POST http://localhost:4000/v2/files
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/octet-stream"
-H "x-vercel-digest: sha256hash"
--data-binary @file.txt

undefined

Domains

域名

bash

undefined

bash

undefined

Add domain (with optional redirect, gitBranch, customEnvironmentId)

添加域名（可配置重定向、Git分支、自定义环境ID）

curl -X POST http://localhost:4000/v10/projects/my-app/domains
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "example.com", "redirect": null, "redirectStatusCode": null, "gitBranch": null}'

*.vercel.app domains are auto-verified

*.vercel.app域名会自动验证

List domains (cursor paginated)

列出域名（游标分页）

curl http://localhost:4000/v9/projects/my-app/domains
-H "Authorization: Bearer $TOKEN"

Get, update, remove domain

获取、更新、删除域名

curl http://localhost:4000/v9/projects/my-app/domains/example.com
-H "Authorization: Bearer $TOKEN"

Verify domain

验证域名

curl -X POST http://localhost:4000/v9/projects/my-app/domains/example.com/verify
-H "Authorization: Bearer $TOKEN"


Redirect status codes: `301`, `302`, `307`, `308`.

curl -X POST http://localhost:4000/v9/projects/my-app/domains/example.com/verify
-H "Authorization: Bearer $TOKEN"


重定向状态码选项：`301`、`302`、`307`、`308`。

Environment Variables

环境变量

bash

undefined

bash

undefined

List env vars (with decrypt option; filter by gitBranch, customEnvironmentId)

列出环境变量（支持解密选项；可按Git分支、自定义环境ID过滤）

curl "http://localhost:4000/v10/projects/my-app/env?decrypt=true"
-H "Authorization: Bearer $TOKEN"

Create env vars (single, batch, or upsert)

创建环境变量（支持单个、批量或更新插入）

curl -X POST "http://localhost:4000/v10/projects/my-app/env?upsert=true"
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"key": "API_KEY", "value": "secret123", "type": "encrypted", "target": ["production", "preview"], "comment": "API key for service"}'

Get env var

获取环境变量信息

curl http://localhost:4000/v10/projects/my-app/env/env_abc123
-H "Authorization: Bearer $TOKEN"

Update env var

更新环境变量

curl -X PATCH http://localhost:4000/v9/projects/my-app/env/env_abc123
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"value": "newsecret"}'

Delete env var

删除环境变量

curl -X DELETE http://localhost:4000/v9/projects/my-app/env/env_abc123
-H "Authorization: Bearer $TOKEN"


Env var types: `system`, `encrypted`, `plain`, `secret`, `sensitive`.

curl -X DELETE http://localhost:4000/v9/projects/my-app/env/env_abc123
-H "Authorization: Bearer $TOKEN"


环境变量类型：`system`、`encrypted`、`plain`、`secret`、`sensitive`。

API Keys

API密钥

bash

undefined

bash

undefined

Create API key (optional teamId scope)

创建API密钥（可选指定teamId作用域）

curl -X POST "http://localhost:4000/v1/api-keys?teamId=team_abc123"
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "CI Deploy Key"}'

List API keys (optional teamId filter)

列出API密钥（可选按teamId过滤）

curl "http://localhost:4000/v1/api-keys?teamId=team_abc123"
-H "Authorization: Bearer $TOKEN"

Delete API key

删除API密钥

curl -X DELETE http://localhost:4000/v1/api-keys/ak_abc123
-H "Authorization: Bearer $TOKEN"


Created API keys are automatically registered in the token map and can be used as Bearer tokens for all endpoints.

curl -X DELETE http://localhost:4000/v1/api-keys/ak_abc123
-H "Authorization: Bearer $TOKEN"


创建的API密钥会自动注册到令牌映射中，可作为Bearer令牌用于所有端点。

OAuth / Integrations

OAuth / 集成

bash

undefined

bash

undefined

Authorize (browser flow, shows user picker)

授权（浏览器流程，显示用户选择器）

GET /oauth/authorize?client_id=...&redirect_uri=...&scope=...&state=...

Token exchange (supports PKCE; accepts JSON or form-urlencoded)

令牌交换（支持PKCE；接受JSON或表单编码格式）

curl -X POST http://localhost:4000/login/oauth/token
-H "Content-Type: application/json"
-d '{"client_id": "oac_abc123", "client_secret": "secret_abc123", "code": "<code>", "redirect_uri": "http://localhost:3000/api/auth/callback/vercel"}'

User info (returns sub, email, email_verified, name, preferred_username, picture)

用户信息（返回sub、email、email_verified、name、preferred_username、picture）

curl http://localhost:4000/login/oauth/userinfo
-H "Authorization: Bearer $TOKEN"

undefined

curl http://localhost:4000/login/oauth/userinfo
-H "Authorization: Bearer $TOKEN"

undefined

Common Patterns

常见使用模式

Create Project and Deploy

创建项目并部署

bash

TOKEN="test_token_admin"
BASE="http://localhost:4000"

bash

TOKEN="test_token_admin"
BASE="http://localhost:4000"

Create project

创建项目

curl -X POST $BASE/v11/projects
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "my-app", "framework": "nextjs"}'

Add env var

添加环境变量

curl -X POST $BASE/v10/projects/my-app/env
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"key": "DATABASE_URL", "value": "postgres://...", "type": "encrypted", "target": ["production"]}'

Create deployment

创建部署

curl -X POST $BASE/v13/deployments
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "my-app", "target": "production"}'

undefined

curl -X POST $BASE/v13/deployments
-H "Authorization: Bearer $TOKEN"
-H "Content-Type: application/json"
-d '{"name": "my-app", "target": "production"}'

undefined

OAuth Integration Flow

OAuth集成流程

Redirect user to

$VERCEL_EMULATOR_URL/oauth/authorize?client_id=...&redirect_uri=...&state=...

User picks a seeded user on the emulator's UI
Emulator redirects back with
```
?code=...&state=...
```
Exchange code for token via
```
POST /login/oauth/token
```
Fetch user info via
```
GET /login/oauth/userinfo
```

PKCE is supported. Pass

code_challenge

and

code_challenge_method

on authorize, then

code_verifier

on token exchange.

将用户重定向至

$VERCEL_EMULATOR_URL/oauth/authorize?client_id=...&redirect_uri=...&state=...

用户在模拟器UI中选择一个预配置的用户
模拟器重定向回原地址并携带
```
?code=...&state=...
```
通过
```
POST /login/oauth/token
```
交换令牌
通过
```
GET /login/oauth/userinfo
```
获取用户信息

支持PKCE流程。在授权时传递

code_challenge

和

code_challenge_method

，然后在令牌交换时传递

code_verifier

。

Team-Scoped Requests

团队作用域请求

All endpoints accept

teamId

or

slug

query params:

bash

curl "http://localhost:4000/v10/projects?teamId=team_abc123" \
  -H "Authorization: Bearer $TOKEN"

curl "http://localhost:4000/v10/projects?slug=my-team" \
  -H "Authorization: Bearer $TOKEN"

所有端点均支持

teamId

或

slug

查询参数：

bash

curl "http://localhost:4000/v10/projects?teamId=team_abc123" \
  -H "Authorization: Bearer $TOKEN"

curl "http://localhost:4000/v10/projects?slug=my-team" \
  -H "Authorization: Bearer $TOKEN"

vercel

Original

Translation

Vercel API Emulator

Vercel API模拟器

Start

启动

Vercel only

仅启动Vercel模拟服务

Default port

默认端口

http://localhost:4000

http://localhost:4000

Auth

认证

Pointing Your App at the Emulator

将应用指向模拟器

Environment Variable

环境变量配置

Vercel SDK / Custom Fetch

Vercel SDK / 自定义Fetch

OAuth URL Mapping

OAuth URL映射

Auth.js / NextAuth.js

Auth.js / NextAuth.js配置

Seed Config

种子配置

Pagination

分页

API Endpoints

API端点

User & Teams

用户与团队

Registration check

注册检查

Authenticated user

获取已认证用户信息

Update user

更新用户信息

List teams (cursor paginated)

列出团队（游标分页）

Get team (by ID or slug)

获取团队信息（通过ID或slug）

Create team

创建团队

Update team (name, slug, description)

更新团队信息（名称、slug、描述）

List members

列出团队成员

Add member (by uid or email, with role)

添加团队成员（通过uid或邮箱，指定角色）

Projects

项目

Create project (with optional env vars, git, and build config)

创建项目（可配置环境变量、Git和构建参数）

List projects (search, cursor pagination)

列出项目（支持搜索、游标分页）

Get project (includes env vars)

获取项目信息（包含环境变量）

Update project (framework, buildCommand, devCommand, installCommand,

更新项目信息（框架、构建命令、开发命令、安装命令、

outputDirectory, rootDirectory, nodeVersion, serverlessFunctionRegion,

输出目录、根目录、Node版本、无服务器函数区域、

publicSource, autoAssignCustomDomains, gitForkProtection,

公开源码、自动分配自定义域名、Git分支保护、

commandForIgnoringBuildStep)

忽略构建步骤命令）

Delete project (cascades deployments, domains, env vars, protection bypasses)

删除项目（会级联删除部署、域名、环境变量、防护绕过配置）

Promote aliases status

提升别名状态

Protection bypass: generate, revoke, regenerate

防护绕过：生成、撤销、重新生成

Revoke protection bypass secrets

撤销防护绕过密钥

Regenerate protection bypass secrets

重新生成防护绕过密钥

Deployments

部署

Create deployment (auto-transitions to READY)