@dereekb/nestjs 12.1.13 → 12.2.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [12.2.0](https://github.com/dereekb/dbx-components/compare/v12.1.14-dev...v12.2.0) (2025-06-29)
+
+
+### Features
+
+* added vapi.ai integration ([c06f5e8](https://github.com/dereekb/dbx-components/commit/c06f5e886369ad5da2712b667346b5cbf7161845))
+
+
+
+## [12.1.14](https://github.com/dereekb/dbx-components/compare/v12.1.13-dev...v12.1.14) (2025-06-27)
+
+
+
 ## [12.1.13](https://github.com/dereekb/dbx-components/compare/v12.1.12-dev...v12.1.13) (2025-06-23)
 
 

package/mailgun/package.json

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

package/package.json

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

package/stripe/package.json

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

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

@@ -42,7 +42,7 @@ export type StripeCheckoutSessionEventDataObject = Stripe.TypedEventDataObject<S
 export type StripeCustomerSubscriptionEventDataObject = Stripe.TypedEventDataObject<Stripe.Subscription>;
 export type StripeSubscriptionScheduleEventDataObject = Stripe.TypedEventDataObject<Stripe.SubscriptionSchedule>;
 export type StripeEventHandler = Handler<Stripe.Event, string>;
-export declare const stripeEventHandlerFactory: import("@dereekb/util").HandlerFactory<Stripe.Event, string>;
+export declare const stripeEventHandlerFactory: import("@dereekb/util").HandlerFactory<Stripe.Event, string, boolean>;
 export type StripeHandlerMappedSetFunction<T> = HandlerMappedSetFunction<StripeWebhookEvent<T>>;
 export interface StripeEventHandlerConfigurer extends HandlerBindAccessor<Stripe.Event, string> {
     readonly handleCheckoutSessionComplete: StripeHandlerMappedSetFunction<StripeCheckoutSessionEventDataObject>;
@@ -59,4 +59,4 @@ export interface StripeEventHandlerConfigurer extends HandlerBindAccessor<Stripe
     readonly handleSubscriptionScheduleReleased: StripeHandlerMappedSetFunction<StripeSubscriptionScheduleEventDataObject>;
     readonly handleSubscriptionScheduleUpdated: StripeHandlerMappedSetFunction<StripeSubscriptionScheduleEventDataObject>;
 }
-export declare const stripeEventHandlerConfigurerFactory: import("@dereekb/util").HandlerConfigurerFactory<StripeEventHandlerConfigurer, Stripe.Event, string>;
+export declare const stripeEventHandlerConfigurerFactory: import("@dereekb/util").HandlerConfigurerFactory<StripeEventHandlerConfigurer, Stripe.Event, string, boolean>;

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

@@ -9,7 +9,7 @@ export declare class StripeWebhookService {
     private readonly logger;
     private readonly _stripeApi;
     readonly handler: Handler<Stripe.Event>;
-    readonly configure: import("@dereekb/util").HandlerConfigurer<import("./webhook.stripe").StripeEventHandlerConfigurer, Stripe.Event, string>;
+    readonly configure: import("@dereekb/util").HandlerConfigurer<import("./webhook.stripe").StripeEventHandlerConfigurer, Stripe.Event, string, boolean>;
     constructor(stripeApi: StripeApi);
     updateForWebhook(req: Request, rawBody: Buffer): Promise<boolean>;
     updateForStripeEvent(event: Stripe.Event): Promise<boolean>;

package/vapiai/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/vapiai/package.json

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

package/vapiai/src/index.d.ts

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

package/vapiai/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/vapiai/src/index.js.map

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

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

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

package/vapiai/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("./vapiai.module"), exports);
+tslib_1.__exportStar(require("./vapiai.api"), exports);
+tslib_1.__exportStar(require("./vapiai.module"), exports);
+tslib_1.__exportStar(require("./vapiai.config"), exports);
+tslib_1.__exportStar(require("./vapiai.type"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,7 @@
+import { VapiClient } from '@vapi-ai/server-sdk';
+import { VapiAiServiceConfig } from './vapiai.config';
+export declare class VapiAiApi {
+    readonly config: VapiAiServiceConfig;
+    readonly vapiClient: VapiClient;
+    constructor(config: VapiAiServiceConfig);
+}

package/vapiai/src/lib/vapiai.api.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiAiApi = void 0;
+const tslib_1 = require("tslib");
+const server_sdk_1 = require("@vapi-ai/server-sdk");
+const common_1 = require("@nestjs/common");
+const vapiai_config_1 = require("./vapiai.config");
+let VapiAiApi = class VapiAiApi {
+    config;
+    vapiClient;
+    constructor(config) {
+        this.config = config;
+        this.vapiClient = new server_sdk_1.VapiClient(config.vapiai.config);
+    }
+};
+exports.VapiAiApi = VapiAiApi;
+exports.VapiAiApi = VapiAiApi = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(vapiai_config_1.VapiAiServiceConfig)),
+    tslib_1.__metadata("design:paramtypes", [vapiai_config_1.VapiAiServiceConfig])
+], VapiAiApi);
+//# sourceMappingURL=vapiai.api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vapiai.api.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/vapiai/src/lib/vapiai.api.ts"],"names":[],"mappings":";;;;AAAA,oDAAiD;AACjD,2CAAoD;AACpD,mDAAsD;AAG/C,IAAM,SAAS,GAAf,MAAM,SAAS;IAG8B;IAFzC,UAAU,CAAa;IAEhC,YAAkD,MAA2B;QAA3B,WAAM,GAAN,MAAM,CAAqB;QAC3E,IAAI,CAAC,UAAU,GAAG,IAAI,uBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzD,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/vapiai/src/lib/vapiai.config.d.ts

@@ -0,0 +1,12 @@
+import { VapiClient } from '@vapi-ai/server-sdk';
+export declare const VAPI_AI_SECRET_TOKEN_ENV_VAR = "VAPI_AI_SECRET_TOKEN";
+export interface VapiAiServiceApiConfig {
+    readonly config: VapiClient.Options;
+}
+/**
+ * Configuration for VapiAiService
+ */
+export declare abstract class VapiAiServiceConfig {
+    readonly vapiai: VapiAiServiceApiConfig;
+    static assertValidConfig(config: VapiAiServiceConfig): void;
+}

package/vapiai/src/lib/vapiai.config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiAiServiceConfig = exports.VAPI_AI_SECRET_TOKEN_ENV_VAR = void 0;
+exports.VAPI_AI_SECRET_TOKEN_ENV_VAR = 'VAPI_AI_SECRET_TOKEN';
+/**
+ * Configuration for VapiAiService
+ */
+class VapiAiServiceConfig {
+    vapiai;
+    static assertValidConfig(config) {
+        if (!config.vapiai.config.token) {
+            throw new Error('No Vapi.ai secret/token specified.');
+        }
+    }
+}
+exports.VapiAiServiceConfig = VapiAiServiceConfig;
+//# sourceMappingURL=vapiai.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vapiai.config.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/vapiai/src/lib/vapiai.config.ts"],"names":[],"mappings":";;;AAEa,QAAA,4BAA4B,GAAG,sBAAsB,CAAC;AAMnE;;GAEG;AACH,MAAsB,mBAAmB;IAC9B,MAAM,CAA0B;IAEzC,MAAM,CAAC,iBAAiB,CAAC,MAA2B;QAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF;AARD,kDAQC"}

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

@@ -0,0 +1,5 @@
+import { ConfigService } from '@nestjs/config';
+import { VapiAiServiceConfig } from './vapiai.config';
+export declare function vapiaiServiceConfigFactory(configService: ConfigService): VapiAiServiceConfig;
+export declare class VapiAiModule {
+}

package/vapiai/src/lib/vapiai.module.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiAiModule = void 0;
+exports.vapiaiServiceConfigFactory = vapiaiServiceConfigFactory;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const vapiai_api_1 = require("./vapiai.api");
+const vapiai_config_1 = require("./vapiai.config");
+function vapiaiServiceConfigFactory(configService) {
+    const config = {
+        vapiai: {
+            config: {
+                token: configService.get(vapiai_config_1.VAPI_AI_SECRET_TOKEN_ENV_VAR)
+            }
+        }
+    };
+    vapiai_config_1.VapiAiServiceConfig.assertValidConfig(config);
+    return config;
+}
+let VapiAiModule = class VapiAiModule {
+};
+exports.VapiAiModule = VapiAiModule;
+exports.VapiAiModule = VapiAiModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule],
+        providers: [
+            {
+                provide: vapiai_config_1.VapiAiServiceConfig,
+                inject: [config_1.ConfigService],
+                useFactory: vapiaiServiceConfigFactory
+            },
+            vapiai_api_1.VapiAiApi
+        ],
+        exports: [vapiai_api_1.VapiAiApi]
+    })
+], VapiAiModule);
+//# sourceMappingURL=vapiai.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vapiai.module.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/vapiai/src/lib/vapiai.module.ts"],"names":[],"mappings":";;;AAMA,gEAWC;;AAjBD,2CAAwC;AACxC,2CAA6D;AAC7D,6CAAyC;AACzC,mDAAoF;AAGpF,SAAgB,0BAA0B,CAAC,aAA4B;IACrE,MAAM,MAAM,GAAwB;QAClC,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,KAAK,EAAE,aAAa,CAAC,GAAG,CAAoB,4CAA4B,CAAsB;aAC/F;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/vapiai/src/lib/vapiai.type.d.ts

