@dereekb/nestjs 12.3.9 → 12.3.10

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [12.3.10](https://github.com/dereekb/dbx-components/compare/v12.3.9-dev...v12.3.10) (2025-08-15)
+
+
+
 ## [12.3.9](https://github.com/dereekb/dbx-components/compare/v12.3.8-dev...v12.3.9) (2025-08-15)
 
 

package/mailgun/package.json

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

package/openai/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs/openai",
-  "version": "12.3.9",
+  "version": "12.3.10",
   "type": "commonjs",
   "peerDependencies": {},
   "dependencies": {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs",
-  "version": "12.3.9",
+  "version": "12.3.10",
   "type": "commonjs",
   "exports": {
     ".": {

package/stripe/package.json

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

package/typeform/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/nestjs/typeform",
-  "version": "12.3.9",
+  "version": "12.3.10",
   "type": "commonjs",
   "peerDependencies": {},
   "dependencies": {},

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

@@ -4,3 +4,4 @@ export * from './typeform.api';
 export * from './typeform.module';
 export * from './typeform.config';
 export * from './typeform.type';
+export * from './typeform.util';

package/typeform/src/lib/index.js

@@ -7,4 +7,5 @@ tslib_1.__exportStar(require("./typeform.api"), exports);
 tslib_1.__exportStar(require("./typeform.module"), exports);
 tslib_1.__exportStar(require("./typeform.config"), exports);
 tslib_1.__exportStar(require("./typeform.type"), exports);
+tslib_1.__exportStar(require("./typeform.util"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/typeform/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,4DAAkC;AAClC,yDAA+B;AAC/B,4DAAkC;AAClC,4DAAkC;AAClC,0DAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/typeform/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,4DAAkC;AAClC,yDAA+B;AAC/B,4DAAkC;AAClC,4DAAkC;AAClC,0DAAgC;AAChC,0DAAgC"}

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

@@ -46,6 +46,8 @@ export interface TypeformFormHiddenMetadata extends Partial<Record<string, any>>
     readonly utm_medium?: string;
     readonly utm_source?: string;
 }
+export type TypeformFormResponseDefinitionFieldId = string;
+export type TypeformFormResponseDefinitionField = MaybeSo<TypeformFormResponseDefinition['fields']>[0];
 export interface TypeformFormResponseDefinition extends MaybeSo<TypeformResponse['definition']> {
     readonly id: TypeformFormId;
     readonly title: TypeformFormName;

package/typeform/src/lib/typeform.util.d.ts

@@ -0,0 +1,20 @@
+export type TypeformTemplateRefType = 'field';
+export interface TypeformTemplateRef {
+    /**
+     * The type of ref
+     */
+    readonly type: TypeformTemplateRefType;
+    /**
+     * The full match
+     *
+     * I.E. {{field:123456789}}
+     */
+    readonly match: string;
+    /**
+     * The field ref value
+     *
+     * I.E. 123456789
+     */
+    readonly ref: string;
+}
+export declare function findTypeformTemplateRefsInString(input: string): TypeformTemplateRef[];

package/typeform/src/lib/typeform.util.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTypeformTemplateRefsInString = findTypeformTemplateRefsInString;
+function findTypeformTemplateRefsInString(input) {
+    /**
+     * Used to search the input string to find field refs like the following:
+     *
+     * {{field:8f7adc1e-c3b8-44bd-b00c-1b6c8de65797}}
+     * {{field:01H7G3DCZ1FZV4KYZGM755MXZZ}}
+     */
+    const regex = /\{\{\s*(field)\s*:\s*([A-Za-z0-9-]+)\s*\}\}/g;
+    const matches = input.matchAll(regex);
+    const result = [];
+    for (const regexMatch of matches) {
+        const match = regexMatch[0]; // {{field:8f7adc1e-c3b8-44bd-b00c-1b6c8de65797}}
+        const type = regexMatch[1]; // field
+        const ref = regexMatch[2]; // 8f7adc1e-c3b8-44bd-b00c-1b6c8de65797
+        result.push({
+            type,
+            match,
+            ref
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=typeform.util.js.map

package/typeform/src/lib/typeform.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeform.util.js","sourceRoot":"","sources":["../../../../../../packages/nestjs/typeform/src/lib/typeform.util.ts"],"names":[],"mappings":";;AAqBA,4EAwBC;AAxBD,SAAgB,gCAAgC,CAAC,KAAa;IAC5D;;;;;OAKG;IACH,MAAM,KAAK,GAAG,8CAA8C,CAAC;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,MAAM,GAA0B,EAAE,CAAC;IAEzC,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,iDAAiD;QAC9E,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAA4B,CAAC,CAAC,QAAQ;QAC/D,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,uCAAuC;QAElE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,KAAK;YACL,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -3,5 +3,6 @@ export * from './webhook.typeform.type';
 export * from './webhook.typeform.config';
 export * from './webhook.typeform.controller';
 export * from './webhook.typeform.module';
+export * from './webhook.typeform.form';
 export * from './webhook.typeform.service';
 export * from './webhook.typeform.verify';

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

@@ -6,6 +6,7 @@ tslib_1.__exportStar(require("./webhook.typeform.type"), exports);
 tslib_1.__exportStar(require("./webhook.typeform.config"), exports);
 tslib_1.__exportStar(require("./webhook.typeform.controller"), exports);
 tslib_1.__exportStar(require("./webhook.typeform.module"), exports);
+tslib_1.__exportStar(require("./webhook.typeform.form"), exports);
 tslib_1.__exportStar(require("./webhook.typeform.service"), exports);
 tslib_1.__exportStar(require("./webhook.typeform.verify"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/typeform/src/lib/webhook/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,kEAAwC;AACxC,oEAA0C;AAC1C,wEAA8C;AAC9C,oEAA0C;AAC1C,qEAA2C;AAC3C,oEAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/nestjs/typeform/src/lib/webhook/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,kEAAwC;AACxC,oEAA0C;AAC1C,wEAA8C;AAC9C,oEAA0C;AAC1C,kEAAwC;AACxC,qEAA2C;AAC3C,oEAA0C"}

package/typeform/src/lib/webhook/webhook.typeform.form.d.ts

@@ -0,0 +1,48 @@
+import { Maybe } from '@dereekb/util';
+import { TypeformFormResponseAnswer, TypeformFormResponseDefinitionField } from '../typeform.type';
+import { TypeformWebhookFormResponse } from './webhook.typeform.type';
+export interface TypeformFormResponseAnswerValuePair<T = unknown> {
+    /**
+     * The answer as retrieved from the form response.
+     */
+    readonly answer: TypeformFormResponseAnswer;
+    /**
+     * Answer value as was retrieved
+     */
+    readonly value: T;
+    /**
+     * Answer value as a string
+     */
+    readonly valueString: string;
+}
+export interface TypeformFormQuestionAnswerPair<T = unknown> extends TypeformFormResponseAnswerValuePair<T> {
+    /**
+     * The expanded question title, which replaces all field references with the field's value.
+     *
+     * Provided only if the definition field exists.
+     */
+    readonly questionTitle?: Maybe<string>;
+    /**
+     * True if the original title had a field reference.
+     */
+    readonly hadReferenceInTitle: boolean;
+    /**
+     * Definition field, if it exists.
+     */
+    readonly definitionField?: TypeformFormResponseDefinitionField;
+}
+/**
+ * An expanded TypeformWebhookFormResponse, containing the original form response and a list of TypeformFormQuestionAnswerPair.
+ */
+export interface ExpandedTypeformWebhookFormResponse {
+    readonly formResponse: TypeformWebhookFormResponse;
+    readonly pairs: TypeformFormQuestionAnswerPair[];
+}
+/**
+ * Creates an ExpandedTypeformWebhookFormResponse from a TypeformWebhookFormResponse.
+ */
+export declare function expandTypeformWebhookFormResponse(formResponse: TypeformWebhookFormResponse): ExpandedTypeformWebhookFormResponse;
+/**
+ * Creates a TypeformFormQuestionAnswerPair from a TypeformFormResponseAnswer.
+ */
+export declare function makeTypeformFormResponseAnswerValuePair(answer: TypeformFormResponseAnswer): TypeformFormResponseAnswerValuePair;

package/typeform/src/lib/webhook/webhook.typeform.form.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expandTypeformWebhookFormResponse = expandTypeformWebhookFormResponse;
+exports.makeTypeformFormResponseAnswerValuePair = makeTypeformFormResponseAnswerValuePair;
+const util_1 = require("@dereekb/util");
+const typeform_util_1 = require("../typeform.util");
+/**
+ * Creates an ExpandedTypeformWebhookFormResponse from a TypeformWebhookFormResponse.
+ */
+function expandTypeformWebhookFormResponse(formResponse) {
+    const { answers, definition } = formResponse;
+    const { fields = [] } = definition;
+    const questionFieldMap = new Map((0, util_1.filterMaybeArrayValues)(fields.map((x) => (x.id ? [x.id, x] : null))));
+    const answerValuePairs = answers.map((answer) => makeTypeformFormResponseAnswerValuePair(answer));
+    const answerValueFieldRefMap = new Map((0, util_1.filterMaybeArrayValues)(answerValuePairs.map((x) => (x.answer.field.ref ? [x.answer.field.ref, x] : null))));
+    function expandQuestionTitle(title) {
+        let result = title;
+        let hadReferenceInTitle = false;
+        if (result) {
+            const refsInTitle = (0, typeform_util_1.findTypeformTemplateRefsInString)(result);
+            if (refsInTitle.length > 0) {
+                hadReferenceInTitle = true;
+                refsInTitle.forEach((refInTitle) => {
+                    const { match, ref } = refInTitle;
+                    const fullMatch = match;
+                    const answer = answerValueFieldRefMap.get(ref);
+                    const answerValue = answer?.valueString;
+                    const replacedTitle = result.replaceAll(fullMatch, answerValue || '');
+                    result = replacedTitle;
+                });
+            }
+        }
+        return {
+            questionTitle: result,
+            hadReferenceInTitle
+        };
+    }
+    const pairs = answerValuePairs.map((answerValue) => {
+        const definitionField = questionFieldMap.get(answerValue.answer.field.id);
+        const { questionTitle, hadReferenceInTitle } = expandQuestionTitle(definitionField?.title);
+        const result = {
+            ...answerValue,
+            definitionField,
+            questionTitle,
+            hadReferenceInTitle
+        };
+        return result;
+    });
+    return {
+        formResponse,
+        pairs
+    };
+}
+/**
+ * Creates a TypeformFormQuestionAnswerPair from a TypeformFormResponseAnswer.
+ */
+function makeTypeformFormResponseAnswerValuePair(answer) {
+    let value;
+    let valueString;
+    switch (answer.type) {
+        case 'number':
+            value = answer.number;
+            valueString = answer.number.toString();
+            break;
+        case 'boolean':
+            value = answer.boolean;
+            valueString = answer.boolean.toString();
+            break;
+        case 'email':
+            value = answer.email;
+            valueString = answer.email;
+            break;
+        case 'phone_number':
+            value = answer.phone_number;
+            valueString = answer.phone_number;
+            break;
+        case 'date':
+            value = answer.date;
+            valueString = answer.date;
+            break;
+        case 'payment':
+            value = answer.payment;
+            valueString = answer.payment.amount.toString();
+            break;
+        case 'text':
+            value = answer.text;
+            valueString = answer.text;
+            break;
+        case 'choices':
+            value = answer.choices;
+            valueString = answer.choices.other || (0, util_1.joinStringsWithCommas)(answer.choices.labels);
+            break;
+        case 'choice':
+            value = answer.choice;
+            valueString = answer.choice.other || answer.choice.label || '';
+            break;
+        case 'url':
+            value = answer.url;
+            valueString = answer.url;
+            break;
+        case 'file_url':
+            value = answer.file_url;
+            valueString = answer.file_url;
+            break;
+    }
+    const result = {
+        answer,
+        value,
+        valueString
+    };
+    return result;
+}
+//# sourceMappingURL=webhook.typeform.form.js.map

package/typeform/src/lib/webhook/webhook.typeform.form.js.map

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

package/vapiai/package.json

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