dymo-api 1.2.20 → 1.2.23

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

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidPhone = void 0;
+const basics_1 = require("../../../../utils/basics.cjs");
+/**
+ * Validates an phone using a secure verification endpoint.
+ *
+ * @param {string | null} token - Authentication token (required).
+ * @param {Interfaces.PhoneValidator} phone - Phone to validate.
+ * @param {Interfaces.PhoneValidatorRules} [rules] - Deny rules. Defaults to ["FRAUD", "INVALID"].
+ *
+ * Deny rules (some are premium ⚠️):
+ * - "FRAUD", "INVALID", "HIGH_RISK_SCORE" ⚠️
+ *
+ * @returns {Promise<boolean>} True if the phone passes all deny rules, false otherwise.
+ * @throws Error if token is null, rules are empty, or request fails.
+ *
+ * @example
+ * const valid = await isValidPhone(apiToken, "+34617509462", { deny: ["FRAUD", "INVALID" });
+ */
+const isValidPhone = async (axiosClient, phone, rules) => {
+    if (!axiosClient.defaults.headers?.Authorization)
+        throw (0, basics_1.customError)(3000, "Invalid private token.");
+    if (rules.deny.length === 0)
+        throw (0, basics_1.customError)(1500, "You must provide at least one deny rule.");
+    if (rules.mode === "DRY_RUN") {
+        console.warn("[Dymo API] DRY_RUN mode is enabled. No requests with real data will be processed until you switch to LIVE mode.");
+        return {
+            phone,
+            allow: true,
+            reasons: [],
+            response: "CHANGE TO LIVE MODE"
+        };
+    }
+    try {
+        const responsePhone = (await axiosClient.post("/private/secure/verify", {
+            phone,
+            plugins: [
+                rules.deny.includes("HIGH_RISK_SCORE") ? "riskScore" : undefined
+            ].filter(Boolean)
+        }, { headers: { "Content-Type": "application/json" } })).data.phone;
+        let reasons = [];
+        if (rules.deny.includes("INVALID") && !responsePhone.valid) {
+            return {
+                phone: responsePhone.phone,
+                allow: false,
+                reasons: ["INVALID"],
+                response: responsePhone
+            };
+        }
+        if (rules.deny.includes("FRAUD") && responsePhone.fraud)
+            reasons.push("FRAUD");
+        if (rules.deny.includes("HIGH_RISK_SCORE") && responsePhone.plugins.riskScore >= 80)
+            reasons.push("HIGH_RISK_SCORE");
+        return {
+            phone: responsePhone.phone,
+            allow: reasons.length === 0,
+            reasons,
+            response: responsePhone
+        };
+    }
+    catch (error) {
+        const statusCode = error.response?.status || 500;
+        const errorMessage = error.response?.data?.message || error.message;
+        const errorDetails = JSON.stringify(error.response?.data || {});
+        throw (0, basics_1.customError)(5000, `Error ${statusCode}: ${errorMessage}. Details: ${errorDetails}`);
+    }
+};
+exports.isValidPhone = isValidPhone;

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

@@ -18,5 +18,6 @@ __exportStar(require("./functions/extractWithTextly/index.cjs"), exports);
 __exportStar(require("./functions/getRandom/index.cjs"), exports);
 __exportStar(require("./functions/isValidDataRaw/index.cjs"), exports);
 __exportStar(require("./functions/isValidEmail/index.cjs"), exports);
+__exportStar(require("./functions/isValidPhone/index.cjs"), exports);
 __exportStar(require("./functions/protectReq/index.cjs"), exports);
 __exportStar(require("./functions/sendEmail/index.cjs"), exports);

package/dist/cjs/dymo-api.cjs

