@dereekb/zoom 13.11.14 → 13.11.15

package/nestjs/index.esm.js

@@ -89,9 +89,9 @@ function _define_property$8(obj, key, value) {
 /**
  * Reads a ZoomOAuthServiceConfig from the NestJS ConfigService using environment variables.
  *
- * @param configService The NestJS ConfigService to read from
- * @param prefix Optional prefix for environment variable names
- * @returns A validated ZoomOAuthServiceConfig
+ * @param configService - The NestJS ConfigService to read from.
+ * @param prefix - Optional prefix for environment variable names.
+ * @returns A validated ZoomOAuthServiceConfig.
  */ function readZoomOAuthServiceConfigFromConfigService(configService, prefix) {
     var prefixString = characterPrefixSuffixInstance({
         suffix: '_',
@@ -426,7 +426,7 @@ function updateZoomCacheCapturingError(cache, accessToken) {
 /**
  * Default error logging function for merged cache service update failures.
  *
- * @param failedUpdates Array of failed cache update results with their errors
+ * @param failedUpdates - Array of failed cache update results with their errors.
  */ function logMergeZoomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates) {
     console.warn("mergeZoomOAuthAccessTokenCacheServices(): failed updating ".concat(failedUpdates.length, " caches."));
     failedUpdates.forEach(function(param, i) {
@@ -446,9 +446,10 @@ function updateZoomCacheCapturingError(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 ZoomOAuthAccessTokenCacheService
+ * @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 ZoomOAuthAccessTokenCacheService.
+ * @throws {Error} When `inputServicesToMerge` is empty.
  */ function mergeZoomOAuthAccessTokenCacheServices(inputServicesToMerge, logError) {
     var allServices = _to_consumable_array$2(inputServicesToMerge);
     var logErrorFunction = typeof logError === 'function' ? logError : logError !== false ? logMergeZoomOAuthAccessTokenCacheServiceErrorFunction : undefined;
@@ -520,9 +521,9 @@ function updateZoomCacheCapturingError(cache, accessToken) {
  *
  * Backed by {@link inMemoryAsyncValueCache} so all consumers share the same single token slot.
  *
- * @param existingToken Optional initial token to seed the cache with
- * @param logAccessToConsole Whether to log token access to console
- * @returns A memory-backed ZoomOAuthAccessTokenCacheService
+ * @param existingToken - Optional initial token to seed the cache with.
+ * @param logAccessToConsole - Whether to log token access to console.
+ * @returns A memory-backed ZoomOAuthAccessTokenCacheService.
  */ function memoryZoomOAuthAccessTokenCacheService(existingToken, logAccessToConsole) {
     var cache = inMemoryAsyncValueCache(existingToken);
     function loadZoomAccessTokenCache() {
@@ -591,22 +592,26 @@ var DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoom-acce
  * 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 ZoomAccessToken, or undefined when the payload is empty/invalid
+ * @param raw - The raw JSON-parsed file payload.
+ * @returns The revived ZoomAccessToken, or undefined when the payload is empty/invalid.
  */ function reviveZoomAccessTokenFile(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$3({}, 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$3({}, token), {
-        expiresAt: expiresAt
-    });
+    return result;
 }
 /**
  * Creates a ZoomOAuthAccessTokenCacheService that reads and writes the access token to the file system.
@@ -616,9 +621,9 @@ var DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoom-acce
  *
  * Useful for testing.
  *
- * @param filename Path to the token cache file
- * @param useMemoryCache Whether to also cache tokens in memory for faster access
- * @returns A file-system-backed ZoomOAuthAccessTokenCacheService
+ * @param filename - Path to the token cache file.
+ * @param useMemoryCache - Whether to also cache tokens in memory for faster access.
+ * @returns A file-system-backed ZoomOAuthAccessTokenCacheService.
  */ function fileZoomOAuthAccessTokenCacheService() {
     var filename = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH, useMemoryCache = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : true;
     var innerCacheInput = {
@@ -677,7 +682,7 @@ var DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoom-acce
     }
     function readTokenFile() {
         return _async_to_generator$2(function() {
-            var raw, token;
+            var raw, result, token;
             return _ts_generator$2(this, function(_state) {
                 switch(_state.label){
                     case 0:
@@ -688,17 +693,16 @@ var DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoom-acce
                     case 1:
                         raw = _state.sent();
                         if (raw == null) {
-                            return [
-                                2,
-                                undefined
-                            ];
+                            result = undefined;
+                        } else {
+                            token = reviveZoomAccessTokenFile(raw);
+                            result = {
+                                token: token
+                            };
                         }
-                        token = reviveZoomAccessTokenFile(raw);
                         return [
                             2,
-                            {
-                                token: token
-                            }
+                            result
                         ];
                 }
             });
@@ -886,16 +890,16 @@ function _unsupported_iterable_to_array$1(o, minLen) {
 /**
  * Default factory function for creating ZoomOAuthServiceConfig from ConfigService.
  *
- * @param configService The NestJS ConfigService
- * @returns A validated ZoomOAuthServiceConfig
+ * @param configService - The NestJS ConfigService.
+ * @returns A validated ZoomOAuthServiceConfig.
  */ function zoomOAuthServiceConfigFactory(configService) {
     return readZoomOAuthServiceConfigFromConfigService(configService);
 }
 /**
  * Convenience function used to generate ModuleMetadata for an app's ZoomOAuthModule.
  *
- * @param config The configuration for the module metadata
- * @returns Module metadata for the Zoom OAuth module
+ * @param config - The configuration for the module metadata.
+ * @returns Module metadata for the Zoom OAuth module.
  */ function appZoomOAuthModuleMetadata(config) {
     var _config_zoomOAuthServiceConfigFactory;
     var dependencyModule = config.dependencyModule, imports = config.imports, exports = config.exports, providers = config.providers;
@@ -1071,10 +1075,10 @@ var zoomEventHandlerConfigurerFactory = handlerConfigurerFactory({
 /**
  * Verifies a Zoom webhook event header.
  *
- * @see https://developers.zoom.us/docs/api/webhooks/#verify-with-zooms-header
+ * @param zoomSecretToken - The Zoom secret token.
+ * @returns Verifies a Zoom webhook event.
  *
- * @param zoomSecretToken The Zoom secret token.
- * @returns A function that verifies a Zoom webhook event.
+ * @see https://developers.zoom.us/docs/api/webhooks/#verify-with-zooms-header
  */ function zoomWebhookEventVerifier(zoomSecretToken) {
     return function(request, _rawBody) {
         var requestBodyString = String(request.body);
@@ -1095,7 +1099,7 @@ var ZOOM_WEBHOOK_URL_VALIDATION_EVENT_TYPE = 'endpoint.url_validation';
 /**
  * Creates a ZoomWebhookEventValidationFunction.
  *
- * @param zoomSecretToken The secret token used to validate the event.
+ * @param zoomSecretToken - The secret token used to validate the event.
  * @returns A ZoomWebhookEventValidationFunction.
  */ function zoomWebhookEventValidationFunction(zoomSecretToken) {
     return function(event) {
@@ -1589,8 +1593,8 @@ function _class_call_check$2(instance, Constructor) {
 /**
  * Factory function that creates ZoomWebhookServiceConfig from NestJS ConfigService.
  *
- * @param configService The NestJS ConfigService
- * @returns A validated ZoomWebhookServiceConfig
+ * @param configService - The NestJS ConfigService.
+ * @returns A validated ZoomWebhookServiceConfig.
  */ function zoomWebhookServiceConfigFactory(configService) {
     var config = {
         webhookConfig: {
@@ -1881,8 +1885,8 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Default factory function for creating ZoomServiceConfig from ConfigService.
  *
- * @param _configService The NestJS ConfigService (unused currently)
- * @returns A validated ZoomServiceConfig
+ * @param _configService - The NestJS ConfigService (unused currently)
+ * @returns A validated ZoomServiceConfig.
  */ function zoomServiceConfigFactory(_configService) {
     var config = {
         zoom: {}
@@ -1893,8 +1897,8 @@ function _unsupported_iterable_to_array(o, minLen) {
 /**
  * Convenience function used to generate ModuleMetadata for an app's ZoomModule.
  *
- * @param config The configuration for the module metadata
- * @returns Module metadata for the Zoom module
+ * @param config - The configuration for the module metadata.
+ * @returns Module metadata for the Zoom module.
  */ function appZoomModuleMetadata(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/zoom/nestjs",
-  "version": "13.11.14",
+  "version": "13.11.15",
   "peerDependencies": {
-    "@dereekb/nestjs": "13.11.14",
-    "@dereekb/rxjs": "13.11.14",
-    "@dereekb/util": "13.11.14",
-    "@dereekb/zoom": "13.11.14",
+    "@dereekb/nestjs": "13.11.15",
+    "@dereekb/rxjs": "13.11.15",
+    "@dereekb/util": "13.11.15",
+    "@dereekb/zoom": "13.11.15",
     "@nestjs/common": "^11.1.19",
     "@nestjs/config": "^4.0.4",
     "express": "^5.2.1"

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

@@ -14,8 +14,8 @@ export declare abstract class ZoomOAuthServiceConfig {
 /**
  * Reads a ZoomOAuthServiceConfig from the NestJS ConfigService using environment variables.
  *
- * @param configService The NestJS ConfigService to read from
- * @param prefix Optional prefix for environment variable names
- * @returns A validated ZoomOAuthServiceConfig
+ * @param configService - The NestJS ConfigService to read from.
+ * @param prefix - Optional prefix for environment variable names.
+ * @returns A validated ZoomOAuthServiceConfig.
  */
 export declare function readZoomOAuthServiceConfigFromConfigService(configService: ConfigService, prefix?: string): ZoomOAuthServiceConfig;

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

@@ -6,8 +6,8 @@ export type ZoomOAuthServiceConfigFactory = (configService: ConfigService) => Zo
 /**
  * Default factory function for creating ZoomOAuthServiceConfig from ConfigService.
  *
- * @param configService The NestJS ConfigService
- * @returns A validated ZoomOAuthServiceConfig
+ * @param configService - The NestJS ConfigService.
+ * @returns A validated ZoomOAuthServiceConfig.
  */
 export declare function zoomOAuthServiceConfigFactory(configService: ConfigService): ZoomOAuthServiceConfig;
 export interface ProvideAppZoomOAuthMetadataConfig extends Pick<ModuleMetadata, 'imports' | 'exports' | 'providers'> {
@@ -28,7 +28,7 @@ export interface ProvideAppZoomOAuthMetadataConfig extends Pick<ModuleMetadata,
 /**
  * Convenience function used to generate ModuleMetadata for an app's ZoomOAuthModule.
  *
- * @param config The configuration for the module metadata
- * @returns Module metadata for the Zoom OAuth module
+ * @param config - The configuration for the module metadata.
+ * @returns Module metadata for the Zoom OAuth module.
  */
 export declare function appZoomOAuthModuleMetadata(config: ProvideAppZoomOAuthMetadataConfig): ModuleMetadata;

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

@@ -22,7 +22,7 @@ export type LogMergeZoomOAuthAccessTokenCacheServiceErrorFunction = (failedUpdat
 /**
  * Default error logging function for merged cache service update failures.
  *
- * @param failedUpdates Array of failed cache update results with their errors
+ * @param failedUpdates - Array of failed cache update results with their errors.
  */
 export declare function logMergeZoomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates: (readonly [ZoomAccessTokenCache, unknown])[]): void;
 /**
@@ -37,9 +37,10 @@ export declare function logMergeZoomOAuthAccessTokenCacheServiceErrorFunction(fa
  * 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 ZoomOAuthAccessTokenCacheService
+ * @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 ZoomOAuthAccessTokenCacheService.
+ * @throws {Error} When `inputServicesToMerge` is empty.
  */
 export declare function mergeZoomOAuthAccessTokenCacheServices(inputServicesToMerge: ZoomOAuthAccessTokenCacheService[], logError?: Maybe<boolean | LogMergeZoomOAuthAccessTokenCacheServiceErrorFunction>): ZoomOAuthAccessTokenCacheService;
 /**
@@ -47,9 +48,9 @@ export declare function mergeZoomOAuthAccessTokenCacheServices(inputServicesToMe
  *
  * Backed by {@link inMemoryAsyncValueCache} so all consumers share the same single token slot.
  *
- * @param existingToken Optional initial token to seed the cache with
- * @param logAccessToConsole Whether to log token access to console
- * @returns A memory-backed ZoomOAuthAccessTokenCacheService
+ * @param existingToken - Optional initial token to seed the cache with.
+ * @param logAccessToConsole - Whether to log token access to console.
+ * @returns A memory-backed ZoomOAuthAccessTokenCacheService.
  */
 export declare function memoryZoomOAuthAccessTokenCacheService(existingToken?: Maybe<ZoomAccessToken>, logAccessToConsole?: boolean): ZoomOAuthAccessTokenCacheService;
 export interface FileSystemZoomOAuthAccessTokenCacheService extends ZoomOAuthAccessTokenCacheService {
@@ -69,8 +70,8 @@ export type ZoomOAuthAccessTokenCacheFileContent = {
  *
  * Useful for testing.
  *
- * @param filename Path to the token cache file
- * @param useMemoryCache Whether to also cache tokens in memory for faster access
- * @returns A file-system-backed ZoomOAuthAccessTokenCacheService
+ * @param filename - Path to the token cache file.
+ * @param useMemoryCache - Whether to also cache tokens in memory for faster access.
+ * @returns A file-system-backed ZoomOAuthAccessTokenCacheService.
  */
 export declare function fileZoomOAuthAccessTokenCacheService(filename?: string, useMemoryCache?: boolean): FileSystemZoomOAuthAccessTokenCacheService;

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

@@ -3,8 +3,8 @@ import { ZoomWebhookServiceConfig } from './webhook.zoom.config';
 /**
  * Factory function that creates ZoomWebhookServiceConfig from NestJS ConfigService.
  *
- * @param configService The NestJS ConfigService
- * @returns A validated ZoomWebhookServiceConfig
+ * @param configService - The NestJS ConfigService.
+ * @returns A validated ZoomWebhookServiceConfig.
  */
 export declare function zoomWebhookServiceConfigFactory(configService: ConfigService): ZoomWebhookServiceConfig;
 /**

package/nestjs/src/lib/webhook/webhook.zoom.validate.d.ts

@@ -11,7 +11,7 @@ export type ZoomWebhookEventValidationFunction = (event: ZoomWebhookUrlValidatio
 /**
  * Creates a ZoomWebhookEventValidationFunction.
  *
- * @param zoomSecretToken The secret token used to validate the event.
+ * @param zoomSecretToken - The secret token used to validate the event.
  * @returns A ZoomWebhookEventValidationFunction.
  */
 export declare function zoomWebhookEventValidationFunction(zoomSecretToken: ZoomSecretToken): ZoomWebhookEventValidationFunction;

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

@@ -12,9 +12,9 @@ export type ZoomWebhookEventVerifier = (req: Request, _rawBody: Buffer) => ZoomW
 /**
  * Verifies a Zoom webhook event header.
  *
- * @see https://developers.zoom.us/docs/api/webhooks/#verify-with-zooms-header
+ * @param zoomSecretToken - The Zoom secret token.
+ * @returns Verifies a Zoom webhook event.
  *
- * @param zoomSecretToken The Zoom secret token.
- * @returns A function that verifies a Zoom webhook event.
+ * @see https://developers.zoom.us/docs/api/webhooks/#verify-with-zooms-header
  */
 export declare function zoomWebhookEventVerifier(zoomSecretToken: ZoomSecretToken): ZoomWebhookEventVerifier;

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

@@ -5,8 +5,8 @@ import { type Maybe } from '@dereekb/util';
 /**
  * Default factory function for creating ZoomServiceConfig from ConfigService.
  *
- * @param _configService The NestJS ConfigService (unused currently)
- * @returns A validated ZoomServiceConfig
+ * @param _configService - The NestJS ConfigService (unused currently)
+ * @returns A validated ZoomServiceConfig.
  */
 export declare function zoomServiceConfigFactory(_configService: ConfigService): ZoomServiceConfig;
 export interface ProvideAppZoomMetadataConfig extends Pick<ModuleMetadata, 'imports' | 'exports' | 'providers'> {
@@ -21,7 +21,7 @@ export interface ProvideAppZoomMetadataConfig extends Pick<ModuleMetadata, 'impo
 /**
  * Convenience function used to generate ModuleMetadata for an app's ZoomModule.
  *
- * @param config The configuration for the module metadata
- * @returns Module metadata for the Zoom module
+ * @param config - The configuration for the module metadata.
+ * @returns Module metadata for the Zoom module.
  */
 export declare function appZoomModuleMetadata(config: ProvideAppZoomMetadataConfig): ModuleMetadata;

package/package.json

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

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

@@ -38,15 +38,15 @@ export declare function userAccessToken(context: ZoomOAuthContext): (input: Zoom
 /**
  * Builds a FetchJsonInput for Zoom OAuth API calls with Basic auth.
  *
- * @param context The Zoom OAuth context
- * @param input Optional override for client credentials
- * @returns A configured FetchJsonInput for the OAuth API call
+ * @param context - The Zoom OAuth context.
+ * @param input - Optional override for client credentials.
+ * @returns A configured FetchJsonInput for the OAuth API call.
  */
 export declare function zoomOAuthApiFetchJsonInput(context: ZoomOAuthContext, input?: Maybe<ZoomOAuthServerAccessTokenInput>): FetchJsonInput;
 /**
  * Generates a Basic Authorization header value for Zoom OAuth.
  *
- * @param input The client ID and secret pair
- * @returns The Base64-encoded Basic auth header value
+ * @param input - The client ID and secret pair.
+ * @returns The Base64-encoded Basic auth header value.
  */
 export declare function zoomOAuthServerBasicAuthorizationHeaderValue(input: ZoomAuthClientIdAndSecretPair): string;

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

@@ -68,8 +68,9 @@ export type ZoomAccessTokenStringFactory = () => Promise<ZoomAccessTokenString>;
 /**
  * Generates a new ZoomAccessTokenStringFactory from a ZoomAccessTokenFactory.
  *
- * @param zoomAccessTokenFactory The factory to extract the token string from
- * @returns A factory that returns the access token string
+ * @param zoomAccessTokenFactory - The factory to extract the token string from.
+ * @returns A factory that returns the access token string.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zoomAccessTokenStringFactory(zoomAccessTokenFactory: ZoomAccessTokenFactory): ZoomAccessTokenStringFactory;

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

@@ -28,16 +28,16 @@ export declare const logZoomOAuthErrorToConsole: import("..").LogZoomServerError
 /**
  * Parses a FetchResponseError into a typed Zoom OAuth error.
  *
- * @param responseError The fetch response error to parse
- * @returns The parsed error, or undefined if parsing fails
+ * @param responseError - The fetch response error to parse.
+ * @returns The parsed error, or undefined if parsing fails.
  */
 export declare function parseZoomOAuthError(responseError: FetchResponseError): Promise<ParsedZoomServerError>;
 /**
  * Parses a ZoomServerErrorData into a Zoom OAuth-specific error.
  *
- * @param zoomServerError The raw error data from the Zoom API
- * @param responseError The original fetch response error
- * @returns A parsed error, or undefined if the error is unrecognized
+ * @param zoomServerError - The raw error data from the Zoom API.
+ * @param responseError - The original fetch response error.
+ * @returns A parsed error, or undefined if the error is unrecognized.
  */
 export declare function parseZoomOAuthServerErrorResponseData(zoomServerError: ZoomServerErrorData, responseError: FetchResponseError): FetchRequestFactoryError | import("..").ZoomServerError<ZoomServerErrorData<unknown>> | undefined;
 export declare const handleZoomOAuthErrorFetch: import("..").HandleZoomErrorFetchFactory;

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

@@ -17,8 +17,9 @@ export type ZoomOAuthFactory = (config: ZoomOAuthConfig) => ZoomOAuth;
 /**
  * Creates a ZoomOAuth instance factory from the given configuration.
  *
- * @param factoryConfig Configuration for the OAuth factory
- * @returns A factory that creates configured ZoomOAuth instances
+ * @param factoryConfig - Configuration for the OAuth factory.
+ * @returns A factory that creates configured ZoomOAuth instances.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zoomOAuthFactory(factoryConfig: ZoomOAuthFactoryConfig): ZoomOAuthFactory;
@@ -33,10 +34,11 @@ export interface ZoomOAuthZoomAccessTokenFactoryConfig {
     readonly accessTokenCache?: Maybe<ZoomAccessTokenCache>;
 }
 /**
- * Creates a ZoomOAuthZoomAccessTokenFactoryConfig
+ * Creates a ZoomOAuthZoomAccessTokenFactoryConfig.
  *
  * @param config
  * @returns
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function zoomOAuthZoomAccessTokenFactory(config: ZoomOAuthZoomAccessTokenFactoryConfig): ZoomAccessTokenFactory;

package/src/lib/zoom/zoom.api.meeting.d.ts

@@ -11,10 +11,10 @@ export interface GetMeetingInput {
 export type GetMeetingResponse = ZoomMeeting;
 export type GetMeetingFunction = (input: GetMeetingInput) => Promise<GetMeetingResponse>;
 /**
- * https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/meeting
+ * Https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/meeting.
  *
- * @param context The Zoom API context
- * @returns A function that retrieves a meeting by ID
+ * @param context - The Zoom API context.
+ * @returns Retrieves a meeting by ID.
  */
 export declare function getMeeting(context: ZoomContext): GetMeetingFunction;
 export interface ListMeetingsForUserInput extends ZoomPageFilter {
@@ -23,18 +23,19 @@ export interface ListMeetingsForUserInput extends ZoomPageFilter {
 export type ListMeetingsForUserResponse = ZoomPageResult<ZoomMeeting>;
 export type ListMeetingsForUserFunction = (input: ListMeetingsForUserInput) => Promise<ListMeetingsForUserResponse>;
 /**
- * https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/meetings
+ * Https://developers.zoom.us/docs/api/rest/reference/zoom-api/methods/#operation/meetings.
  *
- * @param context The Zoom API context
- * @returns A function that lists meetings for a user
+ * @param context - The Zoom API context.
+ * @returns Lists meetings for a user.
  */
 export declare function listMeetingsForUser(context: ZoomContext): ListMeetingsForUserFunction;
 export type ListMeetingsForUserPageFactory = FetchPageFactory<ListMeetingsForUserInput, ListMeetingsForUserResponse>;
 /**
  * Creates a page factory for listing meetings for a user.
  *
- * @param context The Zoom API context
- * @returns A page factory for paginated meeting listing
+ * @param context - The Zoom API context.
+ * @returns A page factory for paginated meeting listing.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function listMeetingsForUserPageFactory(context: ZoomContext): ListMeetingsForUserPageFactory;
@@ -132,10 +133,11 @@ export interface CreateMeetingForUserInput {
 }
 export type CreateMeetingForUserResponse = ZoomMeeting;
 /**
- * https://developers.zoom.us/docs/api/meetings/#tag/meetings/POST/users/{userId}/meetings
+ * Https://developers.zoom.us/docs/api/meetings/#tag/meetings/POST/users/{userId}/meetings.
+ *
+ * @param context - The Zoom API context.
+ * @returns Creates a meeting for a user.
  *
- * @param context The Zoom API context
- * @returns A function that creates a meeting for a user
  * @__NO_SIDE_EFFECTS__
  */
 export declare function createMeetingForUser(context: ZoomContext): (input: CreateMeetingForUserInput) => Promise<CreateMeetingForUserResponse>;
@@ -157,10 +159,10 @@ export interface UpdateMeetingInput {
 export type UpdateMeetingResponse = unknown;
 export type UpdateMeetingFunction = (input: UpdateMeetingInput) => Promise<UpdateMeetingResponse>;
 /**
- * https://developers.zoom.us/docs/api/meetings/#tag/meetings/PUT/meetings/{meetingId}
+ * Https://developers.zoom.us/docs/api/meetings/#tag/meetings/PUT/meetings/{meetingId}
  *
- * @param context The Zoom API context
- * @returns A function that updates a meeting
+ * @param context - The Zoom API context.
+ * @returns Updates a meeting.
  */
 export declare function updateMeeting(context: ZoomContext): UpdateMeetingFunction;
 export interface DeleteMeetingInput extends SilenceZoomErrorConfig {
@@ -186,10 +188,10 @@ export type DeleteMeetingResponse = unknown;
 export type DeleteMeetingFunction = (input: DeleteMeetingInput) => Promise<DeleteMeetingResponse>;
 export declare const DELETE_MEETING_DOES_NOT_EXIST_ERROR_CODE = 3001;
 /**
- * https://developers.zoom.us/docs/api/meetings/#tag/meetings/DELETE/meetings/{meetingId}
+ * Https://developers.zoom.us/docs/api/meetings/#tag/meetings/DELETE/meetings/{meetingId}
  *
- * @param context The Zoom API context
- * @returns A function that deletes a meeting (silences 3001 "not found" errors by default)
+ * @param context - The Zoom API context.
+ * @returns Deletes a meeting (silences 3001 "not found" errors by default)
  */
 export declare function deleteMeeting(context: ZoomContext): DeleteMeetingFunction;
 export interface GetPastMeetingInput {
@@ -198,10 +200,10 @@ export interface GetPastMeetingInput {
 export type GetPastMeetingResponse = PastZoomMeeting;
 export type GetPastMeetingFunction = (input: GetPastMeetingInput) => Promise<GetPastMeetingResponse>;
 /**
- * https://developers.zoom.us/docs/api/meetings/#tag/meetings/GET/past_meetings/{meetingId}
+ * Https://developers.zoom.us/docs/api/meetings/#tag/meetings/GET/past_meetings/{meetingId}
  *
- * @param context The Zoom API context
- * @returns A function that retrieves a past meeting
+ * @param context - The Zoom API context.
+ * @returns Retrieves a past meeting.
  */
 export declare function getPastMeeting(context: ZoomContext): GetPastMeetingFunction;
 export interface GetPastMeetingParticipantsInput extends ZoomPageFilter {
@@ -210,18 +212,19 @@ export interface GetPastMeetingParticipantsInput extends ZoomPageFilter {
 export type GetPastMeetingParticipantsResponse = ZoomPageResult<PastZoomMeeting>;
 export type GetPastMeetingParticipantsFunction = (input: GetPastMeetingParticipantsInput) => Promise<GetPastMeetingParticipantsResponse>;
 /**
- * https://developers.zoom.us/docs/api/meetings/#tag/meetings/GET/past_meetings/{meetingId}/participants
+ * Https://developers.zoom.us/docs/api/meetings/#tag/meetings/GET/past_meetings/{meetingId}/participants.
  *
- * @param context The Zoom API context
- * @returns A function that retrieves participants from a past meeting
+ * @param context - The Zoom API context.
+ * @returns Retrieves participants from a past meeting.
  */
 export declare function getPastMeetingParticipants(context: ZoomContext): GetPastMeetingParticipantsFunction;
 export type GetPastMeetingParticipantsPageFactory = FetchPageFactory<GetPastMeetingParticipantsInput, GetPastMeetingParticipantsResponse>;
 /**
  * Creates a page factory for listing past meeting participants.
  *
- * @param context The Zoom API context
- * @returns A page factory for paginated participant listing
+ * @param context - The Zoom API context.
+ * @returns A page factory for paginated participant listing.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function getPastMeetingParticipantsPageFactory(context: ZoomContext): GetPastMeetingParticipantsPageFactory;

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

@@ -9,7 +9,7 @@ export interface GetUserInput {
 export type GetUserResponse = ZoomUser;
 export type GetUserFunction = (input: GetUserInput) => Promise<GetUserResponse>;
 /**
- * https://developers.zoom.us/docs/api/users/#tag/users/GET/users/{userId}
+ * Https://developers.zoom.us/docs/api/users/#tag/users/GET/users/{userId}
  *
  * @param context
  * @returns
@@ -22,7 +22,7 @@ export interface ListUsersInput extends ZoomPageFilter {
 export type ListUsersResponse = ZoomPageResult<ZoomUser>;
 export type ListUsersFunction = (input?: ListUsersInput) => Promise<ListUsersResponse>;
 /**
- * https://developers.zoom.us/docs/api/users/#tag/users/GET/users
+ * Https://developers.zoom.us/docs/api/users/#tag/users/GET/users.
  *
  * @param context
  * @returns
@@ -32,8 +32,9 @@ export type ListUsersPageFactory = FetchPageFactory<ListUsersInput, ListUsersRes
 /**
  * Creates a page factory for listing users.
  *
- * @param context The Zoom API context
- * @returns A page factory for paginated user listing
+ * @param context - The Zoom API context.
+ * @returns A page factory for paginated user listing.
+ *
  * @__NO_SIDE_EFFECTS__
  */
 export declare function listUsersPageFactory(context: ZoomContext): ListUsersPageFactory;

package/src/lib/zoom/zoom.api.user.type.d.ts

@@ -1,4 +1,4 @@
-import { type EmailAddress, type ISO8601DateStringUTCFull, type TimezoneString, type WebsiteUrl } from '@dereekb/util';
+import { type EmailAddress, type ISO8601DateStringUTCFull, type SuggestedString, type TimezoneString, type WebsiteUrl } from '@dereekb/util';
 import { type ZoomClientVersion, type ZoomUserId } from '../zoom.type';
 /**
  * Represents a Zoom user, as returned by the Zoom API.
@@ -239,7 +239,7 @@ export interface ZoomUserPhoneNumber {
      *
      * @example "Mobile"
      */
-    readonly label: 'Mobile' | 'Office' | 'Home' | 'Fax' | (string & {});
+    readonly label: SuggestedString<'Mobile' | 'Office' | 'Home' | 'Fax'>;
     /**
      * The user's phone number.
      *