@crvouga/mockingbird-service-google-日历

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

状态模拟器 谷歌日历 v3 财务报告和审定财务报表 Google OAuth 2.0 (英语) 测试套房,涵盖什么 我们的EMR后端呼叫: calendarList.list, (中文(简体) ), calendars.insert, (中文(简体) ), events.list (时间窗口, q, (中文(简体) ), orderBy,呼号,与 410 同步递增 fullSyncRequired, (中文(简体) ), events.get/insert/ update/delete, (中文(简体) ), events.watch 将通知推到频道的地址 channels.stop;加符号终点(授权代码和刷新赠款),撤销,以及 OpenID 用户信息 。 从业人员连接、同步EMR任命并接受日历推 没有谷歌的账户.

• 行动范围: 支助
• 合同openapi.yaml从Google的日历 v3 发现文档中修剪 OAuth 文档到什么 google-calendar-service.ts, (中文(简体) ), authorize.business.ts 和网络 控制器的使用.

安装

npm install -D @crvouga/mockingbird-service-google-calendar

仅限无害环境管理。 节点 22或 Bun 1.2. 无土生属地. 给它服务 npx mockingbird-google-calendar serve, (中文(简体) ), createServer 从 ./server (节点),或 createRuntime 与任何获取服务器.

使用量

接合( 应用程序的硬码今天 Google ): 给日历客户端一个 rootUrl (单位:千美元)google.calendar({version: "v3", auth, rootUrl: "<emulator>/"})),给出 OAuth2Client endpoints: {oauth2TokenUrl: "<emulator>/token", oauth2RevokeUrl: "<emulator>/revoke"},并点 用户信息获取到 <emulator>/oauth2/v3/userinfo。 。 。 . GOOGLE_WEBHOOK_URL 可以保持原样:仿真者 帖子推向任何东西 address 应用程序注册(允许http,除非 --require-https-webhooks) (中文(简体) ).

npx mockingbird-google-calendar serve --port 8820 --client "$GOOGLE_CLIENT_ID:$GOOGLE_CLIENT_SECRET"

import { auth, calendar } from "@googleapis/calendar"
import { OAuth2Client } from "google-auth-library"
import { createServer } from "@crvouga/mockingbird-service-google-calendar/server"

const google = await createServer()

// The application's OAuth and Calendar clients. Only their URLs change.
const oauth = new OAuth2Client({
  clientId: "c",
  clientSecret: "s",
  redirectUri: "postmessage",
  endpoints: { oauth2TokenUrl: `${google.url}/token`, oauth2RevokeUrl: `${google.url}/revoke` },
})
// Authorization code "4/mock-<name>" signs in <name>@example.com ("4/mock-<email>" for others).
const { tokens } = await oauth.getToken("4/mock-dr.house")
const client = new auth.OAuth2()
client.setCredentials({ access_token: tokens.access_token ?? null })
const cal = calendar({ version: "v3", auth: client, rootUrl: `${google.url}/` })
await cal.events.insert({
  calendarId: "primary",
  requestBody: { summary: "Rounds", start: { dateTime: "2026-10-01T15:00:00Z" }, end: { dateTime: "2026-10-01T16:00:00Z" } },
})

await google.close()

在Google的UI(admin路由)中创建的事件

import { auth, calendar } from "@googleapis/calendar"
import { OAuth2Client } from "google-auth-library"
import { createServer } from "@crvouga/mockingbird-service-google-calendar/server"

const google = await createServer()

// Test control: the practitioner adds an event in Google's UI.
await fetch(`${google.url}/__admin/events`, {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    email: "[email protected]",
    event: { summary: "Rounds", start: { dateTime: "2026-10-01T15:00:00Z" }, end: { dateTime: "2026-10-01T16:00:00Z" } },
  }),
})

// The application lists it through the Calendar client.
const oauth = new OAuth2Client({
  clientId: "c",
  clientSecret: "s",
  redirectUri: "postmessage",
  endpoints: { oauth2TokenUrl: `${google.url}/token` },
})
const { tokens } = await oauth.getToken("4/mock-dr.house")
const client = new auth.OAuth2()
client.setCredentials({ access_token: tokens.access_token ?? null })
const cal = calendar({ version: "v3", auth: client, rootUrl: `${google.url}/` })
const { data } = await cal.events.list({ calendarId: "primary" })
console.log(data.items?.map((event) => event.summary)) // ["Rounds"]

await google.close()

路线

错误使用 Google 的信封 {error: {errors: [{domain, reason, message}], code, message, status?}}。 。 。 . 无效或过期的访问令牌为 401 authError (用户信息 : invalid_request) (中文(简体) ).

推动通知

每次更改日历事件( 通过 API 或 管理员平面) 都会张贴到每个直播 该日历上的频道: 空正文 X-Goog-Channel-ID, (中文(简体) ), X-Goog-Channel-Token (当 设定), X-Goog-Channel-Expiration (RFC 1123), (中文(简体) ), X-Goog-Message-Number (1个) sync,然后为+1, X-Goog-Resource-ID, (中文(简体) ), X-Goog-Resource-URI 财务报告和审定财务报表 X-Goog-Resource-State (单位:千美元)sync,则 exists。停止或过期的(模拟时钟)频道获得什么也没有。 非-2xx 答案被重审 (一等会,一等会,一等会,一等会,一等会). GET /__admin/webhooks * 清单交付,以及 /__admin/webhooks/events, (中文(简体) ), …/replay, (中文(简体) ), …/flush 工作如常.

管理员(超过标准合同)

错误预设( E)POST /__admin/faults {"preset": "<name>", "count"?: n}: invalid_grant, (中文(简体) ), token_expired, (中文(简体) ), rate_limited (403个上限), too_many_requests (429个), calendar_api_disabled (403次访问未配置), insufficient_scopes, (中文(简体) ), sync_token_gone, (中文(简体) ), backend_error (503个), connection_drop, (中文(简体) ), push_duplicate, (中文(简体) ), push_drop. gaxios 重试 429 和 5xx本身,所以通过一个 count 超过其预算(三次检讨).

命名空间

由账号: 访问符携带他们的电子邮件,所以 PUT /__admin/credentials {"credentials": {"[email protected]": "<namespace>"}} 路径 日历和用户信息呼叫. x-mockingbird-namespace 和往常一样 A 类 /__admin/ns/<name> 前缀 用于符号、撤销和用户信息 URL (它们是完整的 URL) 但不用于日历 客户端: googleapis 解析路径与 rootUrl'来源并放下路径前缀.

SDK 软件

测试驱动真正的客户端堆栈 googleapis@149数字 : @googleapis/[email protected] (中文(简体) ) 在 googleapis- common 7 / gaxios 6 上生成日历模块; 完整 googleapis 软件包是 ~125 MB已解开,因此只安装了模块)并 [email protected]。 。 。 .

故意不模拟

• 经常性活动recurrence 、参与者的答复和电子邮件 请访问链接、 免费/ 繁忙、 ACL 、 颜色和设置 .
• 真实的谷歌身份 : id_tokens是JWT形但与Google的密钥没有签名.
• X-Goog-Changed (Google为日历事件频道省略)和 not_exists 各州.

API 密码

部分 嘲笑鸟。 。 。 .