@dereekb/calcom 13.11.13 → 13.11.15

package/nestjs/index.cjs.js

@@ -93,8 +93,8 @@ var CALCOM_API_KEY_CONFIG_KEY = 'CALCOM_API_KEY';
 /**
  * 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.
  */ function calcomOAuthServiceConfigFactory(configService) {
     var clientId = configService.get(CALCOM_CLIENT_ID_CONFIG_KEY);
     var clientSecret = configService.get(CALCOM_CLIENT_SECRET_CONFIG_KEY);
@@ -379,8 +379,8 @@ exports.CalcomOAuthAccessTokenCacheService = __decorate([
  *
  * 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.
  */ function calcomRefreshTokenCacheKey(refreshToken) {
     return node_crypto.createHash('sha256').update(refreshToken).digest('hex').substring(0, 16);
 }
@@ -438,7 +438,7 @@ function updateCalcomCacheCapturingError(cache, accessToken) {
  * 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.
  */ function logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates) {
     console.warn("mergeCalcomOAuthAccessTokenCacheServices(): failed updating ".concat(failedUpdates.length, " caches."));
     failedUpdates.forEach(function(param, i) {
@@ -457,9 +457,10 @@ function updateCalcomCacheCapturingError(cache, accessToken) {
  * 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.
  */ function mergeCalcomOAuthAccessTokenCacheServices(inputServicesToMerge, logError) {
     var allServices = _to_consumable_array$3(inputServicesToMerge);
     var logErrorFunction = typeof logError === 'function' ? logError : logError !== false ? logMergeCalcomOAuthAccessTokenCacheServiceErrorFunction : undefined;
@@ -528,9 +529,9 @@ function updateCalcomCacheCapturingError(cache, accessToken) {
 /**
  * Adapts an {@link AsyncValueCache} to a {@link CalcomAccessTokenCache}, optionally logging cache reads/writes to the console.
  *
- * @param cache - underlying single-value cache for the access token
- * @param logAccessToConsole - when true, logs reads and writes to the console
- * @returns the CalcomAccessTokenCache backed by the given async cache
+ * @param cache - Underlying single-value cache for the access token.
+ * @param logAccessToConsole - When true, logs reads and writes to the console.
+ * @returns The CalcomAccessTokenCache backed by the given async cache.
  */ function calcomAccessTokenCacheFromAsyncValueCache(cache, logAccessToConsole) {
     return {
         loadCachedToken: function loadCachedToken() {
@@ -591,9 +592,9 @@ function updateCalcomCacheCapturingError(cache, accessToken) {
  * 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.
  */ function memoryCalcomOAuthAccessTokenCacheService(existingToken, logAccessToConsole) {
     var serverCache = util.inMemoryAsyncValueCache(existingToken);
     var userCache = util.inMemoryAsyncKeyedValueCache();
@@ -627,22 +628,26 @@ var CALCOM_SERVER_TOKEN_FILE_KEY = 'server';
  * Reviver applied to the cached file payload on load so `expiresAt` is always a `Date`
  * regardless of how it was serialized.
  *
- * @param raw - the raw JSON-parsed file payload
- * @returns the revived CalcomAccessToken, or undefined when the payload is empty/invalid
+ * @param raw - The raw JSON-parsed file payload.
+ * @returns The revived CalcomAccessToken, or undefined when the payload is empty/invalid.
  */ function reviveCalcomAccessTokenFile(raw) {
+    var result;
     if (raw == null || (typeof raw === "undefined" ? "undefined" : _type_of(raw)) !== 'object') {
-        return undefined;
-    }
-    var wrapper = raw;
-    var token = wrapper.token;
-    if (token == null) {
-        return undefined;
+        result = undefined;
+    } else {
+        var wrapper = raw;
+        var token = wrapper.token;
+        if (token == null) {
+            result = undefined;
+        } else {
+            var rawExpiresAt = token.expiresAt;
+            var expiresAt = rawExpiresAt != null && !_instanceof(rawExpiresAt, Date) ? new Date(rawExpiresAt) : rawExpiresAt;
+            result = _object_spread_props$2(_object_spread$2({}, token), {
+                expiresAt: expiresAt
+            });
+        }
     }
-    var rawExpiresAt = token.expiresAt;
-    var expiresAt = rawExpiresAt != null && !_instanceof(rawExpiresAt, Date) ? new Date(rawExpiresAt) : rawExpiresAt;
-    return _object_spread_props$2(_object_spread$2({}, token), {
-        expiresAt: expiresAt
-    });
+    return result;
 }
 /**
  * Creates a CalcomOAuthAccessTokenCacheService that reads and writes access tokens
@@ -658,8 +663,8 @@ var CALCOM_SERVER_TOKEN_FILE_KEY = 'server';
  *   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.
  */ function fileCalcomOAuthAccessTokenCacheService() {
     var cacheDir = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : DEFAULT_FILE_CALCOM_ACCESS_TOKEN_CACHE_DIR;
     var cachesByKey = new Map();
@@ -795,7 +800,7 @@ exports.CalcomOAuthApi = /*#__PURE__*/ function() {
             /**
      * Configured pass-through for {@link exchangeAuthorizationCode}.
      *
-     * @returns function to exchange an OAuth authorization code for tokens
+     * @returns Function to exchange an OAuth authorization code for tokens.
      */ function get() {
                 return calcom.exchangeAuthorizationCode(this.oauthContext);
             }
@@ -804,10 +809,10 @@ exports.CalcomOAuthApi = /*#__PURE__*/ function() {
             /**
      * 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
+     * @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 Promise resolving to the user's CalcomAccessToken.
      */ key: "userAccessToken",
             value: function userAccessToken(input) {
                 var factory = this.oauthContext.makeUserAccessTokenFactory(input);
@@ -819,8 +824,8 @@ 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
+     * @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;
@@ -864,8 +869,8 @@ 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
+ * @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;
@@ -1059,7 +1064,7 @@ function _object_spread_props$1(target, source) {
      * Returns the cached {@link CalcomApiContextInstance} for the server context.
      * All API functions are available through this instance.
      *
-     * @returns the server context instance
+     * @returns The server context instance.
      */ function get() {
                 return this._serverInstance();
             }
@@ -1070,7 +1075,7 @@ function _object_spread_props$1(target, source) {
             /**
      * Configured pass-through for {@link getAvailableSlots} using the public (unauthenticated) context.
      *
-     * @returns function to query available slots without authentication
+     * @returns Function to query available slots without authentication.
      */ function get() {
                 return calcom.getAvailableSlots(this._publicContext());
             }
@@ -1085,8 +1090,8 @@ 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
+     * @param input - The user context factory input containing the refresh token and optional cache.
+     * @returns A new CalcomApiContextInstance scoped to the user.
      *
      * @example
      * ```ts
@@ -1119,8 +1124,8 @@ 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
+     * @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);
@@ -1131,8 +1136,8 @@ 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
+     * @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);
@@ -1180,7 +1185,7 @@ exports.CalcomApi = __decorate([
             /**
      * Configured pass-through for {@link getMe}.
      *
-     * @returns function to retrieve the authenticated user's profile
+     * @returns Function to retrieve the authenticated user's profile.
      */ function get() {
                 return calcom.getMe(this.context);
             }
@@ -1191,7 +1196,7 @@ exports.CalcomApi = __decorate([
             /**
      * Configured pass-through for {@link getSchedules}.
      *
-     * @returns function to retrieve all schedules for the authenticated user
+     * @returns Function to retrieve all schedules for the authenticated user.
      */ function get() {
                 return calcom.getSchedules(this.context);
             }
@@ -1202,7 +1207,7 @@ exports.CalcomApi = __decorate([
             /**
      * Configured pass-through for {@link createBooking}.
      *
-     * @returns function to create a new booking
+     * @returns Function to create a new booking.
      */ function get() {
                 return calcom.createBooking(this.context);
             }
@@ -1212,7 +1217,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link getBooking}.
      *
-     * @returns function to retrieve a booking by UID
+     * @returns Function to retrieve a booking by UID.
      */ function get() {
                 return calcom.getBooking(this.context);
             }
@@ -1222,7 +1227,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link cancelBooking}.
      *
-     * @returns function to cancel a booking by UID
+     * @returns Function to cancel a booking by UID.
      */ function get() {
                 return calcom.cancelBooking(this.context);
             }
@@ -1233,7 +1238,7 @@ exports.CalcomApi = __decorate([
             /**
      * Configured pass-through for {@link getEventTypes}.
      *
-     * @returns function to retrieve all event types for the authenticated user
+     * @returns Function to retrieve all event types for the authenticated user.
      */ function get() {
                 return calcom.getEventTypes(this.context);
             }
@@ -1243,7 +1248,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link createEventType}.
      *
-     * @returns function to create a new event type
+     * @returns Function to create a new event type.
      */ function get() {
                 return calcom.createEventType(this.context);
             }
@@ -1253,7 +1258,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link updateEventType}.
      *
-     * @returns function to update an existing event type by ID
+     * @returns Function to update an existing event type by ID.
      */ function get() {
                 return calcom.updateEventType(this.context);
             }
@@ -1263,7 +1268,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link deleteEventType}.
      *
-     * @returns function to delete an event type by ID
+     * @returns Function to delete an event type by ID.
      */ function get() {
                 return calcom.deleteEventType(this.context);
             }
@@ -1274,7 +1279,7 @@ exports.CalcomApi = __decorate([
             /**
      * Configured pass-through for {@link getCalendars}.
      *
-     * @returns function to retrieve all connected calendars
+     * @returns Function to retrieve all connected calendars.
      */ function get() {
                 return calcom.getCalendars(this.context);
             }
@@ -1284,7 +1289,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link getBusyTimes}.
      *
-     * @returns function to retrieve busy time ranges across connected calendars
+     * @returns Function to retrieve busy time ranges across connected calendars.
      */ function get() {
                 return calcom.getBusyTimes(this.context);
             }
@@ -1295,7 +1300,7 @@ exports.CalcomApi = __decorate([
             /**
      * Configured pass-through for {@link createWebhook}.
      *
-     * @returns function to create a webhook subscription
+     * @returns Function to create a webhook subscription.
      */ function get() {
                 return calcom.createWebhook(this.context);
             }
@@ -1305,7 +1310,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link getWebhooks}.
      *
-     * @returns function to retrieve all webhooks
+     * @returns Function to retrieve all webhooks.
      */ function get() {
                 return calcom.getWebhooks(this.context);
             }
@@ -1315,7 +1320,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link getWebhook}.
      *
-     * @returns function to retrieve a specific webhook by ID
+     * @returns Function to retrieve a specific webhook by ID.
      */ function get() {
                 return calcom.getWebhook(this.context);
             }
@@ -1325,7 +1330,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link updateWebhook}.
      *
-     * @returns function to update an existing webhook by ID
+     * @returns Function to update an existing webhook by ID.
      */ function get() {
                 return calcom.updateWebhook(this.context);
             }
@@ -1335,7 +1340,7 @@ exports.CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link deleteWebhook}.
      *
-     * @returns function to delete a webhook by ID
+     * @returns Function to delete a webhook by ID.
      */ function get() {
                 return calcom.deleteWebhook(this.context);
             }
@@ -1374,8 +1379,8 @@ function _unsupported_iterable_to_array$1(o, minLen) {
 /**
  * Factory function that creates a {@link CalcomServiceConfig} from NestJS ConfigService values.
  *
- * @param _configService - the NestJS ConfigService instance
- * @returns a validated CalcomServiceConfig
+ * @param _configService - The NestJS ConfigService instance.
+ * @returns A validated CalcomServiceConfig.
  */ function calcomServiceConfigFactory(_configService) {
     var config = {
         calcom: {}
@@ -1386,8 +1391,8 @@ function _unsupported_iterable_to_array$1(o, minLen) {
 /**
  * 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
+ * @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 ? [
@@ -1469,8 +1474,8 @@ 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
+ * @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,
@@ -1550,8 +1555,8 @@ var CALCOM_WEBHOOK_SECRET_CONFIG_KEY = 'CALCOM_WEBHOOK_SECRET';
 /**
  * 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.
  */ function calcomWebhookEventVerifier(secret) {
     return function(rawBody, headers) {
         var _headers_xcalsignature256;
@@ -2062,8 +2067,8 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * 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.
  */ function calcomWebhookServiceConfigFactory(configService) {
     var config = {
         webhookConfig: {
@@ -2104,8 +2109,8 @@ exports.CalcomWebhookModule = __decorate([
 /**
  * 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.
  */ 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 ? [