@dereekb/calcom 13.11.13 → 13.11.15

package/nestjs/src/lib/oauth/oauth.config.d.ts

@@ -22,7 +22,7 @@ export declare abstract class CalcomOAuthServiceConfig {
 /**
  * Factory function that creates a {@link CalcomOAuthServiceConfig} from NestJS ConfigService environment variables.
  *
- * @param configService - the NestJS ConfigService instance
- * @returns a validated CalcomOAuthServiceConfig
+ * @param configService - The NestJS ConfigService instance.
+ * @returns A validated CalcomOAuthServiceConfig.
  */
 export declare function calcomOAuthServiceConfigFactory(configService: ConfigService): CalcomOAuthServiceConfig;

package/nestjs/src/lib/oauth/oauth.module.d.ts

@@ -21,7 +21,7 @@ export interface ProvideAppCalcomOAuthMetadataConfig extends Pick<ModuleMetadata
 /**
  * Convenience function used to generate ModuleMetadata for an app's CalcomOAuthModule.
  *
- * @param config - the module metadata configuration including optional dependency module and config factory
- * @returns NestJS ModuleMetadata for registering the CalcomOAuthModule
+ * @param config - The module metadata configuration including optional dependency module and config factory.
+ * @returns NestJS ModuleMetadata for registering the CalcomOAuthModule.
  */
 export declare function appCalcomOAuthModuleMetadata(config: ProvideAppCalcomOAuthMetadataConfig): ModuleMetadata;

package/nestjs/src/lib/oauth/oauth.service.d.ts

@@ -27,8 +27,8 @@ export type CalcomOAuthAccessTokenCacheServiceWithRefreshToken = Required<Calcom
  *
  * Uses SHA-256 truncated to 16 hex chars; the goal is fingerprinting, not security.
  *
- * @param refreshToken - the OAuth refresh token to hash
- * @returns a 16-character hex string suitable for use as a cache key
+ * @param refreshToken - The OAuth refresh token to hash.
+ * @returns A 16-character hex string suitable for use as a cache key.
  */
 export declare function calcomRefreshTokenCacheKey(refreshToken: string): string;
 export type LogMergeCalcomOAuthAccessTokenCacheServiceErrorFunction = (failedUpdates: (readonly [CalcomAccessTokenCache, unknown])[]) => void;
@@ -36,7 +36,7 @@ export type LogMergeCalcomOAuthAccessTokenCacheServiceErrorFunction = (failedUpd
  * Default error logging function for {@link mergeCalcomOAuthAccessTokenCacheServices}.
  * Logs a warning for each cache that failed to update.
  *
- * @param failedUpdates - array of tuples containing the failed cache and its error
+ * @param failedUpdates - Array of tuples containing the failed cache and its error.
  */
 export declare function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates: (readonly [CalcomAccessTokenCache, unknown])[]): void;
 /**
@@ -50,9 +50,10 @@ export declare function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(
  * never short-circuits the lookup. Updates run across all services in parallel via
  * `Promise.allSettled`, mirroring the previous behavior, with optional error logging.
  *
- * @param inputServicesToMerge Must include at least one service. Empty arrays will throw an error.
- * @param logError - optional error logging configuration; pass a function, true for default logging, or false to disable
- * @returns a merged CalcomOAuthAccessTokenCacheService that delegates across all input services
+ * @param inputServicesToMerge - Must include at least one service. Empty arrays will throw an error.
+ * @param logError - Optional error logging configuration; pass a function, true for default logging, or false to disable.
+ * @returns A merged CalcomOAuthAccessTokenCacheService that delegates across all input services.
+ * @throws {Error} When `inputServicesToMerge` is empty.
  */
 export declare function mergeCalcomOAuthAccessTokenCacheServices(inputServicesToMerge: CalcomOAuthAccessTokenCacheService[], logError?: Maybe<boolean | LogMergeCalcomOAuthAccessTokenCacheServiceErrorFunction>): CalcomOAuthAccessTokenCacheService;
 /**
@@ -62,9 +63,9 @@ export declare function mergeCalcomOAuthAccessTokenCacheServices(inputServicesTo
  * per-user tokens are held in an {@link inMemoryAsyncKeyedValueCache} keyed by the
  * sha256-truncated refresh token hash.
  *
- * @param existingToken - optional pre-existing server-level access token to seed the cache
- * @param logAccessToConsole - when true, logs all cache reads and writes to console
- * @returns a CalcomOAuthAccessTokenCacheService backed by in-memory caches
+ * @param existingToken - Optional pre-existing server-level access token to seed the cache.
+ * @param logAccessToConsole - When true, logs all cache reads and writes to console.
+ * @returns A CalcomOAuthAccessTokenCacheService backed by in-memory caches.
  */
 export declare function memoryCalcomOAuthAccessTokenCacheService(existingToken?: Maybe<CalcomAccessToken>, logAccessToConsole?: boolean): CalcomOAuthAccessTokenCacheService;
 export declare const DEFAULT_FILE_CALCOM_ACCESS_TOKEN_CACHE_DIR = ".tmp/calcom-tokens";
@@ -89,7 +90,7 @@ export interface FileSystemCalcomOAuthAccessTokenCacheService extends CalcomOAut
  *   user-<sha256hash>.json   — per-user tokens (hash of initial refresh token)
  * ```
  *
- * @param cacheDir Directory to store token files. Defaults to `.tmp/calcom-tokens`.
- * @returns a CalcomOAuthAccessTokenCacheService backed by the file system
+ * @param cacheDir - Directory to store token files. Defaults to `.tmp/calcom-tokens`.
+ * @returns A CalcomOAuthAccessTokenCacheService backed by the file system.
  */
 export declare function fileCalcomOAuthAccessTokenCacheService(cacheDir?: string): FileSystemCalcomOAuthAccessTokenCacheService;

package/nestjs/src/lib/webhook/webhook.calcom.d.ts

@@ -3,8 +3,8 @@ import { type CalcomWebhookEventType, type UntypedCalcomWebhookEvent, type Calco
 /**
  * Creates a CalcomWebhookEvent and treats the data as the input type.
  *
- * @param event - the untyped webhook event to convert
- * @returns a typed CalcomWebhookEvent with the payload cast to type T
+ * @param event - The untyped webhook event to convert.
+ * @returns A typed CalcomWebhookEvent with the payload cast to type T.
  */
 export declare function calcomWebhookEvent<T>(event: UntypedCalcomWebhookEvent): CalcomWebhookEvent<T>;
 export type CalcomEventHandler = Handler<UntypedCalcomWebhookEvent, CalcomWebhookEventType>;

package/nestjs/src/lib/webhook/webhook.calcom.module.d.ts

@@ -5,8 +5,8 @@ import { type Maybe } from '@dereekb/util';
 /**
  * Factory function that creates a {@link CalcomWebhookServiceConfig} from NestJS ConfigService environment variables.
  *
- * @param configService - the NestJS ConfigService instance
- * @returns a validated CalcomWebhookServiceConfig
+ * @param configService - The NestJS ConfigService instance.
+ * @returns A validated CalcomWebhookServiceConfig.
  */
 export declare function calcomWebhookServiceConfigFactory(configService: ConfigService): CalcomWebhookServiceConfig;
 /**
@@ -23,7 +23,7 @@ export interface ProvideAppCalcomWebhookMetadataConfig extends Pick<ModuleMetada
 /**
  * Convenience function used to generate ModuleMetadata for an app's CalcomWebhookModule.
  *
- * @param config - the module metadata configuration including optional dependency module
- * @returns NestJS ModuleMetadata for registering the CalcomWebhookModule
+ * @param config - The module metadata configuration including optional dependency module.
+ * @returns NestJS ModuleMetadata for registering the CalcomWebhookModule.
  */
 export declare function appCalcomWebhookModuleMetadata(config: ProvideAppCalcomWebhookMetadataConfig): ModuleMetadata;

package/nestjs/src/lib/webhook/webhook.calcom.verify.d.ts

@@ -10,7 +10,7 @@ export type CalcomWebhookEventVerifier = (rawBody: Buffer, headers: Record<strin
 /**
  * Verifies a Cal.com webhook event using HMAC-SHA256 signature.
  *
- * @param secret The webhook signing secret.
- * @returns A function that verifies a Cal.com webhook event.
+ * @param secret - The webhook signing secret.
+ * @returns Verifies a Cal.com webhook event.
  */
 export declare function calcomWebhookEventVerifier(secret: string): CalcomWebhookEventVerifier;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/calcom",
-  "version": "13.11.13",
+  "version": "13.11.15",
   "exports": {
     "./nestjs": {
       "module": "./nestjs/index.esm.js",
@@ -17,9 +17,9 @@
     }
   },
   "peerDependencies": {
-    "@dereekb/nestjs": "13.11.13",
-    "@dereekb/rxjs": "13.11.13",
-    "@dereekb/util": "13.11.13",
+    "@dereekb/nestjs": "13.11.15",
+    "@dereekb/rxjs": "13.11.15",
+    "@dereekb/util": "13.11.15",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1",

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

@@ -48,10 +48,10 @@ export interface CalcomCancelBookingResponse {
  * Creates a new booking for the specified event type. The `attendee` represents the person
  * booking (the client), not the host. This endpoint can be called without authentication.
  *
- * @see https://cal.com/docs/api-reference/v2/bookings/create-a-booking
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Creates a booking from the given input.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that creates a booking from the given input
+ * @see https://cal.com/docs/api-reference/v2/bookings/create-a-booking
  *
  * @example
  * ```ts
@@ -62,16 +62,17 @@ export interface CalcomCancelBookingResponse {
  * });
  * console.log(response.data.uid);
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function createBooking(context: CalcomContext): (input: CalcomCreateBookingInput) => Promise<CalcomCreateBookingResponse>;
 /**
  * Retrieves a booking by its unique UID.
  *
- * @see https://cal.com/docs/api-reference/v2/bookings/get-a-booking
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves a booking by its UID.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves a booking by its UID
+ * @see https://cal.com/docs/api-reference/v2/bookings/get-a-booking
  *
  * @example
  * ```ts
@@ -83,10 +84,10 @@ export declare function getBooking(context: CalcomContext): (uid: CalcomBookingU
 /**
  * Cancels a booking by its unique UID, with an optional cancellation reason.
  *
- * @see https://cal.com/docs/api-reference/v2/bookings/cancel-a-booking
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Cancels a booking by UID.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that cancels a booking by UID
+ * @see https://cal.com/docs/api-reference/v2/bookings/cancel-a-booking
  *
  * @example
  * ```ts

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

@@ -56,10 +56,10 @@ export interface CalcomGetBusyTimesResponse {
 /**
  * Retrieves all connected calendars and the destination calendar for the authenticated user.
  *
- * @see https://cal.com/docs/api-reference/v2/calendars/get-all-calendars
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves all connected calendars.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves all connected calendars
+ * @see https://cal.com/docs/api-reference/v2/calendars/get-all-calendars
  *
  * @example
  * ```ts
@@ -71,10 +71,10 @@ export declare function getCalendars(context: CalcomContext): () => Promise<Calc
 /**
  * Retrieves busy time ranges across the user's connected calendars for a given date range.
  *
- * @see https://cal.com/docs/api-reference/v2/calendars/get-busy-times
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves busy time ranges for a date range.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves busy time ranges for a date range
+ * @see https://cal.com/docs/api-reference/v2/calendars/get-busy-times
  *
  * @example
  * ```ts

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

@@ -1,11 +1,11 @@
-import { type Minutes } from '@dereekb/util';
+import { type Minutes, type Maybe } from '@dereekb/util';
 import { type CalcomContext } from './calcom.config';
 import { type CalcomEventTypeId, type CalcomEventTypeSlug, type CalcomResponseStatus } from '../calcom.type';
 export interface CalcomEventType {
     readonly id: CalcomEventTypeId;
     readonly title: string;
     readonly slug: CalcomEventTypeSlug;
-    readonly description: string | null;
+    readonly description: Maybe<string>;
     readonly lengthInMinutes: Minutes;
     readonly locations: unknown[];
 }
@@ -36,10 +36,10 @@ export interface CalcomUpdateEventTypeInput {
 /**
  * Retrieves all event types for the authenticated user.
  *
- * @see https://cal.com/docs/api-reference/v2/event-types/get-all-event-types
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves all event types.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves all event types
+ * @see https://cal.com/docs/api-reference/v2/event-types/get-all-event-types
  *
  * @example
  * ```ts
@@ -51,10 +51,10 @@ export declare function getEventTypes(context: CalcomContext): () => Promise<Cal
 /**
  * Creates a new event type for the authenticated user.
  *
- * @see https://cal.com/docs/api-reference/v2/event-types/create-an-event-type
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Creates a new event type from the given input.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that creates a new event type from the given input
+ * @see https://cal.com/docs/api-reference/v2/event-types/create-an-event-type
  *
  * @example
  * ```ts
@@ -65,16 +65,17 @@ export declare function getEventTypes(context: CalcomContext): () => Promise<Cal
  * });
  * console.log(response.data.id);
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function createEventType(context: CalcomContext): (input: CalcomCreateEventTypeInput) => Promise<CalcomEventTypeResponse>;
 /**
  * Updates an existing event type by ID.
  *
- * @see https://cal.com/docs/api-reference/v2/event-types/update-an-event-type
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Updates an event type by ID.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that updates an event type by ID
+ * @see https://cal.com/docs/api-reference/v2/event-types/update-an-event-type
  *
  * @example
  * ```ts
@@ -85,10 +86,10 @@ export declare function updateEventType(context: CalcomContext): (eventTypeId: C
 /**
  * Deletes an event type by ID.
  *
- * @see https://cal.com/docs/api-reference/v2/event-types/delete-an-event-type
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Deletes an event type by ID.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that deletes an event type by ID
+ * @see https://cal.com/docs/api-reference/v2/event-types/delete-an-event-type
  *
  * @example
  * ```ts

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

@@ -21,10 +21,10 @@ export interface CalcomGetSchedulesResponse {
 /**
  * Retrieves all schedules for the authenticated user, including availability rules and overrides.
  *
- * @see https://cal.com/docs/api-reference/v2/schedules/get-all-schedules
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves all schedules.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves all schedules
+ * @see https://cal.com/docs/api-reference/v2/schedules/get-all-schedules
  *
  * @example
  * ```ts

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

@@ -28,10 +28,10 @@ export interface CalcomGetAvailableSlotsResponse {
  *
  * Identify the event type by `eventTypeId`, or by `eventTypeSlug` + `username`/`teamSlug`.
  *
- * @see https://cal.com/docs/api-reference/v2/slots/get-available-time-slots-for-an-event-type
+ * @param context - The Cal.com API context (authenticated or public)
+ * @returns Queries available slots for the given input.
  *
- * @param context - the Cal.com API context (authenticated or public)
- * @returns a function that queries available slots for the given input
+ * @see https://cal.com/docs/api-reference/v2/slots/get-available-time-slots-for-an-event-type
  *
  * @example
  * ```ts

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

@@ -1,15 +1,15 @@
-import { type EmailAddress, type ISO8601DateString, type TimezoneString } from '@dereekb/util';
+import { type EmailAddress, type ISO8601DateString, type TimezoneString, type Maybe } from '@dereekb/util';
 import { type CalcomContext } from './calcom.config';
 import { type CalcomUserId, type CalcomUsername, type CalcomScheduleId, type CalcomResponseStatus } from '../calcom.type';
 export interface CalcomUser {
     readonly id: CalcomUserId;
     readonly email: EmailAddress;
-    readonly username: CalcomUsername | null;
+    readonly username: Maybe<CalcomUsername>;
     readonly timeZone: TimezoneString;
     readonly weekStart: string;
     readonly createdDate: ISO8601DateString;
     readonly timeFormat: number;
-    readonly defaultScheduleId: CalcomScheduleId | null;
+    readonly defaultScheduleId: Maybe<CalcomScheduleId>;
 }
 export interface CalcomGetMeResponse {
     readonly status: CalcomResponseStatus;
@@ -18,10 +18,10 @@ export interface CalcomGetMeResponse {
 /**
  * Retrieves the profile of the currently authenticated Cal.com user.
  *
- * @see https://cal.com/docs/api-reference/v2/me
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves the authenticated user's profile.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves the authenticated user's profile
+ * @see https://cal.com/docs/api-reference/v2/me
  *
  * @example
  * ```ts

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

@@ -1,4 +1,4 @@
-import { type WebsiteUrl } from '@dereekb/util';
+import { type WebsiteUrl, type Maybe } from '@dereekb/util';
 import { type CalcomContext } from './calcom.config';
 import { type CalcomWebhookId, type CalcomResponseStatus } from '../calcom.type';
 export type CalcomWebhookTrigger = 'BOOKING_CREATED' | 'BOOKING_CANCELLED' | 'BOOKING_RESCHEDULED' | 'BOOKING_REQUESTED' | 'BOOKING_REJECTED' | 'BOOKING_NO_SHOW_UPDATED' | 'BOOKING_PAYMENT_INITIATED' | 'BOOKING_PAID' | 'MEETING_STARTED' | 'MEETING_ENDED' | 'RECORDING_READY' | 'RECORDING_TRANSCRIPTION_GENERATED';
@@ -7,8 +7,8 @@ export interface CalcomWebhook {
     readonly subscriberUrl: WebsiteUrl;
     readonly triggers: CalcomWebhookTrigger[];
     readonly active: boolean;
-    readonly payloadTemplate?: string | null;
-    readonly secret?: string | null;
+    readonly payloadTemplate?: Maybe<string>;
+    readonly secret?: Maybe<string>;
 }
 export interface CalcomCreateWebhookInput {
     readonly subscriberUrl: WebsiteUrl;
@@ -36,10 +36,10 @@ export interface CalcomGetWebhooksResponse {
  * Creates a webhook subscription for the authenticated user. Webhooks notify your app
  * when specified events occur (e.g., bookings created, cancelled, rescheduled).
  *
- * @see https://cal.com/docs/api-reference/v2/webhooks/create-a-webhook
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Creates a webhook subscription from the given input.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that creates a webhook subscription from the given input
+ * @see https://cal.com/docs/api-reference/v2/webhooks/create-a-webhook
  *
  * @example
  * ```ts
@@ -50,16 +50,17 @@ export interface CalcomGetWebhooksResponse {
  * });
  * console.log(response.data.id);
  * ```
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function createWebhook(context: CalcomContext): (input: CalcomCreateWebhookInput) => Promise<CalcomWebhookResponse>;
 /**
  * Retrieves all webhooks for the authenticated user.
  *
- * @see https://cal.com/docs/api-reference/v2/webhooks/get-all-webhooks
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves all webhooks.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves all webhooks
+ * @see https://cal.com/docs/api-reference/v2/webhooks/get-all-webhooks
  *
  * @example
  * ```ts
@@ -71,10 +72,10 @@ export declare function getWebhooks(context: CalcomContext): () => Promise<Calco
 /**
  * Retrieves a specific webhook by ID.
  *
- * @see https://cal.com/docs/api-reference/v2/webhooks/get-a-webhook
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Retrieves a specific webhook by ID.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that retrieves a specific webhook by ID
+ * @see https://cal.com/docs/api-reference/v2/webhooks/get-a-webhook
  *
  * @example
  * ```ts
@@ -86,10 +87,10 @@ export declare function getWebhook(context: CalcomContext): (webhookId: CalcomWe
 /**
  * Updates an existing webhook by ID.
  *
- * @see https://cal.com/docs/api-reference/v2/webhooks/update-a-webhook
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Updates an existing webhook by ID.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that updates an existing webhook by ID
+ * @see https://cal.com/docs/api-reference/v2/webhooks/update-a-webhook
  *
  * @example
  * ```ts
@@ -100,10 +101,10 @@ export declare function updateWebhook(context: CalcomContext): (webhookId: Calco
 /**
  * Deletes a webhook by ID.
  *
- * @see https://cal.com/docs/api-reference/v2/webhooks/delete-a-webhook
+ * @param context - The Cal.com API context providing authentication and fetch capabilities.
+ * @returns Deletes a webhook by ID.
  *
- * @param context - the Cal.com API context providing authentication and fetch capabilities
- * @returns a function that deletes a webhook by ID
+ * @see https://cal.com/docs/api-reference/v2/webhooks/delete-a-webhook
  *
  * @example
  * ```ts

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

@@ -5,17 +5,17 @@ export declare const logCalcomErrorToConsole: import("..").LogCalcomServerErrorF
  * Parses a FetchResponseError from a Cal.com API call into a typed CalcomServerError.
  * Attempts to extract JSON error data from the response body.
  *
- * @param responseError - the fetch response error to parse
- * @returns a parsed CalcomServerError, or undefined if the response body cannot be parsed
+ * @param responseError - The fetch response error to parse.
+ * @returns A parsed CalcomServerError, or undefined if the response body cannot be parsed.
  */
 export declare function parseCalcomApiError(responseError: FetchResponseError): Promise<ParsedCalcomServerError>;
 /**
  * Parses Cal.com API server error response data into a specific error type.
  * Delegates to {@link parseCalcomServerErrorData} for general error classification.
  *
- * @param calcomServerError - the parsed error data from the Cal.com response body
- * @param responseError - the original FetchResponseError containing the HTTP response
- * @returns a parsed CalcomServerError, or undefined if the error data is falsy
+ * @param calcomServerError - The parsed error data from the Cal.com response body.
+ * @param responseError - The original FetchResponseError containing the HTTP response.
+ * @returns A parsed CalcomServerError, or undefined if the error data is falsy.
  */
 export declare function parseCalcomApiServerErrorResponseData(calcomServerError: CalcomServerErrorData, responseError: FetchResponseError): ParsedCalcomServerError;
 export declare const handleCalcomErrorFetch: import("..").HandleCalcomErrorFetchFactory;

