@ganju/utils 0.0.5 → 0.0.6

package/dist/constants.d.ts

@@ -451,6 +451,7 @@ export declare const constants: {
     CALCOM_API_VERSION_EVENT_TYPES: string;
     CALCOM_API_VERSION_SLOTS: string;
     CALCOM_API_VERSION_BOOKINGS: string;
+    CALCOM_API_VERSION_ME: string;
     CALCOM_TOOL_KEY_PREFIX: string;
     TAVILY_API_BASE: string;
     TAVILY_SEARCH_DEPTH_BASIC: "basic";

package/dist/constants.d.ts.map

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

package/dist/constants.js

@@ -877,6 +877,7 @@ const CALCOM_API_BASE = 'https://api.cal.com/v2';
 const CALCOM_API_VERSION_EVENT_TYPES = '2024-06-14';
 const CALCOM_API_VERSION_SLOTS = '2024-09-04';
 const CALCOM_API_VERSION_BOOKINGS = '2026-02-25';
+const CALCOM_API_VERSION_ME = '2024-06-14';
 const CALCOM_TOOL_KEY_PREFIX = 'calcom-';
 // Tavily web search. The key is validated against the live API before it is
 // persisted (a minimal 1-result search), then stored as an artifact_credential
@@ -2140,6 +2141,7 @@ exports.constants = {
     CALCOM_API_VERSION_EVENT_TYPES,
     CALCOM_API_VERSION_SLOTS,
     CALCOM_API_VERSION_BOOKINGS,
+    CALCOM_API_VERSION_ME,
     CALCOM_TOOL_KEY_PREFIX,
     TAVILY_API_BASE,
     TAVILY_SEARCH_DEPTH_BASIC,

package/dist/index.d.ts

@@ -2161,6 +2161,7 @@ export declare const utils: {
         CALCOM_API_VERSION_EVENT_TYPES: string;
         CALCOM_API_VERSION_SLOTS: string;
         CALCOM_API_VERSION_BOOKINGS: string;
+        CALCOM_API_VERSION_ME: string;
         CALCOM_TOOL_KEY_PREFIX: string;
         TAVILY_API_BASE: string;
         TAVILY_SEARCH_DEPTH_BASIC: "basic";
@@ -2878,6 +2879,12 @@ export declare const utils: {
     buildReauthMetadata: (previous: Record<string, unknown> | null, reason: string) => Record<string, unknown>;
     clearReauthMetadata: (previous: Record<string, unknown> | null) => Record<string, unknown> | null;
     isCredentialNeedingReauth: (metadata: unknown) => boolean;
+    isValidTimeZone: (value: unknown) => value is string;
+    readCredentialTimeZone: (metadata: unknown) => string | null;
+    credentialTimeZoneIsStale: (metadata: unknown, now?: number) => boolean;
+    writeCredentialTimeZone: (previous: unknown, timeZone: string | null, now?: Date) => Record<string, unknown>;
+    fetchGoogleCalendarTimeZone: (accessToken: string) => Promise<string | null>;
+    fetchCalcomTimeZone: (apiKey: string) => Promise<string | null>;
     PlanLimitError: typeof PlanLimitError;
     isPlanLimitError: (error: unknown) => error is PlanLimitError;
 };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aA5Gf,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;kBAhHiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA0DF,CAAC;oBAEd,CAAC;;;;aA0BkB,CAAC;mBAA8B,CAAC;WACvC,CAAC;gBACf,CAAC;gBAA4B,CAAA;;;mBAoBK,CAAC;oBACjC,CAAC;;;;;;;;;;;;;;;kBA3Dc,CAAC;;;;;;;sBAqCR,CAAC;;;;;;;;;CAsPf,CAAC;AAEF,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,OAAO,EACP,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,kBAAkB,EAClB,mBAAmB,EACnB,gCAAgC,EAChC,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACX,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aApHf,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;kBAhHiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA0DF,CAAC;oBAEd,CAAC;;;;aA0BkB,CAAC;mBAA8B,CAAC;WACvC,CAAC;gBACf,CAAC;gBAA4B,CAAA;;;mBAoBK,CAAC;oBACjC,CAAC;;;;;;;;;;;;;;;kBA3Dc,CAAC;;;;;;;sBAqCR,CAAC;;;;;;;;;;;;;;;CAoQf,CAAC;AAEF,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,YAAY,EACZ,OAAO,EACP,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,8BAA8B,EAC9B,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,kBAAkB,EAClB,mBAAmB,EACnB,gCAAgC,EAChC,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACX,CAAC"}

package/dist/index.js

@@ -45,6 +45,7 @@ const channelNotifier_1 = require("./channelNotifier");
 const channelDebounce_1 = require("./channelDebounce");
 const sources_1 = require("./sources");
 const oauth_1 = require("./oauth");
+const vendorTimeZone_1 = require("./vendorTimeZone");
 const planLimitError_1 = require("./planLimitError");
 exports.utils = {
     Schema: schema_1.Schema,
@@ -157,6 +158,12 @@ exports.utils = {
     buildReauthMetadata: oauth_1.buildReauthMetadata,
     clearReauthMetadata: oauth_1.clearReauthMetadata,
     isCredentialNeedingReauth: oauth_1.isCredentialNeedingReauth,
+    isValidTimeZone: vendorTimeZone_1.isValidTimeZone,
+    readCredentialTimeZone: vendorTimeZone_1.readCredentialTimeZone,
+    credentialTimeZoneIsStale: vendorTimeZone_1.credentialTimeZoneIsStale,
+    writeCredentialTimeZone: vendorTimeZone_1.writeCredentialTimeZone,
+    fetchGoogleCalendarTimeZone: vendorTimeZone_1.fetchGoogleCalendarTimeZone,
+    fetchCalcomTimeZone: vendorTimeZone_1.fetchCalcomTimeZone,
     PlanLimitError: planLimitError_1.PlanLimitError,
     isPlanLimitError: planLimitError_1.isPlanLimitError
 };

package/dist/vendorTimeZone.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Is this a time zone the runtime actually knows?
+ *
+ * Everything downstream — `Intl.DateTimeFormat`, Google's `start.timeZone`,
+ * Cal.com's `attendee.timeZone` — throws or 400s on a name it cannot resolve.
+ * A vendor returning something unexpected must degrade to "we don't know"
+ * rather than poison every later call with a value that cannot be used.
+ */
+export declare const isValidTimeZone: (value: unknown) => value is string;
+/** The cached zone on a credential's metadata, or null. */
+export declare const readCredentialTimeZone: (metadata: unknown) => string | null;
+/**
+ * Should we ask the vendor again?
+ *
+ * True when there is nothing cached, when the stamp is missing or unreadable,
+ * or when the TTL has passed. A cache with no stamp is treated as stale rather
+ * than as fresh-forever — the conservative direction, since the only cost is
+ * one request.
+ */
+export declare const credentialTimeZoneIsStale: (metadata: unknown, now?: number) => boolean;
+/**
+ * Merge a freshly read zone into a credential's metadata.
+ *
+ * Merges rather than replaces, because this column also carries the reauth
+ * markers — writing a bare `{ timeZone }` here would clear `needsReauth` and
+ * silently re-enable a connection the refresh path had flagged as broken.
+ *
+ * A null zone (the vendor could not tell us) still stamps the check, so a
+ * provider that never reports one is asked once a day rather than on every
+ * single call.
+ */
+export declare const writeCredentialTimeZone: (previous: unknown, timeZone: string | null, now?: Date) => Record<string, unknown>;
+/**
+ * The zone Google Calendar is configured in, from the primary calendar.
+ *
+ * Deliberately NOT `GET /users/me/settings/timezone`, which is the more
+ * direct answer to "what did the user configure" and needs
+ * `calendar.settings.readonly` — a scope we do not request and could not add
+ * without sending every already-connected user back through consent. The
+ * primary calendar's zone is the same value in every case that matters, and
+ * `calendar.readonly` already covers it.
+ *
+ * Returns null on any failure. Not knowing the zone is a state the callers
+ * handle; a throw here would take a tool call or a chat turn with it.
+ */
+export declare const fetchGoogleCalendarTimeZone: (accessToken: string) => Promise<string | null>;
+/**
+ * The zone on the connected Cal.com profile.
+ *
+ * This is the host's zone — the one their availability is written in — which
+ * is what "9am" means when the artifact owner or their bot says it. It is not
+ * the attendee's zone; see the booking handler for why we use it there anyway.
+ *
+ * Same null-on-failure contract as the Google reader above.
+ */
+export declare const fetchCalcomTimeZone: (apiKey: string) => Promise<string | null>;
+//# sourceMappingURL=vendorTimeZone.d.ts.map

package/dist/vendorTimeZone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendorTimeZone.d.ts","sourceRoot":"","sources":["../src/vendorTimeZone.ts"],"names":[],"mappings":"AAiCA;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAQzD,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,GAAI,UAAU,OAAO,KAAG,MAAM,GAAG,IAInE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,UAAU,OAAO,EACjB,MAAK,MAAmB,KACvB,OAOF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,OAAO,EACjB,UAAU,MAAM,GAAG,IAAI,EACvB,MAAK,IAAiB,KACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAYxB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,GACtC,aAAa,MAAM,KAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAiBvB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,KACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAkBvB,CAAC"}

package/dist/vendorTimeZone.js

@@ -0,0 +1,165 @@
+"use strict";
+// The time zone the user configured with the vendor, and where we keep it.
+//
+// Every scheduling question the model answers is a time-zone question first:
+// "tomorrow at 9" is not an instant until you know whose 9 it is. We had two
+// sources for that and neither worked. `artifact_tool.config.defaultTimeZone`
+// is only written when the owner opens a dropdown and changes it, so in
+// practice it is empty. The fallbacks underneath it were `undefined` (Google
+// then uses the calendar's own zone, which only helps when the timestamp has no
+// offset) and the string 'UTC' (Cal.com, which books the attendee in UTC and
+// tells nobody).
+//
+// But the user already answered this question — in Google Calendar's settings,
+// and in their Cal.com profile. So we ask the vendor instead of asking the
+// owner again, and the answer becomes the default under any explicit choice.
+//
+// It is cached on `artifact_credential.metadata` because that is what it is a
+// property of: the connected account, not the tool row. One artifact can have
+// six calendar tools installed and they all share one connection, so the
+// connection is the only place the answer belongs exactly once.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchCalcomTimeZone = exports.fetchGoogleCalendarTimeZone = exports.writeCredentialTimeZone = exports.credentialTimeZoneIsStale = exports.readCredentialTimeZone = exports.isValidTimeZone = void 0;
+const constants_1 = require("./constants");
+// Metadata keys on artifact_credential. Namespaced with a prefix that will not
+// collide with the reauth markers written by the OAuth refresh path.
+const TIME_ZONE_KEY = 'timeZone';
+const TIME_ZONE_CHECKED_AT_KEY = 'timeZoneCheckedAt';
+// How long a cached zone is trusted. A day, because this changes when somebody
+// moves or travels — rarely, and never urgently. The cost of being briefly
+// stale is one meeting in the old zone; the cost of a shorter TTL is a vendor
+// round trip on the path of a tool call.
+const TIME_ZONE_TTL_MS = 24 * 60 * 60 * 1000;
+/**
+ * Is this a time zone the runtime actually knows?
+ *
+ * Everything downstream — `Intl.DateTimeFormat`, Google's `start.timeZone`,
+ * Cal.com's `attendee.timeZone` — throws or 400s on a name it cannot resolve.
+ * A vendor returning something unexpected must degrade to "we don't know"
+ * rather than poison every later call with a value that cannot be used.
+ */
+const isValidTimeZone = (value) => {
+    if (typeof value !== 'string' || !value.trim())
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: value.trim() });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.isValidTimeZone = isValidTimeZone;
+/** The cached zone on a credential's metadata, or null. */
+const readCredentialTimeZone = (metadata) => {
+    if (!metadata || typeof metadata !== 'object')
+        return null;
+    const value = metadata[TIME_ZONE_KEY];
+    return (0, exports.isValidTimeZone)(value) ? value.trim() : null;
+};
+exports.readCredentialTimeZone = readCredentialTimeZone;
+/**
+ * Should we ask the vendor again?
+ *
+ * True when there is nothing cached, when the stamp is missing or unreadable,
+ * or when the TTL has passed. A cache with no stamp is treated as stale rather
+ * than as fresh-forever — the conservative direction, since the only cost is
+ * one request.
+ */
+const credentialTimeZoneIsStale = (metadata, now = Date.now()) => {
+    if (!(0, exports.readCredentialTimeZone)(metadata))
+        return true;
+    const raw = metadata[TIME_ZONE_CHECKED_AT_KEY];
+    if (typeof raw !== 'string')
+        return true;
+    const checkedAt = Date.parse(raw);
+    if (!Number.isFinite(checkedAt))
+        return true;
+    return now - checkedAt >= TIME_ZONE_TTL_MS;
+};
+exports.credentialTimeZoneIsStale = credentialTimeZoneIsStale;
+/**
+ * Merge a freshly read zone into a credential's metadata.
+ *
+ * Merges rather than replaces, because this column also carries the reauth
+ * markers — writing a bare `{ timeZone }` here would clear `needsReauth` and
+ * silently re-enable a connection the refresh path had flagged as broken.
+ *
+ * A null zone (the vendor could not tell us) still stamps the check, so a
+ * provider that never reports one is asked once a day rather than on every
+ * single call.
+ */
+const writeCredentialTimeZone = (previous, timeZone, now = new Date()) => {
+    const base = previous && typeof previous === 'object'
+        ? { ...previous }
+        : {};
+    if ((0, exports.isValidTimeZone)(timeZone)) {
+        base[TIME_ZONE_KEY] = timeZone.trim();
+    }
+    else {
+        delete base[TIME_ZONE_KEY];
+    }
+    base[TIME_ZONE_CHECKED_AT_KEY] = now.toISOString();
+    return base;
+};
+exports.writeCredentialTimeZone = writeCredentialTimeZone;
+/**
+ * The zone Google Calendar is configured in, from the primary calendar.
+ *
+ * Deliberately NOT `GET /users/me/settings/timezone`, which is the more
+ * direct answer to "what did the user configure" and needs
+ * `calendar.settings.readonly` — a scope we do not request and could not add
+ * without sending every already-connected user back through consent. The
+ * primary calendar's zone is the same value in every case that matters, and
+ * `calendar.readonly` already covers it.
+ *
+ * Returns null on any failure. Not knowing the zone is a state the callers
+ * handle; a throw here would take a tool call or a chat turn with it.
+ */
+const fetchGoogleCalendarTimeZone = async (accessToken) => {
+    try {
+        const response = await fetch(`${constants_1.constants.GOOGLE_CALENDAR_API_BASE}/calendars/primary`, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: 'application/json'
+            }
+        });
+        if (!response.ok)
+            return null;
+        const payload = (await response.json());
+        return (0, exports.isValidTimeZone)(payload?.timeZone) ? payload.timeZone.trim() : null;
+    }
+    catch {
+        return null;
+    }
+};
+exports.fetchGoogleCalendarTimeZone = fetchGoogleCalendarTimeZone;
+/**
+ * The zone on the connected Cal.com profile.
+ *
+ * This is the host's zone — the one their availability is written in — which
+ * is what "9am" means when the artifact owner or their bot says it. It is not
+ * the attendee's zone; see the booking handler for why we use it there anyway.
+ *
+ * Same null-on-failure contract as the Google reader above.
+ */
+const fetchCalcomTimeZone = async (apiKey) => {
+    try {
+        const response = await fetch(`${constants_1.constants.CALCOM_API_BASE}/me`, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                'cal-api-version': constants_1.constants.CALCOM_API_VERSION_ME,
+                Accept: 'application/json'
+            }
+        });
+        if (!response.ok)
+            return null;
+        const payload = (await response.json());
+        const value = payload?.data?.timeZone;
+        return (0, exports.isValidTimeZone)(value) ? value.trim() : null;
+    }
+    catch {
+        return null;
+    }
+};
+exports.fetchCalcomTimeZone = fetchCalcomTimeZone;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ganju/utils",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Shared constants, schemas and helpers for Ganju",
   "license": "Apache-2.0",
   "author": "MontoyaAndres <andresmontoyafcb@gmail.com>",