@@ -0,0 +1,37 @@
+import { ChatCostsItem, CallCostsItem, ServerMessageEndOfCallReportCostsItem } from '@vapi-ai/server-sdk/api';
+/**
+ * Secret token used by Vapi.ai for making requests.
+ */
+export type VapiAiSecretToken = string;
+/**
+ * Secret token used by Vapi.ai for validating webhook events.
+ */
+export type VapiAiWebhookSecretToken = string;
+/**
+ * Type of verification to use for validating webhook events.
+ *
+ * none:
+ * - no verification is performed
+ *
+ * secret:
+ * - uses the x-vapi-secret header to verify the webhook event by comparing it to the secret
+ *
+ * hmac:
+ * - uses a secret key along with HMAC to verify the webhook event. Requires configuration!
+ * - must configure the hmac setup in the Vapi.ai console at https://dashboard.vapi.ai/settings/integrations
+ * -- supply a secret token, but keep all other settings as default
+ * --- defaults:
+ * ---- signature header: x-signature
+ * ---- timestamp header: x-timestamp
+ * ---- payload format: {timestamp}.{body}
+ * ---- signature encoding: hex
+ */
+export type VapiApiWebhookEventVerificationType = 'none' | 'secret' | 'hmac';
+/**
+ * Cost item used by Vapi.ai.
+ */
+export type VapiCostsItem = ChatCostsItem | CallCostsItem | ServerMessageEndOfCallReportCostsItem;
+/**
+ * Assistant id used by Vapi.ai.
+ */
+export type VapiAssistantId = string;

