@zhin.js/plugin-calendar 0.0.0-stage → 0.1.2

package/lib/oauth-session.js

@@ -0,0 +1,43 @@
+export const OAUTH_SESSION_TTL_MS = 10 * 60 * 1000;
+export class OAuthSessionRegistry {
+    #sessions = new Map();
+    #now;
+    #ttlMs;
+    constructor(options = {}) {
+        this.#now = options.now ?? Date.now;
+        this.#ttlMs = options.ttlMs ?? OAUTH_SESSION_TTL_MS;
+    }
+    create(session) {
+        this.pruneExpired();
+        const created = {
+            ...session,
+            expiresAt: this.#now() + this.#ttlMs,
+        };
+        this.#sessions.set(session.state, created);
+        return created;
+    }
+    /** Removes and returns the session; a state can only be consumed once. */
+    consume(state) {
+        const session = this.#sessions.get(state);
+        if (!session) {
+            return undefined;
+        }
+        this.#sessions.delete(state);
+        if (session.expiresAt <= this.#now()) {
+            return undefined;
+        }
+        return session;
+    }
+    pruneExpired() {
+        const now = this.#now();
+        for (const [state, session] of this.#sessions) {
+            if (session.expiresAt <= now) {
+                this.#sessions.delete(state);
+            }
+        }
+    }
+    get size() {
+        return this.#sessions.size;
+    }
+}
+//# sourceMappingURL=oauth-session.js.map

package/lib/oauth-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-session.js","sourceRoot":"","sources":["../src/oauth-session.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAWnD,MAAM,OAAO,oBAAoB;IACtB,SAAS,GAAG,IAAI,GAAG,EAAmC,CAAC;IACvD,IAAI,CAAe;IACnB,MAAM,CAAS;IAExB,YAAY,UAAkD,EAAE;QAC9D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,oBAAoB,CAAC;IACtD,CAAC;IAED,MAAM,CACJ,OAAmD;QAEnD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,OAAO,GAA4B;YACvC,GAAG,OAAO;YACV,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM;SACrC,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0EAA0E;IAC1E,OAAO,CAAC,KAAa;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACrC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,YAAY;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,OAAO,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;gBAC7B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/lib/oauth.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Google Calendar and Microsoft Graph providers backed by OAuthTokenManager
+ * (refresh_token flow; access tokens are never stored in config).
+ */
+import type { CalendarProvider } from "./types.js";
+import { OAuthTokenManager, type AuthorizationLostListener, type RefreshTokenStore, type TokenManagerLogger } from "./token-manager.js";
+export interface OAuthCalendarOptions {
+    readonly clientId: string;
+    readonly clientSecret?: string;
+    /** Fallback refresh token from config/env. */
+    readonly refreshToken?: string;
+    readonly tokenStore?: RefreshTokenStore;
+    readonly onAuthorizationLost?: AuthorizationLostListener;
+    /** Use an existing manager (shared with the chat auth flow) instead of creating one. */
+    readonly tokenManager?: OAuthTokenManager;
+    readonly calendarId: string;
+    readonly timezone: string;
+    readonly tenant?: string;
+    /** Optional JSON file to persist rotated refresh tokens. */
+    readonly tokenFile?: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly logger?: TokenManagerLogger;
+}
+export declare function createGoogleCalendarProvider(options: OAuthCalendarOptions): CalendarProvider;
+/** Default calendar when id empty / primary / me. */
+export declare function microsoftCalendarBase(calendarId: string): string;
+export declare function createMicrosoftCalendarProvider(options: OAuthCalendarOptions): CalendarProvider;
+//# sourceMappingURL=oauth.d.ts.map

package/lib/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAEV,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IACzD,wFAAwF;IACxF,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAwED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,gBAAgB,CAkFlB;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQhE;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,oBAAoB,GAC5B,gBAAgB,CA6FlB"}

package/lib/oauth.js

