@dereekb/calcom 13.4.0 → 13.4.2

package/nestjs/index.cjs.js

@@ -91,7 +91,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);
@@ -313,10 +318,18 @@ exports.CalcomOAuthAccessTokenCacheService = __decorate([
 ], exports.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 crypto.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];
@@ -330,6 +343,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;
@@ -414,6 +429,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();
@@ -486,6 +505,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();
@@ -675,13 +695,22 @@ exports.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 calcom.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);
@@ -692,6 +721,9 @@ exports.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;
@@ -734,6 +766,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$1) {
     var _config_calcomOAuthServiceConfigFactory;
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;
@@ -926,6 +961,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();
             }
@@ -933,7 +970,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 calcom.getAvailableSlots(this._publicContext());
             }
         },
@@ -947,6 +988,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):
@@ -977,6 +1021,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);
@@ -986,6 +1033,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);
@@ -1032,6 +1082,8 @@ exports.CalcomApi = __decorate([
             get: // MARK: User
             /**
      * Configured pass-through for {@link getMe}.
+     *
+     * @returns function to retrieve the authenticated user's profile
      */ function get() {
                 return calcom.getMe(this.context);
             }
@@ -1041,6 +1093,8 @@ exports.CalcomApi = __decorate([
             get: // MARK: Schedules
             /**
      * Configured pass-through for {@link getSchedules}.
+     *
+     * @returns function to retrieve all schedules for the authenticated user
      */ function get() {
                 return calcom.getSchedules(this.context);
             }
@@ -1050,6 +1104,8 @@ exports.CalcomApi = __decorate([
             get: // MARK: Bookings
             /**
      * Configured pass-through for {@link createBooking}.
+     *
+     * @returns function to create a new booking
      */ function get() {
                 return calcom.createBooking(this.context);
             }
@@ -1058,6 +1114,8 @@ exports.CalcomApi = __decorate([
             key: "getBooking",
             get: /**
      * Configured pass-through for {@link getBooking}.
+     *
+     * @returns function to retrieve a booking by UID
      */ function get() {
                 return calcom.getBooking(this.context);
             }
@@ -1066,6 +1124,8 @@ exports.CalcomApi = __decorate([
             key: "cancelBooking",
             get: /**
      * Configured pass-through for {@link cancelBooking}.
+     *
+     * @returns function to cancel a booking by UID
      */ function get() {
                 return calcom.cancelBooking(this.context);
             }
@@ -1075,6 +1135,8 @@ exports.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 calcom.getEventTypes(this.context);
             }
@@ -1083,6 +1145,8 @@ exports.CalcomApi = __decorate([
             key: "createEventType",
             get: /**
      * Configured pass-through for {@link createEventType}.
+     *
+     * @returns function to create a new event type
      */ function get() {
                 return calcom.createEventType(this.context);
             }
@@ -1091,6 +1155,8 @@ exports.CalcomApi = __decorate([
             key: "updateEventType",
             get: /**
      * Configured pass-through for {@link updateEventType}.
+     *
+     * @returns function to update an existing event type by ID
      */ function get() {
                 return calcom.updateEventType(this.context);
             }
@@ -1099,6 +1165,8 @@ exports.CalcomApi = __decorate([
             key: "deleteEventType",
             get: /**
      * Configured pass-through for {@link deleteEventType}.
+     *
+     * @returns function to delete an event type by ID
      */ function get() {
                 return calcom.deleteEventType(this.context);
             }
@@ -1108,6 +1176,8 @@ exports.CalcomApi = __decorate([
             get: // MARK: Calendars
             /**
      * Configured pass-through for {@link getCalendars}.
+     *
+     * @returns function to retrieve all connected calendars
      */ function get() {
                 return calcom.getCalendars(this.context);
             }
@@ -1116,6 +1186,8 @@ exports.CalcomApi = __decorate([
             key: "getBusyTimes",
             get: /**
      * Configured pass-through for {@link getBusyTimes}.
+     *
+     * @returns function to retrieve busy time ranges across connected calendars
      */ function get() {
                 return calcom.getBusyTimes(this.context);
             }
@@ -1125,6 +1197,8 @@ exports.CalcomApi = __decorate([
             get: // MARK: Webhooks
             /**
      * Configured pass-through for {@link createWebhook}.
+     *
+     * @returns function to create a webhook subscription
      */ function get() {
                 return calcom.createWebhook(this.context);
             }
@@ -1133,6 +1207,8 @@ exports.CalcomApi = __decorate([
             key: "getWebhooks",
             get: /**
      * Configured pass-through for {@link getWebhooks}.
+     *
+     * @returns function to retrieve all webhooks
      */ function get() {
                 return calcom.getWebhooks(this.context);
             }
@@ -1141,6 +1217,8 @@ exports.CalcomApi = __decorate([
             key: "getWebhook",
             get: /**
      * Configured pass-through for {@link getWebhook}.
+     *
+     * @returns function to retrieve a specific webhook by ID
      */ function get() {
                 return calcom.getWebhook(this.context);
             }
@@ -1149,6 +1227,8 @@ exports.CalcomApi = __decorate([
             key: "updateWebhook",
             get: /**
      * Configured pass-through for {@link updateWebhook}.
+     *
+     * @returns function to update an existing webhook by ID
      */ function get() {
                 return calcom.updateWebhook(this.context);
             }
@@ -1157,6 +1237,8 @@ exports.CalcomApi = __decorate([
             key: "deleteWebhook",
             get: /**
      * Configured pass-through for {@link deleteWebhook}.
+     *
+     * @returns function to delete a webhook by ID
      */ function get() {
                 return calcom.deleteWebhook(this.context);
             }
@@ -1192,7 +1274,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: {}
     };
@@ -1201,6 +1288,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$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -1281,6 +1371,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,
@@ -1293,7 +1386,6 @@ var calcomEventHandlerFactory = util.handlerFactory(function(x) {
 });
 var calcomEventHandlerConfigurerFactory = util.handlerConfigurerFactory({
     configurerForAccessor: function configurerForAccessor(accessor) {
-        // eslint-disable-next-line
         var fnWithKey = util.handlerMappedSetFunctionFactory(accessor, calcomWebhookEvent);
         var configurer = _object_spread_props(_object_spread({}, accessor), {
             handleBookingCreated: fnWithKey(CALCOM_WEBHOOK_BOOKING_CREATED),
@@ -1373,7 +1465,7 @@ var CALCOM_WEBHOOK_SECRET_CONFIG_KEY = 'CALCOM_WEBHOOK_SECRET';
         var event;
         try {
             event = JSON.parse(rawBodyString);
-        } catch (e) {
+        } catch (unused) {
             event = {
                 triggerEvent: '',
                 createdAt: '',
@@ -1870,7 +1962,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)
@@ -1909,6 +2006,9 @@ exports.CalcomWebhookModule = __decorate([
 ], exports.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$1) {
     var dependencyModule = config$1.dependencyModule, imports = config$1.imports, exports$1 = config$1.exports, providers = config$1.providers;
     var dependencyModuleImport = dependencyModule ? [