@dereekb/nestjs 12.2.0 → 12.3.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [12.3.0](https://github.com/dereekb/dbx-components/compare/v12.2.1-dev...v12.3.0) (2025-07-04)
+
+
+### Features
+
+* added @dereekb/nestjs/openai integration ([611724f](https://github.com/dereekb/dbx-components/commit/611724f3c5354f2c38a6aecf75a64085f2aa6bcd))
+
+
+
+## [12.2.1](https://github.com/dereekb/dbx-components/compare/v12.2.0-dev...v12.2.1) (2025-07-02)
+
+
+
 # [12.2.0](https://github.com/dereekb/dbx-components/compare/v12.1.14-dev...v12.2.0) (2025-06-29)
 
 

package/mailgun/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs/mailgun",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "type": "commonjs",
   "types": "./src/index.d.ts",
   "main": "./src/index.js"

package/openai/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Hapier Creative LLC.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/openai/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@dereekb/nestjs/openai",
+  "version": "12.3.0",
+  "type": "commonjs",
+  "peerDependencies": {},
+  "dependencies": {},
+  "types": "./src/index.d.ts",
+  "main": "./src/index.js"
+}

package/openai/src/index.d.ts

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

package/openai/src/index.js

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

package/openai/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/nestjs/openai/src/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB"}

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

@@ -0,0 +1,6 @@
+export * from './webhook';
+export * from './openai.module';
+export * from './openai.api';
+export * from './openai.module';
+export * from './openai.config';
+export * from './openai.type';

package/openai/src/lib/index.js

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

package/openai/src/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/openai/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,0DAAgC;AAChC,uDAA6B;AAC7B,0DAAgC;AAChC,0DAAgC;AAChC,wDAA8B"}

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

@@ -0,0 +1,7 @@
+import { OpenAIServiceConfig } from './openai.config';
+import { OpenAI } from 'openai';
+export declare class OpenAIApi {
+    readonly config: OpenAIServiceConfig;
+    readonly openAIClient: OpenAI;
+    constructor(config: OpenAIServiceConfig);
+}

package/openai/src/lib/openai.api.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIApi = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const openai_config_1 = require("./openai.config");
+const openai_1 = require("openai");
+let OpenAIApi = class OpenAIApi {
+    config;
+    openAIClient;
+    constructor(config) {
+        this.config = config;
+        this.openAIClient = new openai_1.OpenAI(config.openai.config);
+    }
+};
+exports.OpenAIApi = OpenAIApi;
+exports.OpenAIApi = OpenAIApi = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(openai_config_1.OpenAIServiceConfig)),
+    tslib_1.__metadata("design:paramtypes", [openai_config_1.OpenAIServiceConfig])
+], OpenAIApi);
+//# sourceMappingURL=openai.api.js.map

package/openai/src/lib/openai.api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.api.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/openai/src/lib/openai.api.ts"],"names":[],"mappings":";;;;AAAA,2CAAoD;AACpD,mDAAsD;AACtD,mCAAgC;AAGzB,IAAM,SAAS,GAAf,MAAM,SAAS;IAG8B;IAFzC,YAAY,CAAS;IAE9B,YAAkD,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;QAC3E,IAAI,CAAC,YAAY,GAAG,IAAI,eAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvD,CAAC;CACF,CAAA;AANY,8BAAS;oBAAT,SAAS;IADrB,IAAA,mBAAU,GAAE;IAIE,mBAAA,IAAA,eAAM,EAAC,mCAAmB,CAAC,CAAA;6CAAkB,mCAAmB;GAHlE,SAAS,CAMrB"}

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

@@ -0,0 +1,18 @@
+import { ClientOptions } from 'openai';
+/**
+ * Default environment variable for the OpenAI API key.
+ */
+export declare const OPENAI_API_KEY_ENV_VAR = "OPENAI_API_KEY";
+export declare const OPENAI_BASE_URL_ENV_VAR = "OPENAI_BASE_URL";
+export declare const OPENAI_ORGANIZATION_ID_ENV_VAR = "OPENAI_ORG_ID";
+export declare const OPENAI_PROJECT_ID_ENV_VAR = "OPENAI_PROJECT_ID";
+export interface OpenAIServiceApiConfig {
+    readonly config: ClientOptions;
+}
+/**
+ * Configuration for OpenAIService
+ */
+export declare abstract class OpenAIServiceConfig {
+    readonly openai: OpenAIServiceApiConfig;
+    static assertValidConfig(config: OpenAIServiceConfig): void;
+}

package/openai/src/lib/openai.config.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIServiceConfig = exports.OPENAI_PROJECT_ID_ENV_VAR = exports.OPENAI_ORGANIZATION_ID_ENV_VAR = exports.OPENAI_BASE_URL_ENV_VAR = exports.OPENAI_API_KEY_ENV_VAR = void 0;
+/**
+ * Default environment variable for the OpenAI API key.
+ */
+exports.OPENAI_API_KEY_ENV_VAR = 'OPENAI_API_KEY';
+exports.OPENAI_BASE_URL_ENV_VAR = 'OPENAI_BASE_URL';
+exports.OPENAI_ORGANIZATION_ID_ENV_VAR = 'OPENAI_ORG_ID';
+exports.OPENAI_PROJECT_ID_ENV_VAR = 'OPENAI_PROJECT_ID';
+/**
+ * Configuration for OpenAIService
+ */
+class OpenAIServiceConfig {
+    openai;
+    static assertValidConfig(config) {
+        if (!config.openai.config.apiKey) {
+            throw new Error('No OpenAI API key specified.');
+        }
+        else if (!config.openai.config.organization) {
+            throw new Error('No OpenAI organization specified.');
+        }
+        else if (!config.openai.config.project) {
+            throw new Error('No OpenAI project specified.');
+        }
+    }
+}
+exports.OpenAIServiceConfig = OpenAIServiceConfig;
+//# sourceMappingURL=openai.config.js.map

package/openai/src/lib/openai.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.config.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/openai/src/lib/openai.config.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACU,QAAA,sBAAsB,GAAG,gBAAgB,CAAC;AAC1C,QAAA,uBAAuB,GAAG,iBAAiB,CAAC;AAC5C,QAAA,8BAA8B,GAAG,eAAe,CAAC;AACjD,QAAA,yBAAyB,GAAG,mBAAmB,CAAC;AAM7D;;GAEG;AACH,MAAsB,mBAAmB;IAC9B,MAAM,CAA0B;IAEzC,MAAM,CAAC,iBAAiB,CAAC,MAA2B;QAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAZD,kDAYC"}

package/openai/src/lib/openai.module.d.ts

@@ -0,0 +1,5 @@
+import { ConfigService } from '@nestjs/config';
+import { OpenAIServiceConfig } from './openai.config';
+export declare function openAIServiceConfigFactory(configService: ConfigService): OpenAIServiceConfig;
+export declare class OpenAIModule {
+}

