n8n-nodes-jmap 0.2.2 → 0.2.4

package/README.md

@@ -4,7 +4,7 @@ Community node for [n8n](https://n8n.io/) to interact with JMAP email servers ([
 
 Compatible with:
 - [Apache James](https://james.apache.org/)
-- [Twake Mail](https://twake.app/)
+- [Twake Mail](https://twake.app/) by [LINAGORA](https://linagora.com/)
 - [Stalwart Mail Server](https://stalw.art/)
 - [Fastmail](https://www.fastmail.com/)
 - Any JMAP-compliant email server
@@ -119,7 +119,8 @@ Main node for email operations.
 | Email | Send | Send a new email |
 | Email | Reply | Reply to an existing email |
 | Email | Get | Retrieve an email by ID |
-| Email | Get Many | List emails (with optional mailbox filter) |
+| Email | Get Many | List emails with advanced search filters |
+| Email | Get Attachments | Download attachments as binary data |
 | Email | Create Draft | Create a draft without sending |
 | Email | Delete | Delete an email |
 | Email | Mark as Read | Mark email as read |
@@ -149,9 +150,92 @@ Polling-based trigger for new emails.
 
 ---
 
-## Development
+## Features
+
+### Advanced Email Search
+
+The **Get Many** operation supports powerful search filters based on JMAP RFC 8621:
+
+| Filter | Description |
+|--------|-------------|
+| **Received After** | Emails received after a specific date |
+| **Received Before** | Emails received before a specific date |
+| **From Contains** | Filter by sender address |
+| **To Contains** | Filter by recipient address |
+| **Subject Contains** | Filter by subject line |
+| **Full Text Search** | Search in subject, body, and addresses |
+| **Has Attachment** | Only emails with attachments |
+| **Unread Only** | Only unread emails |
+| **Flagged Only** | Only starred/flagged emails |
+
+Combine multiple filters for precise email retrieval.
+
+### Attachment Handling
+
+The **Get Attachments** operation downloads email attachments as binary data, ready to use with other n8n nodes:
+
+- **Inline image filtering**: Exclude embedded images (signatures, logos) by default
+- **MIME type filtering**: Filter by file type (e.g., `application/pdf`, `image/*`)
+- **Native compatibility**: Works seamlessly with n8n's Compression, Google Drive, S3, and other nodes
+
+Example workflow: `JMAP Trigger` > `Get Attachments` > `Compression` (extract ZIP) > `Google Drive` (upload)
+
+---
+
+## AI Agent Integration
+
+This node can be used as a tool by n8n AI Agents, enabling autonomous email operations.
+
+### Setup
+
+1. Ensure you're using n8n version 1.x or later
+2. The node will automatically appear in the AI Agent's tool list
+
+### Example Use Cases
+
+- **Email assistant**: Let the AI read, search, and respond to emails
+- **Automated triage**: AI categorizes and labels incoming emails
+- **Smart notifications**: AI analyzes email content and triggers actions
+
+### Supported Operations as AI Tool
+
+The AI Agent can use all JMAP operations:
+- Search emails with natural language queries
+- Read and analyze email content
+- Send replies based on context
+- Organize emails (labels, folders, flags)
+- Download and process attachments
+
+---
+
+## Contributing
+
+Contributions are welcome! This project is open source and we encourage the community to help improve it.
+
+### How to Contribute
+
+1. **Fork** the repository
+2. **Create a branch** for your feature or fix: `git checkout -b feature/my-feature`
+3. **Make your changes** and test them locally
+4. **Run linting**: `npm run lint`
+5. **Commit** with a clear message
+6. **Push** to your fork and open a **Pull Request**
+
+### Ideas for Contributions
+
+- Support for additional JMAP capabilities (Calendar, Contacts)
+- Improved error handling and messages
+- Additional search filters
+- Documentation improvements
+- Bug fixes and optimizations
+
+### Local Development
 
 ```bash
+# Clone your fork
+git clone https://github.com/YOUR_USERNAME/n8n-nodes-jmap.git
+cd n8n-nodes-jmap
+
 # Install dependencies
 npm install
 
@@ -168,14 +252,11 @@ npm run lint
 npm run format
 ```
 
-### Local Testing
+### Testing Locally with n8n
 
 ```bash
-# Link for local n8n development
-npm link
-
-# In your n8n installation
-npm link n8n-nodes-jmap
+# Start n8n with the local node
+N8N_CUSTOM_EXTENSIONS="/path/to/n8n-nodes-jmap" n8n start
 ```
 
 ---
@@ -201,4 +282,6 @@ AGPL-3.0
 
 ## Author
 
-[Michel-Marie Maudet](https://github.com/mmaudet)
+[Michel-Marie MAUDET](https://github.com/mmaudet)
+
+This project is developed with the support of [LINAGORA](https://linagora.com/) and [Twake](https://twake.app/).

package/dist/nodes/Jmap/GenericFunctions.js

@@ -501,7 +501,11 @@ async function getAttachments(accountId, emailId, options = {}) {
     let attachmentIndex = 0;
     for (const attachment of attachments) {
         // Filter by inline status
-        if (attachment.isInline && !includeInline) {
+        // An attachment is considered inline if:
+        // - isInline is explicitly true, OR
+        // - it has a cid (Content-ID) which is used for inline images in HTML
+        const isInlineAttachment = attachment.isInline === true || (attachment.cid !== undefined && attachment.cid !== null);
+        if (isInlineAttachment && !includeInline) {
             continue;
         }
         // Filter by MIME type
@@ -523,7 +527,8 @@ async function getAttachments(accountId, emailId, options = {}) {
                 fileName: attachment.name,
                 mimeType: attachment.type,
                 fileSize: attachment.size,
-                isInline: attachment.isInline || false,
+                isInline: isInlineAttachment,
+                cid: attachment.cid || null,
             },
             binary: {
                 file: binaryData,

package/dist/nodes/Jmap/Jmap.node.js

@@ -5,12 +5,14 @@ const n8n_workflow_1 = require("n8n-workflow");
 const GenericFunctions_1 = require("./GenericFunctions");
 class Jmap {
     constructor() {
+        // @ts-ignore - usableAsTool not in type definitions
         this.description = {
             displayName: 'JMAP',
             name: 'jmap',
             icon: 'file:jmap.svg',
             group: ['transform'],
             version: 1,
+            usableAsTool: true,
             subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
             description: 'Interact with JMAP email servers (Apache James, Twake Mail, etc.)',
             defaults: {
@@ -464,6 +466,89 @@ class Jmap {
                     default: 50,
                     description: 'Max number of results to return',
                 },
+                // Options for getMany (search filters)
+                {
+                    displayName: 'Options',
+                    name: 'getManyOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    displayOptions: {
+                        show: {
+                            resource: ['email'],
+                            operation: ['getMany'],
+                        },
+                    },
+                    options: [
+                        {
+                            displayName: 'Flagged Only',
+                            name: 'flaggedOnly',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to return only flagged/starred emails',
+                        },
+                        {
+                            displayName: 'From Contains',
+                            name: 'from',
+                            type: 'string',
+                            default: '',
+                            placeholder: 'sender@example.com',
+                            description: 'Filter emails where the From address contains this text',
+                        },
+                        {
+                            displayName: 'Full Text Search',
+                            name: 'text',
+                            type: 'string',
+                            default: '',
+                            placeholder: 'search terms',
+                            description: 'Search in subject, body, and addresses',
+                        },
+                        {
+                            displayName: 'Has Attachment',
+                            name: 'hasAttachment',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to return only emails with attachments',
+                        },
+                        {
+                            displayName: 'Received After',
+                            name: 'after',
+                            type: 'dateTime',
+                            default: '',
+                            description: 'Filter emails received after this date',
+                        },
+                        {
+                            displayName: 'Received Before',
+                            name: 'before',
+                            type: 'dateTime',
+                            default: '',
+                            description: 'Filter emails received before this date',
+                        },
+                        {
+                            displayName: 'Subject Contains',
+                            name: 'subject',
+                            type: 'string',
+                            default: '',
+                            placeholder: 'Invoice',
+                            description: 'Filter emails where the subject contains this text',
+                        },
+                        {
+                            displayName: 'To Contains',
+                            name: 'to',
+                            type: 'string',
+                            default: '',
+                            placeholder: 'recipient@example.com',
+                            description: 'Filter emails where the To address contains this text',
+                        },
+                        {
+                            displayName: 'Unread Only',
+                            name: 'unreadOnly',
+                            type: 'boolean',
+                            default: false,
+                            description: 'Whether to return only unread emails',
+                        },
+                    ],
+                },
                 // ==================== MAILBOX PARAMETERS ====================
                 {
                     displayName: 'Mailbox ID',
@@ -630,10 +715,42 @@ class Jmap {
                     if (operation === 'getMany') {
                         const mailbox = this.getNodeParameter('mailbox', i);
                         const limit = this.getNodeParameter('limit', i);
+                        const options = this.getNodeParameter('getManyOptions', i);
                         const filter = {};
+                        // Mailbox filter
                         if (mailbox) {
                             filter.inMailbox = mailbox;
                         }
+                        // Date filters
+                        if (options.after) {
+                            filter.after = new Date(options.after).toISOString();
+                        }
+                        if (options.before) {
+                            filter.before = new Date(options.before).toISOString();
+                        }
+                        // Content filters
+                        if (options.from) {
+                            filter.from = options.from;
+                        }
+                        if (options.to) {
+                            filter.to = options.to;
+                        }
+                        if (options.subject) {
+                            filter.subject = options.subject;
+                        }
+                        if (options.text) {
+                            filter.text = options.text;
+                        }
+                        // Boolean filters
+                        if (options.hasAttachment) {
+                            filter.hasAttachment = true;
+                        }
+                        if (options.unreadOnly) {
+                            filter.notKeyword = '$seen';
+                        }
+                        if (options.flaggedOnly) {
+                            filter.hasKeyword = '$flagged';
+                        }
                         const { ids } = await GenericFunctions_1.queryEmails.call(this, accountId, filter, [{ property: 'receivedAt', isAscending: false }], limit);
                         if (ids.length > 0) {
                             responseData = await GenericFunctions_1.getEmails.call(this, accountId, ids);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-jmap",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "n8n community node for JMAP email protocol (RFC 8620/8621) - Works with Apache James, Twake Mail, Fastmail, and other JMAP-compatible servers",
   "keywords": [
     "n8n-community-node-package",