@dereekb/zoom 12.1.0

package/nestjs/src/lib/oauth/oauth.service.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = exports.ZoomOAuthAccessTokenCacheService = void 0;
+exports.logMergeZoomOAuthAccessTokenCacheServiceErrorFunction = logMergeZoomOAuthAccessTokenCacheServiceErrorFunction;
+exports.mergeZoomOAuthAccessTokenCacheServices = mergeZoomOAuthAccessTokenCacheServices;
+exports.memoryZoomOAuthAccessTokenCacheService = memoryZoomOAuthAccessTokenCacheService;
+exports.fileZoomOAuthAccessTokenCacheService = fileZoomOAuthAccessTokenCacheService;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const util_1 = require("@dereekb/util");
+const path_1 = require("path");
+const fs_1 = require("fs");
+/**
+ * Service used for retrieving ZoomAccessTokenCache for Zoom services.
+ */
+let ZoomOAuthAccessTokenCacheService = class ZoomOAuthAccessTokenCacheService {
+};
+exports.ZoomOAuthAccessTokenCacheService = ZoomOAuthAccessTokenCacheService;
+exports.ZoomOAuthAccessTokenCacheService = ZoomOAuthAccessTokenCacheService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], ZoomOAuthAccessTokenCacheService);
+function logMergeZoomOAuthAccessTokenCacheServiceErrorFunction(failedUpdates) {
+    console.warn(`mergeZoomOAuthAccessTokenCacheServices(): failed updating ${failedUpdates.length} caches.`);
+    failedUpdates.forEach(([x, e], i) => {
+        console.warn(`Cache update failure ${i + 1}: - ${e}`);
+    });
+}
+/**
+ * Merges the input services in order to use some as a backup source.
+ *
+ * If once source fails retrieval, the next will be tried.
+ *
+ * When updating a cached token, it will update the token across all services.
+ *
+ * @param servicesToMerge Must include atleast one service. Empty arrays will throw an error.
+ */
+function mergeZoomOAuthAccessTokenCacheServices(inputServicesToMerge, logError) {
+    const allServices = [...inputServicesToMerge];
+    const logErrorFunction = typeof logError === 'function' ? logError : logError !== false ? logMergeZoomOAuthAccessTokenCacheServiceErrorFunction : undefined;
+    if (allServices.length === 0) {
+        throw new Error('mergeZoomOAuthAccessTokenCacheServices() input cannot be empty.');
+    }
+    const loadZoomAccessTokenCache = (accessCachesForServices) => {
+        const loadCachedTokenFromFirstService = (0, util_1.tryWithPromiseFactoriesFunction)({
+            promiseFactories: accessCachesForServices.map((x) => () => x
+                .loadCachedToken()
+                .catch(() => null)
+                .then((x) => {
+                let result = undefined;
+                if (x && !(0, util_1.isPast)(x.expiresAt)) {
+                    result = x; // only return from cache if it is not expired
+                }
+                return result;
+            })),
+            successOnMaybe: false,
+            throwErrors: false
+        });
+        const cacheForService = {
+            loadCachedToken: function () {
+                return loadCachedTokenFromFirstService();
+            },
+            updateCachedToken: async function (accessToken) {
+                return Promise.allSettled(accessCachesForServices.map((x) => x
+                    .updateCachedToken(accessToken)
+                    .then(() => null)
+                    .catch((e) => {
+                    return [x, e];
+                }))).then((x) => {
+                    // only find the failures if we're logging
+                    if (logErrorFunction != null) {
+                        const failedUpdates = (0, util_1.filterMaybeArrayValues)(x.map((y) => y.value));
+                        if (failedUpdates.length) {
+                            logErrorFunction(failedUpdates);
+                        }
+                    }
+                });
+            }
+        };
+        return cacheForService;
+    };
+    const allServiceAccessTokenCaches = allServices.map((x) => x.loadZoomAccessTokenCache());
+    const allServicesWithCacheForRefreshToken = allServices.filter((x) => x.cacheForRefreshToken != null);
+    const cacheForRefreshToken = allServiceAccessTokenCaches.length > 0
+        ? (refreshToken) => {
+            const allCaches = allServicesWithCacheForRefreshToken.map((x) => x.cacheForRefreshToken(refreshToken));
+            return loadZoomAccessTokenCache(allCaches);
+        }
+        : undefined;
+    const service = {
+        loadZoomAccessTokenCache: () => loadZoomAccessTokenCache(allServiceAccessTokenCaches),
+        cacheForRefreshToken
+    };
+    return service;
+}
+// MARK: Memory Access Token Cache
+/**
+ * Creates a ZoomOAuthAccessTokenCacheService that uses in-memory storage.
+ *
+ * @returns
+ */
+function memoryZoomOAuthAccessTokenCacheService(existingToken) {
+    let token = existingToken;
+    function loadZoomAccessTokenCache() {
+        const accessTokenCache = {
+            loadCachedToken: async function () {
+                console.log('retrieving access token from memory: ', { token });
+                return token;
+            },
+            updateCachedToken: async function (accessToken) {
+                token = accessToken;
+                console.log('updating access token in memory: ', { accessToken });
+            }
+        };
+        return accessTokenCache;
+    }
+    return {
+        loadZoomAccessTokenCache,
+        cacheForRefreshToken: () => loadZoomAccessTokenCache()
+    };
+}
+// MARK: File System Access Token Cache
+exports.DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH = '.tmp/zoom-access-tokens.json';
+/**
+ * Creates a ZoomOAuthAccessTokenCacheService that reads and writes the access token to the file system.
+ *
+ * Useful for testing.
+ *
+ * @returns
+ */
+function fileZoomOAuthAccessTokenCacheService(filename = exports.DEFAULT_FILE_ZOOM_ACCOUNTS_ACCESS_TOKEN_CACHE_SERVICE_PATH, useMemoryCache = true) {
+    let loadedToken = null;
+    async function loadTokenFile() {
+        let token = undefined;
+        if (!loadedToken) {
+            token = (await readTokenFile()) ?? {};
+        }
+        else {
+            token = loadedToken;
+        }
+        return token;
+    }
+    function readTokenFile() {
+        return new Promise((resolve) => {
+            (0, fs_1.mkdirSync)((0, path_1.dirname)(filename), { recursive: true }); // make the directory first
+            (0, fs_1.readFile)(filename, {}, (x, data) => {
+                let result = undefined;
+                if (!x) {
+                    try {
+                        result = JSON.parse(data.toString());
+                        if (result?.token) {
+                            result.token.expiresAt = new Date(result.token.expiresAt);
+                        }
+                    }
+                    catch (e) {
+                        console.error('Failed reading token file: ', e);
+                    }
+                }
+                resolve(result);
+            });
+        }).then((x) => {
+            // update loaded tokens
+            if (useMemoryCache) {
+                loadedToken = {
+                    ...loadedToken,
+                    ...x
+                };
+            }
+            return x;
+        });
+    }
+    async function writeTokenFile(tokens) {
+        return new Promise((resolve, reject) => {
+            (0, fs_1.writeFile)(filename, JSON.stringify(tokens), {}, (x) => {
+                if (!x) {
+                    resolve();
+                }
+                else {
+                    reject(x);
+                }
+            });
+        });
+    }
+    async function deleteTokenFile() {
+        return new Promise((resolve, reject) => {
+            (0, fs_1.rm)(filename, (x) => {
+                if (!x) {
+                    resolve();
+                }
+                else {
+                    reject(x);
+                }
+            });
+        });
+    }
+    function loadZoomAccessTokenCache() {
+        const accessTokenCache = {
+            loadCachedToken: async function () {
+                const tokens = await loadTokenFile();
+                const token = tokens.token;
+                // console.log('retrieving access token from file: ', { token });
+                return token;
+            },
+            updateCachedToken: async function (accessToken) {
+                const tokenFile = await loadTokenFile();
+                if (tokenFile) {
+                    tokenFile.token = accessToken;
+                }
+                // console.log('updating access token in file: ', { accessToken });
+                try {
+                    await writeTokenFile(tokenFile);
+                }
+                catch (e) {
+                    console.error('Failed updating access token in file: ', e);
+                }
+            }
+        };
+        return accessTokenCache;
+    }
+    return {
+        loadZoomAccessTokenCache,
+        readTokenFile,
+        writeTokenFile,
+        deleteTokenFile
+    };
+}
+//# sourceMappingURL=oauth.service.js.map

