@emailverifier/sdk 0.1.1

package/dist/types/client.d.ts

@@ -0,0 +1,41 @@
+export type VerificationSignal = 'invalid_syntax' | 'invalid_domain' | 'no_mail_server' | 'disposable_address' | 'free_provider' | 'role_address' | 'mailbox_accepts_mail' | 'mailbox_rejected' | 'catch_all_domain' | 'possible_typo' | 'verification_inconclusive';
+export type VerificationResult = {
+    email: string;
+    status: 'deliverable' | 'risky' | 'undeliverable' | 'unknown';
+    action: 'block' | 'allow' | 'review';
+    flagged: boolean;
+    signals: VerificationSignal[];
+    suggestion: string | null;
+};
+export type DomainResult = {
+    domain: string;
+    classification: 'disposable' | 'free_provider' | 'unknown';
+    risk: 'high' | 'medium' | 'unknown';
+    mail_routing: 'available' | 'unavailable' | 'unknown';
+};
+export type UsageResult = {
+    project: string;
+    credits_used: number;
+    credits_remaining: number;
+    last_used_at: string | null;
+};
+export type EmailVerifierOptions = {
+    apiKey: string;
+    baseUrl?: string;
+};
+export type RequestOptions = {
+    signal?: AbortSignal;
+};
+export declare class EmailVerifierError extends Error {
+    readonly status: number;
+    readonly response: unknown;
+    constructor(message: string, status: number, response: unknown);
+}
+export declare class EmailVerifier {
+    #private;
+    constructor(options: EmailVerifierOptions);
+    verify(email: string, options?: RequestOptions): Promise<VerificationResult>;
+    checkDomain(domain: string, options?: RequestOptions): Promise<DomainResult>;
+    getUsage(options?: RequestOptions): Promise<UsageResult>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/types/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,2BAA2B,CAAA;AAE/B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,aAAa,GAAG,OAAO,GAAG,eAAe,GAAG,SAAS,CAAA;IAC7D,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,kBAAkB,EAAE,CAAA;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,YAAY,GAAG,eAAe,GAAG,SAAS,CAAA;IAC1D,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IACnC,YAAY,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAAA;CACtD,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;gBAEd,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;CAM/D;AAED,qBAAa,aAAa;;gBAIZ,OAAO,EAAE,oBAAoB;IAYzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ5E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAO5E,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;CAqCzD"}

package/dist/types/data/disposable-domains.generated.d.ts

@@ -0,0 +1,3 @@
+export declare const disposableDataUpdatedAt = "2026-08-27T05:01:50.920Z";
+export declare const upstreamDisposableDomainList: string[];
+//# sourceMappingURL=disposable-domains.generated.d.ts.map

package/dist/types/data/disposable-domains.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable-domains.generated.d.ts","sourceRoot":"","sources":["../../../src/data/disposable-domains.generated.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB,6BAA6B,CAAA;AACjE,eAAO,MAAM,4BAA4B,UAqgrBgC,CAAA"}

package/dist/types/data/domains.d.ts

@@ -0,0 +1,8 @@
+import { disposableDataUpdatedAt } from './disposable-domains.generated.js';
+export { disposableDataUpdatedAt };
+export declare const customDisposableDomainList: string[];
+export declare const freeEmailDomainList: string[];
+export declare const freeEmailDomains: Set<string>;
+export declare const disposableDomainList: string[];
+export declare const disposableDomains: Set<string>;
+//# sourceMappingURL=domains.d.ts.map

package/dist/types/data/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/data/domains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAgC,MAAM,mCAAmC,CAAA;AAEzG,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAElC,eAAO,MAAM,0BAA0B,UAuFtC,CAAA;AAED,eAAO,MAAM,mBAAmB,UA4J/B,CAAA;AAED,eAAO,MAAM,gBAAgB,aAA+B,CAAA;AAC5D,eAAO,MAAM,oBAAoB,UAGyB,CAAA;AAC1D,eAAO,MAAM,iBAAiB,aAAgC,CAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { EmailVerifier, EmailVerifierError } from './client.js';
+export type { DomainResult, EmailVerifierOptions, RequestOptions, UsageResult, VerificationResult, VerificationSignal } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,kBAAkB,EACnB,MAAM,aAAa,CAAA;AAEpB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,aAAa,CAAA"}

package/dist/types/offline.d.ts

@@ -0,0 +1,25 @@
+export type OfflineEmailAnalysis = {
+    email: string;
+    normalizedEmail: string | null;
+    domain: string | null;
+    suggestion: string | null;
+    checks: {
+        syntax: boolean;
+        emailLength: boolean;
+        localPartLength: boolean;
+        domainFormat: boolean;
+        disposable: boolean;
+        freeProvider: boolean;
+        roleBased: boolean;
+    };
+    reasons: string[];
+};
+export declare const maxEmailLength = 254;
+export declare function getDisposableDomainMatch(domain: string): string | null;
+export declare function getFreeEmailDomainMatch(domain: string): string | null;
+export declare function isDisposableDomain(domain: string): boolean;
+export declare function isFreeEmailProvider(domain: string): boolean;
+export declare function isRoleAddress(email: string): boolean;
+export declare function analyzeEmail(input: unknown): OfflineEmailAnalysis;
+export { customDisposableDomainList, disposableDataUpdatedAt, disposableDomainList, freeEmailDomainList } from './data/domains.js';
+//# sourceMappingURL=offline.d.ts.map

package/dist/types/offline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline.d.ts","sourceRoot":"","sources":["../../src/offline.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,EAAE;QACN,MAAM,EAAE,OAAO,CAAA;QACf,WAAW,EAAE,OAAO,CAAA;QACpB,eAAe,EAAE,OAAO,CAAA;QACxB,YAAY,EAAE,OAAO,CAAA;QACrB,UAAU,EAAE,OAAO,CAAA;QACnB,YAAY,EAAE,OAAO,CAAA;QACrB,SAAS,EAAE,OAAO,CAAA;KACnB,CAAA;IACD,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA;AAKD,eAAO,MAAM,cAAc,MAAM,CAAA;AA+EjC,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWtE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGrE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAoDjE;AAED,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,mBAAmB,CAAA"}

package/dist/types/role-addresses.d.ts

@@ -0,0 +1,2 @@
+export declare const roleLocalParts: Set<string>;
+//# sourceMappingURL=role-addresses.d.ts.map

package/dist/types/role-addresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-addresses.d.ts","sourceRoot":"","sources":["../../src/role-addresses.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,aAgSzB,CAAA"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@emailverifier/sdk",
+  "version": "0.1.1",
+  "description": "Email verifier SDK with free offline checks, the emailverifier.dev API client, and a CLI.",
+  "keywords": [
+    "email",
+    "email-verifier",
+    "email-verification",
+    "email-verification-api",
+    "disposable-email",
+    "email-validation",
+    "typescript",
+    "cli"
+  ],
+  "homepage": "https://emailverifier.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/usamaejaz/emailverifier.git"
+  },
+  "bugs": {
+    "url": "https://github.com/usamaejaz/emailverifier/issues"
+  },
+  "license": "MIT",
+  "author": "Usama Ejaz",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./offline": {
+      "types": "./dist/types/offline.d.ts",
+      "import": "./dist/esm/offline.js",
+      "require": "./dist/cjs/offline.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "emailverifier": "dist/esm/cli.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "check": "npm run typecheck && npm test && npm pack --dry-run --cache ./.npm-cache",
+    "test": "npm run build && node --test",
+    "typecheck": "node node_modules/typescript/bin/tsc -p tsconfig.json --noEmit",
+    "update:data": "node scripts/update-disposable-domains.mjs"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.10",
+    "typescript": "^5.7.3"
+  }
+}