@crvouga/mockingbird-service-clerk

中文文档
0.10.0发布于 2026/11/11MITTypeScriptES Module构建来源已验证近 30 天下载 3078

具有本地命名空间、检查站和测试控制的国有办事员公共供应商API模拟器.

中文使用文档
文档目录3 节
  1. 安装
  2. 使用量
  3. API 密码

@crvouga/mockingbird-service-clerk (英语)

本地模拟器。 真正的API合同. 部分 嘲笑鸟。 。 。 .

OIDC发现,JWKS,OAuth授权/token/userinfo,用户,电子邮件地址,组织,成员,邀请,会话. 通过Mockingbird的便携式抓取运行时间,并带有SQLite坚持性,命名空间,检查站,断层和管理员控制等功能.

安装

npm install @crvouga/mockingbird-service-clerk

使用量

import { createServer } from "@crvouga/mockingbird-service-clerk/server"

const server = await createServer({ seed: 1 })

// The app's Backend API calls, with the emulator's URL in place of https://api.clerk.com.
const headers = { authorization: "Bearer sk_test_fixture", "content-type": "application/json" }
const created = await fetch(`${server.url}/v1/users`, {
  method: "POST",
  headers,
  body: JSON.stringify({ email_address: ["[email protected]"], first_name: "Ada" }),
})
const user = (await created.json()) as { id: string; first_name: string }
const listed = await fetch(`${server.url}/v1/[email protected]`, { headers })
const { data } = (await listed.json()) as { data: { id: string }[] }
console.log(data[0]?.id === user.id) // true
await server.close()

示例使用平面 fetch 因为 @clerk/backend 只解析其回复 content-type 没错 application/json,模拟器则回答 application/json; charset=UTF-8与 createClerkClient({ secretKey, apiUrl: server.url }) 页:1 请求成功, 但资源作为未解析的 JSON 字符串返回 .

API 密码

  • ClerkAPI:便携式提供者实例;接受SQLite,命名空间,时钟,定着和基底Url.
  • createRuntime:共享运行时间,包括本地命名空间和检查站控制.
  • CLERK_NAMESPACE: 默认存储名空间.
  • document, (中文(简体) ), operationIds, (中文(简体) ), supportedOperationIds: 注册供应商路线盘点.
  • createServer, (中文(简体) ), DEFAULT_PORT, (中文(简体) ), serveTarget 从 /server:回放收听器和CLI配置.

fixtures 接受合成供应商种子记录. reset() 恢复默认值。 模拟0.12.1只是一个测试神谕,从来不是一个运行时间依赖. 在Apache-2.0下移植的供应商操作员保留其许可证和归属;见LICENSE EMULATE和TIII PARTY NOTICES.md.

见 支助 覆盖范围和限度以及 API 证据.md 用于验证状态.

版本与发布记录

@crvouga/mockingbird-service-clerk 共发布 20 个版本,首次发布于 2026/10/11;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.0latest2026/11/11今天
0.9.92026/11/038 天前
0.9.82026/11/038 天前
0.9.72026/11/038 天前
0.9.62026/11/038 天前
0.9.52026/11/038 天前

关于 @crvouga/mockingbird-service-clerk 的常见问题

@crvouga/mockingbird-service-clerk 是什么?

具有本地命名空间、检查站和测试控制的国有办事员公共供应商API模拟器.

如何安装 @crvouga/mockingbird-service-clerk?

在项目目录运行 npm install @crvouga/mockingbird-service-clerk,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mockingbird-clerk,可以用 npx mockingbird-clerk 直接运行。

@crvouga/mockingbird-service-clerk 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@crvouga/mockingbird-service-clerk 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@crvouga/mockingbird-service-clerk 可以商用吗?

@crvouga/mockingbird-service-clerk 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@crvouga/mockingbird-service-clerk 的下载量有多少?

根据 npm 官方下载统计,@crvouga/mockingbird-service-clerk 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,078 次,日均约 103 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@crvouga/mockingbird-service-clerk 还在维护吗?

最新版本 0.10.0 发布于 2026/11/11(今天);至今共发布 20 个版本,其中过去 12 个月发布了 20 个;首次发布于 2026/10/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。