package/nestjs/src/lib/oauth/oauth.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.service.js","sourceRoot":"","sources":["../../../../../../../packages/zoom/nestjs/src/lib/oauth/oauth.service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+export * from './zoom.api';
+export * from './zoom.config';
+export * from './zoom.module';

package/nestjs/src/lib/zoom/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./zoom.api"), exports);
+tslib_1.__exportStar(require("./zoom.config"), exports);
+tslib_1.__exportStar(require("./zoom.module"), exports);
+//# sourceMappingURL=index.js.map

package/nestjs/src/lib/zoom/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/zoom/nestjs/src/lib/zoom/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,wDAA8B;AAC9B,wDAA8B"}

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

@@ -0,0 +1,21 @@
+import { ZoomServiceConfig } from './zoom.config';
+import { Zoom, ZoomServerContext } from '@dereekb/zoom';
+import { ZoomOAuthApi } from '../oauth';
+export declare class ZoomApi {
+    readonly config: ZoomServiceConfig;
+    readonly zoomOAuthApi: ZoomOAuthApi;
+    readonly zoom: Zoom;
+    get zoomContext(): ZoomServerContext;
+    get zoomRateLimiter(): import("dist/packages/util/src").ResetPeriodPromiseRateLimiter;
+    constructor(config: ZoomServiceConfig, zoomOAuthApi: ZoomOAuthApi);
+    get getUser(): import("@dereekb/zoom").GetUserFunction;
+    get listUsers(): import("@dereekb/zoom").ListUsersFunction;
+    get listUsersPageFactory(): import("@dereekb/zoom").ListUsersPageFactory;
+    get listMeetingsForUser(): import("@dereekb/zoom").ListMeetingsForUserFunction;
+    get listMeetingsForUserPageFactory(): import("@dereekb/zoom").ListMeetingsForUserPageFactory;
+    get createMeetingForUser(): (input: import("@dereekb/zoom").CreateMeetingForUserInput) => Promise<import("@dereekb/zoom").CreateMeetingForUserResponse>;
+    get deleteMeeting(): import("@dereekb/zoom").DeleteMeetingFunction;
+}
+export declare class ZoomApiUserContext {
+    constructor(refreshToken: string);
+}