package/openai/src/lib/openai.module.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIModule = void 0;
+exports.openAIServiceConfigFactory = openAIServiceConfigFactory;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const openai_api_1 = require("./openai.api");
+const openai_config_1 = require("./openai.config");
+function openAIServiceConfigFactory(configService) {
+    const config = {
+        openai: {
+            config: {
+                apiKey: configService.get(openai_config_1.OPENAI_API_KEY_ENV_VAR),
+                baseURL: configService.get(openai_config_1.OPENAI_BASE_URL_ENV_VAR) ?? undefined,
+                organization: configService.get(openai_config_1.OPENAI_ORGANIZATION_ID_ENV_VAR),
+                project: configService.get(openai_config_1.OPENAI_PROJECT_ID_ENV_VAR)
+            }
+        }
+    };
+    openai_config_1.OpenAIServiceConfig.assertValidConfig(config);
+    return config;
+}
+let OpenAIModule = class OpenAIModule {
+};
+exports.OpenAIModule = OpenAIModule;
+exports.OpenAIModule = OpenAIModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule],
+        providers: [
+            {
+                provide: openai_config_1.OpenAIServiceConfig,
+                inject: [config_1.ConfigService],
+                useFactory: openAIServiceConfigFactory
+            },
+            openai_api_1.OpenAIApi
+        ],
+        exports: [openai_api_1.OpenAIApi]
+    })
+], OpenAIModule);
+//# sourceMappingURL=openai.module.js.map

package/openai/src/lib/openai.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.module.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/openai/src/lib/openai.module.ts"],"names":[],"mappings":";;;AAMA,gEAcC;;AApBD,2CAAwC;AACxC,2CAA6D;AAC7D,6CAAyC;AACzC,mDAAkK;AAGlK,SAAgB,0BAA0B,CAAC,aAA4B;IACrE,MAAM,MAAM,GAAwB;QAClC,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,MAAM,EAAE,aAAa,CAAC,GAAG,CAAe,sCAAsB,CAAiB;gBAC/E,OAAO,EAAE,aAAa,CAAC,GAAG,CAAqB,uCAAuB,CAAC,IAAI,SAAS;gBACpF,YAAY,EAAE,aAAa,CAAC,GAAG,CAAuB,8CAA8B,CAAC;gBACrF,OAAO,EAAE,aAAa,CAAC,GAAG,CAAkB,yCAAyB,CAAC;aACvE;SACF;KACF,CAAC;IAEF,mCAAmB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAcM,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IAZxB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,CAAC;QACvB,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,mCAAmB;gBAC5B,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,0BAA0B;aACvC;YACD,sBAAS;SACV;QACD,OAAO,EAAE,CAAC,sBAAS,CAAC;KACrB,CAAC;GACW,YAAY,CAAG"}

package/openai/src/lib/openai.type.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Api key used by OpenAI for making requests.
+ */
+export type OpenAIApiKey = string;
+/**
+ * Your OpenAI organization id.
+ */
+export type OpenAIOrganizationId = string;
+/**
+ * Your OpenAI project id.
+ */
+export type OpenAIProjectId = string;
+/**
+ * Webhook secret used by OpenAI for validating webhook events.
+ */
+export type OpenAIWebhookSecret = string;
+/**
+ * Assistant id used by OpenAI.
+ */
+export type OpenAIAssistantId = string;

package/openai/src/lib/openai.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=openai.type.js.map

package/openai/src/lib/openai.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.type.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/openai/src/lib/openai.type.ts"],"names":[],"mappings":""}

package/openai/src/lib/webhook/index.d.ts

@@ -0,0 +1,6 @@
+export * from './webhook.openai';
+export * from './webhook.openai.config';
+export * from './webhook.openai.controller';
+export * from './webhook.openai.module';
+export * from './webhook.openai.service';
+export * from './webhook.openai.verify';

package/openai/src/lib/webhook/index.js

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

package/openai/src/lib/webhook/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/openai/src/lib/webhook/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,kEAAwC;AACxC,sEAA4C;AAC5C,kEAAwC;AACxC,mEAAyC;AACzC,kEAAwC"}

package/openai/src/lib/webhook/webhook.openai.config.d.ts

@@ -0,0 +1,12 @@
+import { OpenAIWebhookSecret } from '../openai.type';
+export declare const OPENAI_WEBHOOK_SECRET_ENV_VAR = "OPENAI_WEBHOOK_SECRET";
+export interface OpenAIWebhookConfig {
+    readonly webhookSecret: OpenAIWebhookSecret;
+}
+/**
+ * Configuration for OpenAIService
+ */
+export declare abstract class OpenAIWebhookServiceConfig {
+    readonly openaiWebhook: OpenAIWebhookConfig;
+    static assertValidConfig(config: OpenAIWebhookServiceConfig): void;
+}

package/openai/src/lib/webhook/webhook.openai.config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIWebhookServiceConfig = exports.OPENAI_WEBHOOK_SECRET_ENV_VAR = void 0;
+exports.OPENAI_WEBHOOK_SECRET_ENV_VAR = 'OPENAI_WEBHOOK_SECRET';
+/**
+ * Configuration for OpenAIService
+ */
+class OpenAIWebhookServiceConfig {
+    openaiWebhook;
+    static assertValidConfig(config) {
+        if (!config.openaiWebhook.webhookSecret) {
+            throw new Error('No OpenAI webhook secret specified.');
+        }
+    }
+}
+exports.OpenAIWebhookServiceConfig = OpenAIWebhookServiceConfig;
+//# sourceMappingURL=webhook.openai.config.js.map

package/openai/src/lib/webhook/webhook.openai.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.openai.config.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/openai/src/lib/webhook/webhook.openai.config.ts"],"names":[],"mappings":";;;AAEa,QAAA,6BAA6B,GAAG,uBAAuB,CAAC;AAMrE;;GAEG;AACH,MAAsB,0BAA0B;IACrC,aAAa,CAAuB;IAE7C,MAAM,CAAC,iBAAiB,CAAC,MAAkC;QACzD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AARD,gEAQC"}

package/openai/src/lib/webhook/webhook.openai.controller.d.ts

@@ -0,0 +1,8 @@
+import { RawBodyBuffer } from '@dereekb/nestjs';
+import { Request } from 'express';
+import { OpenAIWebhookService } from './webhook.openai.service';
+export declare class OpenAIWebhookController {
+    private readonly _openaiWebhookService;
+    constructor(openaiWebhookService: OpenAIWebhookService);
+    handleOpenAIWebhook(req: Request, rawBody: RawBodyBuffer): Promise<void>;
+}

