n8n-nodes-resend 2.0.1 → 2.1.0

package/LICENSE.md

@@ -1,19 +1,19 @@
-Copyright 2022 n8n
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
-of the Software, and to permit persons to whom the Software is furnished to do
-so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Copyright 2022 n8n
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,17 +1,21 @@
 <h1 align="center">
   <br>
-  <a href="/"><img src=".github/media/resend.png" alt="n8n-nodes-resend" width="900"></a>
+  <a href="/"><img src=".github/media/resend-header.png" alt="n8n-nodes-resend" width="900"></a>
   <br>
 </h1>
 
 <p align="center">
-  <a href="https://badge.fury.io/js/n8n-nodes-resend"><img src="https://badge.fury.io/js/n8n-nodes-resend.svg" alt="npm version"></a>
-  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+	<img alt="NPM Version" src="https://img.shields.io/npm/v/n8n-nodes-resend">
+	<img alt="GitHub License" src="https://img.shields.io/github/license/SilkePilon/n8n-nodes-resend">
+	<img alt="NPM Downloads" src="https://img.shields.io/npm/dm/n8n-nodes-resend">
+	<img alt="NPM Last Update" src="https://img.shields.io/npm/last-update/n8n-nodes-resend">
+	<img alt="n8n community node" src="https://img.shields.io/badge/n8n-community_node-blue?logo=n8n">
 </p>
 
 <p align="center">
   <a href="#installation">Installation</a> |
   <a href="#credentials">Credentials</a> |
+  <a href="#human-in-the-loop">Human in the Loop</a> |
   <a href="#resources">Resources</a> |
   <a href="#trigger-events">Trigger Events</a> |
   <a href="#development">Development</a>
