{"id":26213244,"url":"https://github.com/maxgalbu/nodemailer-plugin-file2inline","last_synced_at":"2026-04-29T09:32:07.072Z","repository":{"id":143901128,"uuid":"101275629","full_name":"maxgalbu/nodemailer-plugin-file2inline","owner":"maxgalbu","description":null,"archived":false,"fork":false,"pushed_at":"2017-09-21T10:41:29.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-21T23:51:58.053Z","etag":null,"topics":["attachment","cid","html","inline","node","nodemailer-plugin"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/maxgalbu.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":"2017-08-24T09:05:54.000Z","updated_at":"2017-08-29T09:41:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"91da53d1-a00b-4e56-8eb9-d28efdcd960b","html_url":"https://github.com/maxgalbu/nodemailer-plugin-file2inline","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/maxgalbu/nodemailer-plugin-file2inline","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxgalbu%2Fnodemailer-plugin-file2inline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxgalbu%2Fnodemailer-plugin-file2inline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxgalbu%2Fnodemailer-plugin-file2inline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxgalbu%2Fnodemailer-plugin-file2inline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxgalbu","download_url":"https://codeload.github.com/maxgalbu/nodemailer-plugin-file2inline/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxgalbu%2Fnodemailer-plugin-file2inline/sbom","scorecard":{"id":629093,"data":{"date":"2025-08-11","repo":{"name":"github.com/maxgalbu/nodemailer-plugin-file2inline","commit":"a729bad3e02e41b2d60b22b45f22db6050531fdf"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 0/9 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-21T07:19:57.087Z","repository_id":143901128,"created_at":"2025-08-21T07:19:57.088Z","updated_at":"2025-08-21T07:19:57.088Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32419860,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["attachment","cid","html","inline","node","nodemailer-plugin"],"created_at":"2025-03-12T09:18:21.135Z","updated_at":"2026-04-29T09:32:07.063Z","avatar_url":"https://github.com/maxgalbu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nodemailer plugin for converting external images to email attachments\n\nThis plugin will convert external images in your [nodemailer](https://github.com/nodemailer/nodemailer) email to be inline (\"CID-referenced\") attachments within the email. Inline attachments are useful because they embed the image inside the actual email, so it's viewable even if the user is checking their email without an internet connection.\n\nLocal files will not be accessible with html alone. This Nodemailer plugin will take images in your email html in the form:\n\n    \u003cimg src=\"path/to/file.jpg\"\u003e\n\nand replace it with a CID-referenced attachment that works in all email clients.\n\n## Install\n\n```\nyarn add nodemailer-plugin-file2inline\n```\nor\n```\nnpm install nodemailer-plugin-file2inline --save\n```\n\n## Usage\n\n#### 1. Load the `nodemailer-plugin-file2inline` plugin:\n\n```javascript\nvar file2InlinePlugin = require('nodemailer-plugin-file2inline');\n```\n\n#### 2. Attach it as a 'compile' handler for a nodemailer transport object\n\n```javascript\n//Without options\nnodemailerTransport.use('compile', file2InlinePlugin())\n\n//With options\nnodemailerTransport.use('compile', file2InlinePlugin({\n\tcidPrefix: \"prefix_\",\n\thtmlFilePath: \"path/relative/to/the/html/file\",\n\tmaxWidth: 600\n))\n```\nOptions are:\n- **cidPrefix**: allows to set CID prefix\u003csup\u003e\u003ca href=\"#1\"\u003e1\u003c/a\u003e\u003c/sup\u003e ```{cidPrefix: 'somePrefix_'}```, then all inline images will have prefix in cid, i.e.: `cid:somePrefix_5fe3b631c651bdb1`.\n- **htmlFilePath**: path to the folder where the html file is, relative to the current working folder\n- **maxWidth**: if this options is set, all images will have the \"width\" attribute set to the value\n\n\n## Example\n\n```javascript\nvar nodemailer = require('nodemailer');\nvar file2InlinePlugin = require('nodemailer-plugin-file2inline');\n\nlet transporter = nodemailer.createTransport({\n    sendmail: true,\n    newline: 'unix',\n});\ntransporter.use('compile', file2InlinePlugin({cidPrefix: 'somePrefix_'}));\ntransporter.sendMail({\n    from: 'me@example.com',\n    to: 'hello@mixmax.com',\n    html: '\u003cimg src=\"external/image.png\"\u003e'\n});\n```\n\n## Changelog\n\n* 1.0.0 Initial release\n\n## References\n\u003csup id=\"1\"\u003e1\u003c/sup\u003e It might be useful for reply email processing, example with [MailParser](https://github.com/andris9/mailparser)\n\n```javascript\nmp.on(\"attachment\", function(attachment, mail){\n    if (!attachment.contentId.includes('somePrefix')) { // process only images attached by user in reply\n        // ...\n    }\n});\n```\n\n## License\n\n**MIT**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxgalbu%2Fnodemailer-plugin-file2inline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxgalbu%2Fnodemailer-plugin-file2inline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxgalbu%2Fnodemailer-plugin-file2inline/lists"}