package/openai/src/lib/webhook/webhook.openai.controller.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIWebhookController = void 0;
+const tslib_1 = require("tslib");
+const nestjs_1 = require("@dereekb/nestjs");
+const common_1 = require("@nestjs/common");
+const webhook_openai_service_1 = require("./webhook.openai.service");
+let OpenAIWebhookController = class OpenAIWebhookController {
+    _openaiWebhookService;
+    constructor(openaiWebhookService) {
+        this._openaiWebhookService = openaiWebhookService;
+    }
+    async handleOpenAIWebhook(req, rawBody) {
+        await this._openaiWebhookService.updateForWebhook(req, rawBody);
+    }
+};
+exports.OpenAIWebhookController = OpenAIWebhookController;
+tslib_1.__decorate([
+    (0, common_1.Post)(),
+    tslib_1.__param(0, (0, common_1.Req)()),
+    tslib_1.__param(1, (0, nestjs_1.RawBody)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], OpenAIWebhookController.prototype, "handleOpenAIWebhook", null);
+exports.OpenAIWebhookController = OpenAIWebhookController = tslib_1.__decorate([
+    (0, common_1.Controller)('/webhook/openai'),
+    tslib_1.__metadata("design:paramtypes", [webhook_openai_service_1.OpenAIWebhookService])
+], OpenAIWebhookController);
+//# sourceMappingURL=webhook.openai.controller.js.map

package/openai/src/lib/webhook/webhook.openai.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.openai.controller.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/openai/src/lib/webhook/webhook.openai.controller.ts"],"names":[],"mappings":";;;;AAAA,4CAAyD;AACzD,2CAAuD;AAEvD,qEAAgE;AAGzD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IACjB,qBAAqB,CAAuB;IAE7D,YAAY,oBAA0C;QACpD,IAAI,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;IACpD,CAAC;IAGK,AAAN,KAAK,CAAC,mBAAmB,CAAQ,GAAY,EAAa,OAAsB;QAC9E,MAAM,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACF,CAAA;AAXY,0DAAuB;AAQ5B;IADL,IAAA,aAAI,GAAE;IACoB,mBAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,mBAAA,IAAA,gBAAO,GAAE,CAAA;;;;kEAExD;kCAVU,uBAAuB;IADnC,IAAA,mBAAU,EAAC,iBAAiB,CAAC;6CAIM,6CAAoB;GAH3C,uBAAuB,CAWnC"}

package/openai/src/lib/webhook/webhook.openai.d.ts

@@ -0,0 +1,44 @@
+import { HandlerBindAccessor, HandlerMappedSetFunction, Handler } from '@dereekb/util';
+import '../openai.type';
+import { BatchCancelledWebhookEvent, BatchCompletedWebhookEvent, BatchExpiredWebhookEvent, BatchFailedWebhookEvent, EvalRunCanceledWebhookEvent, EvalRunFailedWebhookEvent, EvalRunSucceededWebhookEvent, FineTuningJobCancelledWebhookEvent, FineTuningJobFailedWebhookEvent, FineTuningJobSucceededWebhookEvent, ResponseCancelledWebhookEvent, ResponseCompletedWebhookEvent, ResponseFailedWebhookEvent, ResponseIncompleteWebhookEvent, UnwrapWebhookEvent } from 'openai/resources/webhooks';
+export type OpenAIWebhookEventType = UnwrapWebhookEvent['type'];
+export interface RawOpenAIWebhookEvent {
+    readonly message: UntypedOpenAIWebhookEvent;
+}
+/**
+ * A parsed OpenAIWebhookEventType that contains the relevant data and the original event.
+ */
+export type OpenAIWebhookEvent<T extends UnwrapWebhookEvent = UnwrapWebhookEvent, ET extends OpenAIWebhookEventType = OpenAIWebhookEventType> = T & {
+    /**
+     * The event type
+     */
+    readonly type: ET;
+};
+export type UntypedOpenAIWebhookEvent = UnwrapWebhookEvent;
+/**
+ * Creates a OpenAIWebhookEvent and treats the data as the input type.
+ *
+ * @param event
+ * @returns
+ */
+export declare function openAIWebhookEvent<T extends UnwrapWebhookEvent = UnwrapWebhookEvent>(event: UntypedOpenAIWebhookEvent): OpenAIWebhookEvent<T>;
+export type OpenAIEventHandler = Handler<UntypedOpenAIWebhookEvent, OpenAIWebhookEventType>;
+export declare const openaiEventHandlerFactory: import("@dereekb/util").HandlerFactory<UnwrapWebhookEvent, "batch.cancelled" | "batch.completed" | "batch.expired" | "batch.failed" | "eval.run.canceled" | "eval.run.failed" | "eval.run.succeeded" | "fine_tuning.job.cancelled" | "fine_tuning.job.failed" | "fine_tuning.job.succeeded" | "response.cancelled" | "response.completed" | "response.failed" | "response.incomplete", boolean>;
+export type OpenAIHandlerMappedSetFunction<T extends UnwrapWebhookEvent = UnwrapWebhookEvent> = HandlerMappedSetFunction<OpenAIWebhookEvent<T>>;
+export interface OpenAIEventHandlerConfigurer extends HandlerBindAccessor<UntypedOpenAIWebhookEvent, OpenAIWebhookEventType> {
+    readonly handleBatchCancelled: OpenAIHandlerMappedSetFunction<BatchCancelledWebhookEvent>;
+    readonly handleBatchCompleted: OpenAIHandlerMappedSetFunction<BatchCompletedWebhookEvent>;
+    readonly handleBatchExpired: OpenAIHandlerMappedSetFunction<BatchExpiredWebhookEvent>;
+    readonly handleBatchFailed: OpenAIHandlerMappedSetFunction<BatchFailedWebhookEvent>;
+    readonly handleEvalRunCanceled: OpenAIHandlerMappedSetFunction<EvalRunCanceledWebhookEvent>;
+    readonly handleEvalRunFailed: OpenAIHandlerMappedSetFunction<EvalRunFailedWebhookEvent>;
+    readonly handleEvalRunSucceeded: OpenAIHandlerMappedSetFunction<EvalRunSucceededWebhookEvent>;
+    readonly handleFineTuningJobCancelled: OpenAIHandlerMappedSetFunction<FineTuningJobCancelledWebhookEvent>;
+    readonly handleFineTuningJobFailed: OpenAIHandlerMappedSetFunction<FineTuningJobFailedWebhookEvent>;
+    readonly handleFineTuningJobSucceeded: OpenAIHandlerMappedSetFunction<FineTuningJobSucceededWebhookEvent>;
+    readonly handleResponseCancelled: OpenAIHandlerMappedSetFunction<ResponseCancelledWebhookEvent>;
+    readonly handleResponseCompleted: OpenAIHandlerMappedSetFunction<ResponseCompletedWebhookEvent>;
+    readonly handleResponseFailed: OpenAIHandlerMappedSetFunction<ResponseFailedWebhookEvent>;
+    readonly handleResponseIncomplete: OpenAIHandlerMappedSetFunction<ResponseIncompleteWebhookEvent>;
+}
+export declare const openaiEventHandlerConfigurerFactory: import("@dereekb/util").HandlerConfigurerFactory<OpenAIEventHandlerConfigurer, UnwrapWebhookEvent, "batch.cancelled" | "batch.completed" | "batch.expired" | "batch.failed" | "eval.run.canceled" | "eval.run.failed" | "eval.run.succeeded" | "fine_tuning.job.cancelled" | "fine_tuning.job.failed" | "fine_tuning.job.succeeded" | "response.cancelled" | "response.completed" | "response.failed" | "response.incomplete", boolean>;

package/openai/src/lib/webhook/webhook.openai.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openaiEventHandlerConfigurerFactory = exports.openaiEventHandlerFactory = void 0;
+exports.openAIWebhookEvent = openAIWebhookEvent;
+const util_1 = require("@dereekb/util");
+require("../openai.type");
+/**
+ * Creates a OpenAIWebhookEvent and treats the data as the input type.
+ *
+ * @param event
+ * @returns
+ */
+function openAIWebhookEvent(event) {
+    return event;
+}
+exports.openaiEventHandlerFactory = (0, util_1.handlerFactory)((x) => x.type);
+exports.openaiEventHandlerConfigurerFactory = (0, util_1.handlerConfigurerFactory)({
+    configurerForAccessor: (accessor) => {
+        // eslint-disable-next-line
+        const fnWithKey = (0, util_1.handlerMappedSetFunctionFactory)(accessor, openAIWebhookEvent);
+        const configurer = {
+            ...accessor,
+            handleBatchCancelled: fnWithKey('batch.cancelled'),
+            handleBatchCompleted: fnWithKey('batch.completed'),
+            handleBatchExpired: fnWithKey('batch.expired'),
+            handleBatchFailed: fnWithKey('batch.failed'),
+            handleEvalRunCanceled: fnWithKey('eval.run.canceled'),
+            handleEvalRunFailed: fnWithKey('eval.run.failed'),
+            handleEvalRunSucceeded: fnWithKey('eval.run.succeeded'),
+            handleFineTuningJobCancelled: fnWithKey('fine_tuning.job.cancelled'),
+            handleFineTuningJobFailed: fnWithKey('fine_tuning.job.failed'),
+            handleFineTuningJobSucceeded: fnWithKey('fine_tuning.job.succeeded'),
+            handleResponseCancelled: fnWithKey('response.cancelled'),
+            handleResponseCompleted: fnWithKey('response.completed'),
+            handleResponseFailed: fnWithKey('response.failed'),
+            handleResponseIncomplete: fnWithKey('response.incomplete')
+        };
+        return configurer;
+    }
+});
+//# sourceMappingURL=webhook.openai.js.map

package/openai/src/lib/webhook/webhook.openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.openai.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/openai/src/lib/webhook/webhook.openai.ts"],"names":[],"mappings":";;;AA4BA,gDAEC;AA9BD,wCAAkK;AAClK,0BAAwB;AAqBxB;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAoD,KAAgC;IACpH,OAAO,KAA8B,CAAC;AACxC,CAAC;AAIY,QAAA,yBAAyB,GAAG,IAAA,qBAAc,EAAoD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAqB7G,QAAA,mCAAmC,GAAG,IAAA,+BAAwB,EAAkF;IAC3J,qBAAqB,EAAE,CAAC,QAAgF,EAAE,EAAE;QAC1G,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAA,sCAA+B,EAAuD,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAEtI,MAAM,UAAU,GAAiC;YAC/C,GAAG,QAAQ;YACX,oBAAoB,EAAE,SAAS,CAAC,iBAAiB,CAAC;YAClD,oBAAoB,EAAE,SAAS,CAAC,iBAAiB,CAAC;YAClD,kBAAkB,EAAE,SAAS,CAAC,eAAe,CAAC;YAC9C,iBAAiB,EAAE,SAAS,CAAC,cAAc,CAAC;YAC5C,qBAAqB,EAAE,SAAS,CAAC,mBAAmB,CAAC;YACrD,mBAAmB,EAAE,SAAS,CAAC,iBAAiB,CAAC;YACjD,sBAAsB,EAAE,SAAS,CAAC,oBAAoB,CAAC;YACvD,4BAA4B,EAAE,SAAS,CAAC,2BAA2B,CAAC;YACpE,yBAAyB,EAAE,SAAS,CAAC,wBAAwB,CAAC;YAC9D,4BAA4B,EAAE,SAAS,CAAC,2BAA2B,CAAC;YACpE,uBAAuB,EAAE,SAAS,CAAC,oBAAoB,CAAC;YACxD,uBAAuB,EAAE,SAAS,CAAC,oBAAoB,CAAC;YACxD,oBAAoB,EAAE,SAAS,CAAC,iBAAiB,CAAC;YAClD,wBAAwB,EAAE,SAAS,CAAC,qBAAqB,CAAC;SAC3D,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}

