@arkyn/server 3.0.1-beta.73 → 3.0.1-beta.74

package/dist/validations/validateEmail.js

@@ -0,0 +1,121 @@
+import dns from "node:dns";
+const resolveDns = dns.promises.resolve;
+// Validates basic email format using a comprehensive regex pattern
+function isValidBasicFormat(email) {
+    const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[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])?)*$/;
+    return emailRegex.test(email);
+}
+// Validates the local part of email (before @)
+function isValidLocalPart(localPart) {
+    if (localPart.length === 0 || localPart.length > 64)
+        return false;
+    if (localPart.startsWith(".") || localPart.endsWith("."))
+        return false;
+    if (localPart.includes(".."))
+        return false;
+    const validLocalRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+$/;
+    if (!validLocalRegex.test(localPart))
+        return false;
+    return true;
+}
+// Validates a single domain label
+function isValidDomainLabel(label) {
+    if (label.length === 0 || label.length > 63)
+        return false;
+    if (label.startsWith("-") || label.endsWith("-"))
+        return false;
+    if (!/^[a-zA-Z0-9-]+$/.test(label))
+        return false;
+    return true;
+}
+// Validates the domain part of email (after @)
+function isValidDomainPart(domainPart) {
+    if (domainPart.length === 0 || domainPart.length > 253)
+        return false;
+    if (domainPart.startsWith(".") ||
+        domainPart.endsWith(".") ||
+        domainPart.startsWith("-") ||
+        domainPart.endsWith("-")) {
+        return false;
+    }
+    const labels = domainPart.split(".");
+    if (labels.length < 2)
+        return false;
+    for (const label of labels)
+        if (!isValidDomainLabel(label))
+            return false;
+    const tld = labels[labels.length - 1];
+    if (tld.length < 2 || !/^[a-zA-Z]+$/.test(tld))
+        return false;
+    return true;
+}
+// Performs advanced syntax validation beyond basic regex
+function isValidAdvancedSyntax(email) {
+    const parts = email.split("@");
+    if (parts.length !== 2)
+        return false;
+    const [localPart, domainPart] = parts;
+    if (!isValidLocalPart(localPart))
+        return false;
+    if (!isValidDomainPart(domainPart))
+        return false;
+    return true;
+}
+// Extracts the domain from email address
+function extractDomain(email) {
+    const parts = email.split("@");
+    return parts.length === 2 ? parts[1].toLowerCase() : null;
+}
+// DNS record types to check for domain validation
+const DNS_RECORD_TYPES = ["MX", "A", "AAAA"];
+// Attempts to resolve a specific DNS record type for a domain
+async function tryResolveDnsRecord(domain, recordType) {
+    try {
+        await resolveDns(domain, recordType);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Validates if domain has valid DNS records (MX, A, or AAAA records)
+async function isValidDns(domain) {
+    for (const recordType of DNS_RECORD_TYPES) {
+        const hasRecord = await tryResolveDnsRecord(domain, recordType);
+        if (hasRecord)
+            return true;
+    }
+    return false;
+}
+/**
+ * Validates if an email address is valid in all possible ways, including DNS validation.
+ *
+ * This function performs comprehensive email validation by:
+ * - Checking basic email format and syntax
+ * - Validating advanced RFC 5322 compliance rules
+ * - Verifying that the domain has valid MX or A records in DNS
+ *
+ * @param rawEmail - The email address string to validate
+ * @returns A promise that resolves to `true` if the email is valid (including DNS), otherwise `false`
+ *
+ * @example
+ * ```typescript
+ * await validateEmail("user@gmail.com"); // true
+ * await validateEmail("user@gmil.com"); // false (invalid domain)
+ * await validateEmail("invalid-email"); // false (invalid format)
+ * ```
+ */
+const validateEmail = async (rawEmail) => {
+    if (!rawEmail || typeof rawEmail !== "string")
+        return false;
+    const email = rawEmail.trim();
+    if (!isValidBasicFormat(email))
+        return false;
+    if (!isValidAdvancedSyntax(email))
+        return false;
+    const domain = extractDomain(email);
+    if (!domain)
+        return false;
+    return await isValidDns(domain);
+};
+export { validateEmail };

package/dist/validations/validatePassword.d.ts

@@ -0,0 +1,21 @@
+type ValidatePasswordFunction = (rawPassword: string) => boolean;
+/**
+ * Validates a password based on the following rules:
+ * - At least 8 characters
+ * - At least 1 uppercase letter
+ * - At least 1 letter (any case)
+ * - At least 1 number
+ * - At least 1 special character
+ *
+ * @param rawPassword - The raw password string.
+ * @returns `true` if password is valid, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * validatePassword("Senha@123"); // true
+ * validatePassword("senha123");  // false (no uppercase, no special char)
+ * ```
+ */
+declare const validatePassword: ValidatePasswordFunction;
+export { validatePassword };
+//# sourceMappingURL=validatePassword.d.ts.map

package/dist/validations/validatePassword.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePassword.d.ts","sourceRoot":"","sources":["../../src/validations/validatePassword.ts"],"names":[],"mappings":"AAAA,KAAK,wBAAwB,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;AAEjE;;;;;;;;;;;;;;;;GAgBG;AAEH,QAAA,MAAM,gBAAgB,EAAE,wBAkBvB,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/validations/validatePassword.js

@@ -0,0 +1,34 @@
+/**
+ * Validates a password based on the following rules:
+ * - At least 8 characters
+ * - At least 1 uppercase letter
+ * - At least 1 letter (any case)
+ * - At least 1 number
+ * - At least 1 special character
+ *
+ * @param rawPassword - The raw password string.
+ * @returns `true` if password is valid, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * validatePassword("Senha@123"); // true
+ * validatePassword("senha123");  // false (no uppercase, no special char)
+ * ```
+ */
+const validatePassword = (rawPassword) => {
+    if (!rawPassword)
+        return false;
+    const hasMinLength = rawPassword.length >= 8;
+    const hasUppercase = /[A-Z]/.test(rawPassword);
+    const hasLetter = /[a-z]/.test(rawPassword);
+    const hasNumber = /\d/.test(rawPassword);
+    const hasSpecialChar = /[!@#$%^&*(),.?":{}|<>_\-+=~`[\]\\\/]/.test(rawPassword);
+    return [
+        hasMinLength,
+        hasUppercase,
+        hasLetter,
+        hasNumber,
+        hasSpecialChar,
+    ].every((condition) => condition);
+};
+export { validatePassword };

package/dist/validations/validatePhone.d.ts

@@ -0,0 +1,29 @@
+type ValidatePhoneFunction = (rawPhone: string) => boolean;
+/**
+ * Validates a phone number against a list of country-specific formats.
+ *
+ * The function iterates through a predefined list of countries and checks if the
+ * provided phone number matches the format for any of the countries. It uses
+ * regular expressions to validate the phone number based on the country's code,
+ * prefix, and mask.
+ *
+ * Special handling is applied for Brazilian phone numbers (ISO code "BR"), which
+ * allows for an optional ninth digit.
+ *
+ * @param rawPhone - The phone number to validate as a string.
+ * @returns `true` if the phone number matches any country's format, otherwise `false`.
+ *
+ * @example
+ * ```typescript
+ * import { validatePhone } from "./validatePhone";
+ *
+ * validatePhone("+55 32912345678"); // true for a valid Brazilian phone number
+ * validatePhone("+55 3212345678"); // true for a valid Brazilian phone number
+ * validatePhone("+1-684 1234567"); // true for a valid American Samoa phone number
+ * validatePhone("+5532912345678"); // false for an invalid Brazilian phone number
+ * validatePhone("+55 1234567890"); // false for an invalid Brazilian phone number
+ * ```
+ */
+declare const validatePhone: ValidatePhoneFunction;
+export { validatePhone };
+//# sourceMappingURL=validatePhone.d.ts.map

package/dist/validations/validatePhone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validatePhone.d.ts","sourceRoot":"","sources":["../../src/validations/validatePhone.ts"],"names":[],"mappings":"AAEA,KAAK,qBAAqB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,QAAA,MAAM,aAAa,EAAE,qBAiBpB,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/validations/validatePhone.js

@@ -0,0 +1,44 @@
+import { countries } from "@arkyn/templates";
+/**
+ * Validates a phone number against a list of country-specific formats.
+ *
+ * The function iterates through a predefined list of countries and checks if the
+ * provided phone number matches the format for any of the countries. It uses
+ * regular expressions to validate the phone number based on the country's code,
+ * prefix, and mask.
+ *
+ * Special handling is applied for Brazilian phone numbers (ISO code "BR"), which
+ * allows for an optional ninth digit.
+ *
+ * @param rawPhone - The phone number to validate as a string.
+ * @returns `true` if the phone number matches any country's format, otherwise `false`.
+ *
+ * @example
+ * ```typescript
+ * import { validatePhone } from "./validatePhone";
+ *
+ * validatePhone("+55 32912345678"); // true for a valid Brazilian phone number
+ * validatePhone("+55 3212345678"); // true for a valid Brazilian phone number
+ * validatePhone("+1-684 1234567"); // true for a valid American Samoa phone number
+ * validatePhone("+5532912345678"); // false for an invalid Brazilian phone number
+ * validatePhone("+55 1234567890"); // false for an invalid Brazilian phone number
+ * ```
+ */
+const validatePhone = (rawPhone) => {
+    for (const country of countries) {
+        const countryCode = country.code;
+        const prefix = country.prefix ? `-${country.prefix}` : "";
+        const digitCount = country.mask.replace(/[^_]/g, "").length;
+        if (country.iso === "BR") {
+            const brazilRegex = new RegExp(`^\\${countryCode} \\d{2}9?\\d{8}$`);
+            if (brazilRegex.test(rawPhone))
+                return true;
+            continue;
+        }
+        const regex = new RegExp(`^\\${countryCode}${prefix} \\d{${digitCount}}$`);
+        if (regex.test(rawPhone))
+            return true;
+    }
+    return false;
+};
+export { validatePhone };

package/dist/validations/validateRg.d.ts

@@ -0,0 +1,22 @@
+type ValidateRgFunction = (rawRg: string) => boolean;
+/**
+ * Validates a Brazilian RG (Registro Geral) in a generic way.
+ *
+ * This function does a basic structure validation:
+ * - Removes non-alphanumeric characters.
+ * - Ensures length is reasonable (7–9 digits).
+ * - Optionally allows for a final letter (verifier).
+ *
+ * @param rawRg - RG string, possibly formatted.
+ * @returns `true` if format seems valid, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * validateRg("12.345.678-9"); // true
+ * validateRg("MG-12.345.678"); // false (not supported)
+ * validateRg("12345678X"); // true
+ * ```
+ */
+declare const validateRg: ValidateRgFunction;
+export { validateRg };
+//# sourceMappingURL=validateRg.d.ts.map

package/dist/validations/validateRg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateRg.d.ts","sourceRoot":"","sources":["../../src/validations/validateRg.ts"],"names":[],"mappings":"AAAA,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AAEH,QAAA,MAAM,UAAU,EAAE,kBAajB,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/validations/validateRg.js

@@ -0,0 +1,31 @@
+/**
+ * Validates a Brazilian RG (Registro Geral) in a generic way.
+ *
+ * This function does a basic structure validation:
+ * - Removes non-alphanumeric characters.
+ * - Ensures length is reasonable (7–9 digits).
+ * - Optionally allows for a final letter (verifier).
+ *
+ * @param rawRg - RG string, possibly formatted.
+ * @returns `true` if format seems valid, otherwise `false`.
+ *
+ * @example
+ * ```ts
+ * validateRg("12.345.678-9"); // true
+ * validateRg("MG-12.345.678"); // false (not supported)
+ * validateRg("12345678X"); // true
+ * ```
+ */
+const validateRg = (rawRg) => {
+    if (!rawRg)
+        return false;
+    const validFormat = /^[0-9a-zA-Z.-]+$/.test(rawRg);
+    if (!validFormat)
+        return false;
+    const rg = rawRg.replace(/[^a-zA-Z0-9]/g, "");
+    if (rg.length < 7 || rg.length > 9)
+        return false;
+    const isValidFormat = /^[0-9]{7,8}[0-9Xx]?$/.test(rg);
+    return isValidFormat;
+};
+export { validateRg };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkyn/server",
-  "version": "3.0.1-beta.73",
+  "version": "3.0.1-beta.74",
   "author": "Arkyn | Lucas Gonçalves",
   "main": "./dist/bundle.js",
   "module": "./dist/bundle.js",
@@ -31,9 +31,10 @@
     "test": "vitest --config vitest.config.ts",
     "typecheck": "bunx tsc --project tsconfig.json --noEmit"
   },
-  "dependencies": {
+  "peerDependencies": {
     "@arkyn/shared": "*",
-    "zod": "^4.0.17"
+    "@arkyn/templates": "*",
+    "zod": ">=4.0.17"
   },
   "devDependencies": {
     "bun-types": "latest",