@@ -62,6 +62,7 @@ class DymoAPI {
     constructor({ rootApiKey = null, apiKey = null, baseUrl = "https://api.tpeoficial.com", serverEmailConfig = undefined, rules = {} } = {}) {
         this.rules = {
             email: { mode: "LIVE", deny: ["FRAUD", "INVALID", "NO_MX_RECORDS", "NO_REPLY_EMAIL"] },
+            phone: { mode: "LIVE", deny: ["FRAUD", "INVALID"] },
             sensitiveInfo: { mode: "LIVE", deny: ["EMAIL", "PHONE", "CREDIT_CARD"] },
             waf: { mode: "LIVE", allowBots: ["CURL", "CATEGORY:SEARCH_ENGINE", "CATEGORY:PREVIEW"], deny: ["FRAUD", "TOR_NETWORK"] },
             ...rules
@@ -76,7 +77,7 @@ class DymoAPI {
             headers: {
                 "User-Agent": "DymoAPISDK/1.0.0",
                 "X-Dymo-SDK-Env": "Node",
-                "X-Dymo-SDK-Version": "1.2.20"
+                "X-Dymo-SDK-Version": "1.2.23"
             }
         });
         // We set the authorization in the Axios client to make requests.
@@ -144,7 +145,7 @@ class DymoAPI {
      * This method requires either the root API key or the API key to be set.
      * If neither is set, it will throw an error.
      *
-     * @param {string} [email] - Optional email address to validate.
+     * @param {string} [email] - Email address to validate.
      * @param {NegativeEmailRules[]} [rules] - Optional rules for validation. Some rules are premium features.
      * @important
      * **⚠️ NO_MX_RECORDS, HIGH_RISK_SCORE and NO_REACHABLE are [PREMIUM](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier) features.**
@@ -154,12 +155,34 @@ class DymoAPI {
      * @example
      * const valid = await dymoClient.isValidEmail("user@example.com", { deny: ["FRAUD", "NO_MX_RECORDS"] });
      *
-     * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/request-verifier)
+     * @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);
     }
     ;
+    /**
+     * Validates the given email against the configured rules.
+     *
+     * This method requires either the root API key or the API key to be set.
+     * If neither is set, it will throw an error.
+     *
+     * @param {string} [phone] - Phone number to validate.
+     * @param {NegativePhoneRules[]} [rules] - Optional rules for validation. Some rules are premium features.
+     * @important
+     * **⚠️ HIGH_RISK_SCORE is a [PREMIUM](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier) feature.**
+     * @returns {Promise<Interfaces.EmailValidatorResponse>} Resolves with the validation response.
+     * @throws Will throw an error if validation cannot be performed.
+     *
+     * @example
+     * const valid = await dymoClient.isValidPhone("+34617509462", { deny: ["FRAUD", "INVALID"] });
+     *
+     * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/phone-validation)
+     */
+    async isValidPhone(phone, rules = this.rules.phone) {
+        return await PrivateAPI.isValidPhone(this.axiosClient, phone, rules);
+    }
+    ;
     /**
      * Protects the given request against the configured rules.
      *

package/dist/esm/branches/private/functions/isValidPhone/index.js

@@ -0,0 +1,65 @@
+import { customError } from "../../../../utils/basics.js";
+/**
+ * Validates an phone using a secure verification endpoint.
+ *
+ * @param {string | null} token - Authentication token (required).
+ * @param {Interfaces.PhoneValidator} phone - Phone to validate.
+ * @param {Interfaces.PhoneValidatorRules} [rules] - Deny rules. Defaults to ["FRAUD", "INVALID"].
+ *
+ * Deny rules (some are premium ⚠️):
+ * - "FRAUD", "INVALID", "HIGH_RISK_SCORE" ⚠️
+ *
+ * @returns {Promise<boolean>} True if the phone passes all deny rules, false otherwise.
+ * @throws Error if token is null, rules are empty, or request fails.
+ *
+ * @example
+ * const valid = await isValidPhone(apiToken, "+34617509462", { deny: ["FRAUD", "INVALID" });
+ */
+export const isValidPhone = async (axiosClient, phone, rules) => {
+    if (!axiosClient.defaults.headers?.Authorization)
+        throw customError(3000, "Invalid private token.");
+    if (rules.deny.length === 0)
+        throw customError(1500, "You must provide at least one deny rule.");
+    if (rules.mode === "DRY_RUN") {
+        console.warn("[Dymo API] DRY_RUN mode is enabled. No requests with real data will be processed until you switch to LIVE mode.");
+        return {
+            phone,
+            allow: true,
+            reasons: [],
+            response: "CHANGE TO LIVE MODE"
+        };
+    }
+    try {
+        const responsePhone = (await axiosClient.post("/private/secure/verify", {
+            phone,
+            plugins: [
+                rules.deny.includes("HIGH_RISK_SCORE") ? "riskScore" : undefined
+            ].filter(Boolean)
+        }, { headers: { "Content-Type": "application/json" } })).data.phone;
+        let reasons = [];
+        if (rules.deny.includes("INVALID") && !responsePhone.valid) {
+            return {
+                phone: responsePhone.phone,
+                allow: false,
+                reasons: ["INVALID"],
+                response: responsePhone
+            };
+        }
+        if (rules.deny.includes("FRAUD") && responsePhone.fraud)
+            reasons.push("FRAUD");
+        if (rules.deny.includes("HIGH_RISK_SCORE") && responsePhone.plugins.riskScore >= 80)
+            reasons.push("HIGH_RISK_SCORE");
+        return {
+            phone: responsePhone.phone,
+            allow: reasons.length === 0,
+            reasons,
+            response: responsePhone
+        };
+    }
+    catch (error) {
+        const statusCode = error.response?.status || 500;
+        const errorMessage = error.response?.data?.message || error.message;
+        const errorDetails = JSON.stringify(error.response?.data || {});
+        throw customError(5000, `Error ${statusCode}: ${errorMessage}. Details: ${errorDetails}`);
+    }
+};

package/dist/esm/branches/private/index.js

@@ -2,5 +2,6 @@ export * from "./functions/extractWithTextly";
 export * from "./functions/getRandom";
 export * from "./functions/isValidDataRaw";
 export * from "./functions/isValidEmail";
+export * from "./functions/isValidPhone";
 export * from "./functions/protectReq";
 export * from "./functions/sendEmail";

package/dist/esm/dymo-api.js

@@ -24,6 +24,7 @@ class DymoAPI {
     constructor({ rootApiKey = null, apiKey = null, baseUrl = "https://api.tpeoficial.com", serverEmailConfig = undefined, rules = {} } = {}) {
         this.rules = {
             email: { mode: "LIVE", deny: ["FRAUD", "INVALID", "NO_MX_RECORDS", "NO_REPLY_EMAIL"] },
+            phone: { mode: "LIVE", deny: ["FRAUD", "INVALID"] },
             sensitiveInfo: { mode: "LIVE", deny: ["EMAIL", "PHONE", "CREDIT_CARD"] },
             waf: { mode: "LIVE", allowBots: ["CURL", "CATEGORY:SEARCH_ENGINE", "CATEGORY:PREVIEW"], deny: ["FRAUD", "TOR_NETWORK"] },
             ...rules
@@ -38,7 +39,7 @@ class DymoAPI {
             headers: {
                 "User-Agent": "DymoAPISDK/1.0.0",
                 "X-Dymo-SDK-Env": "Node",
-                "X-Dymo-SDK-Version": "1.2.20"
+                "X-Dymo-SDK-Version": "1.2.23"
             }
         });
         // We set the authorization in the Axios client to make requests.
@@ -106,7 +107,7 @@ class DymoAPI {
      * This method requires either the root API key or the API key to be set.
      * If neither is set, it will throw an error.
      *
-     * @param {string} [email] - Optional email address to validate.
+     * @param {string} [email] - Email address to validate.
      * @param {NegativeEmailRules[]} [rules] - Optional rules for validation. Some rules are premium features.
      * @important
      * **⚠️ NO_MX_RECORDS, HIGH_RISK_SCORE and NO_REACHABLE are [PREMIUM](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier) features.**
@@ -116,12 +117,34 @@ class DymoAPI {
      * @example
      * const valid = await dymoClient.isValidEmail("user@example.com", { deny: ["FRAUD", "NO_MX_RECORDS"] });
      *
-     * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/request-verifier)
+     * @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);
     }
     ;
+    /**
+     * Validates the given email against the configured rules.
+     *
+     * This method requires either the root API key or the API key to be set.
+     * If neither is set, it will throw an error.
+     *
+     * @param {string} [phone] - Phone number to validate.
+     * @param {NegativePhoneRules[]} [rules] - Optional rules for validation. Some rules are premium features.
+     * @important
+     * **⚠️ HIGH_RISK_SCORE is a [PREMIUM](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier) feature.**
+     * @returns {Promise<Interfaces.EmailValidatorResponse>} Resolves with the validation response.
+     * @throws Will throw an error if validation cannot be performed.
+     *
+     * @example
+     * const valid = await dymoClient.isValidPhone("+34617509462", { deny: ["FRAUD", "INVALID"] });
+     *
+     * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/phone-validation)
+     */
+    async isValidPhone(phone, rules = this.rules.phone) {
+        return await PrivateAPI.isValidPhone(this.axiosClient, phone, rules);
+    }
+    ;
     /**
      * Protects the given request against the configured rules.
      *

package/dist/types/branches/private/functions/isValidPhone/index.d.ts

@@ -0,0 +1,19 @@
+import { type AxiosInstance } from "axios";
+import * as Interfaces from "../../../../lib/types/interfaces";
+/**
+ * Validates an phone using a secure verification endpoint.
+ *
+ * @param {string | null} token - Authentication token (required).
+ * @param {Interfaces.PhoneValidator} phone - Phone to validate.
+ * @param {Interfaces.PhoneValidatorRules} [rules] - Deny rules. Defaults to ["FRAUD", "INVALID"].
+ *
+ * Deny rules (some are premium ⚠️):
+ * - "FRAUD", "INVALID", "HIGH_RISK_SCORE" ⚠️
+ *
+ * @returns {Promise<boolean>} True if the phone passes all deny rules, false otherwise.
+ * @throws Error if token is null, rules are empty, or request fails.
+ *
+ * @example
+ * const valid = await isValidPhone(apiToken, "+34617509462", { deny: ["FRAUD", "INVALID" });
+ */
+export declare const isValidPhone: (axiosClient: AxiosInstance, phone: Interfaces.PhoneValidator, rules: Interfaces.PhoneValidatorRules) => Promise<any>;

package/dist/types/branches/private/index.d.ts

@@ -2,5 +2,6 @@ export * from "./functions/extractWithTextly";
 export * from "./functions/getRandom";
 export * from "./functions/isValidDataRaw";
 export * from "./functions/isValidEmail";
+export * from "./functions/isValidPhone";
 export * from "./functions/protectReq";
 export * from "./functions/sendEmail";

package/dist/types/dymo-api.d.ts

@@ -83,7 +83,7 @@ declare class DymoAPI {
      * This method requires either the root API key or the API key to be set.
      * If neither is set, it will throw an error.
      *
-     * @param {string} [email] - Optional email address to validate.
+     * @param {string} [email] - Email address to validate.
      * @param {NegativeEmailRules[]} [rules] - Optional rules for validation. Some rules are premium features.
      * @important
      * **⚠️ NO_MX_RECORDS, HIGH_RISK_SCORE and NO_REACHABLE are [PREMIUM](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier) features.**
@@ -93,9 +93,28 @@ declare class DymoAPI {
      * @example
      * const valid = await dymoClient.isValidEmail("user@example.com", { deny: ["FRAUD", "NO_MX_RECORDS"] });
      *
-     * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/request-verifier)
+     * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/email-validation)
      */
     isValidEmail(email: Interfaces.EmailValidator, rules?: Interfaces.EmailValidatorRules): Promise<Interfaces.EmailValidatorResponse>;
+    /**
+     * Validates the given email against the configured rules.
+     *
+     * This method requires either the root API key or the API key to be set.
+     * If neither is set, it will throw an error.
+     *
+     * @param {string} [phone] - Phone number to validate.
+     * @param {NegativePhoneRules[]} [rules] - Optional rules for validation. Some rules are premium features.
+     * @important
+     * **⚠️ HIGH_RISK_SCORE is a [PREMIUM](https://docs.tpeoficial.com/docs/dymo-api/private/data-verifier) feature.**
+     * @returns {Promise<Interfaces.EmailValidatorResponse>} Resolves with the validation response.
+     * @throws Will throw an error if validation cannot be performed.
+     *
+     * @example
+     * const valid = await dymoClient.isValidPhone("+34617509462", { deny: ["FRAUD", "INVALID"] });
+     *
+     * @see [Documentation](https://docs.tpeoficial.com/docs/dymo-api/private/phone-validation)
+     */
+    isValidPhone(phone: Interfaces.PhoneValidator, rules?: Interfaces.PhoneValidatorRules): Promise<Interfaces.PhoneValidatorResponse>;
     /**
      * Protects the given request against the configured rules.
      *
@@ -243,4 +262,4 @@ declare class DymoAPI {
     isValidPwd(data: Interfaces.IsValidPwdData): Promise<Interfaces.PasswordValidationResult>;
 }
 export default DymoAPI;
-export type { EmailValidatorRules, WafRules, NegativeEmailRules, SensitiveInfoRules, DataEmailValidationAnalysis } from "./lib/types/interfaces";
+export type { EmailValidatorRules, NegativeEmailRules, DataEmailValidationAnalysis, PhoneValidatorRules, NegativePhoneRules, DataPhoneValidationAnalysis, WafRules, SensitiveInfoRules } from "./lib/types/interfaces";

package/dist/types/lib/types/data-verifier.d.ts

@@ -28,7 +28,7 @@ export interface Validator {
      * Credit card number or object to validate.
      * Checks for fraud, test cards, card type, and optional blocklist or risk score plugins.
      */
-    creditCard?: string | CreditCard;
+    creditCard?: CreditCard;
     /**
      * IP address to validate. Example: `192.168.0.1`.
      * Validation includes type (IPv4/IPv6), class (A-E), geolocation, proxy/hosting detection, fraud, and plugins.
@@ -64,6 +64,14 @@ export type EmailValidator = Email;
  * ⚠️ NO_MX_RECORDS, PROXIED_EMAIL, FREE_SUBDOMAIN, CORPORATE, NO_GRAVATAR, and HIGH_RISK_SCORE are premium features.
  */
 export type NegativeEmailRules = "FRAUD" | "INVALID" | "NO_MX_RECORDS" | "PROXIED_EMAIL" | "FREE_SUBDOMAIN" | "PERSONAL_EMAIL" | "CORPORATE_EMAIL" | "NO_REPLY_EMAIL" | "ROLE_ACCOUNT" | "NO_GRAVATAR" | "NO_REACHABLE" | "HIGH_RISK_SCORE";
+export type PhoneValidator = Phone;
+/**
+ * @typedef {"FRAUD"|"INVALID"|"HIGH_RISK_SCORE"} NegativePhoneRules
+ * ⚠️ HIGH_RISK_SCORE is a premium feature.
+ * @description
+ * Values indicating why an phone is considered negative.
+ */
+export type NegativePhoneRules = "FRAUD" | "INVALID" | "HIGH_RISK_SCORE";
 export type NegativeSensitiveInfoRules = "EMAIL" | "PHONE" | "CREDIT_CARD" | "URL" | "DOMAIN" | "IP" | "WALLET" | "USER_AGENT";
 /**
  * Response returned by the email validator.
@@ -78,6 +86,19 @@ export type EmailValidatorResponse = {
     /** Detailed analysis of the email validation result. */
     response: DataEmailValidationAnalysis;
 };
+/**
+ * Response returned by the phone validator.
+ */
+export type PhoneValidatorResponse = {
+    /** The validated phone number. */
+    phone: string;
+    /** Whether the email is allowed (not blocked/fraudulent). */
+    allow: boolean;
+    /** List of rules indicating why the email may be considered negative. */
+    reasons: NegativePhoneRules[];
+    /** Detailed analysis of the email validation result. */
+    response: DataPhoneValidationAnalysis;
+};
 /**
  * Response returned by the sensitive info validator.
  */
@@ -141,6 +162,45 @@ export interface DataEmailValidationAnalysis {
         urlShortener?: boolean;
     };
 }