package/vapiai/src/lib/vapiai.type.js

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

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

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

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

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

package/vapiai/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.vapiai"), exports);
+tslib_1.__exportStar(require("./webhook.vapiai.controller"), exports);
+tslib_1.__exportStar(require("./webhook.vapiai.module"), exports);
+tslib_1.__exportStar(require("./webhook.vapiai.service"), exports);
+tslib_1.__exportStar(require("./webhook.vapiai.types"), exports);
+tslib_1.__exportStar(require("./webhook.vapiai.verify"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { VapiApiWebhookEventVerificationConfig } from './webhook.vapiai.verify';
+export declare const VAPI_AI_WEBHOOK_SECRET_TOKEN_ENV_VAR = "VAPI_AI_WEBHOOK_SECRET_TOKEN";
+export declare const VAPI_AI_WEBHOOK_HMAC_SECRET_TOKEN_ENV_VAR = "VAPI_AI_WEBHOOK_HMAC_SECRET_TOKEN";
+export declare const VAPI_AI_WEBHOOK_SECRET_VERIFICATION_TYPE_ENV_VAR = "VAPI_AI_WEBHOOK_SECRET_VERIFICATION_TYPE";
+export declare const VAPI_AI_WEBHOOK_SIGNATURE_PREFIX_ENV_VAR = "VAPI_AI_WEBHOOK_SIGNATURE_PREFIX";
+export type VapiAiWebhookConfig = VapiApiWebhookEventVerificationConfig;
+/**
+ * Configuration for VapiAiService
+ */
+export declare abstract class VapiAiWebhookServiceConfig {
+    readonly webhookConfig: VapiAiWebhookConfig;
+    static assertValidConfig(config: VapiAiWebhookServiceConfig): void;
+}

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiAiWebhookServiceConfig = exports.VAPI_AI_WEBHOOK_SIGNATURE_PREFIX_ENV_VAR = exports.VAPI_AI_WEBHOOK_SECRET_VERIFICATION_TYPE_ENV_VAR = exports.VAPI_AI_WEBHOOK_HMAC_SECRET_TOKEN_ENV_VAR = exports.VAPI_AI_WEBHOOK_SECRET_TOKEN_ENV_VAR = void 0;
+exports.VAPI_AI_WEBHOOK_SECRET_TOKEN_ENV_VAR = 'VAPI_AI_WEBHOOK_SECRET_TOKEN';
+exports.VAPI_AI_WEBHOOK_HMAC_SECRET_TOKEN_ENV_VAR = 'VAPI_AI_WEBHOOK_HMAC_SECRET_TOKEN';
+exports.VAPI_AI_WEBHOOK_SECRET_VERIFICATION_TYPE_ENV_VAR = 'VAPI_AI_WEBHOOK_SECRET_VERIFICATION_TYPE';
+exports.VAPI_AI_WEBHOOK_SIGNATURE_PREFIX_ENV_VAR = 'VAPI_AI_WEBHOOK_SIGNATURE_PREFIX';
+/**
+ * Configuration for VapiAiService
+ */
+class VapiAiWebhookServiceConfig {
+    webhookConfig;
+    static assertValidConfig(config) {
+        if (!config.webhookConfig.secret && !config.webhookConfig.hmacSecret) {
+            throw new Error('No Vapi.ai webhook secret token specified.');
+        }
+    }
+}
+exports.VapiAiWebhookServiceConfig = VapiAiWebhookServiceConfig;
+//# sourceMappingURL=webhook.vapi.config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.vapi.config.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapi.config.ts"],"names":[],"mappings":";;;AAEa,QAAA,oCAAoC,GAAG,8BAA8B,CAAC;AACtE,QAAA,yCAAyC,GAAG,mCAAmC,CAAC;AAChF,QAAA,gDAAgD,GAAG,0CAA0C,CAAC;AAC9F,QAAA,wCAAwC,GAAG,kCAAkC,CAAC;AAI3F;;GAEG;AACH,MAAsB,0BAA0B;IACrC,aAAa,CAAuB;IAE7C,MAAM,CAAC,iBAAiB,CAAC,MAAkC;QACzD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF;AARD,gEAQC"}

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

@@ -0,0 +1,8 @@
+import { RawBodyBuffer } from '@dereekb/nestjs';
+import { Request, Response } from 'express';
+import { VapiAiWebhookService } from './webhook.vapiai.service';
+export declare class VapiAiWebhookController {
+    private readonly _vapiaiWebhookService;
+    constructor(vapiaiWebhookService: VapiAiWebhookService);
+    handleVapiAiWebhook(res: Response, req: Request, rawBody: RawBodyBuffer): Promise<void>;
+}

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiAiWebhookController = void 0;
+const tslib_1 = require("tslib");
+const nestjs_1 = require("@dereekb/nestjs");
+const common_1 = require("@nestjs/common");
+const webhook_vapiai_service_1 = require("./webhook.vapiai.service");
+let VapiAiWebhookController = class VapiAiWebhookController {
+    _vapiaiWebhookService;
+    constructor(vapiaiWebhookService) {
+        this._vapiaiWebhookService = vapiaiWebhookService;
+    }
+    async handleVapiAiWebhook(res, req, rawBody) {
+        const { valid, response: responseData } = await this._vapiaiWebhookService.updateForWebhook(req, rawBody);
+        const response = res.status(200); // always return a 200 status code
+        if (valid && responseData) {
+            response.json(responseData);
+        }
+        else {
+            response.json({});
+        }
+    }
+};
+exports.VapiAiWebhookController = VapiAiWebhookController;
+tslib_1.__decorate([
+    (0, common_1.Post)(),
+    tslib_1.__param(0, (0, common_1.Res)()),
+    tslib_1.__param(1, (0, common_1.Req)()),
+    tslib_1.__param(2, (0, nestjs_1.RawBody)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], VapiAiWebhookController.prototype, "handleVapiAiWebhook", null);
+exports.VapiAiWebhookController = VapiAiWebhookController = tslib_1.__decorate([
+    (0, common_1.Controller)('/webhook/vapiai'),
+    tslib_1.__metadata("design:paramtypes", [webhook_vapiai_service_1.VapiAiWebhookService])
+], VapiAiWebhookController);
+//# sourceMappingURL=webhook.vapiai.controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.vapiai.controller.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.controller.ts"],"names":[],"mappings":";;;;AAAA,4CAAyD;AACzD,2CAA4D;AAE5D,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,GAAa,EAAS,GAAY,EAAa,OAAsB;QACpG,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE1G,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,kCAAkC;QAEpE,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;CACF,CAAA;AAnBY,0DAAuB;AAQ5B;IADL,IAAA,aAAI,GAAE;IACoB,mBAAA,IAAA,YAAG,GAAE,CAAA;IAAiB,mBAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,mBAAA,IAAA,gBAAO,GAAE,CAAA;;;;kEAU9E;kCAlBU,uBAAuB;IADnC,IAAA,mBAAU,EAAC,iBAAiB,CAAC;6CAIM,6CAAoB;GAH3C,uBAAuB,CAmBnC"}

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

@@ -0,0 +1,50 @@
+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;
+export interface VapiAiWebhookResult {
+    readonly handled: boolean;
+    /**
+     * Response to return to the vapi server.
+     */
+    readonly response?: VapiResponse;
+}
+export interface RawVapiAiWebhookEvent {
+    readonly message: UntypedVapiAiWebhookEvent;
+}
+/**
+ * A parsed VapiWebhookEventType that contains the relevant data and the original event.
+ */
+export type VapiAiWebhookEvent<T extends VapiPayload = VapiPayload, ET extends VapiAiWebhookEventType = VapiAiWebhookEventType> = T & {
+    /**
+     * The event type
+     */
+    readonly type: ET;
+};
+export type UntypedVapiAiWebhookEvent = VapiAiWebhookEvent;
+/**
+ * Creates a ZoomWebhookEvent and treats the data as the input type.
+ *
+ * @param event
+ * @returns
+ */
+export declare function vapiAiWebhookEvent<T extends VapiPayload>(event: UntypedVapiAiWebhookEvent): VapiAiWebhookEvent<T>;
+export type VapiAiEventHandler = Handler<UntypedVapiAiWebhookEvent, VapiAiWebhookEventType>;
+export declare const vapiaiEventHandlerFactory: import("@dereekb/util").HandlerFactory<UntypedVapiAiWebhookEvent, string, VapiAiWebhookResult>;
+export type VapiAiHandlerMappedSetFunction<T extends VapiPayload> = HandlerMappedSetFunction<VapiAiWebhookEvent<T>, Maybe<VapiAiWebhookResult>>;
+export interface VapiAiEventHandlerConfigurer extends HandlerBindAccessor<UntypedVapiAiWebhookEvent, VapiAiWebhookEventType, VapiAiWebhookResult> {
+    readonly handleAssistantRequest: VapiAiHandlerMappedSetFunction<AssistantRequestPayload>;
+    readonly handleStatusUpdate: VapiAiHandlerMappedSetFunction<StatusUpdatePayload>;
+    readonly handleFunctionCall: VapiAiHandlerMappedSetFunction<FunctionCallPayload>;
+    readonly handleEndOfCallReport: VapiAiHandlerMappedSetFunction<EndOfCallReportPayload>;
+    readonly handleHang: VapiAiHandlerMappedSetFunction<HangPayload>;
+    /**
+     * @deprecated
+     */
+    readonly handleSpeechUpdate: VapiAiHandlerMappedSetFunction<SpeechUpdatePayload>;
+    /**
+     * @deprecated
+     */
+    readonly handleTranscript: VapiAiHandlerMappedSetFunction<TranscriptPayload>;
+}
+export declare const vapiaiEventHandlerConfigurerFactory: import("@dereekb/util").HandlerConfigurerFactory<VapiAiEventHandlerConfigurer, UntypedVapiAiWebhookEvent, string, VapiAiWebhookResult>;

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

@@ -0,0 +1,44 @@
+"use strict";
+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.
+ *
+ * @param event
+ * @returns
+ */
+function vapiAiWebhookEvent(event) {
+    return event;
+}
+exports.vapiaiEventHandlerFactory = (0, util_1.handlerFactory)((x) => x.type, {
+    defaultResult: {
+        handled: true,
+        response: undefined
+    },
+    negativeResult: {
+        handled: true,
+        response: undefined
+    }
+});
+exports.vapiaiEventHandlerConfigurerFactory = (0, util_1.handlerConfigurerFactory)({
+    configurerForAccessor: (accessor) => {
+        // eslint-disable-next-line
+        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)
+        };
+        return configurer;
+    }
+});
+//# sourceMappingURL=webhook.vapiai.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+import { VapiAiWebhookServiceConfig } from './webhook.vapi.config';
+import { ConfigService } from '@nestjs/config';
+export declare function vapiaiWebhookServiceConfigFactory(configService: ConfigService): VapiAiWebhookServiceConfig;
+export declare class VapiAiWebhookModule {
+}

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

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiAiWebhookModule = void 0;
+exports.vapiaiWebhookServiceConfigFactory = vapiaiWebhookServiceConfigFactory;
+const tslib_1 = require("tslib");
+const webhook_vapiai_controller_1 = require("./webhook.vapiai.controller");
+const common_1 = require("@nestjs/common");
+const webhook_vapiai_service_1 = require("./webhook.vapiai.service");
+const webhook_vapi_config_1 = require("./webhook.vapi.config");
+const config_1 = require("@nestjs/config");
+function vapiaiWebhookServiceConfigFactory(configService) {
+    const config = {
+        webhookConfig: {
+            secret: configService.get(webhook_vapi_config_1.VAPI_AI_WEBHOOK_SECRET_TOKEN_ENV_VAR),
+            hmacSecret: configService.get(webhook_vapi_config_1.VAPI_AI_WEBHOOK_HMAC_SECRET_TOKEN_ENV_VAR),
+            verificationType: configService.get(webhook_vapi_config_1.VAPI_AI_WEBHOOK_SECRET_VERIFICATION_TYPE_ENV_VAR),
+            signaturePrefix: configService.get(webhook_vapi_config_1.VAPI_AI_WEBHOOK_SIGNATURE_PREFIX_ENV_VAR)
+        }
+    };
+    webhook_vapi_config_1.VapiAiWebhookServiceConfig.assertValidConfig(config);
+    return config;
+}
+let VapiAiWebhookModule = class VapiAiWebhookModule {
+};
+exports.VapiAiWebhookModule = VapiAiWebhookModule;
+exports.VapiAiWebhookModule = VapiAiWebhookModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        imports: [config_1.ConfigModule],
+        controllers: [webhook_vapiai_controller_1.VapiAiWebhookController],
+        providers: [
+            {
+                provide: webhook_vapi_config_1.VapiAiWebhookServiceConfig,
+                inject: [config_1.ConfigService],
+                useFactory: vapiaiWebhookServiceConfigFactory
+            },
+            webhook_vapiai_service_1.VapiAiWebhookService
+        ],
+        exports: [webhook_vapiai_service_1.VapiAiWebhookService]
+    })
+], VapiAiWebhookModule);
+//# sourceMappingURL=webhook.vapiai.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.vapiai.module.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.module.ts"],"names":[],"mappings":";;;AAOA,8EAYC;;AAnBD,2EAAsE;AACtE,2CAAwC;AACxC,qEAAgE;AAChE,+DAAgP;AAChP,2CAA6D;AAG7D,SAAgB,iCAAiC,CAAC,aAA4B;IAC5E,MAAM,MAAM,GAA+B;QACzC,aAAa,EAAE;YACb,MAAM,EAAE,aAAa,CAAC,GAAG,CAAgC,0DAAoC,CAAC;YAC9F,UAAU,EAAE,aAAa,CAAC,GAAG,CAAgC,+DAAyC,CAAC;YACvG,gBAAgB,EAAE,aAAa,CAAC,GAAG,CAAkD,sEAAgD,CAAC;YACtI,eAAe,EAAE,aAAa,CAAC,GAAG,CAAqB,8DAAwC,CAAC;SACjG;KACF,CAAC;IAEF,gDAA0B,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,CAAC;QACvB,WAAW,EAAE,CAAC,mDAAuB,CAAC;QACtC,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,gDAA0B;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/vapiai/src/lib/webhook/webhook.vapiai.service.d.ts

