@xapp/stentor-service-boberdoo 1.80.2

package/lib/BoberdooIntegration.d.ts

@@ -0,0 +1,23 @@
+import { CrmResponse, ExternalLead } from "stentor-models";
+import { BoberdooExtras, BoberdooLeadPayload, BoberdooResponse, BoberdooServiceProps } from "./models";
+/**
+ * BoberdooIntegration posts leads to the Boberdoo lead distribution platform.
+ *
+ * @see https://support.boberdoo.com/article/116-api-implementation-guide
+ */
+export declare class BoberdooIntegration {
+    private props;
+    private apiEndpoint;
+    constructor(props: BoberdooServiceProps);
+    /**
+     * Posts a lead to Boberdoo.
+     *
+     * @param externalLead - The lead data from the contact capture handler
+     * @param extras - Optional extra fields including TrustedForm cert URL and UTM params
+     */
+    send(externalLead: ExternalLead, extras?: BoberdooExtras): Promise<CrmResponse>;
+    /**
+     * Posts the lead payload to Boberdoo.
+     */
+    protected post(payload: BoberdooLeadPayload): Promise<BoberdooResponse>;
+}

package/lib/BoberdooIntegration.js

@@ -0,0 +1,146 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoberdooIntegration = void 0;
+/*! Copyright (c) 2026, XAPP AI */
+const stentor_logger_1 = require("stentor-logger");
+const axios_1 = __importDefault(require("axios"));
+const DEFAULT_API_ENDPOINT = "https://www.boberdoo.com/index.php";
+/**
+ * BoberdooIntegration posts leads to the Boberdoo lead distribution platform.
+ *
+ * @see https://support.boberdoo.com/article/116-api-implementation-guide
+ */
+class BoberdooIntegration {
+    constructor(props) {
+        this.props = props;
+        this.apiEndpoint = props.apiEndpoint || DEFAULT_API_ENDPOINT;
+    }
+    /**
+     * Posts a lead to Boberdoo.
+     *
+     * @param externalLead - The lead data from the contact capture handler
+     * @param extras - Optional extra fields including TrustedForm cert URL and UTM params
+     */
+    send(externalLead, extras) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const crmResponse = {
+                status: "Failure",
+                message: ""
+            };
+            try {
+                const firstName = (_a = externalLead.fields.find((f) => f.name === "FIRST_NAME")) === null || _a === void 0 ? void 0 : _a.value;
+                const lastName = (_b = externalLead.fields.find((f) => f.name === "LAST_NAME")) === null || _b === void 0 ? void 0 : _b.value;
+                const fullName = (_c = externalLead.fields.find((f) => f.name === "FULL_NAME")) === null || _c === void 0 ? void 0 : _c.value;
+                const phone = (_d = externalLead.fields.find((f) => f.name === "PHONE")) === null || _d === void 0 ? void 0 : _d.value;
+                const email = (_e = externalLead.fields.find((f) => f.name === "EMAIL")) === null || _e === void 0 ? void 0 : _e.value;
+                const address = (_f = externalLead.fields.find((f) => f.name === "ADDRESS")) === null || _f === void 0 ? void 0 : _f.value;
+                const city = (_g = externalLead.fields.find((f) => f.name === "CITY")) === null || _g === void 0 ? void 0 : _g.value;
+                const state = (_h = externalLead.fields.find((f) => f.name === "STATE")) === null || _h === void 0 ? void 0 : _h.value;
+                const zip = (_j = externalLead.fields.find((f) => f.name === "ZIP")) === null || _j === void 0 ? void 0 : _j.value;
+                let resolvedFirstName = firstName;
+                let resolvedLastName = lastName;
+                if (!resolvedFirstName && fullName) {
+                    const parts = fullName.trim().split(/\s+/);
+                    resolvedFirstName = parts[0];
+                    resolvedLastName = parts.slice(1).join(" ") || undefined;
+                }
+                const payload = {
+                    lp_campaign_id: this.props.campaignId,
+                    lp_campaign_key: this.props.campaignKey,
+                    lp_response: "json"
+                };
+                if (this.props.testMode) {
+                    payload.lp_test = "test";
+                }
+                if (resolvedFirstName)
+                    payload.first_name = resolvedFirstName;
+                if (resolvedLastName)
+                    payload.last_name = resolvedLastName;
+                if (phone)
+                    payload.phone_home = phone;
+                if (email)
+                    payload.email_address = email;
+                if (address)
+                    payload.address = address;
+                if (city)
+                    payload.city = city;
+                if (state)
+                    payload.state = state;
+                if (zip)
+                    payload.zip_code = zip;
+                // Include TrustedForm cert URL if present — Boberdoo has native TrustedForm support
+                if (extras === null || extras === void 0 ? void 0 : extras.xxTrustedFormCertUrl) {
+                    payload.xxTrustedFormCertUrl = extras.xxTrustedFormCertUrl;
+                }
+                const boberdooResponse = yield this.post(payload);
+                if (boberdooResponse.status === "Success") {
+                    crmResponse.status = "Success";
+                }
+                else {
+                    crmResponse.message = boberdooResponse.error || "Boberdoo returned a failure response";
+                }
+            }
+            catch (err) {
+                (0, stentor_logger_1.log)().error(`Boberdoo error send(): ${err}`);
+                crmResponse.message = err instanceof Error ? err.message : String(err);
+            }
+            return crmResponse;
+        });
+    }
+    /**
+     * Posts the lead payload to Boberdoo.
+     */
+    post(payload) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const boberdooResponse = {
+                status: "Failure"
+            };
+            const body = new URLSearchParams();
+            for (const [key, value] of Object.entries(payload)) {
+                if (value !== undefined) {
+                    body.append(key, value);
+                }
+            }
+            const config = {
+                method: "post",
+                url: this.apiEndpoint,
+                params: { type: "post" },
+                headers: {
+                    "Content-Type": "application/x-www-form-urlencoded"
+                },
+                data: body.toString()
+            };
+            try {
+                const response = yield (0, axios_1.default)(config);
+                const responseBody = response.data;
+                if ((responseBody === null || responseBody === void 0 ? void 0 : responseBody.status) === "success" || (responseBody === null || responseBody === void 0 ? void 0 : responseBody.status) === "Success") {
+                    boberdooResponse.status = "Success";
+                    boberdooResponse.data = response.data;
+                }
+                else {
+                    boberdooResponse.error = (responseBody === null || responseBody === void 0 ? void 0 : responseBody.error) || "Unexpected response from Boberdoo";
+                }
+            }
+            catch (err) {
+                (0, stentor_logger_1.log)().error(`Boberdoo: Error posting lead ${err}`);
+                boberdooResponse.error = err instanceof Error ? err.message : String(err);
+            }
+            return boberdooResponse;
+        });
+    }
+}
+exports.BoberdooIntegration = BoberdooIntegration;
+//# sourceMappingURL=BoberdooIntegration.js.map