+/**
+ * Detailed analysis of an phone validation.
+ */
+export interface DataPhoneValidationAnalysis {
+    /** Whether the phone number is valid. */
+    valid: boolean;
+    /** Whether the phone number is fraudulent. */
+    fraud: boolean;
+    /** The phone number being analyzed. */
+    phone: string;
+    /** The country code for the phone number. */
+    prefix: string;
+    /** The line type for the phone number. */
+    number: string;
+    /** The line type for the phone number. */
+    lineType: "PREMIUM_RATE" | "TOLL_FREE" | "SHARED_COST" | "VOIP" | "PERSONAL_NUMBER" | "PAGER" | "UAN" | "VOICEMAIL" | "FIXED_LINE_OR_MOBILE" | "FIXED_LINE" | "MOBILE" | "Unknown";
+    /** The carrier information for the phone number. */
+    carrierInfo: {
+        /** The carrier name for the phone number. */
+        carrierName: string;
+        /** The accuracy of the carrier information. */
+        accuracy: number;
+        /** The carrier country for the phone number. */
+        carrierCountry: string;
+        /** The carrier country code for the phone number. */
+        carrierCountryCode: string;
+    };
+    /** The country for the phone number. */
+    country: string;
+    /** The country code for the phone number. */
+    countryCode: string;
+    /** Results from optional validation plugins. */
+    plugins: {
+        /** Whether the phone number is blocked by a blocklist. */
+        blocklist?: boolean;
+        /** The risk score for the phone number. */
+        riskScore?: number;
+    };
+}
 export interface DataValidationAnalysis {
     /** URL validation result. */
     url: {
@@ -181,42 +241,7 @@ export interface DataValidationAnalysis {
     /** Email validation result. */
     email: DataEmailValidationAnalysis;
     /** Phone validation result. */
-    phone: {
-        /** Whether the phone number is valid. */
-        valid: boolean;
-        /** Whether the phone number is fraudulent. */
-        fraud: boolean;
-        /** The phone number being analyzed. */
-        phone: string;
-        /** The country code for the phone number. */
-        prefix: string;
-        /** The line type for the phone number. */
-        number: string;
-        /** The line type for the phone number. */
-        lineType: "PREMIUM_RATE" | "TOLL_FREE" | "SHARED_COST" | "VOIP" | "PERSONAL_NUMBER" | "PAGER" | "UAN" | "VOICEMAIL" | "FIXED_LINE_OR_MOBILE" | "FIXED_LINE" | "MOBILE" | "Unknown";
-        /** The carrier information for the phone number. */
-        carrierInfo: {
-            /** The carrier name for the phone number. */
-            carrierName: string;
-            /** The accuracy of the carrier information. */
-            accuracy: number;
-            /** The carrier country for the phone number. */
-            carrierCountry: string;
-            /** The carrier country code for the phone number. */
-            carrierCountryCode: string;
-        };
-        /** The country for the phone number. */
-        country: string;
-        /** The country code for the phone number. */
-        countryCode: string;
-        /** Results from optional validation plugins. */
-        plugins: {
-            /** Whether the phone number is blocked by a blocklist. */
-            blocklist?: boolean;
-            /** The risk score for the phone number. */
-            riskScore?: number;
-        };
-    };
+    phone: DataPhoneValidationAnalysis;
     /** Domain validation result. */
     domain: {
         /** Whether the domain is valid. */

package/dist/types/lib/types/primitives.d.ts

@@ -1,28 +1,31 @@
-export type Email = `${string}@${string}` | string;
+export type Email = `${string}@${string}.${string}` | string;
+type Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
 export type Phone = {
     /** The country code of the phone number. */
     iso: any;
     /** The phone number. */
     phone: string;
-} | string;
-export interface CreditCard {
+} | `+${string}` | string;
+type CvcString = `${Digit}${Digit}${Digit}` | string | number;
+export type CreditCard = {
     /** The credit card number. */
     pan: string | number;
     /** The expiration date of the credit card. */
     expirationDate?: string;
     /** The security code of the credit card. */
-    cvc?: string | number;
+    cvc?: CvcString;
     /** The security code of the credit card. */
-    cvv?: string | number;
-}
+    cvv?: CvcString;
+} | string;
 export interface HTTPRequest {
     /** The URL to make the request to. */
     url: string;
     /** The HTTP method to use. */
-    method: string | "GET" | "POST" | "PUT" | "DELETE";
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | string;
     /** The headers to include in the request. */
     headers?: Record<string, string>;
     /** The body of the request. */
     body?: string | object | null;
     [key: string]: any;
 }
+export {};

package/dist/types/lib/types/rules.d.ts

@@ -1,5 +1,5 @@
 import * as WellKnownBots from "./well-known-bots";
-import { NegativeEmailRules, NegativeSensitiveInfoRules } from "./data-verifier";
+import { NegativeEmailRules, NegativePhoneRules, NegativeSensitiveInfoRules } from "./data-verifier";
 type Mode = "LIVE" | "DRY_RUN";
 export type NegativeWafRules = "FRAUD" | "VPN" | "PROXY" | "TOR_NETWORK";
 export interface WafRules {
@@ -11,12 +11,17 @@ export interface EmailValidatorRules {
     mode?: Mode;
     deny: NegativeEmailRules[];
 }
+export interface PhoneValidatorRules {
+    mode?: Mode;
+    deny: NegativePhoneRules[];
+}
 export interface SensitiveInfoRules {
     mode?: Mode;
     deny: NegativeSensitiveInfoRules[];
 }
 export interface Rules {
     email?: EmailValidatorRules;
+    phone?: PhoneValidatorRules;
     sensitiveInfo?: SensitiveInfoRules;
     waf?: WafRules;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dymo-api",
-  "version": "1.2.20",
+  "version": "1.2.23",
   "description": "Flow system for Dymo API.",
   "main": "dist/cjs/dymo-api.js",
   "module": "dist/esm/dymo-api.js",
@@ -39,7 +39,18 @@
     "Dymo",
     "Dymo API",
     "TPEOficial",
-    "Ciphera"
+    "Ciphera",
+    "email verification",
+    "email validation",
+    "disposable email detector",
+    "disposable checker",
+    "fraud detection",
+    "anti fraud",
+    "multiaccount detection",
+    "fake user prevention",
+    "bot detection",
+    "spam protection",
+    "user validation"
   ],
   "author": "TPEOficial LLC",
   "license": "Apache-2.0",