@@ -0,0 +1,20 @@
+import { Request } from 'express';
+import { UntypedVapiAiWebhookEvent, VapiAiWebhookEvent, VapiAiWebhookEventType, VapiAiWebhookResult } from './webhook.vapiai';
+import { Handler } from '@dereekb/util';
+import { VapiAiWebhookServiceConfig } from './webhook.vapi.config';
+export interface UpdateForVapiAiWebhookResponse extends VapiAiWebhookResult {
+    readonly valid: boolean;
+    readonly event: UntypedVapiAiWebhookEvent;
+}
+/**
+ * Service that makes system changes based on VapiAi webhook events.
+ */
+export declare class VapiAiWebhookService {
+    private readonly logger;
+    private readonly _verifier;
+    readonly handler: Handler<VapiAiWebhookEvent, VapiAiWebhookEventType, VapiAiWebhookResult>;
+    readonly configure: import("@dereekb/util").HandlerConfigurer<import("./webhook.vapiai").VapiAiEventHandlerConfigurer, UntypedVapiAiWebhookEvent, string, VapiAiWebhookResult>;
+    constructor(vapiAiWebhookServiceConfig: VapiAiWebhookServiceConfig);
+    updateForWebhook(req: Request, rawBody: Buffer): Promise<UpdateForVapiAiWebhookResponse>;
+    updateForVapiAiEvent(event: UntypedVapiAiWebhookEvent): Promise<VapiAiWebhookResult>;
+}

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiAiWebhookService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const webhook_vapiai_1 = require("./webhook.vapiai");
+const webhook_vapiai_verify_1 = require("./webhook.vapiai.verify");
+const webhook_vapi_config_1 = require("./webhook.vapi.config");
+/**
+ * Service that makes system changes based on VapiAi webhook events.
+ */
+let VapiAiWebhookService = class VapiAiWebhookService {
+    logger = new common_1.Logger('VapiAiWebhookService');
+    _verifier;
+    handler = (0, webhook_vapiai_1.vapiaiEventHandlerFactory)();
+    configure = (0, webhook_vapiai_1.vapiaiEventHandlerConfigurerFactory)(this.handler);
+    constructor(vapiAiWebhookServiceConfig) {
+        this._verifier = (0, webhook_vapiai_verify_1.vapiAiWebhookEventVerifier)(vapiAiWebhookServiceConfig.webhookConfig);
+    }
+    async updateForWebhook(req, rawBody) {
+        const { valid, event } = await this._verifier(req, rawBody);
+        let result = {
+            handled: false
+        };
+        if (!valid) {
+            this.logger.warn('Received invalid Vapi.ai event: ', event);
+        }
+        else {
+            result = await this.updateForVapiAiEvent(event);
+        }
+        const response = {
+            valid,
+            event,
+            ...result
+        };
+        return response;
+    }
+    async updateForVapiAiEvent(event) {
+        const result = await this.handler(event);
+        if (!result.handled) {
+            this.logger.warn('Received unexpected/unhandled Vapi.ai event: ', event);
+        }
+        return result;
+    }
+};
+exports.VapiAiWebhookService = VapiAiWebhookService;
+exports.VapiAiWebhookService = VapiAiWebhookService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(webhook_vapi_config_1.VapiAiWebhookServiceConfig)),
+    tslib_1.__metadata("design:paramtypes", [webhook_vapi_config_1.VapiAiWebhookServiceConfig])
+], VapiAiWebhookService);
+//# sourceMappingURL=webhook.vapiai.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.vapiai.service.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4D;AAE5D,qDAA8L;AAE9L,mEAAiG;AACjG,+DAAmE;AAOnE;;GAEG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IACd,MAAM,GAAG,IAAI,eAAM,CAAC,sBAAsB,CAAC,CAAC;IAE5C,SAAS,CAA6B;IAE9C,OAAO,GAA6E,IAAA,0CAAyB,GAAE,CAAC;IAChH,SAAS,GAAG,IAAA,oDAAmC,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvE,YAAgD,0BAAsD;QACpG,IAAI,CAAC,SAAS,GAAG,IAAA,kDAA0B,EAAC,0BAA0B,CAAC,aAAa,CAAC,CAAC;IACxF,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAAC,GAAY,EAAE,OAAe;QACzD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5D,IAAI,MAAM,GAAwB;YAChC,OAAO,EAAE,KAAK;SACf,CAAC;QAEF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,QAAQ,GAAmC;YAC/C,KAAK;YACL,KAAK;YACL,GAAG,MAAM;SACV,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,KAAgC;QACzD,MAAM,MAAM,GAAwB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAA;AA1CY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IASE,mBAAA,IAAA,eAAM,EAAC,gDAA0B,CAAC,CAAA;6CAA6B,gDAA0B;GAR3F,oBAAoB,CA0ChC"}

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