@@ -0,0 +1,200 @@
+import { formatInZone } from "./time.js";
+import { OAuthTokenManager, } from "./token-manager.js";
+function mapGoogleEvent(item, timezone) {
+    const start = item.start ?? {};
+    const end = item.end ?? {};
+    const startDate = new Date(start.dateTime ?? start.date ?? "");
+    const endDate = new Date(end.dateTime ?? end.date ?? "");
+    return {
+        id: String(item.id ?? ""),
+        title: String(item.summary ?? "(无标题)"),
+        start: formatInZone(startDate, timezone),
+        end: formatInZone(endDate, timezone),
+        location: item.location ? String(item.location) : undefined,
+        description: item.description ? String(item.description) : undefined,
+        all_day: Boolean(start.date && !start.dateTime),
+    };
+}
+function mapMicrosoftEvent(item, timezone) {
+    const start = item.start ?? {};
+    const end = item.end ?? {};
+    const startRaw = start.dateTime ?? "";
+    const endRaw = end.dateTime ?? "";
+    const startDate = new Date(/[zZ]|[+-]\d{2}:?\d{2}$/.test(startRaw) ? startRaw : `${startRaw}Z`);
+    const endDate = new Date(/[zZ]|[+-]\d{2}:?\d{2}$/.test(endRaw) ? endRaw : `${endRaw}Z`);
+    return {
+        id: String(item.id ?? ""),
+        title: String(item.subject ?? "(无标题)"),
+        start: formatInZone(startDate, timezone),
+        end: formatInZone(endDate, timezone),
+        location: item.location
+            ? String(item.location.displayName ?? "")
+            : undefined,
+        description: item.bodyPreview ? String(item.bodyPreview) : undefined,
+        all_day: Boolean(item.isAllDay),
+    };
+}
+async function withBearer(manager, fetchImpl, url, init, extraHeaders) {
+    const token = await manager.getAccessToken();
+    const headers = {
+        ...init.headers,
+        ...extraHeaders,
+        authorization: `Bearer ${token}`,
+    };
+    let response = await fetchImpl(url, { ...init, headers });
+    if (response.status === 401) {
+        const fresh = await manager.forceRefresh();
+        response = await fetchImpl(url, {
+            ...init,
+            headers: { ...headers, authorization: `Bearer ${fresh}` },
+        });
+    }
+    return response;
+}
+export function createGoogleCalendarProvider(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const manager = options.tokenManager ??
+        new OAuthTokenManager({
+            provider: "google",
+            clientId: options.clientId,
+            clientSecret: options.clientSecret,
+            initialRefreshToken: options.refreshToken,
+            tokenFile: options.tokenFile,
+            fetchImpl,
+            logger: options.logger,
+            tokenStore: options.tokenStore,
+            onAuthorizationLost: options.onAuthorizationLost,
+        });
+    const calendarId = encodeURIComponent(options.calendarId.trim() || "primary");
+    let hydrated = false;
+    async function ensureHydrated() {
+        if (hydrated)
+            return;
+        await manager.hydrate();
+        hydrated = true;
+    }
+    return {
+        name: "google",
+        async listEvents(from, to, signal) {
+            await ensureHydrated();
+            const url = new URL(`https://www.googleapis.com/calendar/v3/calendars/${calendarId}/events`);
+            url.searchParams.set("timeMin", from.toISOString());
+            url.searchParams.set("timeMax", to.toISOString());
+            url.searchParams.set("singleEvents", "true");
+            url.searchParams.set("orderBy", "startTime");
+            const response = await withBearer(manager, fetchImpl, url.toString(), {
+                signal,
+            });
+            if (!response.ok) {
+                const detail = (await response.text().catch(() => "")).slice(0, 300);
+                throw new Error(`Google Calendar 列表失败：HTTP ${response.status} ${detail}`);
+            }
+            const data = (await response.json());
+            return (data.items ?? []).map((item) => mapGoogleEvent(item, options.timezone));
+        },
+        async createEvent(input, signal) {
+            await ensureHydrated();
+            const body = {
+                summary: input.title,
+                description: input.description,
+                location: input.location,
+                start: input.all_day
+                    ? { date: input.start.toISOString().slice(0, 10) }
+                    : { dateTime: input.start.toISOString(), timeZone: options.timezone },
+                end: input.all_day
+                    ? { date: input.end.toISOString().slice(0, 10) }
+                    : { dateTime: input.end.toISOString(), timeZone: options.timezone },
+            };
+            const response = await withBearer(manager, fetchImpl, `https://www.googleapis.com/calendar/v3/calendars/${calendarId}/events`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(body),
+                signal,
+            });
+            if (!response.ok)
+                throw new Error(`Google Calendar 创建失败：HTTP ${response.status}`);
+            return mapGoogleEvent((await response.json()), options.timezone);
+        },
+    };
+}
+/** Default calendar when id empty / primary / me. */
+export function microsoftCalendarBase(calendarId) {
+    const id = calendarId.trim();
+    if (!id || id === "primary" || id === "me") {
+        return "https://graph.microsoft.com/v1.0/me/calendar";
+    }
+    return `https://graph.microsoft.com/v1.0/me/calendars/${encodeURIComponent(id)}`;
+}
+export function createMicrosoftCalendarProvider(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const manager = options.tokenManager ??
+        new OAuthTokenManager({
+            provider: "microsoft",
+            clientId: options.clientId,
+            clientSecret: options.clientSecret,
+            tenant: options.tenant,
+            initialRefreshToken: options.refreshToken,
+            tokenFile: options.tokenFile,
+            fetchImpl,
+            logger: options.logger,
+            tokenStore: options.tokenStore,
+            onAuthorizationLost: options.onAuthorizationLost,
+        });
+    const base = microsoftCalendarBase(options.calendarId);
+    let hydrated = false;
+    async function ensureHydrated() {
+        if (hydrated)
+            return;
+        await manager.hydrate();
+        hydrated = true;
+    }
+    return {
+        name: "microsoft",
+        async listEvents(from, to, signal) {
+            await ensureHydrated();
+            const url = new URL(`${base}/calendarView`);
+            url.searchParams.set("startDateTime", from.toISOString());
+            url.searchParams.set("endDateTime", to.toISOString());
+            url.searchParams.set("$orderby", "start/dateTime");
+            url.searchParams.set("$top", "50");
+            const response = await withBearer(manager, fetchImpl, url.toString(), { signal }, {
+                prefer: `outlook.timezone="${options.timezone}"`,
+            });
+            if (!response.ok) {
+                const detail = (await response.text().catch(() => "")).slice(0, 300);
+                throw new Error(`Microsoft Graph 列表失败：HTTP ${response.status} ${detail}`);
+            }
+            const data = (await response.json());
+            return (data.value ?? []).map((item) => mapMicrosoftEvent(item, options.timezone));
+        },
+        async createEvent(input, signal) {
+            await ensureHydrated();
+            const body = {
+                subject: input.title,
+                body: input.description
+                    ? { contentType: "Text", content: input.description }
+                    : undefined,
+                location: input.location ? { displayName: input.location } : undefined,
+                start: {
+                    dateTime: input.start.toISOString().replace(/\.\d{3}Z$/, ""),
+                    timeZone: "UTC",
+                },
+                end: {
+                    dateTime: input.end.toISOString().replace(/\.\d{3}Z$/, ""),
+                    timeZone: "UTC",
+                },
+                isAllDay: Boolean(input.all_day),
+            };
+            const response = await withBearer(manager, fetchImpl, `${base}/events`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(body),
+                signal,
+            }, { prefer: `outlook.timezone="${options.timezone}"` });
+            if (!response.ok)
+                throw new Error(`Microsoft Graph 创建失败：HTTP ${response.status}`);
+            return mapMicrosoftEvent((await response.json()), options.timezone);
+        },
+    };
+}
+//# sourceMappingURL=oauth.js.map