package/src/lib/calcom/calcom.factory.d.ts

@@ -25,8 +25,9 @@ export type CalcomFactory = (config: CalcomConfig) => Calcom;
  * Sets up rate limiting, error handling, OAuth token management, and both server
  * and per-user fetch contexts.
  *
- * @param factoryConfig - configuration including OAuth context, rate limiter, and optional fetch/logging overrides
- * @returns a factory function that accepts a CalcomConfig and produces a Calcom instance
+ * @param factoryConfig - Configuration including OAuth context, rate limiter, and optional fetch/logging overrides.
+ * @returns A factory function that accepts a CalcomConfig and produces a Calcom instance.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function calcomFactory(factoryConfig: CalcomFactoryConfig): CalcomFactory;

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

@@ -39,8 +39,9 @@ export type LogCalcomServerErrorFunction = (error: FetchRequestFactoryError | Ca
 /**
  * Creates a logCalcomServerErrorFunction that logs the error to console.
  *
- * @param calcomApiNamePrefix Prefix to use when logging. I.E. CalcomError, etc.
- * @returns a LogCalcomServerErrorFunction that logs errors with the given prefix
+ * @param calcomApiNamePrefix - Prefix to use when logging. I.E. CalcomError, etc.
+ * @returns A LogCalcomServerErrorFunction that logs errors with the given prefix.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function logCalcomServerErrorFunction(calcomApiNamePrefix: string): LogCalcomServerErrorFunction;
@@ -53,9 +54,10 @@ export type ParseCalcomFetchResponseErrorFunction = (responseError: FetchRespons
 /**
  * Wraps a ConfiguredFetch to support handling errors returned by fetch.
  *
- * @param parseCalcomError - function to parse a FetchResponseError into a CalcomServerError
- * @param defaultLogError - default error logging function used when no override is provided
- * @returns a factory that wraps any ConfiguredFetch with Cal.com error handling
+ * @param parseCalcomError - Function to parse a FetchResponseError into a CalcomServerError.
+ * @param defaultLogError - Default error logging function used when no override is provided.
+ * @returns A factory that wraps any ConfiguredFetch with Cal.com error handling.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function handleCalcomErrorFetchFactory(parseCalcomError: ParseCalcomFetchResponseErrorFunction, defaultLogError: LogCalcomServerErrorFunction): HandleCalcomErrorFetchFactory;
@@ -85,8 +87,8 @@ export interface CalcomRateLimitHeaderDetails {
 /**
  * Extracts Cal.com rate limit information from HTTP response headers.
  *
- * @param headers - the HTTP response headers to parse
- * @returns parsed rate limit details, or null if no rate limit headers are present
+ * @param headers - The HTTP response headers to parse.
+ * @returns Parsed rate limit details, or null if no rate limit headers are present.
  */
 export declare function calcomRateLimitHeaderDetails(headers: Headers): Maybe<CalcomRateLimitHeaderDetails>;
 export declare class CalcomTooManyRequestsError extends CalcomServerFetchResponseError {
@@ -95,8 +97,8 @@ export declare class CalcomTooManyRequestsError extends CalcomServerFetchRespons
 /**
  * Function that parses/transforms a CalcomServerErrorData into a general CalcomServerError or other known error type.
  *
- * @param calcomServerError - the parsed error data from the Cal.com response body
- * @param responseError - the original FetchResponseError containing the HTTP response
- * @returns a CalcomServerFetchResponseError (or subclass like CalcomTooManyRequestsError), or undefined if unrecognized
+ * @param calcomServerError - The parsed error data from the Cal.com response body.
+ * @param responseError - The original FetchResponseError containing the HTTP response.
+ * @returns A CalcomServerFetchResponseError (or subclass like CalcomTooManyRequestsError), or undefined if unrecognized.
  */
 export declare function parseCalcomServerErrorData(calcomServerError: CalcomServerErrorData, responseError: FetchResponseError): CalcomServerFetchResponseError | undefined;

package/src/lib/calcom.limit.d.ts

@@ -36,7 +36,7 @@ export type CalcomRateLimitedFetchHandler = RateLimitedFetchHandler<ResetPeriodP
  * Creates a rate-limited fetch handler configured for Cal.com API rate limits.
  * Automatically adjusts based on rate limit response headers and retries on 429 responses.
  *
- * @param config - optional rate limiter configuration overrides
- * @returns a CalcomRateLimitedFetchHandler that enforces rate limiting
+ * @param config - Optional rate limiter configuration overrides.
+ * @returns A CalcomRateLimitedFetchHandler that enforces rate limiting.
  */
 export declare function calcomRateLimitedFetchHandler(config?: Maybe<CalcomRateLimitedFetchHandlerConfig>): CalcomRateLimitedFetchHandler;

package/src/lib/oauth/oauth.api.d.ts

@@ -25,10 +25,10 @@ export interface CalcomOAuthAccessTokenErrorResponse {
  *
  * Cal.com uses JSON body (not Basic Auth) for token requests.
  *
- * @see https://cal.com/docs/api-reference/v2/oauth/refresh-an-existing-access-token
+ * @param context - The Cal.com OAuth context providing client credentials and fetch capabilities.
+ * @returns Refreshes an access token using an optional refresh token override.
  *
- * @param context - the Cal.com OAuth context providing client credentials and fetch capabilities
- * @returns a function that refreshes an access token using an optional refresh token override
+ * @see https://cal.com/docs/api-reference/v2/oauth/refresh-an-existing-access-token
  *
  * @example
  * ```ts
@@ -43,10 +43,10 @@ export declare function refreshAccessToken(context: CalcomOAuthContext): (input?
  *
  * Cal.com uses JSON body (not Basic Auth) for token requests.
  *
- * @see https://cal.com/docs/api-reference/v2/oauth/exchange-an-authorization-code-for-access-tokens
+ * @param context - The Cal.com OAuth context providing client credentials and fetch capabilities.
+ * @returns Exchanges an authorization code for access and refresh tokens.
  *
- * @param context - the Cal.com OAuth context providing client credentials and fetch capabilities
- * @returns a function that exchanges an authorization code for access and refresh tokens
+ * @see https://cal.com/docs/api-reference/v2/oauth/exchange-an-authorization-code-for-access-tokens
  *
  * @example
  * ```ts

package/src/lib/oauth/oauth.d.ts

@@ -63,8 +63,9 @@ export type CalcomAccessTokenStringFactory = () => Promise<CalcomAccessTokenStri
  * Wraps a CalcomAccessTokenFactory to extract just the access token string,
  * throwing a CalcomOAuthAuthFailureError if the token is missing.
  *
- * @param calcomAccessTokenFactory - the factory that produces CalcomAccessToken objects
- * @returns a factory function that returns the access token string
+ * @param calcomAccessTokenFactory - The factory that produces CalcomAccessToken objects.
+ * @returns A factory function that returns the access token string.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function calcomAccessTokenStringFactory(calcomAccessTokenFactory: CalcomAccessTokenFactory): CalcomAccessTokenStringFactory;

package/src/lib/oauth/oauth.error.api.d.ts

@@ -25,8 +25,8 @@ export declare const logCalcomOAuthErrorToConsole: import("..").LogCalcomServerE
  * Parses a FetchResponseError from a Cal.com OAuth call into a typed error.
  * Attempts to extract JSON error data from the response body.
  *
- * @param responseError - the fetch response error to parse
- * @returns a parsed CalcomServerError or CalcomOAuthAccessTokenError, or undefined if unparseable
+ * @param responseError - The fetch response error to parse.
+ * @returns A parsed CalcomServerError or CalcomOAuthAccessTokenError, or undefined if unparseable.
  */
 export declare function parseCalcomOAuthError(responseError: FetchResponseError): Promise<ParsedCalcomServerError>;
 /**
@@ -34,9 +34,9 @@ export declare function parseCalcomOAuthError(responseError: FetchResponseError)
  * Handles known error codes like `invalid_grant` and delegates unknown errors
  * to {@link parseCalcomServerErrorData}.
  *
- * @param calcomServerError - the parsed error data from the Cal.com OAuth response body
- * @param responseError - the original FetchResponseError containing the HTTP response
- * @returns a parsed error instance, or undefined if the error data is falsy
+ * @param calcomServerError - The parsed error data from the Cal.com OAuth response body.
+ * @param responseError - The original FetchResponseError containing the HTTP response.
+ * @returns A parsed error instance, or undefined if the error data is falsy.
  */
 export declare function parseCalcomOAuthServerErrorResponseData(calcomServerError: CalcomServerErrorData, responseError: FetchResponseError): ParsedCalcomServerError;
 export declare const handleCalcomOAuthErrorFetch: import("..").HandleCalcomErrorFetchFactory;