package/src/constants.ts

@@ -1054,6 +1054,7 @@ const CALCOM_API_BASE = 'https://api.cal.com/v2';
 const CALCOM_API_VERSION_EVENT_TYPES = '2024-06-14';
 const CALCOM_API_VERSION_SLOTS = '2024-09-04';
 const CALCOM_API_VERSION_BOOKINGS = '2026-02-25';
+const CALCOM_API_VERSION_ME = '2024-06-14';
 
 const CALCOM_TOOL_KEY_PREFIX = 'calcom-';
 
@@ -2478,6 +2479,7 @@ export const constants = {
   CALCOM_API_VERSION_EVENT_TYPES,
   CALCOM_API_VERSION_SLOTS,
   CALCOM_API_VERSION_BOOKINGS,
+  CALCOM_API_VERSION_ME,
   CALCOM_TOOL_KEY_PREFIX,
   TAVILY_API_BASE,
   TAVILY_SEARCH_DEPTH_BASIC,

package/src/index.ts

@@ -218,6 +218,14 @@ import {
   isCredentialNeedingReauth
 } from './oauth';
 import type { RefreshOAuthTokenInput, RefreshedOAuthToken } from './oauth';
+import {
+  isValidTimeZone,
+  readCredentialTimeZone,
+  credentialTimeZoneIsStale,
+  writeCredentialTimeZone,
+  fetchGoogleCalendarTimeZone,
+  fetchCalcomTimeZone
+} from './vendorTimeZone';
 import { PlanLimitError, isPlanLimitError } from './planLimitError';
 import type { PlanLimitDetails } from './planLimitError';
 import type { PlanLimits } from './constants';
@@ -333,6 +341,12 @@ export const utils = {
   buildReauthMetadata,
   clearReauthMetadata,
   isCredentialNeedingReauth,
+  isValidTimeZone,
+  readCredentialTimeZone,
+  credentialTimeZoneIsStale,
+  writeCredentialTimeZone,
+  fetchGoogleCalendarTimeZone,
+  fetchCalcomTimeZone,
   PlanLimitError,
   isPlanLimitError
 };

package/src/vendorTimeZone.ts

@@ -0,0 +1,171 @@
+// The time zone the user configured with the vendor, and where we keep it.
+//
+// Every scheduling question the model answers is a time-zone question first:
+// "tomorrow at 9" is not an instant until you know whose 9 it is. We had two
+// sources for that and neither worked. `artifact_tool.config.defaultTimeZone`
+// is only written when the owner opens a dropdown and changes it, so in
+// practice it is empty. The fallbacks underneath it were `undefined` (Google
+// then uses the calendar's own zone, which only helps when the timestamp has no
+// offset) and the string 'UTC' (Cal.com, which books the attendee in UTC and
+// tells nobody).
+//
+// But the user already answered this question — in Google Calendar's settings,
+// and in their Cal.com profile. So we ask the vendor instead of asking the
+// owner again, and the answer becomes the default under any explicit choice.
+//
+// It is cached on `artifact_credential.metadata` because that is what it is a
+// property of: the connected account, not the tool row. One artifact can have
+// six calendar tools installed and they all share one connection, so the
+// connection is the only place the answer belongs exactly once.
+
+import { constants } from './constants';
+
+// Metadata keys on artifact_credential. Namespaced with a prefix that will not
+// collide with the reauth markers written by the OAuth refresh path.
+const TIME_ZONE_KEY = 'timeZone';
+const TIME_ZONE_CHECKED_AT_KEY = 'timeZoneCheckedAt';
+
+// How long a cached zone is trusted. A day, because this changes when somebody
+// moves or travels — rarely, and never urgently. The cost of being briefly
+// stale is one meeting in the old zone; the cost of a shorter TTL is a vendor
+// round trip on the path of a tool call.
+const TIME_ZONE_TTL_MS = 24 * 60 * 60 * 1000;
+
+/**
+ * Is this a time zone the runtime actually knows?
+ *
+ * Everything downstream — `Intl.DateTimeFormat`, Google's `start.timeZone`,
+ * Cal.com's `attendee.timeZone` — throws or 400s on a name it cannot resolve.
+ * A vendor returning something unexpected must degrade to "we don't know"
+ * rather than poison every later call with a value that cannot be used.
+ */
+export const isValidTimeZone = (value: unknown): value is string => {
+  if (typeof value !== 'string' || !value.trim()) return false;
+  try {
+    new Intl.DateTimeFormat('en-US', { timeZone: value.trim() });
+    return true;
+  } catch {
+    return false;
+  }
+};
+
+/** The cached zone on a credential's metadata, or null. */
+export const readCredentialTimeZone = (metadata: unknown): string | null => {
+  if (!metadata || typeof metadata !== 'object') return null;
+  const value = (metadata as Record<string, unknown>)[TIME_ZONE_KEY];
+  return isValidTimeZone(value) ? value.trim() : null;
+};
+
+/**
+ * Should we ask the vendor again?
+ *
+ * True when there is nothing cached, when the stamp is missing or unreadable,
+ * or when the TTL has passed. A cache with no stamp is treated as stale rather
+ * than as fresh-forever — the conservative direction, since the only cost is
+ * one request.
+ */
+export const credentialTimeZoneIsStale = (
+  metadata: unknown,
+  now: number = Date.now()
+): boolean => {
+  if (!readCredentialTimeZone(metadata)) return true;
+  const raw = (metadata as Record<string, unknown>)[TIME_ZONE_CHECKED_AT_KEY];
+  if (typeof raw !== 'string') return true;
+  const checkedAt = Date.parse(raw);
+  if (!Number.isFinite(checkedAt)) return true;
+  return now - checkedAt >= TIME_ZONE_TTL_MS;
+};
+
+/**
+ * Merge a freshly read zone into a credential's metadata.
+ *
+ * Merges rather than replaces, because this column also carries the reauth
+ * markers — writing a bare `{ timeZone }` here would clear `needsReauth` and
+ * silently re-enable a connection the refresh path had flagged as broken.
+ *
+ * A null zone (the vendor could not tell us) still stamps the check, so a
+ * provider that never reports one is asked once a day rather than on every
+ * single call.
+ */
+export const writeCredentialTimeZone = (
+  previous: unknown,
+  timeZone: string | null,
+  now: Date = new Date()
+): Record<string, unknown> => {
+  const base =
+    previous && typeof previous === 'object'
+      ? { ...(previous as Record<string, unknown>) }
+      : {};
+  if (isValidTimeZone(timeZone)) {
+    base[TIME_ZONE_KEY] = timeZone.trim();
+  } else {
+    delete base[TIME_ZONE_KEY];
+  }
+  base[TIME_ZONE_CHECKED_AT_KEY] = now.toISOString();
+  return base;
+};
+
+/**
+ * The zone Google Calendar is configured in, from the primary calendar.
+ *
+ * Deliberately NOT `GET /users/me/settings/timezone`, which is the more
+ * direct answer to "what did the user configure" and needs
+ * `calendar.settings.readonly` — a scope we do not request and could not add
+ * without sending every already-connected user back through consent. The
+ * primary calendar's zone is the same value in every case that matters, and
+ * `calendar.readonly` already covers it.
+ *
+ * Returns null on any failure. Not knowing the zone is a state the callers
+ * handle; a throw here would take a tool call or a chat turn with it.
+ */
+export const fetchGoogleCalendarTimeZone = async (
+  accessToken: string
+): Promise<string | null> => {
+  try {
+    const response = await fetch(
+      `${constants.GOOGLE_CALENDAR_API_BASE}/calendars/primary`,
+      {
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          Accept: 'application/json'
+        }
+      }
+    );
+    if (!response.ok) return null;
+    const payload = (await response.json()) as { timeZone?: unknown };
+    return isValidTimeZone(payload?.timeZone) ? payload.timeZone.trim() : null;
+  } catch {
+    return null;
+  }
+};
+
+/**
+ * The zone on the connected Cal.com profile.
+ *
+ * This is the host's zone — the one their availability is written in — which
+ * is what "9am" means when the artifact owner or their bot says it. It is not
+ * the attendee's zone; see the booking handler for why we use it there anyway.
+ *
+ * Same null-on-failure contract as the Google reader above.
+ */
+export const fetchCalcomTimeZone = async (
+  apiKey: string
+): Promise<string | null> => {
+  try {
+    const response = await fetch(`${constants.CALCOM_API_BASE}/me`, {
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        'cal-api-version': constants.CALCOM_API_VERSION_ME,
+        Accept: 'application/json'
+      }
+    });
+    if (!response.ok) return null;
+    const payload = (await response.json()) as {
+      data?: { timeZone?: unknown };
+    };
+    const value = payload?.data?.timeZone;
+    return isValidTimeZone(value) ? value.trim() : null;
+  } catch {
+    return null;
+  }
+};