@dereekb/calcom 13.11.13 → 13.11.15

package/nestjs/index.esm.js

@@ -91,8 +91,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);
@@ -377,8 +377,8 @@ 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 createHash('sha256').update(refreshToken).digest('hex').substring(0, 16);
 }
@@ -436,7 +436,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) {
@@ -455,9 +455,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;
@@ -526,9 +527,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() {
@@ -589,9 +590,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 = inMemoryAsyncValueCache(existingToken);
     var userCache = inMemoryAsyncKeyedValueCache();
@@ -625,22 +626,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
@@ -656,8 +661,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();
@@ -793,7 +798,7 @@ var 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 exchangeAuthorizationCode(this.oauthContext);
             }
@@ -802,10 +807,10 @@ var 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);
@@ -817,8 +822,8 @@ 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
+     * @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;
@@ -862,8 +867,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) {
     var _config_calcomOAuthServiceConfigFactory;
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;
@@ -1057,7 +1062,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();
             }
@@ -1068,7 +1073,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 getAvailableSlots(this._publicContext());
             }
@@ -1083,8 +1088,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
@@ -1117,8 +1122,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);
@@ -1129,8 +1134,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);
@@ -1178,7 +1183,7 @@ 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 getMe(this.context);
             }
@@ -1189,7 +1194,7 @@ 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 getSchedules(this.context);
             }
@@ -1200,7 +1205,7 @@ 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 createBooking(this.context);
             }
@@ -1210,7 +1215,7 @@ 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 getBooking(this.context);
             }
@@ -1220,7 +1225,7 @@ 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 cancelBooking(this.context);
             }
@@ -1231,7 +1236,7 @@ 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 getEventTypes(this.context);
             }
@@ -1241,7 +1246,7 @@ 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 createEventType(this.context);
             }
@@ -1251,7 +1256,7 @@ 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 updateEventType(this.context);
             }
@@ -1261,7 +1266,7 @@ 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 deleteEventType(this.context);
             }
@@ -1272,7 +1277,7 @@ 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 getCalendars(this.context);
             }
@@ -1282,7 +1287,7 @@ 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 getBusyTimes(this.context);
             }
@@ -1293,7 +1298,7 @@ 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 createWebhook(this.context);
             }
@@ -1303,7 +1308,7 @@ CalcomApi = __decorate([
             get: /**
      * Configured pass-through for {@link getWebhooks}.
      *
-     * @returns function to retrieve all webhooks
+     * @returns Function to retrieve all webhooks.
      */ function get() {
                 return getWebhooks(this.context);
             }
@@ -1313,7 +1318,7 @@ 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 getWebhook(this.context);
             }
@@ -1323,7 +1328,7 @@ 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 updateWebhook(this.context);
             }
@@ -1333,7 +1338,7 @@ 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 deleteWebhook(this.context);
             }
@@ -1372,8 +1377,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: {}
@@ -1384,8 +1389,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) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [
@@ -1467,8 +1472,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,
@@ -1548,8 +1553,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;
@@ -2060,8 +2065,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: {
@@ -2102,8 +2107,8 @@ 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) {
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;
     var dependencyModuleImport = dependencyModule ? [

package/nestjs/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@dereekb/calcom/nestjs",
-  "version": "13.11.13",
+  "version": "13.11.15",
   "peerDependencies": {
-    "@dereekb/nestjs": "13.11.13",
-    "@dereekb/rxjs": "13.11.13",
-    "@dereekb/util": "13.11.13",
-    "@dereekb/calcom": "13.11.13",
+    "@dereekb/nestjs": "13.11.15",
+    "@dereekb/rxjs": "13.11.15",
+    "@dereekb/util": "13.11.15",
+    "@dereekb/calcom": "13.11.15",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1"

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

@@ -33,13 +33,13 @@ 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
+     * @returns The server context instance.
      */
     get serverContextInstance(): CalcomApiContextInstance;
     /**
      * 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.
      */
     get getAvailableSlots(): (input: import("@dereekb/calcom").CalcomGetAvailableSlotsInput) => Promise<import("@dereekb/calcom").CalcomGetAvailableSlotsResponse>;
     /**
@@ -50,8 +50,8 @@ 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
+     * @param input - The user context factory input containing the refresh token and optional cache.
+     * @returns A new CalcomApiContextInstance scoped to the user.
      *
      * @example
      * ```ts
@@ -71,16 +71,16 @@ export declare class CalcomApi {
     /**
      * 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.
      */
     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
+     * @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;
 }
@@ -111,97 +111,97 @@ export declare class CalcomApiContextInstance {
     /**
      * Configured pass-through for {@link getMe}.
      *
-     * @returns function to retrieve the authenticated user's profile
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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
+     * @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

@@ -5,8 +5,8 @@ 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
+ * @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'> {
@@ -21,7 +21,7 @@ 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
+ * @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

@@ -11,16 +11,16 @@ export declare class CalcomOAuthApi {
     /**
      * 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.
      */
     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
+     * @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.
      */
     userAccessToken(input: {
         refreshToken: string;
@@ -30,8 +30,8 @@ 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
+     * @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>;
 }