package/nestjs/src/lib/zoom/zoom.api.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZoomApiUserContext = exports.ZoomApi = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const zoom_config_1 = require("./zoom.config");
+const zoom_1 = require("@dereekb/zoom");
+const oauth_1 = require("../oauth");
+let ZoomApi = class ZoomApi {
+    config;
+    zoomOAuthApi;
+    zoom;
+    get zoomContext() {
+        return this.zoom.zoomServerContext;
+    }
+    get zoomRateLimiter() {
+        return this.zoom.zoomServerContext.zoomRateLimiter;
+    }
+    constructor(config, zoomOAuthApi) {
+        this.config = config;
+        this.zoomOAuthApi = zoomOAuthApi;
+        this.zoom = (0, zoom_1.zoomFactory)({
+            ...config.factoryConfig,
+            oauthContext: zoomOAuthApi.oauthContext
+        })(config.zoom);
+    }
+    // MARK: Users
+    get getUser() {
+        return (0, zoom_1.getUser)(this.zoomContext);
+    }
+    get listUsers() {
+        return (0, zoom_1.listUsers)(this.zoomContext);
+    }
+    get listUsersPageFactory() {
+        return (0, zoom_1.listUsersPageFactory)(this.zoomContext);
+    }
+    // MARK: Meetings
+    get listMeetingsForUser() {
+        return (0, zoom_1.listMeetingsForUser)(this.zoomContext);
+    }
+    get listMeetingsForUserPageFactory() {
+        return (0, zoom_1.listMeetingsForUserPageFactory)(this.zoomContext);
+    }
+    get createMeetingForUser() {
+        return (0, zoom_1.createMeetingForUser)(this.zoomContext);
+    }
+    get deleteMeeting() {
+        return (0, zoom_1.deleteMeeting)(this.zoomContext);
+    }
+};
+exports.ZoomApi = ZoomApi;
+exports.ZoomApi = ZoomApi = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(zoom_config_1.ZoomServiceConfig)),
+    tslib_1.__param(1, (0, common_1.Inject)(oauth_1.ZoomOAuthApi)),
+    tslib_1.__metadata("design:paramtypes", [zoom_config_1.ZoomServiceConfig,
+        oauth_1.ZoomOAuthApi])
+], ZoomApi);
+class ZoomApiUserContext {
+    constructor(refreshToken) {
+        // TODO: ...
+    }
+}
+exports.ZoomApiUserContext = ZoomApiUserContext;
+//# sourceMappingURL=zoom.api.js.map

