@dymo-api/better-auth 1.2.21 → 1.2.24

package/README.md

@@ -1,7 +1,31 @@
-# Official Dymo API Library for Better-Auth.
+<div align="center">
+  <h1>Dymo API for Better-Auth</h1>
+  <h3>Official Dymo API Library for Better-Auth</h3>
+  <img src="https://img.shields.io/badge/TypeScript-purple?style=for-the-badge&logo=typescript&logoColor=white"/> 
+  <a href="https://github.com/TPEOficial"> <img alt="GitHub" src="https://img.shields.io/badge/GitHub-purple?style=for-the-badge&logo=github&logoColor=white"/></a>
+  <a href="https://ko-fi.com/fjrg2007"> <img alt="Kofi" src="https://img.shields.io/badge/Ko--fi-purple?style=for-the-badge&logo=ko-fi&logoColor=white"></a>
+  <br />
+  <br />
+  <a href="https://docs.tpeoficial.com/docs/dymo-api/integrations/better-auth/email-validation?ch-pg=gh-dmapi-better-auth-rd-step">Quickstart</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://tpe.li/dsc">Discord</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://docs.tpeoficial.com/docs/dymo-api/integrations/better-auth/getting-started?ch-pg=gh-dmapi-better-auth-rd-step">All Features</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://docs.tpeoficial.com/docs/dymo-api/getting-started/authentication?ch-pg=gh-dmapi-better-auth-rd-step">Node SDK</a>
+  <span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>
+  <a href="https://docs.tpeoficial.com/docs/dymo-api/getting-started/faq?ch-pg=gh-dmapi-better-auth-rd-step">FAQ</a>
+  <br />
+  <hr />
+</div>
 
 You can see the library documentation by clicking [here](https://docs.tpeoficial.com/docs/dymo-api/getting-started/libraries?ch-pg=r-dm-better-auth).
 
+ - ✅ World's largest fraud validation database | `fakeuser@temp.com` -> **Blocked**.
+ - ✅ Fraud validation for personal emails and OAuth (the only one on the market today) | `fakeuser@gmail.com` -> **Blocked**.
+ - ✅ Multi-data validation at no additional cost | Validate email addresses, phone numbers, and more at no additional cost, all in one place.
+ - ✅ Data normalization | `fo.o+tem.p@gmail.com` -> `foo@gmail.com`.
+
 #### Installation
 
 Use one of the following commands to install **Dymo API** in your `TS`/`JS` project.

package/dist/cjs/index.cjs

@@ -1,5 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.dymoEmailPlugin = void 0;
+exports.dymoPhonePlugin = exports.dymoIPPlugin = exports.dymoEmailPlugin = void 0;
 var emailValidation_1 = require("./plugins/emailValidation/index.cjs");
 Object.defineProperty(exports, "dymoEmailPlugin", { enumerable: true, get: function () { return emailValidation_1.dymoEmailPlugin; } });
+var ipValidation_1 = require("./plugins/ipValidation/index.cjs");
+Object.defineProperty(exports, "dymoIPPlugin", { enumerable: true, get: function () { return ipValidation_1.dymoIPPlugin; } });
+var phoneValidation_1 = require("./plugins/phoneValidation/index.cjs");
+Object.defineProperty(exports, "dymoPhonePlugin", { enumerable: true, get: function () { return phoneValidation_1.dymoPhonePlugin; } });

package/dist/cjs/plugins/emailValidation/index.cjs

@@ -18,7 +18,20 @@ const dymoEmailPlugin = ({ apiKey, applyToLogin = false, applyToOAuth = true, em
             }
         }
     });