@@ -0,0 +1,134 @@
+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"
+}
+interface BaseVapiPayload {
+    readonly call: Call;
+}
+/**
+ * Assistant request event payload
+ *
+ * https://docs.vapi.ai/server-url/events#retrieving-assistants
+ */
+export interface AssistantRequestPayload extends BaseVapiPayload {
+    readonly type: VapiWebhookEnum.ASSISTANT_REQUEST;
+}
+/**
+ * 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;
+}
+/**
+ * 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;
+    };
+}
+/**
+ * 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;
+    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 costs: VapiCostsItem[];
+    readonly transcript: string;
+    readonly messages: ChatMessagesItem[];
+    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;
+}
+/**
+ * @deprecated needs documentation link
+ */
+export interface SpeechUpdatePayload extends BaseVapiPayload {
+    readonly type: VapiWebhookEnum.SPEECH_UPDATE;
+    readonly status: 'started' | 'stopped';
+    readonly role: 'assistant' | 'user';
+}
+/**
+ * @deprecated needs documentation link
+ */
+export interface TranscriptPayload {
+    readonly type: VapiWebhookEnum.TRANSCRIPT;
+    readonly role: 'assistant' | 'user';
+    readonly transcriptType: 'partial' | 'final';
+    readonly transcript: string;
+}
+export type VapiPayload = AssistantRequestPayload | StatusUpdatePayload | FunctionCallPayload | EndOfCallReportPayload | SpeechUpdatePayload | TranscriptPayload | HangPayload;
+/**
+ * Response returned when a function is called.
+ *
+ * https://docs.vapi.ai/server-url/events#function-calling
+ */
+export type FunctionCallMessageResponse = {
+    readonly result: string | JSONEncodedString;
+};
+/**
+ * Response returned when an assistant request is received.
+ *
+ * https://docs.vapi.ai/server-url/events#retrieving-assistants
+ */
+export type AssistantRequestMessageResponse = AssistantRequestMessageSuccessResponse | AssistantRequestMessageErrorResponse;
+export type AssistantRequestMessageSuccessResponse = AssistantRequestMessageSuccessIdResponse | AssistantRequestMessageSuccessObjectResponse;
+export interface AssistantRequestMessageSuccessIdResponse {
+    readonly assistantId: VapiAssistantId;
+}
+export interface AssistantRequestMessageSuccessObjectResponse {
+    readonly assistant: Assistant;
+}
+export interface AssistantRequestMessageErrorResponse {
+    readonly error?: string;
+}
+/**
+ * Response that does not return any data.
+ */
+export type VapiVoidResponse = void;
+export type StatusUpdateMessageResponse = VapiVoidResponse;
+export type SpeechUpdateMessageResponse = VapiVoidResponse;
+export type TranscriptMessageResponse = VapiVoidResponse;
+export type HangMessageResponse = VapiVoidResponse;
+export type EndOfCallReportMessageResponse = VapiVoidResponse;
+export type VapiResponse = AssistantRequestMessageResponse | FunctionCallMessageResponse | EndOfCallReportMessageResponse | HangMessageResponse | StatusUpdateMessageResponse | SpeechUpdateMessageResponse | TranscriptMessageResponse;
+export {};

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

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VapiWebhookEnum = void 0;
+var VapiWebhookEnum;
+(function (VapiWebhookEnum) {
+    VapiWebhookEnum["ASSISTANT_REQUEST"] = "assistant-request";
+    VapiWebhookEnum["FUNCTION_CALL"] = "function-call";
+    VapiWebhookEnum["STATUS_UPDATE"] = "status-update";
+    VapiWebhookEnum["END_OF_CALL_REPORT"] = "end-of-call-report";
+    VapiWebhookEnum["HANG"] = "hang";
+    // TODO: speech update and transcript are not implemented or have documentation. They might be deprecated
+    /**
+     * @deprecated needs documentation link
+     */
+    VapiWebhookEnum["SPEECH_UPDATE"] = "speech-update";
+    /**
+     * @deprecated needs documentation link
+     */
+    VapiWebhookEnum["TRANSCRIPT"] = "transcript";
+})(VapiWebhookEnum || (exports.VapiWebhookEnum = VapiWebhookEnum = {}));
+//# sourceMappingURL=webhook.vapiai.types.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,45 @@
+import { Request } from 'express';
+import { VapiAiWebhookSecretToken, VapiApiWebhookEventVerificationType } from '../vapiai.type';
+import { UntypedVapiAiWebhookEvent } from './webhook.vapiai';
+import { Maybe } from '@dereekb/util';
+export interface VapiApiWebhookEventVerificationConfig {
+    /**
+     * Secret token to use for verification.
+     *
+     * If not defined, defaults to an empty string.
+     */
+    readonly secret?: VapiAiWebhookSecretToken;
+    /**
+     * Secret token to use for HMAC verification.
+     *
+     * If not provided, defaults to secret.
+     */
+    readonly hmacSecret?: Maybe<VapiAiWebhookSecretToken>;
+    /**
+     * HMAC signature prefix
+     *
+     * Should match the prefix configured in the Vapi console
+     */
+    readonly signaturePrefix?: Maybe<string>;
+    /**
+     * Explicit verification type.
+     *
+     * If not provided, defaults to hmac if hmac secret is provided.
+     */
+    readonly verificationType?: Maybe<VapiApiWebhookEventVerificationType>;
+}
+export interface VapiAiWebhookEventVerificationResult {
+    readonly valid: boolean;
+    readonly event: UntypedVapiAiWebhookEvent;
+}
+/**
+ * Function that verifies a VapiAi webhook event.
+ */
+export type VapiAiWebhookEventVerifier = (req: Request, rawBody: Buffer) => Promise<VapiAiWebhookEventVerificationResult>;
+/**
+ * Verifies a VapiAi webhook event header.
+ *
+ * @param vapiSecretTokenGetter The VapiAi secret token. The Vapi client allows for using an AsyncGetterOrValue type, so the verifier supports that as well.
+ * @returns A function that verifies a VapiAi webhook event.
+ */
+export declare function vapiAiWebhookEventVerifier(config: VapiApiWebhookEventVerificationConfig): VapiAiWebhookEventVerifier;

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

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vapiAiWebhookEventVerifier = vapiAiWebhookEventVerifier;
+const crypto_1 = require("crypto");
+/**
+ * Verifies a VapiAi webhook event header.
+ *
+ * @param vapiSecretTokenGetter The VapiAi secret token. The Vapi client allows for using an AsyncGetterOrValue type, so the verifier supports that as well.
+ * @returns A function that verifies a VapiAi webhook event.
+ */
+function vapiAiWebhookEventVerifier(config) {
+    const { verificationType: inputVerificationType, secret: inputSecret, hmacSecret: inputHmacSecret, signaturePrefix: inputSignaturePrefix } = config;
+    const verificationType = inputVerificationType ?? (inputHmacSecret != null ? 'hmac' : 'secret'); // default to secret always, never default to none
+    const secretToken = (verificationType === 'hmac' ? (inputHmacSecret ?? inputSecret) : inputSecret) ?? '';
+    const signaturePrefix = inputSignaturePrefix ?? '';
+    function verifyNone(input) {
+        return true;
+    }
+    function verifySecret(input) {
+        const { request } = input;
+        const headers = request.headers;
+        const vapiSecret = headers['x-vapi-secret'];
+        const valid = vapiSecret === secretToken;
+        return valid;
+    }
+    function verifyHmac(input) {
+        const { request, requestBodyString } = input;
+        const headers = request.headers;
+        const timestamp = headers['x-timestamp'];
+        const vapiSignature = headers['x-signature'];
+        const message = `${timestamp}.${requestBodyString}`;
+        const hashForVerify = (0, crypto_1.createHmac)('sha256', secretToken).update(message).digest('hex');
+        const signature = `${signaturePrefix}${hashForVerify}`;
+        const valid = vapiSignature === signature;
+        return valid;
+    }
+    const verify = verificationType === 'hmac' ? verifyHmac : verificationType === 'secret' ? verifySecret : verifyNone;
+    return async (request, rawBody) => {
+        const requestBodyString = String(request.body);
+        const valid = verify({ request, requestBodyString });
+        const requestBody = JSON.parse(requestBodyString);
+        const result = {
+            valid,
+            event: requestBody.message
+        };
+        return result;
+    };
+}
+//# sourceMappingURL=webhook.vapiai.verify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.vapiai.verify.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/vapiai/src/lib/webhook/webhook.vapiai.verify.ts"],"names":[],"mappings":";;AAiDA,gEAoDC;AAjGD,mCAAoC;AAuCpC;;;;;GAKG;AACH,SAAgB,0BAA0B,CAAC,MAA6C;IACtF,MAAM,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAC;IACpJ,MAAM,gBAAgB,GAAG,qBAAqB,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kDAAkD;IACnJ,MAAM,WAAW,GAAG,CAAC,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IACzG,MAAM,eAAe,GAAG,oBAAoB,IAAI,EAAE,CAAC;IAOnD,SAAS,UAAU,CAAC,KAAkB;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,YAAY,CAAC,KAAkB;QACtC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;QAE5C,MAAM,KAAK,GAAG,UAAU,KAAK,WAAW,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,UAAU,CAAC,KAAkB;QACpC,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,KAAK,CAAC;QAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QAE7C,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,iBAAiB,EAAE,CAAC;QACpD,MAAM,aAAa,GAAG,IAAA,mBAAU,EAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtF,MAAM,SAAS,GAAG,GAAG,eAAe,GAAG,aAAa,EAAE,CAAC;QAEvD,MAAM,KAAK,GAAG,aAAa,KAAK,SAAS,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IAEpH,OAAO,KAAK,EAAE,OAAgB,EAAE,OAAe,EAAE,EAAE;QACjD,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAA0B,CAAC;QAE3E,MAAM,MAAM,GAAyC;YACnD,KAAK;YACL,KAAK,EAAE,WAAW,CAAC,OAAO;SAC3B,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}