package/openai/src/lib/webhook/webhook.openai.module.d.ts

@@ -0,0 +1,5 @@
+import { OpenAIWebhookServiceConfig } from './webhook.openai.config';
+import { ConfigService } from '@nestjs/config';
+export declare function openAIWebhookServiceConfigFactory(configService: ConfigService): OpenAIWebhookServiceConfig;
+export declare class OpenAIWebhookModule {
+}

package/openai/src/lib/webhook/webhook.openai.module.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIWebhookModule = void 0;
+exports.openAIWebhookServiceConfigFactory = openAIWebhookServiceConfigFactory;
+const tslib_1 = require("tslib");
+const webhook_openai_controller_1 = require("./webhook.openai.controller");
+const common_1 = require("@nestjs/common");
+const webhook_openai_service_1 = require("./webhook.openai.service");
+const webhook_openai_config_1 = require("./webhook.openai.config");
+const config_1 = require("@nestjs/config");
+const openai_module_1 = require("../openai.module");
+function openAIWebhookServiceConfigFactory(configService) {
+    const config = {
+        openaiWebhook: {
+            webhookSecret: configService.get(webhook_openai_config_1.OPENAI_WEBHOOK_SECRET_ENV_VAR)
+        }
+    };
+    webhook_openai_config_1.OpenAIWebhookServiceConfig.assertValidConfig(config);
+    return config;
+}
+let OpenAIWebhookModule = class OpenAIWebhookModule {
+};
+exports.OpenAIWebhookModule = OpenAIWebhookModule;
+exports.OpenAIWebhookModule = OpenAIWebhookModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule, openai_module_1.OpenAIModule],
+        controllers: [webhook_openai_controller_1.OpenAIWebhookController],
+        providers: [
+            {
+                provide: webhook_openai_config_1.OpenAIWebhookServiceConfig,
+                inject: [config_1.ConfigService],
+                useFactory: openAIWebhookServiceConfigFactory
+            },
+            webhook_openai_service_1.OpenAIWebhookService
+        ],
+        exports: [webhook_openai_service_1.OpenAIWebhookService]
+    })
+], OpenAIWebhookModule);
+//# sourceMappingURL=webhook.openai.module.js.map