package/nestjs/src/lib/zoom/zoom.api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom.api.js","sourceRoot":"","sources":["../../../../../../../packages/zoom/nestjs/src/lib/zoom/zoom.api.ts"],"names":[],"mappings":";;;;AAAA,2CAAoD;AACpD,+CAAkD;AAClD,wCAAyM;AACzM,oCAAwC;AAGjC,IAAM,OAAO,GAAb,MAAM,OAAO;IAYoB;IACL;IAZxB,IAAI,CAAO;IAEpB,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACrC,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC;IACrD,CAAC;IAED,YACsC,MAAyB,EAC9B,YAA0B;QADrB,WAAM,GAAN,MAAM,CAAmB;QAC9B,iBAAY,GAAZ,YAAY,CAAc;QAEzD,IAAI,CAAC,IAAI,GAAG,IAAA,kBAAW,EAAC;YACtB,GAAG,MAAM,CAAC,aAAa;YACvB,YAAY,EAAE,YAAY,CAAC,YAAY;SACxC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,cAAc;IACd,IAAI,OAAO;QACT,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAA,gBAAS,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,oBAAoB;QACtB,OAAO,IAAA,2BAAoB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,iBAAiB;IACjB,IAAI,mBAAmB;QACrB,OAAO,IAAA,0BAAmB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,8BAA8B;QAChC,OAAO,IAAA,qCAA8B,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,oBAAoB;QACtB,OAAO,IAAA,2BAAoB,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAA,oBAAa,EAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;CACF,CAAA;AAlDY,0BAAO;kBAAP,OAAO;IADnB,IAAA,mBAAU,GAAE;IAaR,mBAAA,IAAA,eAAM,EAAC,+BAAiB,CAAC,CAAA;IACzB,mBAAA,IAAA,eAAM,EAAC,oBAAY,CAAC,CAAA;6CADuB,+BAAiB;QAChB,oBAAY;GAbhD,OAAO,CAkDnB;AAED,MAAa,kBAAkB;IAC7B,YAAY,YAAoB;QAC9B,YAAY;IACd,CAAC;CACF;AAJD,gDAIC"}

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

@@ -0,0 +1,10 @@
+import { ZoomConfig, ZoomFactoryConfig } from '@dereekb/zoom';
+export type ZoomServiceApiConfig = ZoomConfig & {};
+/**
+ * Configuration for ZoomService
+ */
+export declare abstract class ZoomServiceConfig {
+    readonly zoom: ZoomServiceApiConfig;
+    readonly factoryConfig?: ZoomFactoryConfig;
+    static assertValidConfig(config: ZoomServiceConfig): void;
+}

package/nestjs/src/lib/zoom/zoom.config.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZoomServiceConfig = void 0;
+/**
+ * Configuration for ZoomService
+ */
+class ZoomServiceConfig {
+    zoom;
+    factoryConfig;
+    static assertValidConfig(config) {
+        // TODO?
+    }
+}
+exports.ZoomServiceConfig = ZoomServiceConfig;
+//# sourceMappingURL=zoom.config.js.map

package/nestjs/src/lib/zoom/zoom.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom.config.js","sourceRoot":"","sources":["../../../../../../../packages/zoom/nestjs/src/lib/zoom/zoom.config.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,MAAsB,iBAAiB;IAC5B,IAAI,CAAwB;IAC5B,aAAa,CAAqB;IAE3C,MAAM,CAAC,iBAAiB,CAAC,MAAyB;QAChD,QAAQ;IACV,CAAC;CACF;AAPD,8CAOC"}

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

