@dereekb/calcom 13.37.0 → 13.39.0

package/index.esm.js

@@ -1469,6 +1469,121 @@ var CALCOM_API_VERSION_HEADER = 'cal-api-version';
         });
     };
 }
+/**
+ * Creates a new schedule for the authenticated user.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Creates a new schedule from the given input.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/create-a-schedule
+ *
+ * @example
+ * ```ts
+ * const response = await createSchedule(context)({
+ *   name: 'Coaching Hours',
+ *   timeZone: 'America/Chicago',
+ *   isDefault: false,
+ *   availability: [{ days: ['Monday', 'Friday'], startTime: '08:00', endTime: '12:00' }],
+ *   overrides: [{ date: '2026-12-24', startTime: '10:00', endTime: '11:00' }]
+ * });
+ * console.log(response.data.id);
+ * ```
+ */ function createSchedule(context) {
+    return function(input) {
+        return context.fetchJson('/schedules', {
+            method: 'POST',
+            headers: calcomApiVersionHeaders(CALCOM_API_VERSION_SCHEDULES),
+            body: JSON.stringify(input)
+        });
+    };
+}
+/**
+ * Retrieves the authenticated user's default schedule.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves the default schedule.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/get-default-schedule
+ *
+ * @example
+ * ```ts
+ * const response = await getDefaultSchedule(context)();
+ * console.log(response.data?.name, response.data?.timeZone);
+ * ```
+ */ function getDefaultSchedule(context) {
+    return function() {
+        return context.fetchJson('/schedules/default', {
+            method: 'GET',
+            headers: calcomApiVersionHeaders(CALCOM_API_VERSION_SCHEDULES)
+        });
+    };
+}
+/**
+ * Retrieves a single schedule by ID.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves a schedule by ID.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/get-a-schedule
+ *
+ * @example
+ * ```ts
+ * const response = await getSchedule(context)(588440);
+ * console.log(response.data.availability, response.data.overrides);
+ * ```
+ */ function getSchedule(context) {
+    return function(scheduleId) {
+        return context.fetchJson("/schedules/".concat(scheduleId), {
+            method: 'GET',
+            headers: calcomApiVersionHeaders(CALCOM_API_VERSION_SCHEDULES)
+        });
+    };
+}
+/**
+ * Updates an existing schedule by ID.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Updates a schedule by ID.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/update-a-schedule
+ *
+ * @example
+ * ```ts
+ * // replaces the weekly rules and marks the whole of Christmas Day unavailable
+ * await updateSchedule(context)(588440, {
+ *   availability: [{ days: ['Monday'], startTime: '09:00', endTime: '17:00' }],
+ *   overrides: [{ date: '2026-12-25', startTime: '00:00', endTime: '00:00' }]
+ * });
+ * ```
+ */ function updateSchedule(context) {
+    return function(scheduleId, input) {
+        return context.fetchJson("/schedules/".concat(scheduleId), {
+            method: 'PATCH',
+            headers: calcomApiVersionHeaders(CALCOM_API_VERSION_SCHEDULES),
+            body: JSON.stringify(input)
+        });
+    };
+}
+/**
+ * Deletes a schedule by ID.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Deletes a schedule by ID.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/delete-a-schedule
+ *
+ * @example
+ * ```ts
+ * await deleteSchedule(context)(588440);
+ * ```
+ */ function deleteSchedule(context) {
+    return function(scheduleId) {
+        return context.fetchJson("/schedules/".concat(scheduleId), {
+            method: 'DELETE',
+            headers: calcomApiVersionHeaders(CALCOM_API_VERSION_SCHEDULES)
+        });
+    };
+}
 
 /**
  * Queries available booking slots for a given event type within a date range.
@@ -2784,4 +2899,4 @@ function _ts_generator(thisArg, body) {
     };
 }
 
-export { ALL_CALCOM_OAUTH_SCOPES, ALL_CALCOM_WEBHOOK_TIME_RELATIVE_TRIGGERS, ALL_CALCOM_WEBHOOK_TIME_UNITS, ALL_CALCOM_WEBHOOK_VERSIONS, CALCOM_API_KEY_ACCESS_TOKEN_EXPIRATION, CALCOM_API_URL, CALCOM_API_VERSION_BOOKINGS, CALCOM_API_VERSION_CALENDARS, CALCOM_API_VERSION_EVENT_TYPES, CALCOM_API_VERSION_HEADER, CALCOM_API_VERSION_ME, CALCOM_API_VERSION_SCHEDULES, CALCOM_API_VERSION_SLOTS, CALCOM_OAUTH_API_URL, CALCOM_OAUTH_AUTHORIZE_RESPONSE_TYPE, CALCOM_OAUTH_AUTHORIZE_URL, CALCOM_OAUTH_INVALID_GRANT_ERROR_CODE, CALCOM_OAUTH_SCOPE_DELIMITER, CALCOM_OAUTH_TOKEN_PATH, CALCOM_OAUTH_TOKEN_URL, CALCOM_RATE_LIMIT_LIMIT_HEADER, CALCOM_RATE_LIMIT_REMAINING_HEADER, CALCOM_RATE_LIMIT_RESET_HEADER, CALCOM_TOO_MANY_REQUESTS_HTTP_STATUS_CODE, CALCOM_WEBHOOK_TIME_UNIT_TIME_UNIT_MAP, CalcomOAuthAccessTokenError, CalcomOAuthAuthFailureError, CalcomServerError, CalcomServerFetchResponseError, CalcomTooManyRequestsError, DEFAULT_CALCOM_API_RATE_LIMIT, DEFAULT_CALCOM_API_RATE_LIMIT_RESET_PERIOD, DEFAULT_CALCOM_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION, calcomAccessTokenFromApiKey, calcomAccessTokenFromTokenResponse, calcomAccessTokenStringFactory, calcomApiVersionHeaders, calcomAuthCredentialFromValues, calcomCalendarsToLoadFromConnectedCalendars, calcomFactory, calcomOAuthAccessTokenFactory, calcomOAuthAuthorizeUrlFactory, calcomOAuthFactory, calcomRateLimitHeaderDetails, calcomRateLimitedFetchHandler, calcomServerErrorDataFromApiErrorResponseBody, calcomWebhookTimeOffsetFromWebhook, calcomWebhookTimeOffsetToTimeDuration, cancelBooking, createBooking, createEventType, createWebhook, deleteEventType, deleteWebhook, exchangeAuthorizationCode, getAvailableSlots, getBooking, getBookings, getBusyTimes, getBusyTimesForConnectedCalendars, getCalendars, getEventTypes, getMe, getSchedules, getWebhook, getWebhooks, handleCalcomErrorFetch, handleCalcomErrorFetchFactory, handleCalcomOAuthErrorFetch, isCalcomApiKeyCredential, isCalcomOAuthScope, logCalcomErrorToConsole, logCalcomOAuthErrorToConsole, logCalcomServerErrorFunction, parseCalcomApiError, parseCalcomApiServerErrorResponseData, parseCalcomOAuthError, parseCalcomOAuthServerErrorResponseData, parseCalcomServerErrorData, refreshAccessToken, updateEventType, updateWebhook };
+export { ALL_CALCOM_OAUTH_SCOPES, ALL_CALCOM_WEBHOOK_TIME_RELATIVE_TRIGGERS, ALL_CALCOM_WEBHOOK_TIME_UNITS, ALL_CALCOM_WEBHOOK_VERSIONS, CALCOM_API_KEY_ACCESS_TOKEN_EXPIRATION, CALCOM_API_URL, CALCOM_API_VERSION_BOOKINGS, CALCOM_API_VERSION_CALENDARS, CALCOM_API_VERSION_EVENT_TYPES, CALCOM_API_VERSION_HEADER, CALCOM_API_VERSION_ME, CALCOM_API_VERSION_SCHEDULES, CALCOM_API_VERSION_SLOTS, CALCOM_OAUTH_API_URL, CALCOM_OAUTH_AUTHORIZE_RESPONSE_TYPE, CALCOM_OAUTH_AUTHORIZE_URL, CALCOM_OAUTH_INVALID_GRANT_ERROR_CODE, CALCOM_OAUTH_SCOPE_DELIMITER, CALCOM_OAUTH_TOKEN_PATH, CALCOM_OAUTH_TOKEN_URL, CALCOM_RATE_LIMIT_LIMIT_HEADER, CALCOM_RATE_LIMIT_REMAINING_HEADER, CALCOM_RATE_LIMIT_RESET_HEADER, CALCOM_TOO_MANY_REQUESTS_HTTP_STATUS_CODE, CALCOM_WEBHOOK_TIME_UNIT_TIME_UNIT_MAP, CalcomOAuthAccessTokenError, CalcomOAuthAuthFailureError, CalcomServerError, CalcomServerFetchResponseError, CalcomTooManyRequestsError, DEFAULT_CALCOM_API_RATE_LIMIT, DEFAULT_CALCOM_API_RATE_LIMIT_RESET_PERIOD, DEFAULT_CALCOM_RATE_LIMITED_TOO_MANY_REQUESTS_LOG_FUNCTION, calcomAccessTokenFromApiKey, calcomAccessTokenFromTokenResponse, calcomAccessTokenStringFactory, calcomApiVersionHeaders, calcomAuthCredentialFromValues, calcomCalendarsToLoadFromConnectedCalendars, calcomFactory, calcomOAuthAccessTokenFactory, calcomOAuthAuthorizeUrlFactory, calcomOAuthFactory, calcomRateLimitHeaderDetails, calcomRateLimitedFetchHandler, calcomServerErrorDataFromApiErrorResponseBody, calcomWebhookTimeOffsetFromWebhook, calcomWebhookTimeOffsetToTimeDuration, cancelBooking, createBooking, createEventType, createSchedule, createWebhook, deleteEventType, deleteSchedule, deleteWebhook, exchangeAuthorizationCode, getAvailableSlots, getBooking, getBookings, getBusyTimes, getBusyTimesForConnectedCalendars, getCalendars, getDefaultSchedule, getEventTypes, getMe, getSchedule, getSchedules, getWebhook, getWebhooks, handleCalcomErrorFetch, handleCalcomErrorFetchFactory, handleCalcomOAuthErrorFetch, isCalcomApiKeyCredential, isCalcomOAuthScope, logCalcomErrorToConsole, logCalcomOAuthErrorToConsole, logCalcomServerErrorFunction, parseCalcomApiError, parseCalcomApiServerErrorResponseData, parseCalcomOAuthError, parseCalcomOAuthServerErrorResponseData, parseCalcomServerErrorData, refreshAccessToken, updateEventType, updateSchedule, updateWebhook };

package/nestjs/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@dereekb/calcom/nestjs",
-  "version": "13.37.0",
+  "version": "13.39.0",
+  "type": "module",
   "peerDependencies": {
-    "@dereekb/nestjs": "13.37.0",
-    "@dereekb/rxjs": "13.37.0",
-    "@dereekb/util": "13.37.0",
-    "@dereekb/calcom": "13.37.0",
+    "@dereekb/nestjs": "13.39.0",
+    "@dereekb/rxjs": "13.39.0",
+    "@dereekb/util": "13.39.0",
+    "@dereekb/calcom": "13.39.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1"
@@ -17,13 +18,12 @@
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "module": "./index.esm.js",
       "types": "./index.d.ts",
-      "import": "./index.cjs.mjs",
-      "default": "./index.cjs.js"
+      "import": "./index.esm.js",
+      "default": "./index.esm.js"
     }
   },
   "module": "./index.esm.js",
-  "main": "./index.cjs.js",
+  "main": "./index.esm.js",
   "types": "./index.d.ts"
-}
+}

package/package.json

@@ -1,25 +1,24 @@
 {
   "name": "@dereekb/calcom",
-  "version": "13.37.0",
+  "version": "13.39.0",
+  "type": "module",
   "exports": {
     "./nestjs": {
-      "module": "./nestjs/index.esm.js",
       "types": "./nestjs/index.d.ts",
-      "import": "./nestjs/index.cjs.mjs",
-      "default": "./nestjs/index.cjs.js"
+      "import": "./nestjs/index.esm.js",
+      "default": "./nestjs/index.esm.js"
     },
     "./package.json": "./package.json",
     ".": {
-      "module": "./index.esm.js",
       "types": "./index.d.ts",
-      "import": "./index.cjs.mjs",
-      "default": "./index.cjs.js"
+      "import": "./index.esm.js",
+      "default": "./index.esm.js"
     }
   },
   "peerDependencies": {
-    "@dereekb/nestjs": "13.37.0",
-    "@dereekb/rxjs": "13.37.0",
-    "@dereekb/util": "13.37.0",
+    "@dereekb/nestjs": "13.39.0",
+    "@dereekb/rxjs": "13.39.0",
+    "@dereekb/util": "13.39.0",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1",
@@ -30,6 +29,6 @@
     "date-fns": "^4.1.0"
   },
   "module": "./index.esm.js",
-  "main": "./index.cjs.js",
+  "main": "./index.esm.js",
   "types": "./index.d.ts"
-}
+}

package/src/lib/calcom/calcom.api.schedule.d.ts

@@ -1,22 +1,38 @@
-import { type ISO8601DayString, type TimezoneString } from '@dereekb/util';
+import { type ISO8601DayString, type Maybe, type TimezoneString } from '@dereekb/util';
 import { type CalcomContext } from './calcom.config';
 import { type CalcomScheduleId, type CalcomResponseStatus, type CalcomUserId } from '../calcom.type';
+/**
+ * A time of day within a schedule, as the `HH:MM` (24-hour, zero-padded) string Cal.com uses.
+ *
+ * The format is enforced server-side: a value that does not match is rejected with a 400 whose
+ * detail reads "startTime must be a valid time format HH:MM". Seconds are not accepted.
+ */
+export type CalcomTimeOfDayString = string;
 export interface CalcomAvailabilityRule {
     readonly days: string[];
-    readonly startTime: string;
-    readonly endTime: string;
+    readonly startTime: CalcomTimeOfDayString;
+    readonly endTime: CalcomTimeOfDayString;
 }
 /**
  * A date-specific exception to a schedule's weekly availability.
  *
- * NOTE: the array itself is confirmed against the live API, but this entry shape is taken from
- * the Cal.com docs — the account used to verify this package has no overrides configured, so no
- * real entry was observed. Treat the field names as unverified.
+ * An override REPLACES the weekly rules for its date rather than adding to them — verified live by
+ * overriding a Monday whose weekly rule was 08:00-12:00 with 13:00-14:00 and observing `/slots`
+ * return only the 13:00-14:00 slots for that day.
+ *
+ * A full-day "unavailable" IS expressible here: `startTime` and `endTime` are both REQUIRED (see
+ * {@link CalcomTimeOfDayString} — omitting either is a 400), but a ZERO-LENGTH range of
+ * `00:00`-`00:00` is accepted, round-trips verbatim, and removes the day from availability
+ * entirely. Verified live by putting a zero-length override on one Monday while leaving a second
+ * Monday untouched, then reading a single `/slots` window covering both: the overridden day came
+ * back with no slots at all (absent from the day map) while the control Monday kept its 8. So a
+ * caller representing a day off as an empty range list maps it to `00:00`-`00:00` here, and does
+ * NOT need the separate `/v2/ooo` (out-of-office) endpoints for it.
  */
 export interface CalcomScheduleOverride {
     readonly date: ISO8601DayString;
-    readonly startTime: string;
-    readonly endTime: string;
+    readonly startTime: CalcomTimeOfDayString;
+    readonly endTime: CalcomTimeOfDayString;
 }
 export interface CalcomSchedule {
     readonly id: CalcomScheduleId;
@@ -34,6 +50,66 @@ export interface CalcomGetSchedulesResponse {
     readonly status: CalcomResponseStatus;
     readonly data: CalcomSchedule[];
 }
+/**
+ * A response carrying a single schedule.
+ *
+ * Returned by create/read/update — each echoes the full schedule back, including the availability
+ * rules and overrides as they were persisted.
+ */
+export interface CalcomScheduleResponse {
+    readonly status: CalcomResponseStatus;
+    readonly data: CalcomSchedule;
+}
+/**
+ * The response to a default-schedule lookup.
+ *
+ * Distinct from {@link CalcomScheduleResponse} because `data` is optional: an account with a
+ * default schedule was observed returning the full schedule object, but an account that has
+ * deleted every schedule was deliberately not exercised (doing so would have meant destroying the
+ * verifying account's only schedule), so the absent case is typed rather than assumed away.
+ */
+export interface CalcomDefaultScheduleResponse {
+    readonly status: CalcomResponseStatus;
+    readonly data: Maybe<CalcomSchedule>;
+}
+/**
+ * The response to a schedule deletion.
+ *
+ * Carries NO `data` — unlike the event-type and webhook deletes, which echo the deleted record,
+ * this endpoint returns a bare `{ "status": "success" }`.
+ */
+export interface CalcomDeleteScheduleResponse {
+    readonly status: CalcomResponseStatus;
+}
+/**
+ * The schedule fields accepted by both create and update.
+ */
+export interface CalcomScheduleInputSettings {
+    /**
+     * The weekly availability rules. Omitting this on create yields a schedule with no availability.
+     */
+    readonly availability?: Maybe<CalcomAvailabilityRule[]>;
+    /**
+     * The date-specific exceptions. See {@link CalcomScheduleOverride} for expressing a full day off.
+     */
+    readonly overrides?: Maybe<CalcomScheduleOverride[]>;
+}
+export interface CalcomCreateScheduleInput extends CalcomScheduleInputSettings {
+    readonly name: string;
+    readonly timeZone: TimezoneString;
+    readonly isDefault: boolean;
+}
+/**
+ * A PARTIAL update — every field is optional and only the provided ones are changed.
+ *
+ * Note that `availability` and `overrides` are REPLACED wholesale when provided, not merged, so
+ * passing `overrides: []` clears every existing override.
+ */
+export interface CalcomUpdateScheduleInput extends CalcomScheduleInputSettings {
+    readonly name?: Maybe<string>;
+    readonly timeZone?: Maybe<TimezoneString>;
+    readonly isDefault?: Maybe<boolean>;
+}
 /**
  * Retrieves all schedules for the authenticated user, including availability rules and overrides.
  *
@@ -49,3 +125,86 @@ export interface CalcomGetSchedulesResponse {
  * ```
  */
 export declare function getSchedules(context: CalcomContext): () => Promise<CalcomGetSchedulesResponse>;
+/**
+ * Creates a new schedule for the authenticated user.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Creates a new schedule from the given input.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/create-a-schedule
+ *
+ * @example
+ * ```ts
+ * const response = await createSchedule(context)({
+ *   name: 'Coaching Hours',
+ *   timeZone: 'America/Chicago',
+ *   isDefault: false,
+ *   availability: [{ days: ['Monday', 'Friday'], startTime: '08:00', endTime: '12:00' }],
+ *   overrides: [{ date: '2026-12-24', startTime: '10:00', endTime: '11:00' }]
+ * });
+ * console.log(response.data.id);
+ * ```
+ */
+export declare function createSchedule(context: CalcomContext): (input: CalcomCreateScheduleInput) => Promise<CalcomScheduleResponse>;
+/**
+ * Retrieves the authenticated user's default schedule.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves the default schedule.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/get-default-schedule
+ *
+ * @example
+ * ```ts
+ * const response = await getDefaultSchedule(context)();
+ * console.log(response.data?.name, response.data?.timeZone);
+ * ```
+ */
+export declare function getDefaultSchedule(context: CalcomContext): () => Promise<CalcomDefaultScheduleResponse>;
+/**
+ * Retrieves a single schedule by ID.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves a schedule by ID.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/get-a-schedule
+ *
+ * @example
+ * ```ts
+ * const response = await getSchedule(context)(588440);
+ * console.log(response.data.availability, response.data.overrides);
+ * ```
+ */
+export declare function getSchedule(context: CalcomContext): (scheduleId: CalcomScheduleId) => Promise<CalcomScheduleResponse>;
+/**
+ * Updates an existing schedule by ID.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Updates a schedule by ID.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/update-a-schedule
+ *
+ * @example
+ * ```ts
+ * // replaces the weekly rules and marks the whole of Christmas Day unavailable
+ * await updateSchedule(context)(588440, {
+ *   availability: [{ days: ['Monday'], startTime: '09:00', endTime: '17:00' }],
+ *   overrides: [{ date: '2026-12-25', startTime: '00:00', endTime: '00:00' }]
+ * });
+ * ```
+ */
+export declare function updateSchedule(context: CalcomContext): (scheduleId: CalcomScheduleId, input: CalcomUpdateScheduleInput) => Promise<CalcomScheduleResponse>;
+/**
+ * Deletes a schedule by ID.
+ *
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Deletes a schedule by ID.
+ *
+ * @see https://cal.com/docs/api-reference/v2/schedules/delete-a-schedule
+ *
+ * @example
+ * ```ts
+ * await deleteSchedule(context)(588440);
+ * ```
+ */
+export declare function deleteSchedule(context: CalcomContext): (scheduleId: CalcomScheduleId) => Promise<CalcomDeleteScheduleResponse>;

package/index.cjs.default.js

@@ -1 +0,0 @@
-exports._default = require('./index.cjs.js').default;