package/openai/src/lib/webhook/webhook.openai.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.openai.module.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/openai/src/lib/webhook/webhook.openai.module.ts"],"names":[],"mappings":";;;AAQA,8EASC;;AAjBD,2EAAsE;AACtE,2CAAwC;AACxC,qEAAgE;AAChE,mEAAoG;AACpG,2CAA6D;AAE7D,oDAAgD;AAEhD,SAAgB,iCAAiC,CAAC,aAA4B;IAC5E,MAAM,MAAM,GAA+B;QACzC,aAAa,EAAE;YACb,aAAa,EAAE,aAAa,CAAC,GAAG,CAAsB,qDAA6B,CAAwB;SAC5G;KACF,CAAC;IAEF,kDAA0B,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC;AAeM,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;CAAG,CAAA;AAAtB,kDAAmB;8BAAnB,mBAAmB;IAb/B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAY,EAAE,4BAAY,CAAC;QACrC,WAAW,EAAE,CAAC,mDAAuB,CAAC;QACtC,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,kDAA0B;gBACnC,MAAM,EAAE,CAAC,sBAAa,CAAC;gBACvB,UAAU,EAAE,iCAAiC;aAC9C;YACD,6CAAoB;SACrB;QACD,OAAO,EAAE,CAAC,6CAAoB,CAAC;KAChC,CAAC;GACW,mBAAmB,CAAG"}

package/openai/src/lib/webhook/webhook.openai.service.d.ts

@@ -0,0 +1,17 @@
+import { Request } from 'express';
+import { OpenAIWebhookEvent, OpenAIWebhookEventType } from './webhook.openai';
+import { Handler } from '@dereekb/util';
+import { OpenAIWebhookServiceConfig } from './webhook.openai.config';
+import { OpenAIApi } from '../openai.api';
+/**
+ * Service that makes system changes based on OpenAI webhook events.
+ */
+export declare class OpenAIWebhookService {
+    private readonly logger;
+    private readonly _verifier;
+    readonly handler: Handler<OpenAIWebhookEvent, OpenAIWebhookEventType>;
+    readonly configure: import("@dereekb/util").HandlerConfigurer<import("./webhook.openai").OpenAIEventHandlerConfigurer, import("openai/resources/webhooks").UnwrapWebhookEvent, "batch.cancelled" | "batch.completed" | "batch.expired" | "batch.failed" | "eval.run.canceled" | "eval.run.failed" | "eval.run.succeeded" | "fine_tuning.job.cancelled" | "fine_tuning.job.failed" | "fine_tuning.job.succeeded" | "response.cancelled" | "response.completed" | "response.failed" | "response.incomplete", boolean>;
+    constructor(openAiApi: OpenAIApi, openAIWebhookServiceConfig: OpenAIWebhookServiceConfig);
+    updateForWebhook(req: Request, rawBody: Buffer): Promise<void>;
+    updateForOpenAIEvent(event: OpenAIWebhookEvent): Promise<void>;
+}

package/openai/src/lib/webhook/webhook.openai.service.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIWebhookService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const webhook_openai_1 = require("./webhook.openai");
+const webhook_openai_config_1 = require("./webhook.openai.config");
+const openai_api_1 = require("../openai.api");
+const webhook_openai_verify_1 = require("./webhook.openai.verify");
+/**
+ * Service that makes system changes based on OpenAI webhook events.
+ */
+let OpenAIWebhookService = class OpenAIWebhookService {
+    logger = new common_1.Logger('OpenAIWebhookService');
+    _verifier;
+    handler = (0, webhook_openai_1.openaiEventHandlerFactory)();
+    configure = (0, webhook_openai_1.openaiEventHandlerConfigurerFactory)(this.handler);
+    constructor(openAiApi, openAIWebhookServiceConfig) {
+        const { webhookSecret } = openAIWebhookServiceConfig.openaiWebhook;
+        this._verifier = (0, webhook_openai_verify_1.openAIWebhookEventVerifier)({
+            secret: webhookSecret,
+            client: openAiApi.openAIClient
+        });
+    }
+    async updateForWebhook(req, rawBody) {
+        const result = await this._verifier(req, rawBody);
+        if (!result.valid) {
+            this.logger.warn('Received invalid OpenAI event.', req);
+        }
+        else {
+            await this.updateForOpenAIEvent(result.event);
+        }
+    }
+    async updateForOpenAIEvent(event) {
+        const result = await this.handler(event);
+        if (!result) {
+            this.logger.warn('Received unexpected/unhandled OpenAI event.', event);
+        }
+    }
+};
+exports.OpenAIWebhookService = OpenAIWebhookService;
+exports.OpenAIWebhookService = OpenAIWebhookService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(openai_api_1.OpenAIApi)),
+    tslib_1.__param(1, (0, common_1.Inject)(webhook_openai_config_1.OpenAIWebhookServiceConfig)),
+    tslib_1.__metadata("design:paramtypes", [openai_api_1.OpenAIApi, webhook_openai_config_1.OpenAIWebhookServiceConfig])
+], OpenAIWebhookService);
+//# sourceMappingURL=webhook.openai.service.js.map

package/openai/src/lib/webhook/webhook.openai.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.openai.service.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/openai/src/lib/webhook/webhook.openai.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4D;AAE5D,qDAA8I;AAE9I,mEAAqE;AACrE,8CAA0C;AAC1C,mEAAiG;AAEjG;;GAEG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IACd,MAAM,GAAG,IAAI,eAAM,CAAC,sBAAsB,CAAC,CAAC;IAE5C,SAAS,CAA6B;IAE9C,OAAO,GAAwD,IAAA,0CAAyB,GAAE,CAAC;IAC3F,SAAS,GAAG,IAAA,oDAAmC,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvE,YAA+B,SAAoB,EAAsC,0BAAsD;QAC7I,MAAM,EAAE,aAAa,EAAE,GAAG,0BAA0B,CAAC,aAAa,CAAC;QAEnE,IAAI,CAAC,SAAS,GAAG,IAAA,kDAA0B,EAAC;YAC1C,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,SAAS,CAAC,YAAY;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,GAAY,EAAE,OAAe;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,KAA2B,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,KAAyB;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;CACF,CAAA;AAlCY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IASE,mBAAA,IAAA,eAAM,EAAC,sBAAS,CAAC,CAAA;IAAwB,mBAAA,IAAA,eAAM,EAAC,kDAA0B,CAAC,CAAA;6CAA9C,sBAAS,EAAkE,kDAA0B;GARpI,oBAAoB,CAkChC"}

package/openai/src/lib/webhook/webhook.openai.verify.d.ts