@@ -0,0 +1,22 @@
+import { ModuleMetadata } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { ZoomServiceConfig } from './zoom.config';
+import { type Maybe } from '@dereekb/util';
+export declare function zoomServiceConfigFactory(configService: ConfigService): ZoomServiceConfig;
+export interface ProvideAppZoomMetadataConfig extends Pick<ModuleMetadata, 'imports' | 'exports' | 'providers'> {
+    /**
+     * The ZoomModule requires the following dependencies in order to initialze properly:
+     * - ZoomOAuthApi
+     *
+     * This module declaration makes it easier to import a module that exports those depenendencies.
+     */
+    readonly dependencyModule?: Maybe<Required<ModuleMetadata>['imports']['0']>;
+}
+/**
+ * Convenience function used to generate ModuleMetadata for an app's ZoomModule.
+ *
+ * @param provide
+ * @param useFactory
+ * @returns
+ */
+export declare function appZoomModuleMetadata(config: ProvideAppZoomMetadataConfig): ModuleMetadata;

package/nestjs/src/lib/zoom/zoom.module.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.zoomServiceConfigFactory = zoomServiceConfigFactory;
+exports.appZoomModuleMetadata = appZoomModuleMetadata;
+const config_1 = require("@nestjs/config");
+const zoom_api_1 = require("./zoom.api");
+const zoom_config_1 = require("./zoom.config");
+// MARK: Provider Factories
+function zoomServiceConfigFactory(configService) {
+    const config = {
+        zoom: {}
+    };
+    zoom_config_1.ZoomServiceConfig.assertValidConfig(config);
+    return config;
+}
+/**
+ * Convenience function used to generate ModuleMetadata for an app's ZoomModule.
+ *
+ * @param provide
+ * @param useFactory
+ * @returns
+ */
+function appZoomModuleMetadata(config) {
+    const { dependencyModule, imports, exports, providers } = config;
+    const dependencyModuleImport = dependencyModule ? [dependencyModule] : [];
+    return {
+        imports: [config_1.ConfigModule, ...dependencyModuleImport, ...(imports ?? [])],
+        exports: [zoom_api_1.ZoomApi, ...(exports ?? [])],
+        providers: [
+            {
+                provide: zoom_config_1.ZoomServiceConfig,
+                inject: [config_1.ConfigService],
+                useFactory: zoomServiceConfigFactory
+            },
+            zoom_api_1.ZoomApi,
+            ...(providers ?? [])
+        ]
+    };
+}
+//# sourceMappingURL=zoom.module.js.map

package/nestjs/src/lib/zoom/zoom.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zoom.module.js","sourceRoot":"","sources":["../../../../../../../packages/zoom/nestjs/src/lib/zoom/zoom.module.ts"],"names":[],"mappings":";;AAOA,4DAOC;AAoBD,sDAiBC;AAlDD,2CAA6D;AAC7D,yCAAqC;AACrC,+CAAkD;AAGlD,2BAA2B;AAC3B,SAAgB,wBAAwB,CAAC,aAA4B;IACnE,MAAM,MAAM,GAAsB;QAChC,IAAI,EAAE,EAAE;KACT,CAAC;IAEF,+BAAiB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC;AAChB,CAAC;AAaD;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,MAAoC;IACxE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IACjE,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE1E,OAAO;QACL,OAAO,EAAE,CAAC,qBAAY,EAAE,GAAG,sBAAsB,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,EAAE,CAAC,kBAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACtC,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,+BAAiB;gBAC1B,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,wBAAwB;aACrC;YACD,kBAAO;YACP,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;SACrB;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@dereekb/zoom",
+  "version": "12.1.0",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "node": {
+        "require": "./index.cjs.js",
+        "import": "./index.mjs"
+      },
+      "browser": {
+        "require": "./index.cjs.js",
+        "import": "./index.esm.js"
+      },
+      "default": "./index.cjs.js"
+    },
+    "./nestjs": {
+      "types": "./nestjs/src/index.d.ts",
+      "main": "./nestjs/src/index.js",
+      "require": "./nestjs/src/index.js",
+      "default": "./nestjs/src/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@dereekb/util": "*",
+    "make-error": "^1.3.0"
+  },
+  "module": "./index.esm.js",
+  "main": "./index.cjs.js",
+  "types": "./index.esm.d.ts"
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export * from './lib';

