@dereekb/calcom 13.4.0 → 13.4.2

package/nestjs/index.esm.js

@@ -89,7 +89,12 @@ var CALCOM_API_KEY_CONFIG_KEY = 'CALCOM_API_KEY';
     ]);
     return CalcomOAuthServiceConfig;
 }();
-function calcomOAuthServiceConfigFactory(configService) {
+/**
+ * Factory function that creates a {@link CalcomOAuthServiceConfig} from NestJS ConfigService environment variables.
+ *
+ * @param configService - the NestJS ConfigService instance
+ * @returns a validated CalcomOAuthServiceConfig
+ */ function calcomOAuthServiceConfigFactory(configService) {
     var clientId = configService.get(CALCOM_CLIENT_ID_CONFIG_KEY);
     var clientSecret = configService.get(CALCOM_CLIENT_SECRET_CONFIG_KEY);
     var refreshToken = configService.get(CALCOM_REFRESH_TOKEN_CONFIG_KEY);
@@ -311,10 +316,18 @@ CalcomOAuthAccessTokenCacheService = __decorate([
 ], CalcomOAuthAccessTokenCacheService);
 /**
  * Derives a short, filesystem-safe cache key from a refresh token using md5.
+ *
+ * @param refreshToken - the OAuth refresh token to hash
+ * @returns a 16-character hex string suitable for use as a cache key
  */ function calcomRefreshTokenCacheKey(refreshToken) {
     return createHash('md5').update(refreshToken).digest('hex').substring(0, 16);
 }
-function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates) {
+/**
+ * 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
+ */ function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates) {
     console.warn("mergeCalcomOAuthAccessTokenCacheServices(): failed updating ".concat(failedUpdates.length, " caches."));
     failedUpdates.forEach(function(param, i) {
         var _param = _sliced_to_array(param, 2); _param[0]; var e = _param[1];
@@ -328,6 +341,8 @@ function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates)
  * When updating a cached token, it will update the token across all 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
  */ function mergeCalcomOAuthAccessTokenCacheServices(inputServicesToMerge, logError) {
     var allServices = _to_consumable_array$3(inputServicesToMerge);
     var logErrorFunction = typeof logError === 'function' ? logError : logError !== false ? logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction : undefined;
@@ -412,6 +427,10 @@ function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates)
 /**
  * Creates a CalcomOAuthAccessTokenCacheService that uses in-memory storage.
  * Per-user caches are stored in a Map keyed by the md5 hash of the refresh token.
+ *
+ * @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 Maps
  */ function memoryCalcomOAuthAccessTokenCacheService(existingToken, logAccessToConsole) {
     var serverToken = existingToken;
     var userTokens = new Map();
@@ -484,6 +503,7 @@ var CALCOM_SERVER_TOKEN_FILE_KEY = 'server';
  * ```
  *
  * @param cacheDir Directory to store token files. Defaults to `.tmp/calcom-tokens`.
+ * @returns a CalcomOAuthAccessTokenCacheService backed by the file system
  */ function fileCalcomOAuthAccessTokenCacheService() {
     var cacheDir = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : DEFAULT_FILE_CALCOM_ACCESS_TOKEN_CACHE_DIR;
     var memoryTokens = new Map();
@@ -673,13 +693,22 @@ var CalcomOAuthApi = /*#__PURE__*/ function() {
         {
             key: "exchangeAuthorizationCode",
             get: // MARK: Accessors
-            /** Configured pass-through for {@link exchangeAuthorizationCode}. */ function get() {
+            /**
+     * Configured pass-through for {@link exchangeAuthorizationCode}.
+     *
+     * @returns function to exchange an OAuth authorization code for tokens
+     */ function get() {
                 return exchangeAuthorizationCode(this.oauthContext);
             }
         },
         {
             /**
      * Retrieves an access token for a specific user using their refresh token.
+     *
+     * @param input - contains the user's refresh token and optional access token cache
+     * @param input.refreshToken - the user's OAuth refresh token
+     * @param input.userAccessTokenCache - optional cache to store/retrieve the user's access token
+     * @returns a promise resolving to the user's CalcomAccessToken
      */ key: "userAccessToken",
             value: function userAccessToken(input) {
                 var factory = this.oauthContext.makeUserAccessTokenFactory(input);
@@ -690,6 +719,9 @@ var CalcomOAuthApi = /*#__PURE__*/ function() {
             /**
      * Returns a per-user CalcomAccessTokenCache derived from the refresh token (md5 hashed as the file key).
      * Returns undefined if the cache service does not support per-user caching.
+     *
+     * @param refreshToken - the user's OAuth refresh token used to derive the cache key
+     * @returns a per-user access token cache, or undefined if not supported
      */ key: "cacheForRefreshToken",
             value: function cacheForRefreshToken(refreshToken) {
                 var _this_cacheService_cacheForRefreshToken, _this_cacheService;
@@ -732,6 +764,9 @@ function _unsupported_iterable_to_array$2(o, minLen) {
 }
 /**
  * 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
  */ function appCalcomOAuthModuleMetadata(config) {
     var _config_calcomOAuthServiceConfigFactory;
     var dependencyModule = config.dependencyModule, imports = config.imports, exports$1 = config.exports, providers = config.providers;
@@ -924,6 +959,8 @@ function _object_spread_props$1(target, source) {
             get: /**
      * Returns the cached {@link CalcomApiContextInstance} for the server context.
      * All API functions are available through this instance.
+     *
+     * @returns the server context instance
      */ function get() {
                 return this._serverInstance();
             }
@@ -931,7 +968,11 @@ function _object_spread_props$1(target, source) {
         {
             key: "getAvailableSlots",
             get: // MARK: Public Context
-            /** Configured pass-through for {@link getAvailableSlots} using the public (unauthenticated) context. */ function get() {
+            /**
+     * Configured pass-through for {@link getAvailableSlots} using the public (unauthenticated) context.
+     *
+     * @returns function to query available slots without authentication
+     */ function get() {
                 return getAvailableSlots(this._publicContext());
             }
         },
@@ -945,6 +986,9 @@ function _object_spread_props$1(target, source) {
      * resolved from the cache service using an md5 hash of the refresh token as the key.
      * This ensures tokens persist across requests and server restarts without collisions.
      *
+     * @param input - the user context factory input containing the refresh token and optional cache
+     * @returns a new CalcomApiContextInstance scoped to the user
+     *
      * @example
      * ```ts
      * // Automatic per-user caching (recommended):
@@ -975,6 +1019,9 @@ function _object_spread_props$1(target, source) {
         {
             /**
      * Creates a {@link CalcomApiContextInstance} from any {@link CalcomContext}.
+     *
+     * @param context - the CalcomContext (server or user) to wrap
+     * @returns a new CalcomApiContextInstance bound to the given context
      */ key: "makeContextInstance",
             value: function makeContextInstance(context) {
                 return new CalcomApiContextInstance(this, context);
@@ -984,6 +1031,9 @@ function _object_spread_props$1(target, source) {
             /**
      * Creates a raw {@link CalcomUserContext} from a refresh token, without wrapping in a {@link CalcomApiContextInstance}.
      * Prefer {@link makeUserContextInstance} unless you need direct context access.
+     *
+     * @param input - the user context factory input containing the refresh token and optional cache
+     * @returns a CalcomUserContext for the given user
      */ key: "makeUserContext",
             value: function makeUserContext(input) {
                 return this.calcom.calcomServerContext.makeUserContext(input);
@@ -1030,6 +1080,8 @@ CalcomApi = __decorate([
             get: // MARK: User
             /**
      * Configured pass-through for {@link getMe}.
+     *
+     * @returns function to retrieve the authenticated user's profile
      */ function get() {
                 return getMe(this.context);
             }
@@ -1039,6 +1091,8 @@ CalcomApi = __decorate([
             get: // MARK: Schedules
             /**
      * Configured pass-through for {@link getSchedules}.
+     *
+     * @returns function to retrieve all schedules for the authenticated user
      */ function get() {
                 return getSchedules(this.context);
             }
@@ -1048,6 +1102,8 @@ CalcomApi = __decorate([
             get: // MARK: Bookings
             /**
      * Configured pass-through for {@link createBooking}.
+     *
+     * @returns function to create a new booking
      */ function get() {
                 return createBooking(this.context);
             }
@@ -1056,6 +1112,8 @@ CalcomApi = __decorate([
             key: "getBooking",
             get: /**
      * Configured pass-through for {@link getBooking}.
+     *
+     * @returns function to retrieve a booking by UID
      */ function get() {
                 return getBooking(this.context);
             }
@@ -1064,6 +1122,8 @@ CalcomApi = __decorate([
             key: "cancelBooking",
             get: /**
      * Configured pass-through for {@link cancelBooking}.
+     *
+     * @returns function to cancel a booking by UID
      */ function get() {
                 return cancelBooking(this.context);
             }
@@ -1073,6 +1133,8 @@ CalcomApi = __decorate([
             get: // MARK: Event Types
             /**
      * Configured pass-through for {@link getEventTypes}.
+     *
+     * @returns function to retrieve all event types for the authenticated user
      */ function get() {
                 return getEventTypes(this.context);
             }
@@ -1081,6 +1143,8 @@ CalcomApi = __decorate([
             key: "createEventType",
             get: /**
      * Configured pass-through for {@link createEventType}.
+     *
+     * @returns function to create a new event type
      */ function get() {
                 return createEventType(this.context);
             }
@@ -1089,6 +1153,8 @@ CalcomApi = __decorate([
             key: "updateEventType",
             get: /**
      * Configured pass-through for {@link updateEventType}.
+     *
+     * @returns function to update an existing event type by ID
      */ function get() {
                 return updateEventType(this.context);
             }
@@ -1097,6 +1163,8 @@ CalcomApi = __decorate([
             key: "deleteEventType",
             get: /**
      * Configured pass-through for {@link deleteEventType}.
+     *
+     * @returns function to delete an event type by ID
      */ function get() {
                 return deleteEventType(this.context);
             }
@@ -1106,6 +1174,8 @@ CalcomApi = __decorate([
             get: // MARK: Calendars
             /**
      * Configured pass-through for {@link getCalendars}.
+     *
+     * @returns function to retrieve all connected calendars
      */ function get() {
                 return getCalendars(this.context);
             }
@@ -1114,6 +1184,8 @@ CalcomApi = __decorate([
             key: "getBusyTimes",
             get: /**
      * Configured pass-through for {@link getBusyTimes}.
+     *
+     * @returns function to retrieve busy time ranges across connected calendars
      */ function get() {
                 return getBusyTimes(this.context);
             }
@@ -1123,6 +1195,8 @@ CalcomApi = __decorate([
             get: // MARK: Webhooks
             /**
      * Configured pass-through for {@link createWebhook}.
+     *
+     * @returns function to create a webhook subscription
      */ function get() {
                 return createWebhook(this.context);
             }
@@ -1131,6 +1205,8 @@ CalcomApi = __decorate([
             key: "getWebhooks",
             get: /**
      * Configured pass-through for {@link getWebhooks}.
+     *
+     * @returns function to retrieve all webhooks
      */ function get() {
                 return getWebhooks(this.context);
             }
@@ -1139,6 +1215,8 @@ CalcomApi = __decorate([
             key: "getWebhook",
             get: /**
      * Configured pass-through for {@link getWebhook}.
+     *
+     * @returns function to retrieve a specific webhook by ID
      */ function get() {
                 return getWebhook(this.context);
             }
@@ -1147,6 +1225,8 @@ CalcomApi = __decorate([
             key: "updateWebhook",
             get: /**
      * Configured pass-through for {@link updateWebhook}.
+     *
+     * @returns function to update an existing webhook by ID
      */ function get() {
                 return updateWebhook(this.context);
             }
@@ -1155,6 +1235,8 @@ CalcomApi = __decorate([
             key: "deleteWebhook",
             get: /**
      * Configured pass-through for {@link deleteWebhook}.
+     *
+     * @returns function to delete a webhook by ID
      */ function get() {
                 return deleteWebhook(this.context);
             }
@@ -1190,7 +1272,12 @@ function _unsupported_iterable_to_array$1(o, minLen) {
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array$1(o, minLen);
 }
 // MARK: Provider Factories
-function calcomServiceConfigFactory(_configService) {
+/**
+ * Factory function that creates a {@link CalcomServiceConfig} from NestJS ConfigService values.
+ *
+ * @param _configService - the NestJS ConfigService instance
+ * @returns a validated CalcomServiceConfig
+ */ function calcomServiceConfigFactory(_configService) {
     var config = {
         calcom: {}
     };
@@ -1199,6 +1286,9 @@ function calcomServiceConfigFactory(_configService) {
 }
 /**
  * Convenience function used to generate ModuleMetadata for an app's CalcomModule.
+ *
+ * @param config - the module metadata configuration including optional dependency module
+ * @returns NestJS ModuleMetadata for registering the CalcomModule
  */ function appCalcomModuleMetadata(config) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports$1 = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -1279,6 +1369,9 @@ function _object_spread_props(target, source) {
 }
 /**
  * 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
  */ function calcomWebhookEvent(event) {
     return {
         triggerEvent: event.triggerEvent,
@@ -1291,7 +1384,6 @@ var calcomEventHandlerFactory = handlerFactory(function(x) {
 });
 var calcomEventHandlerConfigurerFactory = handlerConfigurerFactory({
     configurerForAccessor: function configurerForAccessor(accessor) {
-        // eslint-disable-next-line
         var fnWithKey = handlerMappedSetFunctionFactory(accessor, calcomWebhookEvent);
         var configurer = _object_spread_props(_object_spread({}, accessor), {
             handleBookingCreated: fnWithKey(CALCOM_WEBHOOK_BOOKING_CREATED),
@@ -1371,7 +1463,7 @@ var CALCOM_WEBHOOK_SECRET_CONFIG_KEY = 'CALCOM_WEBHOOK_SECRET';
         var event;
         try {
             event = JSON.parse(rawBodyString);
-        } catch (e) {
+        } catch (unused) {
             event = {
                 triggerEvent: '',
                 createdAt: '',
@@ -1868,7 +1960,12 @@ function _unsupported_iterable_to_array(o, minLen) {
     if (n === "Map" || n === "Set") return Array.from(n);
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
 }
-function calcomWebhookServiceConfigFactory(configService) {
+/**
+ * Factory function that creates a {@link CalcomWebhookServiceConfig} from NestJS ConfigService environment variables.
+ *
+ * @param configService - the NestJS ConfigService instance
+ * @returns a validated CalcomWebhookServiceConfig
+ */ function calcomWebhookServiceConfigFactory(configService) {
     var config = {
         webhookConfig: {
             webhookSecret: configService.get(CALCOM_WEBHOOK_SECRET_CONFIG_KEY)
@@ -1907,6 +2004,9 @@ CalcomWebhookModule = __decorate([
 ], CalcomWebhookModule);
 /**
  * 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
  */ function appCalcomWebhookModuleMetadata(config) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports$1 = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [

package/nestjs/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dereekb/calcom/nestjs",
-  "version": "13.4.0",
+  "version": "13.4.2",
   "peerDependencies": {
-    "@dereekb/nestjs": "13.4.0",
-    "@dereekb/util": "13.4.0",
-    "@dereekb/calcom": "13.4.0",
+    "@dereekb/nestjs": "13.4.2",
+    "@dereekb/util": "13.4.2",
+    "@dereekb/calcom": "13.4.2",
     "@nestjs/common": "^11.1.16",
     "@nestjs/config": "^4.0.3",
     "express": "^5.0.0"

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

@@ -32,9 +32,15 @@ export declare class CalcomApi {
     /**
      * Returns the cached {@link CalcomApiContextInstance} for the server context.
      * All API functions are available through this instance.
+     *
+     * @returns the server context instance
      */
     get serverContextInstance(): CalcomApiContextInstance;
-    /** Configured pass-through for {@link getAvailableSlots} using the public (unauthenticated) context. */
+    /**
+     * Configured pass-through for {@link getAvailableSlots} using the public (unauthenticated) context.
+     *
+     * @returns function to query available slots without authentication
+     */
     get getAvailableSlots(): (input: import("@dereekb/calcom").CalcomGetAvailableSlotsInput) => Promise<import("@dereekb/calcom").CalcomGetAvailableSlotsResponse>;
     /**
      * Creates a {@link CalcomApiContextInstance} for a specific user using their OAuth refresh token.
@@ -44,6 +50,9 @@ export declare class CalcomApi {
      * resolved from the cache service using an md5 hash of the refresh token as the key.
      * This ensures tokens persist across requests and server restarts without collisions.
      *
+     * @param input - the user context factory input containing the refresh token and optional cache
+     * @returns a new CalcomApiContextInstance scoped to the user
+     *
      * @example
      * ```ts
      * // Automatic per-user caching (recommended):
@@ -61,11 +70,17 @@ export declare class CalcomApi {
     makeUserContextInstance(input: CalcomUserContextFactoryInput): CalcomApiContextInstance;
     /**
      * Creates a {@link CalcomApiContextInstance} from any {@link CalcomContext}.
+     *
+     * @param context - the CalcomContext (server or user) to wrap
+     * @returns a new CalcomApiContextInstance bound to the given context
      */
     makeContextInstance(context: CalcomContext): CalcomApiContextInstance;
     /**
      * Creates a raw {@link CalcomUserContext} from a refresh token, without wrapping in a {@link CalcomApiContextInstance}.
      * Prefer {@link makeUserContextInstance} unless you need direct context access.
+     *
+     * @param input - the user context factory input containing the refresh token and optional cache
+     * @returns a CalcomUserContext for the given user
      */
     makeUserContext(input: CalcomUserContextFactoryInput): CalcomUserContext;
 }
@@ -95,66 +110,98 @@ export declare class CalcomApiContextInstance {
     constructor(calcomApi: CalcomApi, context: CalcomContext);
     /**
      * Configured pass-through for {@link getMe}.
+     *
+     * @returns function to retrieve the authenticated user's profile
      */
     get getMe(): () => Promise<import("@dereekb/calcom").CalcomGetMeResponse>;
     /**
      * Configured pass-through for {@link getSchedules}.
+     *
+     * @returns function to retrieve all schedules for the authenticated user
      */
     get getSchedules(): () => Promise<import("@dereekb/calcom").CalcomGetSchedulesResponse>;
     /**
      * Configured pass-through for {@link createBooking}.
+     *
+     * @returns function to create a new booking
      */
     get createBooking(): (input: import("@dereekb/calcom").CalcomCreateBookingInput) => Promise<import("@dereekb/calcom").CalcomCreateBookingResponse>;
     /**
      * Configured pass-through for {@link getBooking}.
+     *
+     * @returns function to retrieve a booking by UID
      */
     get getBooking(): (uid: import("@dereekb/calcom").CalcomBookingUid) => Promise<import("@dereekb/calcom").CalcomGetBookingResponse>;
     /**
      * Configured pass-through for {@link cancelBooking}.
+     *
+     * @returns function to cancel a booking by UID
      */
     get cancelBooking(): (input: import("@dereekb/calcom").CalcomCancelBookingInput) => Promise<import("@dereekb/calcom").CalcomCancelBookingResponse>;
     /**
      * Configured pass-through for {@link getEventTypes}.
+     *
+     * @returns function to retrieve all event types for the authenticated user
      */
     get getEventTypes(): () => Promise<import("@dereekb/calcom").CalcomGetEventTypesResponse>;
     /**
      * Configured pass-through for {@link createEventType}.
+     *
+     * @returns function to create a new event type
      */
     get createEventType(): (input: import("@dereekb/calcom").CalcomCreateEventTypeInput) => Promise<import("@dereekb/calcom").CalcomEventTypeResponse>;
     /**
      * Configured pass-through for {@link updateEventType}.
+     *
+     * @returns function to update an existing event type by ID
      */
     get updateEventType(): (eventTypeId: import("@dereekb/calcom").CalcomEventTypeId, input: import("@dereekb/calcom").CalcomUpdateEventTypeInput) => Promise<import("@dereekb/calcom").CalcomEventTypeResponse>;
     /**
      * Configured pass-through for {@link deleteEventType}.
+     *
+     * @returns function to delete an event type by ID
      */
     get deleteEventType(): (eventTypeId: import("@dereekb/calcom").CalcomEventTypeId) => Promise<import("@dereekb/calcom").CalcomEventTypeResponse>;
     /**
      * Configured pass-through for {@link getCalendars}.
+     *
+     * @returns function to retrieve all connected calendars
      */
     get getCalendars(): () => Promise<import("@dereekb/calcom").CalcomGetCalendarsResponse>;
     /**
      * Configured pass-through for {@link getBusyTimes}.
+     *
+     * @returns function to retrieve busy time ranges across connected calendars
      */
     get getBusyTimes(): (input: import("@dereekb/calcom").CalcomGetBusyTimesInput) => Promise<import("@dereekb/calcom").CalcomGetBusyTimesResponse>;
     /**
      * Configured pass-through for {@link createWebhook}.
+     *
+     * @returns function to create a webhook subscription
      */
     get createWebhook(): (input: import("@dereekb/calcom").CalcomCreateWebhookInput) => Promise<import("@dereekb/calcom").CalcomWebhookResponse>;
     /**
      * Configured pass-through for {@link getWebhooks}.
+     *
+     * @returns function to retrieve all webhooks
      */
     get getWebhooks(): () => Promise<import("@dereekb/calcom").CalcomGetWebhooksResponse>;
     /**
      * Configured pass-through for {@link getWebhook}.
+     *
+     * @returns function to retrieve a specific webhook by ID
      */
     get getWebhook(): (webhookId: import("@dereekb/calcom").CalcomWebhookId) => Promise<import("@dereekb/calcom").CalcomWebhookResponse>;
     /**
      * Configured pass-through for {@link updateWebhook}.
+     *
+     * @returns function to update an existing webhook by ID
      */
     get updateWebhook(): (webhookId: import("@dereekb/calcom").CalcomWebhookId, input: import("@dereekb/calcom").CalcomUpdateWebhookInput) => Promise<import("@dereekb/calcom").CalcomWebhookResponse>;
     /**
      * Configured pass-through for {@link deleteWebhook}.
+     *
+     * @returns function to delete a webhook by ID
      */
     get deleteWebhook(): (webhookId: import("@dereekb/calcom").CalcomWebhookId) => Promise<import("@dereekb/calcom").CalcomWebhookResponse>;
 }

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

@@ -2,6 +2,12 @@ import { type ModuleMetadata } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
 import { CalcomServiceConfig } from './calcom.config';
 import { type Maybe } from '@dereekb/util';
+/**
+ * Factory function that creates a {@link CalcomServiceConfig} from NestJS ConfigService values.
+ *
+ * @param _configService - the NestJS ConfigService instance
+ * @returns a validated CalcomServiceConfig
+ */
 export declare function calcomServiceConfigFactory(_configService: ConfigService): CalcomServiceConfig;
 export interface ProvideAppCalcomMetadataConfig extends Pick<ModuleMetadata, 'imports' | 'exports' | 'providers'> {
     /**
@@ -14,5 +20,8 @@ export interface ProvideAppCalcomMetadataConfig extends Pick<ModuleMetadata, 'im
 }
 /**
  * Convenience function used to generate ModuleMetadata for an app's CalcomModule.
+ *
+ * @param config - the module metadata configuration including optional dependency module
+ * @returns NestJS ModuleMetadata for registering the CalcomModule
  */
 export declare function appCalcomModuleMetadata(config: ProvideAppCalcomMetadataConfig): ModuleMetadata;

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

@@ -8,10 +8,19 @@ export declare class CalcomOAuthApi {
     readonly calcomOAuth: CalcomOAuth;
     get oauthContext(): CalcomOAuthContext;
     constructor(config: CalcomOAuthServiceConfig, cacheService: CalcomOAuthAccessTokenCacheService);
-    /** Configured pass-through for {@link exchangeAuthorizationCode}. */
+    /**
+     * Configured pass-through for {@link exchangeAuthorizationCode}.
+     *
+     * @returns function to exchange an OAuth authorization code for tokens
+     */
     get exchangeAuthorizationCode(): (input: import("@dereekb/calcom").CalcomOAuthExchangeAuthorizationCodeInput) => Promise<import("@dereekb/calcom").CalcomOAuthTokenResponse>;
     /**
      * Retrieves an access token for a specific user using their refresh token.
+     *
+     * @param input - contains the user's refresh token and optional access token cache
+     * @param input.refreshToken - the user's OAuth refresh token
+     * @param input.userAccessTokenCache - optional cache to store/retrieve the user's access token
+     * @returns a promise resolving to the user's CalcomAccessToken
      */
     userAccessToken(input: {
         refreshToken: string;
@@ -20,6 +29,9 @@ export declare class CalcomOAuthApi {
     /**
      * Returns a per-user CalcomAccessTokenCache derived from the refresh token (md5 hashed as the file key).
      * Returns undefined if the cache service does not support per-user caching.
+     *
+     * @param refreshToken - the user's OAuth refresh token used to derive the cache key
+     * @returns a per-user access token cache, or undefined if not supported
      */
     cacheForRefreshToken(refreshToken: CalcomRefreshToken): Maybe<CalcomAccessTokenCache>;
 }

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

@@ -19,4 +19,10 @@ export declare abstract class CalcomOAuthServiceConfig {
     readonly factoryConfig?: CalcomOAuthFactoryConfig;
     static assertValidConfig(config: CalcomOAuthServiceConfig): void;
 }
+/**
+ * Factory function that creates a {@link CalcomOAuthServiceConfig} from NestJS ConfigService environment variables.
+ *
+ * @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

@@ -20,5 +20,8 @@ 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
  */
 export declare function appCalcomOAuthModuleMetadata(config: ProvideAppCalcomOAuthMetadataConfig): ModuleMetadata;

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

@@ -24,9 +24,18 @@ export declare abstract class CalcomOAuthAccessTokenCacheService {
 export type CalcomOAuthAccessTokenCacheServiceWithRefreshToken = Required<CalcomOAuthAccessTokenCacheService>;
 /**
  * Derives a short, filesystem-safe cache key from a refresh token using md5.
+ *
+ * @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;
+/**
+ * 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
+ */
 export declare function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates: (readonly [CalcomAccessTokenCache, unknown])[]): void;
 /**
  * Merges the input services in order to use some as a backup source.
@@ -35,11 +44,17 @@ export declare function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(
  * When updating a cached token, it will update the token across all 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
  */
 export declare function mergeCalcomOAuthAccessTokenCacheServices(inputServicesToMerge: CalcomOAuthAccessTokenCacheService[], logError?: Maybe<boolean | LogMergeCalcomOAuthAccessTokenCacheServiceErrorFunction>): CalcomOAuthAccessTokenCacheService;
 /**
  * Creates a CalcomOAuthAccessTokenCacheService that uses in-memory storage.
  * Per-user caches are stored in a Map keyed by the md5 hash of the refresh token.
+ *
+ * @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 Maps
  */
 export declare function memoryCalcomOAuthAccessTokenCacheService(existingToken?: Maybe<CalcomAccessToken>, logAccessToConsole?: boolean): CalcomOAuthAccessTokenCacheService;
 export declare const DEFAULT_FILE_CALCOM_ACCESS_TOKEN_CACHE_DIR = ".tmp/calcom-tokens";
@@ -62,5 +77,6 @@ export interface FileSystemCalcomOAuthAccessTokenCacheService extends CalcomOAut
  * ```
  *
  * @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

@@ -2,6 +2,9 @@ import { type HandlerBindAccessor, type HandlerMappedSetFunction, type Handler }
 import { type CalcomWebhookEventType, type UntypedCalcomWebhookEvent, type CalcomWebhookEvent, type CalcomWebhookBookingPayload } from './webhook.calcom.type';
 /**
  * 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
  */
 export declare function calcomWebhookEvent<T>(event: UntypedCalcomWebhookEvent): CalcomWebhookEvent<T>;
 export type CalcomEventHandler = Handler<UntypedCalcomWebhookEvent, CalcomWebhookEventType>;