package/lib/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"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"}

package/lib/runtime.d.ts

@@ -0,0 +1,11 @@
+import type { CalendarConfig } from "./config.js";
+import type { CalendarProvider } from "./types.js";
+import type { CalendarAuthService } from "./chat-auth.js";
+export interface CalendarRuntime {
+    readonly config: CalendarConfig;
+    readonly provider: CalendarProvider | undefined;
+    /** Chat authorization flow used by the `calendar` commands. */
+    readonly auth: CalendarAuthService<unknown>;
+}
+export declare const calendarRuntimeToken: import("zhin.js").Token<CalendarRuntime>;
+//# sourceMappingURL=runtime.d.ts.map

package/lib/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAChD,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,oBAAoB,0CAGhC,CAAC"}

package/lib/runtime.js

@@ -0,0 +1,3 @@
+import { createToken } from "zhin.js";
+export const calendarRuntimeToken = createToken("zhin.calendar.runtime", "Owner-scoped calendar provider and config");
+//# sourceMappingURL=runtime.js.map

package/lib/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAYtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAC7C,uBAAuB,EACvB,2CAA2C,CAC5C,CAAC"}

package/lib/secrets.d.ts

@@ -0,0 +1,3 @@
+/** Treat unresolved ${ENV} placeholders as empty. */
+export declare function cleanSecret(value: string): string;
+//# sourceMappingURL=secrets.d.ts.map