package/src/lib/index.d.ts

@@ -0,0 +1,7 @@
+export * from './zoom';
+export * from './oauth';
+export * from './zoom.error.api';
+export * from './zoom.api.page';
+export * from './zoom.config';
+export * from './zoom.limit';
+export * from './zoom.type';

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

@@ -0,0 +1,5 @@
+export * from './oauth';
+export * from './oauth.api';
+export * from './oauth.config';
+export * from './oauth.error.api';
+export * from './oauth.factory';

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

@@ -0,0 +1,39 @@
+import { FetchJsonInput } from '@dereekb/util/fetch';
+import { ZoomOAuthContext } from './oauth.config';
+import { ZoomAccountId, ZoomAuthClientIdAndSecretPair, ZoomRefreshToken } from '../zoom.config';
+import { ZoomAccessTokenApiDomain, ZoomAccessTokenScopesString, ZoomAccessTokenString } from './oauth';
+import { Maybe, Seconds } from '@dereekb/util';
+import { ZoomOAuthAccessTokenErrorCode } from './oauth.error.api';
+export interface ZoomOAuthServerAccessTokenInput {
+    readonly client?: Maybe<ZoomAuthClientIdAndSecretPair>;
+    readonly accountId?: Maybe<ZoomAccountId>;
+}
+export interface ZoomOAuthUserAccessTokenInput extends ZoomOAuthServerAccessTokenInput {
+    readonly refreshToken: ZoomRefreshToken;
+}
+export interface ZoomOAuthAccessTokenResponse {
+    readonly access_token: ZoomAccessTokenString;
+    readonly token_type: 'bearer';
+    readonly api_url: ZoomAccessTokenApiDomain;
+    readonly scope: ZoomAccessTokenScopesString;
+    readonly expires_in: Seconds;
+}
+export interface ZoomOAuthAccessTokenErrorResponse {
+    readonly error: ZoomOAuthAccessTokenErrorCode;
+}
+/**
+ * Retrieves a new AccessToken for Server to Server authentication.
+ *
+ * @param context
+ * @returns
+ */
+export declare function serverAccessToken(context: ZoomOAuthContext): (input?: ZoomOAuthServerAccessTokenInput) => Promise<ZoomOAuthAccessTokenResponse>;
+/**
+ * Retrieves a new AccessToken for a user using their refresh token.
+ *
+ * @param context
+ * @returns
+ */
+export declare function userAccessToken(context: ZoomOAuthContext): (input: ZoomOAuthUserAccessTokenInput) => Promise<ZoomOAuthAccessTokenResponse>;
+export declare function zoomOAuthApiFetchJsonInput(context: ZoomOAuthContext, input?: Maybe<ZoomOAuthServerAccessTokenInput>): FetchJsonInput;
+export declare function zoomOAuthServerBasicAuthorizationHeaderValue(input: ZoomAuthClientIdAndSecretPair): string;

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