@@ -0,0 +1,36 @@
+import { Request } from 'express';
+import { OpenAI } from 'openai';
+import { OpenAIWebhookSecret } from '../openai.type';
+import { Maybe } from '@dereekb/util';
+import { UnwrapWebhookEvent } from 'openai/resources/webhooks';
+export interface OpenAIWebhookEventVerificationConfig {
+    /**
+     * Secret token to use for verification.
+     *
+     * If not defined, uses what is configured in the client.
+     */
+    readonly secret?: OpenAIWebhookSecret;
+    /**
+     * OpenAI client to use for verification.
+     */
+    readonly client: OpenAI;
+}
+export type OpenAIWebhookEventVerificationResult = OpenAIWebhookEventVerificationSuccessResult | OpenAIWebhookEventVerificationErrorResult;
+export interface OpenAIWebhookEventVerificationSuccessResult {
+    readonly valid: true;
+    readonly event: Maybe<UnwrapWebhookEvent>;
+}
+export interface OpenAIWebhookEventVerificationErrorResult {
+    readonly valid: false;
+}
+/**
+ * Function that verifies a OpenAI webhook event.
+ */
+export type OpenAIWebhookEventVerifier = (req: Request, rawBody: Buffer) => Promise<OpenAIWebhookEventVerificationResult>;
+/**
+ * Verifies a OpenAI webhook event header.
+ *
+ * @param vapiSecretTokenGetter The OpenAI secret token. The Vapi client allows for using an AsyncGetterOrValue type, so the verifier supports that as well.
+ * @returns A function that verifies a OpenAI webhook event.
+ */
+export declare function openAIWebhookEventVerifier(config: OpenAIWebhookEventVerificationConfig): OpenAIWebhookEventVerifier;

package/openai/src/lib/webhook/webhook.openai.verify.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openAIWebhookEventVerifier = openAIWebhookEventVerifier;
+const openai_1 = require("openai");
+/**
+ * Verifies a OpenAI webhook event header.
+ *
+ * @param vapiSecretTokenGetter The OpenAI secret token. The Vapi client allows for using an AsyncGetterOrValue type, so the verifier supports that as well.
+ * @returns A function that verifies a OpenAI webhook event.
+ */
+function openAIWebhookEventVerifier(config) {
+    const { secret, client } = config;
+    return async (request, rawBody) => {
+        const headers = request.headers;
+        const requestBodyString = String(request.body);
+        let event;
+        let valid = false;
+        try {
+            event = await client.webhooks.unwrap(requestBodyString, headers, secret);
+            valid = true;
+        }
+        catch (e) {
+            if (e instanceof openai_1.InvalidWebhookSignatureError) {
+                valid = false;
+            }
+            else {
+                throw e;
+            }
+        }
+        const result = {
+            valid,
+            event
+        };
+        return result;
+    };
+}
+//# sourceMappingURL=webhook.openai.verify.js.map

package/openai/src/lib/webhook/webhook.openai.verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.openai.verify.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/openai/src/lib/webhook/webhook.openai.verify.ts"],"names":[],"mappings":";;AAyCA,gEA4BC;AApED,mCAA8D;AAkC9D;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,MAA4C;IACrF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAElC,OAAO,KAAK,EAAE,OAAgB,EAAE,OAAe,EAAE,EAAE;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE/C,IAAI,KAAgC,CAAC;QACrC,IAAI,KAAK,GAAG,KAAK,CAAC;QAElB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACzE,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,qCAA4B,EAAE,CAAC;gBAC9C,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAyC;YACnD,KAAK;YACL,KAAK;SACN,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "type": "commonjs",
   "exports": {
     ".": {
@@ -26,6 +26,12 @@
       "main": "./vapiai/src/index.js",
       "require": "./vapiai/src/index.js",
       "default": "./vapiai/src/index.js"
+    },
+    "./openai": {
+      "types": "./openai/src/index.d.ts",
+      "main": "./openai/src/index.js",
+      "require": "./openai/src/index.js",
+      "default": "./openai/src/index.js"
     }
   },
   "main": "./src/index.js",

package/stripe/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs/stripe",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "type": "commonjs",
   "peerDependencies": {},
   "dependencies": {},

package/vapiai/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs/vapiai",
-  "version": "12.2.0",
+  "version": "12.3.0",
   "type": "commonjs",
   "peerDependencies": {},
   "dependencies": {},

package/vapiai/src/lib/vapiai.type.d.ts

@@ -1,4 +1,4 @@
-import { ChatCostsItem, CallCostsItem, ServerMessageEndOfCallReportCostsItem } from '@vapi-ai/server-sdk/api';
+import { Vapi } from '@vapi-ai/server-sdk';
 /**
  * Secret token used by Vapi.ai for making requests.
  */
@@ -30,8 +30,19 @@ export type VapiApiWebhookEventVerificationType = 'none' | 'secret' | 'hmac';
 /**
  * Cost item used by Vapi.ai.
  */
-export type VapiCostsItem = ChatCostsItem | CallCostsItem | ServerMessageEndOfCallReportCostsItem;
+export type VapiCostsItem = Vapi.ServerMessageEndOfCallReport.Costs.Item;
 /**
  * Assistant id used by Vapi.ai.
  */
 export type VapiAssistantId = string;
+export type VapiTranscript = string;
+export interface VapiTranscriptRef {
+    transcript?: VapiTranscript;
+}
+/**
+ * Call with transcript.
+ *
+ * The Vapi.ai server-sdk does not include the transcript in the call object, so we extend it here.
+ */
+export interface VapiCallWithTranscript extends Vapi.Call, VapiTranscriptRef {
+}

package/vapiai/src/lib/webhook/webhook.vapiai.d.ts

@@ -1,7 +1,6 @@
 import { HandlerBindAccessor, HandlerMappedSetFunction, Handler, Maybe } from '@dereekb/util';