@@ -25,23 +29,20 @@ A community node for [n8n](https://n8n.io) that integrates with the [Resend](htt
 
 Comprehensive coverage of the Resend API (v1.1.0). The table below shows which endpoints are currently implemented:
 
-| API Resource                 | Endpoint                                   | Status          | Operations                                                      |
-| ---------------------------- | ------------------------------------------ | --------------- | --------------------------------------------------------------- |
-| **Email**              | `/emails`                                | ✅ Full         | Send, Send Batch, List, Get, Update, Cancel                     |
-| **Email Attachments**  | `/emails/{id}/attachments`               | ❌ Missing      | List attachments, Get attachment                                |
-| **Receiving Emails**   | `/emails/receiving`                      | ❌ Missing      | List received, Get received, Get attachments                    |
-| **Domains**            | `/domains`                               | ✅ Full         | Create, List, Get, Update, Delete, Verify                       |
-| **API Keys**           | `/api-keys`                              | ✅ Full         | Create, List, Delete                                            |
-| **Templates**          | `/templates`                             | ⚠️ Partial    | Create, List, Get, Update, Delete (Missing: Publish, Duplicate) |
-| **Audiences**          | `/audiences`                             | ⚠️ Deprecated | Replaced by Segments in v2.0.0                                  |
-| **Contacts**           | `/audiences/{id}/contacts`               | ✅ Full         | Create, List, Get, Update, Delete                               |
-| **Contact Segments**   | `/audiences/{id}/contacts/{id}/segments` | ❌ Missing      | Add to segment, List segments, Remove from segment              |
-| **Contact Topics**     | `/audiences/{id}/contacts/{id}/topics`   | ❌ Missing      | Get topics, Update topics                                       |
-| **Broadcasts**         | `/broadcasts`                            | ✅ Full         | Create, List, Get, Update, Delete, Send                         |
-| **Segments**           | `/segments`                              | ⚠️ Partial    | Create, List, Get, Delete (Missing: Update, Filter conditions)  |
-| **Topics**             | `/topics`                                | ✅ Full         | Create, List, Get, Update, Delete                               |
-| **Contact Properties** | `/contact-properties`                    | ✅ Full         | Create, List, Get, Update, Delete                               |
-| **Webhooks**           | `/webhooks`                              | ✅ Full         | Create, List, Get, Update, Delete                               |
+| API Resource           | Endpoint                   | Status  | Operations                                                                                                       |
+| ---------------------- | -------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- |
+| **Email**              | `/emails`                  | ✅ Full | Send, Send Batch, Send and Wait, List, Get, Update, Cancel, List Attachments, Get Attachment                     |
+| **Receiving Emails**   | `/emails/receiving`        | ✅ Full | List, Get, List Attachments, Get Attachment                                                                      |
+| **Domains**            | `/domains`                 | ✅ Full | Create, List, Get, Update, Delete, Verify                                                                        |
+| **API Keys**           | `/api-keys`                | ✅ Full | Create, List, Delete                                                                                             |
+| **Templates**          | `/templates`               | ✅ Full | Create, List, Get, Update, Delete, Publish, Duplicate                                                            |
+| **Audiences**          | `/audiences`               | ✅ Full | Create, List, Get, Delete                                                                                        |
+| **Contacts**           | `/audiences/{id}/contacts` | ✅ Full | Create, List, Get, Update, Delete, Add to Segment, List Segments, Remove from Segment, Get Topics, Update Topics |
+| **Broadcasts**         | `/broadcasts`              | ✅ Full | Create, List, Get, Update, Delete, Send                                                                          |
+| **Segments**           | `/segments`                | ✅ Full | Create, List, Get, Delete                                                                                        |
+| **Topics**             | `/topics`                  | ✅ Full | Create, List, Get, Update, Delete                                                                                |
+| **Contact Properties** | `/contact-properties`      | ✅ Full | Create, List, Get, Update, Delete                                                                                |
+| **Webhooks**           | `/webhooks`                | ✅ Full | Create, List, Get, Update, Delete                                                                                |
 
 ## Installation
 
@@ -74,28 +75,82 @@ docker run -it --rm \
 2. In n8n, go to **Credentials** > **Add credential**
 3. Search for **Resend API** and paste your key
 
+## Human in the Loop
+
+The **Send and Wait for Response** operation enables human-in-the-loop workflows. Send an email and pause the workflow until the recipient responds via approval buttons or a form.
+
+### Features
+
+- **Approval Workflows**: Send emails with Approve/Decline buttons for quick decisions
+- **Free Text Responses**: Collect text input via a response form
+- **Configurable Wait Time**: Set a timeout or wait indefinitely
+- **Secure Callbacks**: Responses use signed URLs for security
+
+### How to Use
+
+1. In the node panel, go to **Human in the Loop** > **Resend**
+2. Or select **Email** resource > **Send and Wait for Response** operation
+
+### Configuration Options
+
+| Option                   | Description                                              |
+| ------------------------ | -------------------------------------------------------- |
+| **Response Type**        | Choose between Approval (buttons) or Free Text (form)    |
+| **Approval Type**        | Single button (Approve only) or Double (Approve/Decline) |
+| **Button Labels**        | Customize the button text                                |
+| **Button Styles**        | Primary or Secondary styling                             |
+| **Message Button Label** | Label for the form link button (Free Text mode)          |
+| **Response Form Title**  | Title shown on the response form                         |
+| **Limit Wait Time**      | Set a timeout for the wait period                        |
+
 ## Resources
 
 ### Email
 
-| Operation  | Description                                   |
-| ---------- | --------------------------------------------- |
-| Send       | Send a single email with optional attachments |
-| Send Batch | Send up to 100 emails in one request          |
-| List       | List sent emails                              |
-| Get        | Retrieve email details and status             |
-| Cancel     | Cancel a scheduled email                      |
-| Update     | Modify a scheduled email                      |
+| Operation        | Description                                       |
+| ---------------- | ------------------------------------------------- |
+| Send             | Send a single email with optional attachments     |
+| Send Batch       | Send up to 100 emails in one request              |
+| Send and Wait    | Send email and wait for recipient response (HITL) |
+| List             | List sent emails                                  |
+| Get              | Retrieve email details and status                 |
+| Cancel           | Cancel a scheduled email                          |
+| Update           | Modify a scheduled email                          |
+| List Attachments | List attachments for a sent email                 |
+| Get Attachment   | Get a specific attachment from a sent email       |
+
+### Receiving Email
+
+| Operation        | Description                                     |
+| ---------------- | ----------------------------------------------- |
+| List             | List all received emails                        |
+| Get              | Retrieve a received email                       |
+| List Attachments | List attachments for a received email           |
+| Get Attachment   | Get a specific attachment from a received email |
+
+### Audience
+
+| Operation | Description               |
+| --------- | ------------------------- |
+| Create    | Create a new audience     |
+| Get       | Retrieve audience details |
+| Delete    | Delete an audience        |
+| List      | List all audiences        |
 
 ### Contact
 
-| Operation | Description                |
-| --------- | -------------------------- |
-| Create    | Add a new contact          |
-| Get       | Retrieve contact details   |
-| Update    | Modify contact information |
-| Delete    | Remove a contact           |
-| List      | List all contacts          |
+| Operation           | Description                              |
+| ------------------- | ---------------------------------------- |
+| Create              | Add a new contact                        |
+| Get                 | Retrieve contact details                 |
+| Update              | Modify contact information               |
+| Delete              | Remove a contact                         |
+| List                | List all contacts                        |
+| Add to Segment      | Add a contact to a segment               |
+| List Segments       | List segments for a contact              |
+| Remove From Segment | Remove a contact from a segment          |
+| Get Topics          | Get topic subscriptions for a contact    |
+| Update Topics       | Update topic subscriptions for a contact |
 
 ### Contact Property
 
@@ -109,12 +164,12 @@ docker run -it --rm \
 
 ### Segment
 
-| Operation | Description              |
-| --------- | ------------------------ |
-| Create    | Create a new segment     |
-| Get       | Retrieve segment details |
-| Delete    | Remove a segment         |
-| List      | List all segments        |
+| Operation | Description                                          |
+| --------- | ---------------------------------------------------- |
+| Create    | Create a new segment with optional filter conditions |
+| Get       | Retrieve segment details                             |
+| Delete    | Remove a segment                                     |
+| List      | List all segments                                    |
 
 ### Topic
 
@@ -139,13 +194,15 @@ docker run -it --rm \
 
 ### Template
 
-| Operation | Description               |
-| --------- | ------------------------- |
-| Create    | Create an email template  |
-| Get       | Retrieve template details |
-| Update    | Modify a template         |
-| Delete    | Remove a template         |
-| List      | List all templates        |
+| Operation | Description                    |
+| --------- | ------------------------------ |
+| Create    | Create an email template       |
+| Get       | Retrieve template details      |
+| Update    | Modify a template              |
+| Delete    | Remove a template              |
+| List      | List all templates             |
+| Publish   | Publish a template             |
+| Duplicate | Duplicate an existing template |
 
 ### Domain
 
@@ -180,8 +237,8 @@ docker run -it --rm \
 
 The **Resend Trigger** node receives webhooks for real-time email events. Signatures are automatically verified using Svix.
 
-| Event                      | Description                  |
-| -------------------------- | ---------------------------- |
+| Event                    | Description                  |
+| ------------------------ | ---------------------------- |
 | `email.sent`             | Email sent to recipient      |
 | `email.delivered`        | Email delivered successfully |
 | `email.delivery_delayed` | Email delivery delayed       |

package/dist/credentials/ResendApi.credentials.d.ts

@@ -3,6 +3,7 @@ export declare class ResendApi implements ICredentialType {
     name: string;
     displayName: string;
     documentationUrl: string;
+    icon: "file:resend.svg";
     properties: INodeProperties[];
     authenticate: IAuthenticateGeneric;
     test: ICredentialTestRequest;

package/dist/credentials/ResendApi.credentials.js

@@ -6,6 +6,7 @@ class ResendApi {
         this.name = 'resendApi';
         this.displayName = 'Resend API';
         this.documentationUrl = 'https://resend.com/docs/api-reference/introduction';
+        this.icon = 'file:resend.svg';
         this.properties = [
             {
                 displayName: 'API Key',

package/dist/credentials/ResendApi.credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResendApi.credentials.js","sourceRoot":"","sources":["../../credentials/ResendApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,SAAS;IAAtB;QACC,SAAI,GAAG,WAAW,CAAC;QACnB,gBAAW,GAAG,YAAY,CAAC;QAC3B,qBAAgB,GAAG,oDAAoD,CAAC;QACxE,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QACF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,sCAAsC;iBACrD;aACD;SACD,CAAC;QACF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,wBAAwB;gBACjC,GAAG,EAAE,WAAW;gBAChB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AA7BD,8BA6BC"}
+{"version":3,"file":"ResendApi.credentials.js","sourceRoot":"","sources":["../../credentials/ResendApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,SAAS;IAAtB;QACC,SAAI,GAAG,WAAW,CAAC;QACnB,gBAAW,GAAG,YAAY,CAAC;QAC3B,qBAAgB,GAAG,oDAAoD,CAAC;QACxE,SAAI,GAAG,iBAA0B,CAAC;QAClC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,SAAS;gBACtB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;aACd;SACD,CAAC;QACF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,sCAAsC;iBACrD;aACD;SACD,CAAC;QACF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,wBAAwB;gBACjC,GAAG,EAAE,WAAW;gBAChB,MAAM,EAAE,KAAK;aACb;SACD,CAAC;IACH,CAAC;CAAA;AA9BD,8BA8BC"}

package/dist/credentials/resend.svg

@@ -0,0 +1,6 @@
+<svg width="60" height="60" viewBox="350 350 1100 1100" fill="none"
+    xmlns="http://www.w3.org/2000/svg">
+    <path
+        d="M1000.46 450C1174.77 450 1278.43 553.669 1278.43 691.282C1278.43 828.896 1174.77 932.563 1000.46 932.563H912.382L1350 1350H1040.82L707.794 1033.48C683.944 1011.47 672.936 985.781 672.935 963.765C672.935 932.572 694.959 905.049 737.161 893.122L908.712 847.244C973.85 829.812 1018.81 779.353 1018.81 713.298C1018.8 632.567 952.745 585.78 871.095 585.78H450V450H1000.46Z"
+        fill="currentColor" />
+</svg>

package/dist/nodes/Resend/Resend.node.d.ts

@@ -1,14 +1,63 @@
-import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
-import { getSegments, getTemplateVariables, getTemplates, getTopics } from './GenericFunctions';
+import type { INodeType, INodeTypeDescription, IWebhookFunctions } from 'n8n-workflow';
+import { router } from './actions/router';
+import { getApiKeys, getAudiences, getBroadcasts, getContactProperties, getContacts, getDomains, getEmails, getReceivedEmails, getSegments, getTemplateVariables, getTemplates, getTopics, getWebhooks, getApiKeysListSearch, getAudiencesListSearch, getBroadcastsListSearch, getContactPropertiesListSearch, getContactsListSearch, getDomainsListSearch, getEmailsListSearch, getReceivedEmailsListSearch, getSegmentsListSearch, getTemplatesListSearch, getTopicsListSearch, getWebhooksListSearch } from './methods';
 export declare class Resend implements INodeType {
     description: INodeTypeDescription;
     methods: {
         loadOptions: {
+            getApiKeys: typeof getApiKeys;
+            getAudiences: typeof getAudiences;
+            getBroadcasts: typeof getBroadcasts;
+            getContactProperties: typeof getContactProperties;
+            getContacts: typeof getContacts;
+            getDomains: typeof getDomains;
+            getEmails: typeof getEmails;
+            getReceivedEmails: typeof getReceivedEmails;
+            getSegments: typeof getSegments;
             getTemplateVariables: typeof getTemplateVariables;
             getTemplates: typeof getTemplates;
-            getSegments: typeof getSegments;
             getTopics: typeof getTopics;
+            getWebhooks: typeof getWebhooks;
+        };
+        listSearch: {
+            getApiKeys: typeof getApiKeysListSearch;
+            getAudiences: typeof getAudiencesListSearch;
+            getBroadcasts: typeof getBroadcastsListSearch;
+            getContactProperties: typeof getContactPropertiesListSearch;
+            getContacts: typeof getContactsListSearch;
+            getDomains: typeof getDomainsListSearch;
+            getEmails: typeof getEmailsListSearch;
+            getReceivedEmails: typeof getReceivedEmailsListSearch;
+            getSegments: typeof getSegmentsListSearch;
+            getTemplates: typeof getTemplatesListSearch;
+            getTopics: typeof getTopicsListSearch;
+            getWebhooks: typeof getWebhooksListSearch;
         };
     };
-    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+    webhook: (this: IWebhookFunctions) => Promise<{
+        noWebhookResponse: boolean;
+        webhookResponse?: undefined;
+        workflowData?: undefined;
+    } | {
+        webhookResponse: undefined;
+        workflowData: {
+            json: {
+                data: {
+                    text: string;
+                };
+            };
+        }[][];
+        noWebhookResponse?: undefined;
+    } | {
+        webhookResponse: undefined;
+        workflowData: {
+            json: {
+                data: {
+                    approved: boolean;
+                };
+            };
+        }[][];
+        noWebhookResponse?: undefined;
+    }>;
+    execute: typeof router;
 }