@@ -0,0 +1,44 @@
+import { FactoryWithInput, FactoryWithRequiredInput, type Maybe } from '@dereekb/util';
+import { ConfiguredFetch, FetchJsonFunction } from '@dereekb/util/fetch';
+import { ZoomAuthClientIdAndSecretPair, ZoomAccountIdRef, ZoomRefreshToken } from '../zoom.config';
+import { ZoomAccessTokenCache, ZoomAccessTokenFactory } from './oauth';
+/**
+ * The Zoom OAuth API URL for the US datacenter.
+ */
+export declare const ZOOM_OAUTH_API_URL = "https://zoom.us/oauth";
+/**
+ * Url for the Zoom OAuth API.
+ *
+ * https://developers.zoom.us/docs/integrations/oauth/
+ */
+export type ZoomOAuthApiUrl = typeof ZOOM_OAUTH_API_URL;
+/**
+ * Configuration for ZoomOAuth.
+ */
+export interface ZoomOAuthConfig extends ZoomAuthClientIdAndSecretPair, ZoomAccountIdRef {
+    /**
+     * Optional ZoomAccessTokenCache for caching access tokens.
+     */
+    readonly accessTokenCache?: Maybe<ZoomAccessTokenCache>;
+}
+export interface ZoomOAuthFetchFactoryInput {
+}
+export type ZoomOAuthFetchFactory = FactoryWithInput<ConfiguredFetch, ZoomOAuthFetchFactoryInput>;
+export type ZoomOAuthMakeUserAccessTokenFactoryInput = {
+    readonly refreshToken: ZoomRefreshToken;
+    readonly userAccessTokenCache?: Maybe<ZoomAccessTokenCache>;
+};
+export type ZoomOAuthMakeUserAccessTokenFactory = FactoryWithRequiredInput<ZoomAccessTokenFactory, ZoomOAuthMakeUserAccessTokenFactoryInput>;
+/**
+ * Context used for performing fetch() and fetchJson() calls with a configured fetch instance.
+ */
+export interface ZoomOAuthContext {
+    readonly fetch: ConfiguredFetch;
+    readonly fetchJson: FetchJsonFunction;
+    readonly loadAccessToken: ZoomAccessTokenFactory;
+    readonly makeUserAccessTokenFactory: ZoomOAuthMakeUserAccessTokenFactory;
+    readonly config: ZoomOAuthConfig;
+}
+export interface ZoomOAuthContextRef {
+    readonly oauthContext: ZoomOAuthContext;
+}

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

@@ -0,0 +1,71 @@
+import { type Maybe } from '@dereekb/util';
+/**
+ * Access token authorization string generated from a refresh token.
+ */
+export type ZoomAccessTokenString = string;
+/**
+ * Scopes string for a ZoomAccessToken that is space-separated.
+ *
+ * Example: "user:read:user:admin api:write:zoom etc:etc:etc"
+ */
+export type ZoomAccessTokenScopesString = string;
+/**
+ * Api domain string for a ZoomAccessToken
+ *
+ * Example: "https://api.zoom.us"
+ */
+export type ZoomAccessTokenApiDomain = string;
+/**
+ * Zoom account access token.
+ */
+export interface ZoomAccessToken {
+    readonly accessToken: ZoomAccessTokenString;
+    readonly scope: ZoomAccessTokenScopesString;
+    /**
+     * Api domain for the token.
+     */
+    readonly apiDomain: ZoomAccessTokenApiDomain;
+    /**
+     * Length of time the token is valid for.
+     */
+    readonly expiresIn: number;
+    /**
+     * Date the token expires at.
+     */
+    readonly expiresAt: Date;
+}
+/**
+ * Used for retrieving and storing ZoomAccessToken values.
+ */
+export interface ZoomAccessTokenCache {
+    /**
+     * Loads the token from the cache, if available.
+     *
+     * The token may be expired.
+     */
+    loadCachedToken(): Promise<Maybe<ZoomAccessToken>>;
+    /**
+     * Updates the cache with the given access token.
+     */
+    updateCachedToken(accessToken: ZoomAccessToken): Promise<void>;
+}
+/**
+ * Source for retriving a ZoomAccessToken.
+ *
+ * Throws an ZoomOAuthAuthRetrievalError error if the token could not be retrieved.
+ */
+export type ZoomAccessTokenFactory = () => Promise<ZoomAccessToken>;
+/**
+ * A ZoomAccessTokenFactory that always generates a new ZoomAccessToken.
+ */
+export type ZoomAccessTokenRefresher = ZoomAccessTokenFactory;
+/**
+ * Source for retriving a ZoomAccessToken string.
+ *
+ * Throws an ZoomOAuthAuthRetrievalError error if the token could not be retrieved.
+ */
+export type ZoomAccessTokenStringFactory = () => Promise<ZoomAccessTokenString>;
+/**
+ * Generates a new ZoomAccessTokenStringFactory.
+ */
+export declare function zoomAccessTokenStringFactory(zoomAccessTokenFactory: ZoomAccessTokenFactory): ZoomAccessTokenStringFactory;