package/lib/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjD"}

package/lib/secrets.js

@@ -0,0 +1,6 @@
+/** Treat unresolved ${ENV} placeholders as empty. */
+export function cleanSecret(value) {
+    const text = (value ?? "").trim();
+    return /^\$\{[^}]*\}$/.test(text) ? "" : text;
+}
+//# sourceMappingURL=secrets.js.map

package/lib/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC"}

package/lib/time.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Timezone helpers built on Intl (no dependencies).
+ */
+export interface ZonedParts {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+    weekday: number;
+}
+/** Throws a readable error for unknown IANA zones. */
+export declare function assertTimeZone(timeZone: string): void;
+/** Wall-clock parts of `date` in `timeZone`. */
+export declare function zonedParts(date: Date, timeZone: string): ZonedParts;
+/** Offset (ms) of `timeZone` from UTC at instant `date`. */
+export declare function timeZoneOffsetMs(date: Date, timeZone: string): number;
+/** Converts a wall-clock time in `timeZone` to a UTC instant. */
+export declare function zonedTimeToUtc(wall: {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second?: number;
+}, timeZone: string): Date;
+/** Formats an instant as `YYYY-MM-DD HH:mm` in `timeZone`. */
+export declare function formatInZone(date: Date, timeZone: string): string;
+/**
+ * Parses an ISO-8601 date-time. Without an explicit offset/`Z`, the value is
+ * interpreted as wall-clock time in `timeZone`.
+ */
+export declare function parseDateTimeInZone(value: string, timeZone: string): Date;
+/** Parses durations like `10m`, `2h30m`, `1d`, `90s`. */
+export declare function parseDuration(value: string): number;
+//# sourceMappingURL=time.d.ts.map

package/lib/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAiCD,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAanE;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWrE;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAC5B,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,QAAQ,EAAE,MAAM,GACf,IAAI,CAYN;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAsBzE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmBnD"}

package/lib/time.js

