{"id":13632551,"url":"https://github.com/mfbx9da4/deep-email-validator","last_synced_at":"2025-05-14T02:04:57.589Z","repository":{"id":37720246,"uuid":"245675427","full_name":"mfbx9da4/deep-email-validator","owner":"mfbx9da4","description":"Validates regex, typos, disposable, dns and smtp","archived":false,"fork":false,"pushed_at":"2025-03-28T04:58:39.000Z","size":578,"stargazers_count":887,"open_issues_count":52,"forks_count":98,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-05-13T10:58:58.289Z","etag":null,"topics":["email-validation","email-validator","smtp"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mfbx9da4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-03-07T17:24:17.000Z","updated_at":"2025-04-24T16:28:37.000Z","dependencies_parsed_at":"2024-06-18T12:40:23.232Z","dependency_job_id":"f4366f2d-3aef-4d9c-a67a-3fc563d11210","html_url":"https://github.com/mfbx9da4/deep-email-validator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfbx9da4%2Fdeep-email-validator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfbx9da4%2Fdeep-email-validator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfbx9da4%2Fdeep-email-validator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfbx9da4%2Fdeep-email-validator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mfbx9da4","download_url":"https://codeload.github.com/mfbx9da4/deep-email-validator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052692,"owners_count":22006716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["email-validation","email-validator","smtp"],"created_at":"2024-08-01T22:03:06.634Z","updated_at":"2025-05-14T02:04:57.565Z","avatar_url":"https://github.com/mfbx9da4.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","🤖 AI \u0026 Machine Learning"],"sub_categories":[],"readme":"# Email Validator\n\nValidates email addresses based on regex, common typos, disposable email blacklists, DNS records and SMTP server response.\n\n- Validates email looks like an email i.e. contains an \"@\" and a \".\" to the right of it.\n- Validates common typos e.g. example@gmaill.com using [mailcheck](https://github.com/mailcheck/mailcheck).\n- Validates email was not generated by disposable email service using [disposable-email-domains](https://github.com/ivolo/disposable-email-domains).\n- Validates MX records are present on DNS.\n- Validates SMTP server is running.\n- Validates mailbox exists on SMTP server.\n- Native typescript support.\n\n## Getting Started\n\nCompatible with nodejs only. Not browser ready.\n\nInstall like so\n\n```\nnpm i deep-email-validator --save\n```\n\nor with yarn\n\n```\nyarn add deep-email-validator\n```\n\nUse like so\n\n```typescript\nimport { validate } from 'deep-email-validator'\nconst main = async () =\u003e {\n  let res = await validate('asdf@gmail.com')\n  // {\n  //   \"valid\": false,\n  //   \"reason\": \"smtp\",\n  //   \"validators\": {\n  //       \"regex\": {\n  //         \"valid\": true\n  //       },\n  //       \"typo\": {\n  //         \"valid\": true\n  //       },\n  //       \"disposable\": {\n  //         \"valid\": true\n  //       },\n  //       \"mx\": {\n  //         \"valid\": true\n  //       },\n  //       \"smtp\": {\n  //         \"valid\": false,\n  //         \"reason\": \"Mailbox not found.\",\n  //       }\n  //   }\n  // }\n\n  // Can also be called with these default options\n  await validate({\n    email: 'name@example.org',\n    sender: 'name@example.org',\n    validateRegex: true,\n    validateMx: true,\n    validateTypo: true,\n    validateDisposable: true,\n    validateSMTP: true,\n  })\n}\n```\n\nIf you want to validate domains with TLDs that are not supported by default, you can use `additionalTopLevelDomains` option:\n\n```typescript\nawait validate({\n  email: 'name@example.ir',\n  sender: 'name@example.ir',\n  validateRegex: true,\n  validateMx: true,\n  validateTypo: true,\n  validateDisposable: true,\n  validateSMTP: true,\n  additionalTopLevelDomains: [ 'ir' ]\n})\n```\nFor a list of TLDs that are supported by default you can see [here](https://github.com/mailcheck/mailcheck/blob/afca031b4ce1cdc6e3ecbe88198f41b4835f81e3/src/mailcheck.js#L31).\n\n##\n\n[Default options can be found here](https://github.com/mfbx9da4/deep-email-validator/blob/8bbd9597a7ce435f0a77889a45daccdd5d7c3488/src/options/options.ts#L1)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmfbx9da4%2Fdeep-email-validator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmfbx9da4%2Fdeep-email-validator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmfbx9da4%2Fdeep-email-validator/lists"}