-import '../vapiai.type';
-import { AssistantRequestPayload, EndOfCallReportPayload, FunctionCallPayload, HangPayload, SpeechUpdatePayload, StatusUpdatePayload, TranscriptPayload, VapiPayload, VapiResponse, VapiWebhookEnum } from './webhook.vapiai.types';
-export type VapiAiWebhookEventType = VapiWebhookEnum | string;
+import { AssistantRequestPayload, EndOfCallReportPayload, FunctionCallPayload, HangPayload, SpeechUpdatePayload, StatusUpdatePayload, TranscriptPayload, VapiPayload, VapiPayloadType, VapiResponse } from './webhook.vapiai.types';
+export type VapiAiWebhookEventType = VapiPayloadType | string;
 export interface VapiAiWebhookResult {
     readonly handled: boolean;
     /**
@@ -23,7 +22,7 @@ export type VapiAiWebhookEvent<T extends VapiPayload = VapiPayload, ET extends V
 };
 export type UntypedVapiAiWebhookEvent = VapiAiWebhookEvent;
 /**
- * Creates a ZoomWebhookEvent and treats the data as the input type.
+ * Creates a VapiAiWebhookEvent and treats the data as the input type.
  *
  * @param event
  * @returns

package/vapiai/src/lib/webhook/webhook.vapiai.js

@@ -3,10 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.vapiaiEventHandlerConfigurerFactory = exports.vapiaiEventHandlerFactory = void 0;
 exports.vapiAiWebhookEvent = vapiAiWebhookEvent;
 const util_1 = require("@dereekb/util");
-require("../vapiai.type");
-const webhook_vapiai_types_1 = require("./webhook.vapiai.types");
 /**
- * Creates a ZoomWebhookEvent and treats the data as the input type.
+ * Creates a VapiAiWebhookEvent and treats the data as the input type.
  *
  * @param event
  * @returns
@@ -30,13 +28,13 @@ exports.vapiaiEventHandlerConfigurerFactory = (0, util_1.handlerConfigurerFactor
         const fnWithKey = (0, util_1.handlerMappedSetFunctionFactory)(accessor, vapiAiWebhookEvent);
         const configurer = {
             ...accessor,
-            handleAssistantRequest: fnWithKey(webhook_vapiai_types_1.VapiWebhookEnum.ASSISTANT_REQUEST),
-            handleStatusUpdate: fnWithKey(webhook_vapiai_types_1.VapiWebhookEnum.STATUS_UPDATE),
-            handleFunctionCall: fnWithKey(webhook_vapiai_types_1.VapiWebhookEnum.FUNCTION_CALL),
-            handleEndOfCallReport: fnWithKey(webhook_vapiai_types_1.VapiWebhookEnum.END_OF_CALL_REPORT),
-            handleHang: fnWithKey(webhook_vapiai_types_1.VapiWebhookEnum.HANG),
-            handleSpeechUpdate: fnWithKey(webhook_vapiai_types_1.VapiWebhookEnum.SPEECH_UPDATE),
-            handleTranscript: fnWithKey(webhook_vapiai_types_1.VapiWebhookEnum.TRANSCRIPT)
+            handleAssistantRequest: fnWithKey('assistant-request'),
+            handleStatusUpdate: fnWithKey('status-update'),
+            handleFunctionCall: fnWithKey('function-call'),
+            handleEndOfCallReport: fnWithKey('end-of-call-report'),
+            handleHang: fnWithKey('hang'),
+            handleSpeechUpdate: fnWithKey('speech-update'),
+            handleTranscript: fnWithKey('transcript')
         };
         return configurer;
     }

package/vapiai/src/lib/webhook/webhook.vapiai.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.vapiai.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.ts"],"names":[],"mappings":";;;AAoCA,gDAEC;AAtCD,wCAAyK;AACzK,0BAAwB;AACxB,iEAAoO;AA4BpO;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAwB,KAAgC;IACxF,OAAO,KAA8B,CAAC;AACxC,CAAC;AAIY,QAAA,yBAAyB,GAAG,IAAA,qBAAc,EAAyE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;IAC7I,aAAa,EAAE;QACb,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,SAAS;KACpB;IACD,cAAc,EAAE;QACd,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,SAAS;KACpB;CACF,CAAC,CAAC;AAoBU,QAAA,mCAAmC,GAAG,IAAA,+BAAwB,EAAuG;IAChL,qBAAqB,EAAE,CAAC,QAAqG,EAAE,EAAE;QAC/H,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAA,sCAA+B,EAAmF,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAElK,MAAM,UAAU,GAAiC;YAC/C,GAAG,QAAQ;YACX,sBAAsB,EAAE,SAAS,CAAC,sCAAe,CAAC,iBAAiB,CAAC;YACpE,kBAAkB,EAAE,SAAS,CAAC,sCAAe,CAAC,aAAa,CAAC;YAC5D,kBAAkB,EAAE,SAAS,CAAC,sCAAe,CAAC,aAAa,CAAC;YAC5D,qBAAqB,EAAE,SAAS,CAAC,sCAAe,CAAC,kBAAkB,CAAC;YACpE,UAAU,EAAE,SAAS,CAAC,sCAAe,CAAC,IAAI,CAAC;YAC3C,kBAAkB,EAAE,SAAS,CAAC,sCAAe,CAAC,aAAa,CAAC;YAC5D,gBAAgB,EAAE,SAAS,CAAC,sCAAe,CAAC,UAAU,CAAC;SACxD,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"webhook.vapiai.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.ts"],"names":[],"mappings":";;;AAmCA,gDAEC;AArCD,wCAAyK;AA6BzK;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAwB,KAAgC;IACxF,OAAO,KAA8B,CAAC;AACxC,CAAC;AAIY,QAAA,yBAAyB,GAAG,IAAA,qBAAc,EAAyE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;IAC7I,aAAa,EAAE;QACb,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,SAAS;KACpB;IACD,cAAc,EAAE;QACd,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,SAAS;KACpB;CACF,CAAC,CAAC;AAoBU,QAAA,mCAAmC,GAAG,IAAA,+BAAwB,EAAuG;IAChL,qBAAqB,EAAE,CAAC,QAAqG,EAAE,EAAE;QAC/H,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAA,sCAA+B,EAAmF,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAElK,MAAM,UAAU,GAAiC;YAC/C,GAAG,QAAQ;YACX,sBAAsB,EAAE,SAAS,CAAC,mBAAmB,CAAC;YACtD,kBAAkB,EAAE,SAAS,CAAC,eAAe,CAAC;YAC9C,kBAAkB,EAAE,SAAS,CAAC,eAAe,CAAC;YAC9C,qBAAqB,EAAE,SAAS,CAAC,oBAAoB,CAAC;YACtD,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC;YAC7B,kBAAkB,EAAE,SAAS,CAAC,eAAe,CAAC;YAC9C,gBAAgB,EAAE,SAAS,CAAC,YAAY,CAAC;SAC1C,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}

package/vapiai/src/lib/webhook/webhook.vapiai.types.d.ts

@@ -1,102 +1,65 @@
 import { DollarAmount, ISO8601DateStringUTCFull, JSONEncodedString, UnixDateTimeNumber, WebsiteUrlWithPrefix } from '@dereekb/util';
-import { Analysis, Artifact, Assistant, Call, CallEndedReason, CallStatus, ChatMessagesItem, CostBreakdown } from '@vapi-ai/server-sdk/api';
-import { VapiAssistantId, VapiCostsItem } from '../vapiai.type';
-export declare enum VapiWebhookEnum {
-    ASSISTANT_REQUEST = "assistant-request",
-    FUNCTION_CALL = "function-call",
-    STATUS_UPDATE = "status-update",
-    END_OF_CALL_REPORT = "end-of-call-report",
-    HANG = "hang",
-    /**
-     * @deprecated needs documentation link
-     */
-    SPEECH_UPDATE = "speech-update",
-    /**
-     * @deprecated needs documentation link
-     */
-    TRANSCRIPT = "transcript"
-}
+import { VapiAssistantId, VapiCostsItem, VapiTranscriptRef } from '../vapiai.type';
+import { Vapi } from '@vapi-ai/server-sdk';
+export type BaseVapiPayloadCall = Required<Pick<Vapi.Call, 'id' | 'orgId' | 'createdAt' | 'updatedAt' | 'type' | 'monitor' | 'transport' | 'status' | 'assistantId' | 'assistantOverrides'>>;
 interface BaseVapiPayload {
-    readonly call: Call;
+    readonly call: BaseVapiPayloadCall & Partial<Vapi.Call>;
 }
 /**
  * Assistant request event payload
  *
  * https://docs.vapi.ai/server-url/events#retrieving-assistants
  */
-export interface AssistantRequestPayload extends BaseVapiPayload {
-    readonly type: VapiWebhookEnum.ASSISTANT_REQUEST;
-}
+export type AssistantRequestPayload = BaseVapiPayload & Omit<Vapi.ServerMessageAssistantRequest, 'call'>;
 /**
  * Status update event payload
  *
  * https://docs.vapi.ai/server-url/events#call-status-updates
  */