@@ -0,0 +1,118 @@
+/**
+ * Timezone helpers built on Intl (no dependencies).
+ */
+const formatterCache = new Map();
+function formatterFor(timeZone) {
+    let formatter = formatterCache.get(timeZone);
+    if (!formatter) {
+        formatter = new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            hourCycle: "h23",
+            year: "numeric",
+            month: "numeric",
+            day: "numeric",
+            hour: "numeric",
+            minute: "numeric",
+            second: "numeric",
+            weekday: "short",
+        });
+        formatterCache.set(timeZone, formatter);
+    }
+    return formatter;
+}
+const WEEKDAYS = {
+    Sun: 0,
+    Mon: 1,
+    Tue: 2,
+    Wed: 3,
+    Thu: 4,
+    Fri: 5,
+    Sat: 6,
+};
+/** Throws a readable error for unknown IANA zones. */
+export function assertTimeZone(timeZone) {
+    try {
+        formatterFor(timeZone);
+    }
+    catch {
+        throw new Error(`未知时区：${timeZone}`);
+    }
+}
+/** Wall-clock parts of `date` in `timeZone`. */
+export function zonedParts(date, timeZone) {
+    const parts = {};
+    for (const part of formatterFor(timeZone).formatToParts(date))
+        parts[part.type] = part.value;
+    return {
+        year: Number(parts.year),
+        month: Number(parts.month),
+        day: Number(parts.day),
+        hour: Number(parts.hour),
+        minute: Number(parts.minute),
+        second: Number(parts.second),
+        weekday: WEEKDAYS[parts.weekday ?? "Sun"] ?? 0,
+    };
+}
+/** Offset (ms) of `timeZone` from UTC at instant `date`. */
+export function timeZoneOffsetMs(date, timeZone) {
+    const parts = zonedParts(date, timeZone);
+    const asUtc = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+    return asUtc - Math.floor(date.getTime() / 1000) * 1000;
+}
+/** Converts a wall-clock time in `timeZone` to a UTC instant. */
+export function zonedTimeToUtc(wall, timeZone) {
+    const guess = Date.UTC(wall.year, wall.month - 1, wall.day, wall.hour, wall.minute, wall.second ?? 0);
+    const first = guess - timeZoneOffsetMs(new Date(guess), timeZone);
+    const second = guess - timeZoneOffsetMs(new Date(first), timeZone);
+    return new Date(second);
+}
+/** Formats an instant as `YYYY-MM-DD HH:mm` in `timeZone`. */
+export function formatInZone(date, timeZone) {
+    const p = zonedParts(date, timeZone);
+    const pad = (value) => String(value).padStart(2, "0");
+    return `${p.year}-${pad(p.month)}-${pad(p.day)} ${pad(p.hour)}:${pad(p.minute)}`;
+}
+/**
+ * Parses an ISO-8601 date-time. Without an explicit offset/`Z`, the value is
+ * interpreted as wall-clock time in `timeZone`.
+ */
+export function parseDateTimeInZone(value, timeZone) {
+    const text = value.trim();
+    if (/([zZ]|[+-]\d{2}:?\d{2})$/.test(text)) {
+        const date = new Date(text);
+        if (Number.isNaN(date.getTime()))
+            throw new Error(`无法解析时间：${value}`);
+        return date;
+    }
+    const match = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2}))?)?$/.exec(text);
+    if (!match)
+        throw new Error(`无法解析时间：${value}（请用 YYYY-MM-DDTHH:mm 格式）`);
+    return zonedTimeToUtc({
+        year: Number(match[1]),
+        month: Number(match[2]),
+        day: Number(match[3]),
+        hour: Number(match[4] ?? 0),
+        minute: Number(match[5] ?? 0),
+        second: Number(match[6] ?? 0),
+    }, timeZone);
+}
+/** Parses durations like `10m`, `2h30m`, `1d`, `90s`. */
+export function parseDuration(value) {
+    const text = value.trim().toLowerCase();
+    const pattern = /(\d+)\s*(d|h|m|s)/g;
+    let total = 0;
+    let consumed = "";
+    for (const match of text.matchAll(pattern)) {
+        const amount = Number(match[1]);
+        const unit = match[2];
+        total +=
+            amount *
+                { d: 86400000, h: 3600000, m: 60000, s: 1000 }[unit];
+        consumed += match[0];
+    }
+    if (total <= 0 || consumed.replace(/\s/g, "") !== text.replace(/\s/g, "")) {
+        throw new Error(`无法解析时长：${value}（示例：10m、2h30m、1d）`);
+    }
+    return total;
+}
+//# sourceMappingURL=time.js.map