-    const activePaths = ["/sign-up/email"];
+    const activePaths = [
+        "/sign-up/email",
+        "/email-otp/verify-email",
+        "/sign-in/email-otp",
+        "/sign-in/magic-link",
+        "/forget-password/email-otp",
+        "/email-otp/reset-password",
+        "/email-otp/create-verification-otp",
+        "/email-otp/get-verification-otp",
+        "/email-otp/send-verification-otp",
+        "/forget-password",
+        "/send-verification-email",
+        "/change-email"
+    ];
     if (applyToLogin)
         activePaths.push("/sign-in/email");
     if (applyToOAuth) {

package/dist/cjs/plugins/ipValidation/index.cjs

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dymoIPPlugin = void 0;
+const api_1 = require("better-auth/api");
+const dymo_api_1 = __importDefault(require("dymo-api"));
+const ipHeaders = ["x-forwarded-for", "cf-connecting-ip", "x-vercel-forwarded-for", "x-real-ip"];
+const dymoIPPlugin = ({ apiKey, applyToLogin = false, applyToOAuth = true, ipRules }) => {
+    const defaultRules = {
+        deny: ["FRAUD", "INVALID", "TOR_NETWORK"]
+    };
+    const dymoClient = new dymo_api_1.default({
+        apiKey,
+        rules: {
+            ip: {
+                deny: ipRules?.deny ?? defaultRules.deny
+            }
+        }
+    });
+    const activePaths = [
+        "/sign-up/email",
+        "/email-otp/verify-email",
+        "/sign-in/email-otp",
+        "/sign-in/magic-link",
+        "/forget-password/email-otp",
+        "/email-otp/reset-password",
+        "/email-otp/create-verification-otp",
+        "/email-otp/get-verification-otp",
+        "/email-otp/send-verification-otp",
+        "/forget-password",
+        "/send-verification-email",
+        "/change-email"
+    ];
+    if (applyToLogin)
+        activePaths.push("/sign-in/email");
+    if (applyToOAuth) {
+        activePaths.push("/sign-up/oauth");
+        activePaths.push("/sign-in/oauth");
+    }
+    return {
+        id: "dymoIPPlugin",
+        hooks: {
+            before: [
+                {
+                    matcher: (context) => activePaths.some(path => context.path.startsWith(path)),
+                    handler: (0, api_1.createAuthMiddleware)(async (ctx) => {
+                        let ip = null;
+                        for (const header of ipHeaders) {
+                            const value = ctx.request.headers.get(header);
+                            if (value) {
+                                ip = value.split(",")[0].trim();
+                                break;
+                            }
+                        }
+                        if (typeof ip !== "string")
+                            throw new api_1.APIError("BAD_REQUEST", { message: "IP must be a string." });
+                        const decision = await dymoClient.isValidIP(ip);
+                        if (!decision.allow) {
+                            throw new api_1.APIError("BAD_REQUEST", {
+                                message: "IP is invalid or blocked.",
+                                reasons: decision.reasons
+                            });
+                        }
+                        ctx.body.ip = decision.ip;
+                        ctx.request.headers.set("x-dymo-client-ip", decision.ip);
+                        ctx.dymoIP = decision.response;
+                        return { context: ctx };
+                    })
+                }
+            ]
+        }
+    };
+};
+exports.dymoIPPlugin = dymoIPPlugin;

package/dist/cjs/plugins/phoneValidation/index.cjs

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dymoPhonePlugin = void 0;
+const api_1 = require("better-auth/api");
+const dymo_api_1 = __importDefault(require("dymo-api"));
+const dymoPhonePlugin = ({ apiKey, applyToLogin = false, applyToOAuth = true, phoneRules }) => {
+    const defaultRules = {
+        deny: ["FRAUD", "INVALID"]
+    };
+    const dymoClient = new dymo_api_1.default({
+        apiKey,
+        rules: {
+            phone: {
+                deny: phoneRules?.deny ?? defaultRules.deny
+            }
+        }
+    });
+    const activePaths = [
+        "/sign-in/phone-number",
+        "/phone-number/forget-password",
+        "/phone-number/reset-password",
+        "/phone-number/send-otp",
+        "/phone-number/verify"
+    ];
+    if (applyToLogin)
+        activePaths.push("/sign-in/email");
+    if (applyToOAuth) {
+        activePaths.push("/sign-up/oauth");
+        activePaths.push("/sign-in/oauth");
+    }
+    return {
+        id: "dymoPhonePlugin",
+        hooks: {
+            before: [
+                {
+                    matcher: (context) => activePaths.some(path => context.path.startsWith(path)),
+                    handler: (0, api_1.createAuthMiddleware)(async (ctx) => {
+                        const phoneNumber = ctx.body?.phoneNumber || ctx.body?.profile?.phoneNumber;
+                        if (typeof phoneNumber !== "string")
+                            throw new api_1.APIError("BAD_REQUEST", { message: "Phone number must be a string." });
+                        const decision = await dymoClient.isValidPhone(phoneNumber);
+                        if (!decision.allow) {
+                            throw new api_1.APIError("BAD_REQUEST", {
+                                message: "Phone number is invalid or blocked.",
+                                reasons: decision.reasons
+                            });
+                        }
+                        ctx.body.phoneNumber = decision.phone;
+                        ctx.dymoEmail = decision.response;
+                        return { context: ctx };
+                    })
+                }
+            ]
+        }
+    };
+};
+exports.dymoPhonePlugin = dymoPhonePlugin;

package/dist/esm/index.js

@@ -1 +1,3 @@
 export { dymoEmailPlugin } from "./plugins/emailValidation";
+export { dymoIPPlugin } from "./plugins/ipValidation";
+export { dymoPhonePlugin } from "./plugins/phoneValidation";

package/dist/esm/plugins/emailValidation/index.js

@@ -12,7 +12,20 @@ export const dymoEmailPlugin = ({ apiKey, applyToLogin = false, applyToOAuth = t
             }
         }
     });