package/lib/BoberdooIntegration.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+/*! Copyright (c) 2026, XAPP AI */
+export { BoberdooIntegration } from "./BoberdooIntegration";
+export * from "./models";

package/lib/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoberdooIntegration = void 0;
+/*! Copyright (c) 2026, XAPP AI */
+var BoberdooIntegration_1 = require("./BoberdooIntegration");
+Object.defineProperty(exports, "BoberdooIntegration", { enumerable: true, get: function () { return BoberdooIntegration_1.BoberdooIntegration; } });
+__exportStar(require("./models"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kCAAkC;AAClC,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,2CAAyB"}

package/lib/models.d.ts

@@ -0,0 +1,65 @@
+/*! Copyright (c) 2026, XAPP AI */
+export interface BoberdooServiceProps {
+    /**
+     * The Boberdoo campaign ID
+     */
+    campaignId: string;
+    /**
+     * The Boberdoo campaign key
+     */
+    campaignKey: string;
+    /**
+     * Optional custom POST endpoint. Defaults to https://www.boberdoo.com/index.php
+     */
+    apiEndpoint?: string;
+    /**
+     * Set to "test" to use Boberdoo's test mode (leads are not billed)
+     */
+    testMode?: boolean;
+}
+/**
+ * The lead payload sent to Boberdoo.
+ */
+export interface BoberdooLeadPayload {
+    lp_campaign_id: string;
+    lp_campaign_key: string;
+    lp_response: "json";
+    /** Set to "test" in test mode */
+    lp_test?: string;
+    first_name?: string;
+    last_name?: string;
+    phone_home?: string;
+    email_address?: string;
+    address?: string;
+    city?: string;
+    state?: string;
+    zip_code?: string;
+    /** TrustedForm certificate URL — required by Boberdoo's TrustedForm integration */
+    xxTrustedFormCertUrl?: string;
+    /** Additional arbitrary fields */
+    [key: string]: string | undefined;
+}
+export interface BoberdooResponse {
+    status: "Success" | "Failure";
+    /**
+     * The raw response from Boberdoo
+     */
+    data?: Record<string, unknown>;
+    error?: string;
+}
+/**
+ * Extras passed alongside an ExternalLead to include TrustedForm and tracking data.
+ *
+ * Mirrors the shape of `LeadExtras` from `@xapp/stentor-handler-contact-capture`.
+ * Keep these two interfaces in sync when adding new tracking fields.
+ */
+export interface BoberdooExtras {
+    xxTrustedFormCertUrl?: string;
+    xxTrustedFormPingUrl?: string;
+    utm_source?: string;
+    utm_campaign?: string;
+    utm_medium?: string;
+    utm_content?: string;
+    utm_term?: string;
+    [key: string]: string | undefined;
+}

package/lib/models.js

@@ -0,0 +1,4 @@
+"use strict";
+/*! Copyright (c) 2026, XAPP AI */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=models.js.map

package/lib/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":";AAAA,kCAAkC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+    "name": "@xapp/stentor-service-boberdoo",
+    "license": "Apache-2.0",
+    "publishConfig": {
+        "access": "public"
+    },
+    "version": "1.80.2",
+    "description": "Service to integrate with Boberdoo lead distribution",
+    "types": "lib/index",
+    "main": "lib/index",
+    "files": [
+        "lib"
+    ],
+    "engines": {
+        "node": "^20 || ^22 || ^24"
+    },
+    "devDependencies": {
+        "@types/chai": "5.2.3",
+        "@types/sinon": "4.3.3",
+        "@xapp/config": "0.3.0",
+        "axios-mock-adapter": "2.1.0",
+        "chai": "4.5.0",
+        "mocha": "11.7.5",
+        "sinon": "21.0.0",
+        "stentor-logger": "1.72.1",
+        "stentor-models": "1.72.0",
+        "ts-node": "10.9.2",
+        "typescript": "5.9.3"
+    },
+    "peerDependencies": {
+        "stentor-logger": "1.x",
+        "stentor-models": "1.x"
+    },
+    "scripts": {
+        "build": "tsc -d true -p .",
+        "clean": "rm -rf ./lib/*",
+        "test": "mocha --recursive --timeout 9000 -r ts-node/register \"./src/**/__test__/*.test.ts\""
+    },
+    "dependencies": {
+        "axios": "1.16.0"
+    },
+    "gitHead": "1cf9e673d939bdf884a12a45548c0d2c9eb1248b"
+}