-export interface StatusUpdatePayload extends BaseVapiPayload {
-    readonly type: VapiWebhookEnum.STATUS_UPDATE;
-    readonly status: CallStatus;
-}
+export type StatusUpdatePayload = BaseVapiPayload & Omit<Vapi.ServerMessageStatusUpdate, 'call'>;
 /**
  * Function call event payload
  *
  * https://docs.vapi.ai/server-url/events#function-calling
  */
 export interface FunctionCallPayload extends BaseVapiPayload {
-    readonly type: VapiWebhookEnum.FUNCTION_CALL;
-    readonly functionCall: {
-        readonly name: string;
-        readonly parameters: JSONEncodedString;
-    };
+    readonly type: 'function-call';
+    readonly functionCall: Vapi.FunctionCall;
 }
 /**
  * End of call report event payload
  *
  * https://docs.vapi.ai/server-url/events#end-of-call-report
  */
-export interface EndOfCallReportPayload extends BaseVapiPayload {
-    readonly type: VapiWebhookEnum.END_OF_CALL_REPORT;
+export interface EndOfCallReportPayload extends BaseVapiPayload, Omit<Vapi.ServerMessageEndOfCallReport, 'call'>, VapiTranscriptRef {
     readonly timestamp: UnixDateTimeNumber;
-    readonly analysis: Analysis;
-    readonly artifact: Artifact;
     readonly startedAt: ISO8601DateStringUTCFull;
     readonly endedAt: ISO8601DateStringUTCFull;
-    readonly endedReason: CallEndedReason;
     readonly cost: DollarAmount;
-    readonly costBreakdown: CostBreakdown;
+    readonly costBreakdown: Vapi.CostBreakdown;
     readonly costs: VapiCostsItem[];
     readonly transcript: string;
-    readonly messages: ChatMessagesItem[];
+    readonly messages: Vapi.Chat.Messages.Item[];
     readonly summary: string;
     readonly recordingUrl?: WebsiteUrlWithPrefix;
     readonly stereoRecordingUrl?: WebsiteUrlWithPrefix;
-    readonly assistant: Assistant;
 }
 /**
  * Hang event payload
  *
  * https://docs.vapi.ai/server-url/events#hang-notifications
  */
-export interface HangPayload extends BaseVapiPayload {
-    readonly type: VapiWebhookEnum.HANG;
-}
+export type HangPayload = BaseVapiPayload & Omit<Vapi.ServerMessageHang, 'call'>;
 /**
  * @deprecated needs documentation link
  */
-export interface SpeechUpdatePayload extends BaseVapiPayload {
-    readonly type: VapiWebhookEnum.SPEECH_UPDATE;
-    readonly status: 'started' | 'stopped';
-    readonly role: 'assistant' | 'user';
-}
+export type SpeechUpdatePayload = BaseVapiPayload & Omit<Vapi.ServerMessageSpeechUpdate, 'call'>;
 /**
  * @deprecated needs documentation link
  */
-export interface TranscriptPayload {
-    readonly type: VapiWebhookEnum.TRANSCRIPT;
-    readonly role: 'assistant' | 'user';
-    readonly transcriptType: 'partial' | 'final';
-    readonly transcript: string;
-}
+export type TranscriptPayload = BaseVapiPayload & Omit<Vapi.ServerMessageTranscript, 'call'>;
 export type VapiPayload = AssistantRequestPayload | StatusUpdatePayload | FunctionCallPayload | EndOfCallReportPayload | SpeechUpdatePayload | TranscriptPayload | HangPayload;
+export type VapiPayloadType = VapiPayload['type'];
 /**
  * Response returned when a function is called.
  *
@@ -116,7 +79,7 @@ export interface AssistantRequestMessageSuccessIdResponse {
     readonly assistantId: VapiAssistantId;
 }
 export interface AssistantRequestMessageSuccessObjectResponse {
-    readonly assistant: Assistant;
+    readonly assistant: Vapi.Assistant;
 }
 export interface AssistantRequestMessageErrorResponse {
     readonly error?: string;
@@ -131,4 +94,22 @@ export type TranscriptMessageResponse = VapiVoidResponse;
 export type HangMessageResponse = VapiVoidResponse;
 export type EndOfCallReportMessageResponse = VapiVoidResponse;
 export type VapiResponse = AssistantRequestMessageResponse | FunctionCallMessageResponse | EndOfCallReportMessageResponse | HangMessageResponse | StatusUpdateMessageResponse | SpeechUpdateMessageResponse | TranscriptMessageResponse;
+/**
+ * @deprecated use VapiWebhookPayloadType instead.
+ */
+export declare enum VapiWebhookEnum {
+    ASSISTANT_REQUEST = "assistant-request",
+    FUNCTION_CALL = "function-call",
+    STATUS_UPDATE = "status-update",
+    END_OF_CALL_REPORT = "end-of-call-report",
+    HANG = "hang",
+    /**
+     * @deprecated needs documentation link
+     */
+    SPEECH_UPDATE = "speech-update",
+    /**
+     * @deprecated needs documentation link
+     */
+    TRANSCRIPT = "transcript"
+}
 export {};

package/vapiai/src/lib/webhook/webhook.vapiai.types.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VapiWebhookEnum = void 0;
+// MARK: Compat
+/**
+ * @deprecated use VapiWebhookPayloadType instead.
+ */
 var VapiWebhookEnum;
 (function (VapiWebhookEnum) {
     VapiWebhookEnum["ASSISTANT_REQUEST"] = "assistant-request";

package/vapiai/src/lib/webhook/webhook.vapiai.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhook.vapiai.types.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.types.ts"],"names":[],"mappings":";;;AAIA,IAAY,eAeX;AAfD,WAAY,eAAe;IACzB,0DAAuC,CAAA;IACvC,kDAA+B,CAAA;IAC/B,kDAA+B,CAAA;IAC/B,4DAAyC,CAAA;IACzC,gCAAa,CAAA;IACb,yGAAyG;IACzG;;OAEG;IACH,kDAA+B,CAAA;IAC/B;;OAEG;IACH,4CAAyB,CAAA;AAC3B,CAAC,EAfW,eAAe,+BAAf,eAAe,QAe1B"}
+{"version":3,"file":"webhook.vapiai.types.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.types.ts"],"names":[],"mappings":";;;AAoHA,eAAe;AAEf;;GAEG;AACH,IAAY,eAeX;AAfD,WAAY,eAAe;IACzB,0DAAuC,CAAA;IACvC,kDAA+B,CAAA;IAC/B,kDAA+B,CAAA;IAC/B,4DAAyC,CAAA;IACzC,gCAAa,CAAA;IACb,yGAAyG;IACzG;;OAEG;IACH,kDAA+B,CAAA;IAC/B;;OAEG;IACH,4CAAyB,CAAA;AAC3B,CAAC,EAfW,eAAe,+BAAf,eAAe,QAe1B"}