package/lib/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"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"}

package/lib/token-manager.d.ts

@@ -0,0 +1,71 @@
+export type OAuthProviderKind = "google" | "microsoft";
+export interface TokenSet {
+    readonly accessToken: string;
+    readonly refreshToken: string;
+    /** Epoch ms when the access token expires. */
+    readonly expiresAt: number;
+}
+export interface TokenManagerLogger {
+    warn(message: string): void;
+}
+/** Persistent storage for the refresh token (e.g. zhin plugin database state). */
+export interface RefreshTokenStore {
+    load(): Promise<string | undefined>;
+    save(refreshToken: string): Promise<void>;
+}
+export type AuthorizationLostListener = (provider: OAuthProviderKind, message: string) => void | Promise<void>;
+/** Chat command that (re-)authorizes a provider; shown in user-facing errors. */
+export declare function authCommandFor(provider: OAuthProviderKind): string;
+export interface TokenManagerOptions {
+    readonly provider: OAuthProviderKind;
+    readonly clientId: string;
+    /** Optional for Microsoft public/native clients. Required for Google. */
+    readonly clientSecret?: string;
+    readonly tenant?: string;
+    /** Fallback refresh token from config/env; the token store wins when it has a value. */
+    readonly initialRefreshToken?: string;
+    /** Refresh token persisted by the chat authorization flow. */
+    readonly tokenStore?: RefreshTokenStore;
+    /** Called once when the refresh token is rejected (invalid_grant). */
+    readonly onAuthorizationLost?: AuthorizationLostListener;
+    /**
+     * Optional path to persist rotated refresh tokens (JSON).
+     * When unset, rotation only logs a warning (update env manually).
+     */
+    readonly tokenFile?: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly now?: () => number;
+    readonly logger?: TokenManagerLogger;
+    /** Refresh this many ms before expiry. Default 5 minutes. */
+    readonly skewMs?: number;
+}
+export declare class OAuthTokenError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class OAuthTokenManager {
+    #private;
+    constructor(options: TokenManagerOptions);
+    get provider(): OAuthProviderKind;
+    /** Whether a refresh token is available (stored or from config). */
+    get hasRefreshToken(): boolean;
+    /** Whether the last refresh attempt was rejected with invalid_grant. */
+    get authorizationLost(): boolean;
+    /**
+     * Loads persisted tokens: token_file overlay first, then the token store,
+     * which takes precedence over config/env because it is written by chat auth.
+     */
+    hydrate(): Promise<void>;
+    /** Replaces the refresh token after a successful chat authorization. */
+    setRefreshToken(refreshToken: string): void;
+    /** Forgets all tokens held in memory (used by `calendar logout`). */
+    clearTokens(): void;
+    /** Current refresh token (may change after Microsoft rotation). */
+    get refreshToken(): string;
+    /** Load optional token file overlay (rotated refresh / cached access). */
+    hydrateFromFile(): Promise<void>;
+    getAccessToken(): Promise<string>;
+    /** Bypass cache (e.g. after HTTP 401). Still single-flight. */
+    forceRefresh(): Promise<string>;
+}
+//# sourceMappingURL=token-manager.d.ts.map

package/lib/token-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-manager.d.ts","sourceRoot":"","sources":["../src/token-manager.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,MAAM,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAElE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IACzD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAUD,qBAAa,iBAAiB;;gBAkBhB,OAAO,EAAE,mBAAmB;IA0BxC,IAAI,QAAQ,IAAI,iBAAiB,CAEhC;IAED,oEAAoE;IACpE,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,wEAAwE;IACxE,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAW9B,wEAAwE;IACxE,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAO3C,qEAAqE;IACrE,WAAW,IAAI,IAAI;IAInB,mEAAmE;IACnE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,0EAA0E;IACpE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BhC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAOvC,+DAA+D;IACzD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CAuJtC"}