@radzor/inbox-parser

Parse raw email (MIME format) into structured data. Extract headers, body (HTML and text), attachments, and metadata from RFC 2822 / MIME messages with no external dependencies.

Emailv0.1.0typescriptpythonServeremailmimeparserinboxattachmentrfc2822by Radzor

Install

View source on GitHub →

$npx radzor@latest add inbox-parser

⚠ Constraints: No external dependencies — pure TypeScript MIME parser. Handles multipart/mixed, multipart/alternative, and nested multipart. Base64 and quoted-printable decoding are supported. Very large emails (>50MB) may cause high memory usage.

Inputs

Name	Type	Default	Description
maxAttachmentSize	number	10485760	Maximum attachment size in bytes (default: 10 MB). Larger attachments are skipped.
decodeCharsets	boolean	true	Whether to decode non-UTF-8 charsets in headers and body parts.

maxAttachmentSizenumber

Maximum attachment size in bytes (default: 10 MB). Larger attachments are skipped.

default: 10485760

decodeCharsetsboolean

Whether to decode non-UTF-8 charsets in headers and body parts.

default: true

Outputs

Name	Type	Description

{ "llm": { "constraints": "No external dependencies — pure TypeScript MIME parser. Handles multipart/mixed, multipart/alternative, and nested multipart. Base64 and quoted-printable decoding are supported. Very large emails (>50MB) may cause high memory usage.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/inbox-parser", "tags": [ "email", "mime", "parser", "inbox", "attachment", "rfc2822" ], "events": [ { "name": "onParsed", "payload": { "subject": "string", "messageId": "string", "attachmentCount": "number" }, "description": "Fired when an email is successfully parsed." }, { "name": "onError", "payload": { "phase": "string", "message": "string" }, "description": "Fired when parsing fails." } ], "inputs": [ { "name": "maxAttachmentSize", "type": "number", "default": 10485760, "required": false, "description": "Maximum attachment size in bytes (default: 10 MB). Larger attachments are skipped." }, { "name": "decodeCharsets", "type": "boolean", "default": true, "required": false, "description": "Whether to decode non-UTF-8 charsets in headers and body parts." } ], "radzor": "1.0.0", "actions": [ { "name": "parse", "params": [ { "name": "rawEmail", "type": "string | Buffer", "description": "Raw MIME email content." } ], "returns": "Promise<ParsedEmail>", "description": "Parse a raw MIME email into structured data." }, { "name": "extractAttachments", "params": [ { "name": "rawEmail", "type": "string | Buffer", "description": "Raw MIME email content." } ], "returns": "Promise<Attachment[]>", "description": "Extract only attachments from a raw MIME email." } ], "outputs": [ { "name": "parsedEmail", "type": "ParsedEmail", "fields": [ { "name": "messageId", "type": "string", "description": "Message-ID header value." }, { "name": "from", "type": "EmailAddress", "description": "Sender address (name + email)." }, { "name": "to", "type": "EmailAddress[]", "description": "Recipient addresses." }, { "name": "cc", "type": "EmailAddress[]", "description": "CC recipient addresses." }, { "name": "subject", "type": "string", "description": "Email subject line." }, { "name": "date", "type": "string", "description": "Date header parsed to ISO 8601." }, { "name": "html", "type": "string", "required": false, "description": "HTML body content." }, { "name": "text", "type": "string", "required": false, "description": "Plain text body content." }, { "name": "attachments", "type": "Attachment[]", "description": "Array of extracted attachments." }, { "name": "headers", "type": "Record<string, string>", "description": "All parsed headers as key-value pairs." } ], "description": "Fully parsed email with headers, body, and attachments." } ], "runtime": "server", "version": "0.1.0", "category": "email", "languages": [ "typescript", "python" ], "description": "Parse raw email (MIME format) into structured data. Extract headers, body (HTML and text), attachments, and metadata from RFC 2822 / MIME messages with no external dependencies.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "output": "parsedEmail", "mapField": "text", "compatibleWith": [ "@radzor/ai-classifier.action.classify.text", "@radzor/llm-completion.action.complete.prompt" ] } ] } }

@radzor/inbox-parser

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json