-    const activePaths = ["/sign-up/email"];
+    const activePaths = [
+        "/sign-up/email",
+        "/email-otp/verify-email",
+        "/sign-in/email-otp",
+        "/sign-in/magic-link",
+        "/forget-password/email-otp",
+        "/email-otp/reset-password",
+        "/email-otp/create-verification-otp",
+        "/email-otp/get-verification-otp",
+        "/email-otp/send-verification-otp",
+        "/forget-password",
+        "/send-verification-email",
+        "/change-email"
+    ];
     if (applyToLogin)
         activePaths.push("/sign-in/email");
     if (applyToOAuth) {

package/dist/esm/plugins/ipValidation/index.js

@@ -0,0 +1,69 @@
+import { APIError, createAuthMiddleware } from "better-auth/api";
+import DymoAPI from "dymo-api";
+const ipHeaders = ["x-forwarded-for", "cf-connecting-ip", "x-vercel-forwarded-for", "x-real-ip"];
+export const dymoIPPlugin = ({ apiKey, applyToLogin = false, applyToOAuth = true, ipRules }) => {
+    const defaultRules = {
+        deny: ["FRAUD", "INVALID", "TOR_NETWORK"]
+    };
+    const dymoClient = new DymoAPI({
+        apiKey,
+        rules: {
+            ip: {
+                deny: ipRules?.deny ?? defaultRules.deny
+            }
+        }
+    });
+    const activePaths = [
+        "/sign-up/email",
+        "/email-otp/verify-email",
+        "/sign-in/email-otp",
+        "/sign-in/magic-link",
+        "/forget-password/email-otp",
+        "/email-otp/reset-password",
+        "/email-otp/create-verification-otp",
+        "/email-otp/get-verification-otp",
+        "/email-otp/send-verification-otp",
+        "/forget-password",
+        "/send-verification-email",
+        "/change-email"
+    ];
+    if (applyToLogin)
+        activePaths.push("/sign-in/email");
+    if (applyToOAuth) {
+        activePaths.push("/sign-up/oauth");
+        activePaths.push("/sign-in/oauth");
+    }
+    return {
+        id: "dymoIPPlugin",
+        hooks: {
+            before: [
+                {
+                    matcher: (context) => activePaths.some(path => context.path.startsWith(path)),
+                    handler: createAuthMiddleware(async (ctx) => {
+                        let ip = null;
+                        for (const header of ipHeaders) {
+                            const value = ctx.request.headers.get(header);
+                            if (value) {
+                                ip = value.split(",")[0].trim();
+                                break;
+                            }
+                        }
+                        if (typeof ip !== "string")
+                            throw new APIError("BAD_REQUEST", { message: "IP must be a string." });
+                        const decision = await dymoClient.isValidIP(ip);
+                        if (!decision.allow) {
+                            throw new APIError("BAD_REQUEST", {
+                                message: "IP is invalid or blocked.",
+                                reasons: decision.reasons
+                            });
+                        }
+                        ctx.body.ip = decision.ip;
+                        ctx.request.headers.set("x-dymo-client-ip", decision.ip);
+                        ctx.dymoIP = decision.response;
+                        return { context: ctx };
+                    })
+                }
+            ]
+        }
+    };
+};

package/dist/esm/plugins/phoneValidation/index.js

@@ -0,0 +1,53 @@
+import { APIError, createAuthMiddleware } from "better-auth/api";
+import DymoAPI from "dymo-api";
+export const dymoPhonePlugin = ({ apiKey, applyToLogin = false, applyToOAuth = true, phoneRules }) => {
+    const defaultRules = {
+        deny: ["FRAUD", "INVALID"]
+    };
+    const dymoClient = new DymoAPI({
+        apiKey,
+        rules: {
+            phone: {
+                deny: phoneRules?.deny ?? defaultRules.deny
+            }
+        }
+    });
+    const activePaths = [
+        "/sign-in/phone-number",
+        "/phone-number/forget-password",
+        "/phone-number/reset-password",
+        "/phone-number/send-otp",
+        "/phone-number/verify"
+    ];
+    if (applyToLogin)
+        activePaths.push("/sign-in/email");
+    if (applyToOAuth) {
+        activePaths.push("/sign-up/oauth");
+        activePaths.push("/sign-in/oauth");
+    }
+    return {
+        id: "dymoPhonePlugin",
+        hooks: {
+            before: [
+                {
+                    matcher: (context) => activePaths.some(path => context.path.startsWith(path)),
+                    handler: createAuthMiddleware(async (ctx) => {
+                        const phoneNumber = ctx.body?.phoneNumber || ctx.body?.profile?.phoneNumber;
+                        if (typeof phoneNumber !== "string")
+                            throw new APIError("BAD_REQUEST", { message: "Phone number must be a string." });
+                        const decision = await dymoClient.isValidPhone(phoneNumber);
+                        if (!decision.allow) {
+                            throw new APIError("BAD_REQUEST", {
+                                message: "Phone number is invalid or blocked.",
+                                reasons: decision.reasons
+                            });
+                        }
+                        ctx.body.phoneNumber = decision.phone;
+                        ctx.dymoEmail = decision.response;
+                        return { context: ctx };
+                    })
+                }
+            ]
+        }
+    };
+};

package/dist/types/index.d.ts

@@ -1 +1,3 @@
 export { dymoEmailPlugin } from "./plugins/emailValidation";
+export { dymoIPPlugin } from "./plugins/ipValidation";
+export { dymoPhonePlugin } from "./plugins/phoneValidation";

package/dist/types/plugins/ipValidation/index.d.ts

@@ -0,0 +1,19 @@
+import { IPValidatorRules } from "dymo-api";
+interface dymoIPPluginOptions {
+    apiKey: string;
+    applyToLogin?: boolean;
+    applyToOAuth?: boolean;
+    ipRules?: Partial<IPValidatorRules>;
+}
+export declare const dymoIPPlugin: ({ apiKey, applyToLogin, applyToOAuth, ipRules }: dymoIPPluginOptions) => {
+    id: "dymoIPPlugin";
+    hooks: {
+        before: {
+            matcher: (context: any) => boolean;
+            handler: (inputContext: import("better-auth").MiddlewareInputContext<import("better-auth").MiddlewareOptions>) => Promise<{
+                context: any;
+            }>;
+        }[];
+    };
+};
+export {};

package/dist/types/plugins/phoneValidation/index.d.ts

@@ -0,0 +1,19 @@
+import { PhoneValidatorRules } from "dymo-api";
+interface DymoPhonePluginOptions {
+    apiKey: string;
+    applyToLogin?: boolean;
+    applyToOAuth?: boolean;
+    phoneRules?: Partial<PhoneValidatorRules>;
+}
+export declare const dymoPhonePlugin: ({ apiKey, applyToLogin, applyToOAuth, phoneRules }: DymoPhonePluginOptions) => {
+    id: "dymoPhonePlugin";
+    hooks: {
+        before: {
+            matcher: (context: any) => boolean;
+            handler: (inputContext: import("better-auth").MiddlewareInputContext<import("better-auth").MiddlewareOptions>) => Promise<{
+                context: any;
+            }>;
+        }[];
+    };
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dymo-api/better-auth",
-  "version": "1.2.21",
+  "version": "1.2.24",
   "description": "Flow system for Dymo API.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -38,7 +38,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",
@@ -48,7 +59,7 @@
   "homepage": "https://dymo.tpeoficial.com",
   "dependencies": {
     "better-auth": "^1.3.23",
-    "dymo-api": "^1.2.17",
+    "dymo-api": "^1.2.29",
     "path": "^0.12.7"
   },
   "contributors": [