返回资讯中心
外部精选
软件工程
#开发者实时流

开发者发布 calsdk:用一套 TypeScript API 统一接入 Google、Outlook 和 iCloud 日历

来源标题:Show HN: calsdk, one TypeScript API for Google Calendar, Outlook and iCloud

calsdk 提供统一的 TypeScript API,支持包括 Google Calendar、Outlook 和 iCloud 在内的九家日历服务的事件、空闲时间和同步操作。该库已发布到 npm,提供 @cal-sdk/mock 内存模拟日历,无需账号或网络即可试用全部功能。

Hacker News 最新vkpdeveloper2026/11/5 · 12 天前10 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一个 TypeScript API,统一接入 Google Calendar、Outlook 和 iCloud

九个服务商的事件、空闲时间和同步功能,包括 Google Calendar、Outlook 和 iCloud,全部整合在一个带类型的 TypeScript API 里。 网站 · 文档 · 快速上手 · 演练场 · 常见问题

网站打开后就是一个实时演示。它在你的浏览器里运行,基于六份示例日历,调用真实的 listEvents、findFreeTime 和 createEvent。

想不安装任何东西就改代码,可以在 StackBlitz 上打开演练场。或者直接安装:

npm i @cal-sdk/core @cal-sdk/mock

import { createEvent, findFreeTime, listEvents } from '@cal-sdk/core'; import { mockCalendar } from '@cal-sdk/mock'; const calendar = mockCalendar(); await createEvent({ calendar, event: { title: 'Standup', start: { dateTime: '2026-11-09T09:30:00', timeZone: 'Europe/Berlin' }, end: { dateTime: '2026-11-09T09:45:00', timeZone: 'Europe/Berlin' }, recurrence: ['RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR'], }); const { events } = await listEvents({ calendar, timeMin: '2026-11-09T00:00:00+01:00', timeMax: '2026-11-14T00:00:00+01:00', }); const { slots } = await findFreeTime({ calendars: [{ calendar }], timeMin: '2026-11-09T00:00:00+01:00', timeMax: '2026-11-10T00:00:00+01:00', duration: 30, workingHours: { start: '09:00', end: '11:00', timeZone: 'Europe/Berlin' }, });

换日历,不换代码

逻辑跑通之后,把 mock 换成真实日历即可。只需要改 import 和创建 calendar 的那一行,所有服务商返回的事件结构都一致。

import { google } from '@cal-sdk/google'; const calendar = google({ accessToken: () => getFreshAccessToken() });

服务商 包 读取 写入 重复事件 视频链接 同步 Google Calendar ✓ ✓ ✓ Google Meet ✓ Outlook 和 Microsoft 365 ✓ ✓ ✓ Teams、工作账号 ✓ iCloud ✓ ✓ ✓ ✓ Zoho Calendar ✓ ✓ ✓ ✓ 任意 CalDAV 服务器 ✓ ✓ ✓ ✓ Zoom ✓ ✓ Zoom 的模式 Zoom ✓ Cal.com ✓ 预约事件类型、移动、取消 ✓ Calendly ✓ 预约事件类型、取消 ✓ ICS 源 ✓ ✓ 各服务商的完整能力清单见 Compare providers。

重复规则永远是 RRULE。Outlook 存的是模式对象,Zoom 则给星期几编了号。你读写的是同一个 RRULE,列事件时会把一个系列展开成一个个具体实例,你可以单独移动其中一个,也可以整体移动。

时区能扛住时钟调整。纽约 9:30 的站会,不管从哪里看,都还是纽约的 9:30。

给警告,而不是悄悄改。当服务商无法完全照你的要求执行时,比如颜色不在 Google 的调色板里,调用会保存能保存的部分并返回一个警告。如果继续执行会丢数据,就直接抛错。

跨服务商的空闲时间。findFreeTime 能找出 Google 日历和 Outlook 日历同时空闲的时间段。

同步。syncEvents 只返回自上次保存的 cursor 以来发生变化的内容。cursor 过期是单独的一类错误,所以全量重新同步只需一个分支。

可以分支处理的错误。冲突、限流、认证失败和事件不存在,各有自己的错误类。

跟着日历走的类型。服务商选项会对照你传入的日历做检查,拼错的选项直接编译不过。

需要知道的几点

它是库,不是托管服务。它运行在你的应用里,用你传入的 token 直接调用各服务商。用户的日历数据不经过任何第三方。

它不做 OAuth。传入 token,或者传入一个返回新 token 的函数即可。

凡是有 fetch 的环境都能跑。Node.js 20 及以上、Bun、Deno 和边缘运行时,不需要任何厂商 SDK。

它在真实 API 上测过。Google、Outlook、Zoho、Zoom、Cal.com 和 Calendly 的调用会被真实录制,并在 CI 中回放。

你可以添加自己的服务商。一个服务商就是一个包含若干函数的对象,由共享的一致性测试套件校验。参见 Build a provider。

参与 calsdk 开发

本仓库使用 Bun。

bun install bun run build # 构建各个包 bun run test bun run typecheck bun run lint

网站和文档在 apps/web 下。先构建各个包,然后在 apps/web 里运行 bun run dev。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →