dymo-api 1.2.29 → 1.2.31

package/dist/cjs/branches/private/functions/isValidPhone/index.cjs

@@ -52,6 +52,14 @@ const isValidPhone = async (axiosClient, phone, rules) => {
             reasons.push("FRAUD");
         if (rules.deny.includes("HIGH_RISK_SCORE") && responsePhone.plugins.riskScore >= 80)
             reasons.push("HIGH_RISK_SCORE");
+        // Country block rules.
+        for (const rule of rules.deny) {
+            if (rule.startsWith("COUNTRY:")) {
+                const block = rule.split(":")[1]; // Extract country code.
+                if (responsePhone.countryCode === block)
+                    reasons.push(`COUNTRY:${block}`);
+            }
+        }
         return {
             phone: responsePhone.phone,
             allow: reasons.length === 0,

package/dist/cjs/dymo-api.cjs

@@ -41,25 +41,29 @@ const axios_1 = __importDefault(require("axios"));
 const basics_1 = require("./utils/basics.cjs");
 const PublicAPI = __importStar(require("./branches/public/index.cjs"));
 const PrivateAPI = __importStar(require("./branches/private/index.cjs"));
+const resilience_1 = require("./lib/resilience/index.cjs");
+const fallback_1 = require("./lib/resilience/fallback.cjs");
 class DymoAPI {
     /**
-     * @param {Object} options - Options to create the DymoAPI instance.
-     * @param {string} [options.rootApiKey] - The root API key.
-     * @param {string} [options.apiKey] - The API key.
-     * @param {string} [options.baseUrl] - Whether to use a local server instead of the cloud server.
-     * @param {Object} [options.serverEmailConfig] - The server email config.
-     * @description
-     * This is the main class to interact with the Dymo API. It should be
-     * instantiated with the root API key and the API key. The root API key is
-     * used to fetch the tokens and the API key is used to authenticate the
-     * requests.
-     * @example
-     * const dymoApi = new DymoAPI({
-     *     rootApiKey: "6bfb7675-6b69-4f8d-9f43-5a6f7f02c6c5",
-     *     apiKey: "dm_4c8b7675-6b69-4f8d-9f43-5a6f7f02c6c5"
-     * });
-     */
-    constructor({ rootApiKey = null, apiKey = null, baseUrl = "https://api.tpeoficial.com", serverEmailConfig = undefined, rules = {} } = {}) {
+         * @param {Object} options - Options to create the DymoAPI instance.
+         * @param {string} [options.rootApiKey] - The root API key.
+         * @param {string} [options.apiKey] - The API key.
+         * @param {string} [options.baseUrl] - Whether to use a local server instead of the cloud server.
+         * @param {Object} [options.serverEmailConfig] - The server email config.
+         * @param {Object} [options.rules] - The rules.
+         * @param {Object} [options.resilience] - The resilience config.
+         * @description
+         * This is the main class to interact with the Dymo API. It should be
+         * instantiated with the root API key and the API key. The root API key is
+         * used to fetch the tokens and the API key is used to authenticate the
+         * requests. Requests are retried once by default with exponential backoff.
+         * @example
+         * const dymoApi = new DymoAPI({
+         *     rootApiKey: "6bfb7675-6b69-4f8d-9f43-5a6f7f02c6c5",
+         *     apiKey: "dm_4c8b7675-6b69-4f8d-9f43-5a6f7f02c6c5"
+         * });
+         */
+    constructor({ rootApiKey = null, apiKey = null, baseUrl = "https://api.tpeoficial.com", serverEmailConfig = undefined, rules = {}, resilience = {} } = {}) {
         this.rules = {
             email: { mode: "LIVE", deny: ["FRAUD", "INVALID", "NO_MX_RECORDS", "NO_REPLY_EMAIL"] },
             ip: { mode: "LIVE", deny: ["FRAUD", "INVALID", "TOR_NETWORK"] },
@@ -72,13 +76,16 @@ class DymoAPI {
         this.apiKey = apiKey;
         this.serverEmailConfig = serverEmailConfig;
         this.baseUrl = baseUrl;
+        // Initialize resilience system with client ID
+        const clientId = this.apiKey || this.rootApiKey || "anonymous";
+        this.resilienceManager = new resilience_1.ResilienceManager(resilience, clientId);
         // We created the Axios client with the appropriate settings.
         this.axiosClient = axios_1.default.create({
             baseURL: `${(0, basics_1.validBaseURL)(this.baseUrl)}/v1`,
             headers: {
                 "User-Agent": "DymoAPISDK/1.0.0",
                 "X-Dymo-SDK-Env": "Node",
-                "X-Dymo-SDK-Version": "1.2.29"
+                "X-Dymo-SDK-Version": "1.2.31"
             }
         });
         // We set the authorization in the Axios client to make requests.
@@ -86,6 +93,14 @@ class DymoAPI {
             this.axiosClient.defaults.headers.Authorization = `Bearer ${this.rootApiKey || this.apiKey}`;
     }
     ;
+    getEmailPlugins(rules) {
+        return [
+            rules.deny.includes("NO_MX_RECORDS") ? "mxRecords" : undefined,
+            rules.deny.includes("NO_REACHABLE") ? "reachable" : undefined,
+            rules.deny.includes("HIGH_RISK_SCORE") ? "riskScore" : undefined,
+            rules.deny.includes("NO_GRAVATAR") ? "gravatar" : undefined
+        ].filter(Boolean);
+    }
     // FUNCTIONS / Private.
     /**
      * Validates the given data against the configured validation settings.
@@ -111,7 +126,12 @@ class DymoAPI {
      * [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier)
      */
     async isValidData(data) {
-        return await PrivateAPI.isValidDataRaw(this.axiosClient, data);
+        const fallbackData = fallback_1.FallbackDataGenerator.generateFallbackData("isValidData", data);
+        return await this.resilienceManager.executeWithResilience(this.axiosClient, {
+            method: "POST",
+            url: "/private/secure/verify",
+            data
+        }, this.resilienceManager.getConfig().fallbackEnabled ? fallbackData : undefined);
     }
     ;
     /**
@@ -137,7 +157,12 @@ class DymoAPI {
      * [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier)
      */
     async isValidDataRaw(data) {
-        return await PrivateAPI.isValidDataRaw(this.axiosClient, data);
+        const fallbackData = fallback_1.FallbackDataGenerator.generateFallbackData("isValidDataRaw", data);
+        return await this.resilienceManager.executeWithResilience(this.axiosClient, {
+            method: "POST",
+            url: "/private/secure/verify",
+            data
+        }, this.resilienceManager.getConfig().fallbackEnabled ? fallbackData : undefined);
     }
     ;
     /**
@@ -159,7 +184,12 @@ class DymoAPI {
      * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/email-validation)
      */
     async isValidEmail(email, rules = this.rules.email) {
-        return await PrivateAPI.isValidEmail(this.axiosClient, email, rules);
+        const fallbackData = fallback_1.FallbackDataGenerator.generateFallbackData("isValidEmail", email);
+        return await this.resilienceManager.executeWithResilience(this.axiosClient, {
+            method: "POST",
+            url: "/private/secure/verify",
+            data: { email, plugins: this.getEmailPlugins(rules) }
+        }, this.resilienceManager.getConfig().fallbackEnabled ? fallbackData : undefined);
     }
     ;
     /**

package/dist/cjs/lib/resilience/fallback.cjs

@@ -0,0 +1,427 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackDataGenerator = void 0;
+class FallbackDataGenerator {
+    static generateFallbackData(method, inputData) {
+        switch (method) {
+            case "isValidData": return this.generateDataValidationAnalysis(inputData);
+            case "isValidEmail": return this.generateEmailValidatorResponse(inputData);
+            case "isValidIP": return this.generateIPValidatorResponse(inputData);
+            case "isValidPhone": return this.generatePhoneValidatorResponse(inputData);
+            case "protectReq": return this.generateHTTPRequest(inputData);
+            case "sendEmail": return this.generateEmailStatus();
+            case "getRandom": return this.generateSRNSummary(inputData);
+            case "extractWithTextly": return this.generateExtractWithTextly(inputData);
+            case "getPrayerTimes": return this.generatePrayerTimes(inputData);
+            case "satinize": return this.generateSatinizedInputAnalysis(inputData);
+            case "isValidPwd": return this.generatePasswordValidationResult(inputData);
+            default: throw new Error(`Unknown method for fallback: ${method}`);
+        }
+    }
+    ;
+    static validateURL(url) {
+        if (!url)
+            return false;
+        const urlRegex = /^https?:\/\/(?:[-\w.])+(?:\:[0-9]+)?(?:\/(?:[\w\/_.])*(?:\?(?:[\w&=%.])*)?(?:\#(?:[\w.])*)?)?$/;
+        return urlRegex.test(url);
+    }
+    ;
+    static validateEmail(email) {
+        if (!email)
+            return false;
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        return emailRegex.test(email);
+    }
+    ;
+    static validateDomain(domain) {
+        if (!domain)
+            return false;
+        const domainRegex = /^[a-zA-Z0-9][a-zA-Z0-9-]{0,61}[a-zA-Z0-9](?:\.[a-zA-Z0-9][a-zA-Z0-9-]{0,61}[a-zA-Z0-9])*$/;
+        if (!domainRegex.test(domain))
+            return false;
+        // Validar que tenga un TLD (último punto + contenido)
+        const parts = domain.split('.');
+        return parts.length >= 2 && parts[parts.length - 1].length > 0;
+    }
+    ;
+    static validateCreditCard(creditCard) {
+        if (!creditCard)
+            return false;
+        const cardNumber = typeof creditCard === "string" ? creditCard : creditCard?.pan || "";
+        if (!cardNumber)
+            return false;
+        const cardRegex = /^\d{13,19}$/;
+        if (!cardRegex.test(cardNumber.replace(/\s/g, "")))
+            return false;
+        // Luhn algorithm
+        const digits = cardNumber.replace(/\s/g, "").split("").map(Number);
+        let sum = 0;
+        let isEven = false;
+        for (let i = digits.length - 1; i >= 0; i--) {
+            let digit = digits[i];
+            if (isEven) {
+                digit *= 2;
+                if (digit > 9)
+                    digit -= 9;
+            }
+            sum += digit;
+            isEven = !isEven;
+        }
+        return sum % 10 === 0;
+    }
+    ;
+    static validateIP(ip) {
+        if (!ip)
+            return false;
+        const ipv4Regex = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+        const ipv6Regex = /^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$/;
+        return ipv4Regex.test(ip) || ipv6Regex.test(ip);
+    }
+    ;
+    static validatePhone(phone) {
+        if (!phone)
+            return false;
+        const phoneRegex = /^\+?[1-9]\d{1,14}$/;
+        return phoneRegex.test(phone.replace(/[^\d+]/g, ""));
+    }
+    ;
+    static validateWallet(wallet) {
+        if (!wallet)
+            return false;
+        const bitcoinRegex = /^[13][a-km-zA-HJ-NP-Z1-9]{25,34}$/;
+        const ethereumRegex = /^0x[a-fA-F0-9]{40}$/;
+        return bitcoinRegex.test(wallet) || ethereumRegex.test(wallet);
+    }
+    ;
+    static validateIBAN(iban) {
+        if (!iban)
+            return false;
+        const ibanRegex = /^[A-Z]{2}\d{2}[A-Z0-9]{11,30}$/;
+        return ibanRegex.test(iban.replace(/\s/g, "").toUpperCase());
+    }
+    ;
+    static extractDomain(url) {
+        if (!url)
+            return "";
+        try {
+            return new URL(url).hostname;
+        }
+        catch {
+            return "";
+        }
+    }
+    ;
+    static generateDataValidationAnalysis(inputData) {
+        return {
+            url: {
+                valid: this.validateURL(inputData?.url),
+                fraud: false,
+                freeSubdomain: false,
+                customTLD: false,
+                url: inputData?.url || "",
+                domain: this.extractDomain(inputData?.url),
+                plugins: {
+                    blocklist: false,
+                    compromiseDetector: false,
+                    mxRecords: [],
+                    nsfw: false,
+                    reputation: "unknown",
+                    riskScore: 0,
+                    torNetwork: false,
+                    typosquatting: 0,
+                    urlShortener: false
+                }
+            },
+            email: this.generateEmailDataAnalysis(inputData?.email),
+            phone: this.generatePhoneDataAnalysis(inputData?.phone),
+            domain: {
+                valid: this.validateDomain(inputData?.domain),
+                fraud: false,
+                freeSubdomain: false,
+                customTLD: false,
+                domain: inputData?.domain || "",
+                plugins: {
+                    blocklist: false,
+                    compromiseDetector: false,
+                    mxRecords: [],
+                    nsfw: false,
+                    reputation: "unknown",
+                    riskScore: 0,
+                    torNetwork: false,
+                    typosquatting: 0,
+                    urlShortener: false
+                }
+            },
+            creditCard: {
+                valid: this.validateCreditCard(inputData?.creditCard),
+                fraud: false,
+                test: false,
+                type: "unknown",
+                creditCard: typeof inputData?.creditCard === "string" ? inputData.creditCard : inputData?.creditCard?.pan || "",
+                plugins: {
+                    blocklist: false,
+                    riskScore: 0
+                }
+            },
+            ip: this.generateIPDataAnalysis(inputData?.ip),
+            wallet: {
+                valid: this.validateWallet(inputData?.wallet),
+                fraud: false,
+                wallet: inputData?.wallet || "",
+                type: "unknown",
+                plugins: {
+                    blocklist: false,
+                    riskScore: 0,
+                    torNetwork: false
+                }
+            },
+            userAgent: {
+                valid: false,
+                fraud: false,
+                userAgent: inputData?.userAgent || "",
+                bot: true,
+                device: { type: "unknown", brand: "unknown" },
+                plugins: {
+                    blocklist: false,
+                    riskScore: 0
+                }
+            },
+            iban: {
+                valid: this.validateIBAN(inputData?.iban),
+                fraud: false,
+                iban: inputData?.iban || "",
+                plugins: {
+                    blocklist: false,
+                    riskScore: 0
+                }
+            }
+        };
+    }
+    ;
+    static generateEmailValidatorResponse(inputData) {
+        return {
+            email: inputData?.email || "",
+            allow: this.validateEmail(inputData?.email),
+            reasons: this.validateEmail(inputData?.email) ? [] : ["INVALID"],
+            response: this.generateEmailDataAnalysis(inputData?.email)
+        };
+    }
+    ;
+    static generateEmailDataAnalysis(email) {
+        return {
+            valid: this.validateEmail(email),
+            fraud: false,
+            proxiedEmail: false,
+            freeSubdomain: false,
+            corporate: false,
+            email: email || "",
+            realUser: "",
+            didYouMean: null,
+            noReply: false,
+            customTLD: false,
+            domain: "",
+            roleAccount: false,
+            plugins: {
+                mxRecords: [],
+                blocklist: false,
+                compromiseDetector: false,
+                nsfw: false,
+                reputation: "unknown",
+                riskScore: 0,
+                torNetwork: false,
+                typosquatting: 0,
+                urlShortener: false
+            }
+        };
+    }
+    ;
+    static generateIPValidatorResponse(inputData) {
+        return {
+            ip: inputData?.ip || "",
+            allow: this.validateIP(inputData?.ip),
+            reasons: this.validateIP(inputData?.ip) ? [] : ["INVALID"],
+            response: this.generateIPDataAnalysis(inputData?.ip)
+        };
+    }
+    ;
+    static generateIPDataAnalysis(ip) {
+        const isValid = this.validateIP(ip);
+        return {
+            valid: isValid,
+            type: isValid ? "IPv4" : "Invalid",
+            class: isValid ? "A" : "Unknown",
+            fraud: false,
+            ip: ip || "",
+            continent: "",
+            continentCode: "",
+            country: "",
+            countryCode: "",
+            region: "",
+            regionName: "",
+            city: "",
+            district: "",
+            zipCode: "",
+            lat: 0,
+            lon: 0,
+            timezone: "",
+            offset: 0,
+            currency: "",
+            isp: "",
+            org: "",
+            as: "",
+            asname: "",
+            mobile: false,
+            proxy: true,
+            hosting: false,
+            plugins: {
+                blocklist: false,
+                riskScore: 0
+            }
+        };
+    }
+    ;
+    static generatePhoneValidatorResponse(inputData) {
+        return {
+            phone: inputData?.phone || "",
+            allow: this.validatePhone(inputData?.phone),
+            reasons: this.validatePhone(inputData?.phone) ? [] : ["INVALID"],
+            response: this.generatePhoneDataAnalysis(inputData?.phone)
+        };
+    }
+    ;
+    static generatePhoneDataAnalysis(phone) {
+        const phoneNumber = phone?.phone || phone;
+        const isValid = this.validatePhone(phoneNumber);
+        return {
+            valid: isValid,
+            fraud: false,
+            phone: phone?.phone || "",
+            prefix: "",
+            number: "",
+            lineType: "Unknown",
+            carrierInfo: {
+                carrierName: "",
+                accuracy: 0,
+                carrierCountry: "",
+                carrierCountryCode: ""
+            },
+            country: "",
+            countryCode: "",
+            plugins: {
+                blocklist: false,
+                riskScore: 0
+            }
+        };
+    }
+    ;
+    static generateHTTPRequest(inputData) {
+        return {
+            method: inputData?.method || "GET",
+            url: inputData?.url || "",
+            headers: inputData?.headers || {},
+            body: inputData?.body || null,
+            allow: false,
+            reasons: ["FRAUD"],
+            protected: true
+        };
+    }
+    ;
+    static generateEmailStatus() {
+        return {
+            status: false,
+            error: "API unavailable - using fallback response"
+        };
+    }
+    ;
+    static generateSRNSummary(inputData) {
+        const quantity = inputData?.quantity || 1;
+        const values = Array.from({ length: quantity }, () => ({
+            integer: 0,
+            float: 0.0
+        }));
+        return {
+            values,
+            executionTime: 0
+        };
+    }
+    ;
+    static generateExtractWithTextly(inputData) {
+        return {
+            data: inputData?.data || "",
+            extracted: {},
+            error: "API unavailable - using fallback response"
+        };
+    }
+    ;
+    static generatePrayerTimes(inputData) {
+        return {
+            error: "API unavailable - using fallback response"
+        };
+    }
+    ;
+    static generateSatinizedInputAnalysis(inputData) {
+        return {
+            input: inputData?.input || "",
+            formats: {
+                ascii: false,
+                bitcoinAddress: false,
+                cLikeIdentifier: false,
+                coordinates: false,
+                crediCard: false,
+                date: false,
+                discordUsername: false,
+                doi: false,
+                domain: false,
+                e164Phone: false,
+                email: false,
+                emoji: false,
+                hanUnification: false,
+                hashtag: false,
+                hyphenWordBreak: false,
+                ipv6: false,
+                ip: false,
+                jiraTicket: false,
+                macAddress: false,
+                name: false,
+                number: false,
+                panFromGstin: false,
+                password: false,
+                port: false,
+                tel: false,
+                text: false,
+                semver: false,
+                ssn: false,
+                uuid: false,
+                url: false,
+                urlSlug: false,
+                username: false
+            },
+            includes: {
+                spaces: false,
+                hasSql: false,
+                hasNoSql: false,
+                letters: false,
+                uppercase: false,
+                lowercase: false,
+                symbols: false,
+                digits: false
+            }
+        };
+    }
+    ;
+    static generatePasswordValidationResult(inputData) {
+        return {
+            valid: false,
+            password: inputData?.password || "",
+            details: [
+                {
+                    validation: "length",
+                    message: "API unavailable - using fallback response"
+                }
+            ]
+        };
+    }
+    ;
+}
+exports.FallbackDataGenerator = FallbackDataGenerator;
+;