@veruna/api-contracts 1.1.5 → 1.1.7

package/build/shared/email-normalization.d.ts

@@ -0,0 +1,12 @@
+import { CanonicalEmailParts } from './email-normalization.types';
+export declare class EmailCanonicalizer {
+    static normalizeInput(email: string): string;
+    static canonicalize(email: string): string;
+    static getCanonicalParts(email: string): CanonicalEmailParts | null;
+    static isCanonicalizable(email: string): boolean;
+    static isValid(email: string): boolean;
+    private static resolveProviderRule;
+    private static canonicalizeDomain;
+    private static canonicalizeLocalPart;
+    private static splitEmail;
+}

package/build/shared/email-normalization.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailCanonicalizer = void 0;
+const email_normalization_constants_1 = require("./email-normalization.constants");
+class EmailCanonicalizer {
+    static normalizeInput(email) {
+        return email.trim().toLowerCase();
+    }
+    static canonicalize(email) {
+        const canonicalParts = this.getCanonicalParts(email);
+        if (canonicalParts === null) {
+            return this.normalizeInput(email);
+        }
+        return canonicalParts.email;
+    }
+    static getCanonicalParts(email) {
+        const normalizedEmail = this.normalizeInput(email);
+        const rawParts = this.splitEmail(normalizedEmail);
+        if (rawParts === null) {
+            return null;
+        }
+        const rule = this.resolveProviderRule(rawParts.domain);
+        const canonicalLocalPart = this.canonicalizeLocalPart(rawParts.localPart, rule);
+        const canonicalDomain = this.canonicalizeDomain(rawParts.domain, rule);
+        return {
+            email: `${canonicalLocalPart}@${canonicalDomain}`,
+            localPart: canonicalLocalPart,
+            domain: canonicalDomain,
+        };
+    }
+    static isCanonicalizable(email) {
+        const normalizedEmail = this.normalizeInput(email);
+        if (!this.isValid(normalizedEmail)) {
+            return false;
+        }
+        const canonicalParts = this.getCanonicalParts(normalizedEmail);
+        if (canonicalParts === null) {
+            return false;
+        }
+        return this.isValid(canonicalParts.email);
+    }
+    static isValid(email) {
+        const normalizedEmail = this.normalizeInput(email);
+        const rawParts = this.splitEmail(normalizedEmail);
+        if (rawParts === null) {
+            return false;
+        }
+        const { localPart, domain } = rawParts;
+        if (localPart.length === 0 ||
+            localPart.length > 64 ||
+            domain.length === 0 ||
+            domain.length > 255 ||
+            normalizedEmail.length > 320) {
+            return false;
+        }
+        if (localPart.startsWith('.') ||
+            localPart.endsWith('.') ||
+            localPart.includes('..') ||
+            domain.startsWith('.') ||
+            domain.endsWith('.') ||
+            domain.includes('..')) {
+            return false;
+        }
+        if (!email_normalization_constants_1.EMAIL_LOCAL_PART_REGEX.test(localPart)) {
+            return false;
+        }
+        const domainLabels = domain.split('.');
+        if (domainLabels.length < 2 || domainLabels[domainLabels.length - 1].length < 2) {
+            return false;
+        }
+        return domainLabels.every((label) => {
+            if (label.length === 0 ||
+                label.length > 63 ||
+                label.startsWith('-') ||
+                label.endsWith('-')) {
+                return false;
+            }
+            return email_normalization_constants_1.EMAIL_DOMAIN_LABEL_REGEX.test(label);
+        });
+    }
+    static resolveProviderRule(domain) {
+        return email_normalization_constants_1.EMAIL_PROVIDER_NORMALIZATION_RULES[domain] ?? email_normalization_constants_1.DEFAULT_EMAIL_PROVIDER_NORMALIZATION_RULE;
+    }
+    static canonicalizeDomain(domain, rule) {
+        return rule.canonicalDomain ?? domain;
+    }
+    static canonicalizeLocalPart(localPart, rule) {
+        const plusIndex = localPart.indexOf('+');
+        const localPartWithoutAlias = rule.removePlusAlias
+            ? localPart.substring(0, plusIndex === -1 ? localPart.length : plusIndex)
+            : localPart;
+        return rule.collapseDots
+            ? localPartWithoutAlias.replace(/\./g, '')
+            : localPartWithoutAlias;
+    }
+    static splitEmail(email) {
+        const atIndex = email.indexOf('@');
+        if (atIndex <= 0 || atIndex !== email.lastIndexOf('@') || atIndex === email.length - 1) {
+            return null;
+        }
+        return {
+            localPart: email.substring(0, atIndex),
+            domain: email.substring(atIndex + 1),
+        };
+    }
+}
+exports.EmailCanonicalizer = EmailCanonicalizer;
+//# sourceMappingURL=email-normalization.js.map

package/build/shared/email-normalization.js.map

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

package/build/shared/email-normalization.types.d.ts

@@ -0,0 +1,14 @@
+export interface CanonicalEmailParts {
+    email: string;
+    localPart: string;
+    domain: string;
+}
+export interface EmailAddressParts {
+    localPart: string;
+    domain: string;
+}
+export interface EmailProviderNormalizationRule {
+    canonicalDomain: string | null;
+    removePlusAlias: boolean;
+    collapseDots: boolean;
+}

package/build/shared/email-normalization.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=email-normalization.types.js.map

package/build/shared/email-normalization.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-normalization.types.js","sourceRoot":"","sources":["../../shared/email-normalization.types.ts"],"names":[],"mappings":""}

package/build/shared/index.d.ts

@@ -6,3 +6,6 @@ export * from './regex';
 export * from './device-type.enum';
 export * from './common-schemas';
 export * from './constants';
+export * from './email-normalization.constants';
+export * from './email-normalization';
+export * from './email-normalization.types';

package/build/shared/index.js

@@ -22,4 +22,7 @@ __exportStar(require("./regex"), exports);
 __exportStar(require("./device-type.enum"), exports);
 __exportStar(require("./common-schemas"), exports);
 __exportStar(require("./constants"), exports);
+__exportStar(require("./email-normalization.constants"), exports);
+__exportStar(require("./email-normalization"), exports);
+__exportStar(require("./email-normalization.types"), exports);
 //# sourceMappingURL=index.js.map

package/build/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../shared/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,8DAA4C;AAC5C,sDAAoC;AACpC,kDAAgC;AAChC,0CAAwB;AACxB,qDAAmC;AACnC,mDAAiC;AACjC,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../shared/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,8DAA4C;AAC5C,sDAAoC;AACpC,kDAAgC;AAChC,0CAAwB;AACxB,qDAAmC;AACnC,mDAAiC;AACjC,8CAA4B;AAC5B,kEAAgD;AAChD,wDAAsC;AACtC,8DAA4C"}