@estaldo/n8n-nodes-postmarkapp 0.1.0

package/dist/nodes/PostmarkEmail/helpers/buildEmailBody.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectSingleMessage = collectSingleMessage;
+exports.collectBatchMessages = collectBatchMessages;
+exports.buildEmailBody = buildEmailBody;
+const n8n_workflow_1 = require("n8n-workflow");
+const mergeAdditionalFields_1 = require("./mergeAdditionalFields");
+// --- Collectors -------------------------------------------------------------
+//
+// Read the raw n8n parameters for one or more messages and shape them into the flat
+// source objects that `buildEmailBody` consumes. The same source shape is used for
+// both single and batch operations, so single send / sendWithTemplate paths reuse
+// the same body builder as each entry in a batch.
+// Reads the top-level single-send / sendWithTemplate parameters into a source object.
+// Optional fields are now flat at the top level (no "Additional Fields" wrapper) — we
+// collect them individually and pack them into `additionalFields` so buildEmailBody's
+// merge logic stays unchanged.
+function collectSingleMessage(ctx, itemIndex, kind) {
+    const source = {
+        from: ctx.getNodeParameter('from', itemIndex),
+        to: ctx.getNodeParameter('to', itemIndex),
+        additionalFields: collectFlatOptionalFields(ctx, itemIndex),
+    };
+    if (kind === 'plain') {
+        source.subject = ctx.getNodeParameter('subject', itemIndex);
+        source.htmlBody = ctx.getNodeParameter('htmlBody', itemIndex, '');
+        source.textBody = ctx.getNodeParameter('textBody', itemIndex, '');
+    }
+    else {
+        source.templateSource = ctx.getNodeParameter('templateSource', itemIndex);
+        source.templateId = ctx.getNodeParameter('templateId', itemIndex);
+        source.templateModel = ctx.getNodeParameter('templateModel', itemIndex, '{}');
+    }
+    return source;
+}
+// Pulls the per-message array out of the appropriate batch fixedCollection. Each
+// raw message has flat fields (Bcc, Cc, Headers, etc. all at the message-entry
+// level, no nested Additional Fields). We restructure each message to nest the
+// optional fields under `additionalFields` so buildEmailBody can consume them
+// uniformly with single-send sources.
+function collectBatchMessages(ctx, itemIndex, kind) {
+    const paramName = kind === 'templated' ? 'batchMessagesWithTemplates' : 'batchMessages';
+    const collection = ctx.getNodeParameter(paramName, itemIndex, {});
+    const messages = collection.message;
+    if (!Array.isArray(messages)) {
+        return [];
+    }
+    return messages.map(restructureBatchMessage);
+}
+// Reads each top-level optional Postmark field into a flat object. mergeAdditionalFields
+// downstream skips empty strings and empty fixedCollections, so unfilled fields don't
+// leak into the request body.
+function collectFlatOptionalFields(ctx, itemIndex) {
+    return {
+        Attachments: ctx.getNodeParameter('Attachments', itemIndex, {}),
+        Bcc: ctx.getNodeParameter('Bcc', itemIndex, ''),
+        Cc: ctx.getNodeParameter('Cc', itemIndex, ''),
+        Headers: ctx.getNodeParameter('Headers', itemIndex, {}),
+        Metadata: ctx.getNodeParameter('Metadata', itemIndex, {}),
+        ReplyTo: ctx.getNodeParameter('ReplyTo', itemIndex, ''),
+        Tag: ctx.getNodeParameter('Tag', itemIndex, ''),
+        TrackLinks: ctx.getNodeParameter('TrackLinks', itemIndex, 'None'),
+        TrackOpens: ctx.getNodeParameter('TrackOpens', itemIndex, false),
+    };
+}
+// Splits a flat batch message entry into primary fields + an `additionalFields` bucket
+// containing everything else, matching the source shape buildEmailBody expects.
+function restructureBatchMessage(msg) {
+    const { from, to, subject, htmlBody, textBody, templateSource, templateId, templateModel, ...additionalFields } = msg;
+    return {
+        from,
+        to,
+        subject,
+        htmlBody,
+        textBody,
+        templateSource,
+        templateId,
+        templateModel,
+        additionalFields,
+    };
+}
+// --- Builder ----------------------------------------------------------------
+//
+// Turn a flat source object (whether from `collectSingleMessage` or one entry of
+// `collectBatchMessages`) into the Postmark request body for that message.
+function buildEmailBody(ctx, itemIndex, source, kind) {
+    const body = {
+        From: source.from,
+        To: source.to,
+    };
+    if (kind === 'plain') {
+        const htmlBody = source.htmlBody ?? '';
+        const textBody = source.textBody ?? '';
+        if (!htmlBody && !textBody) {
+            throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), 'At least one of HTML Body or Text Body must be set', { itemIndex });
+        }
+        body.Subject = source.subject;
+        if (htmlBody) {
+            body.HtmlBody = htmlBody;
+        }
+        if (textBody) {
+            body.TextBody = textBody;
+        }
+    }
+    else {
+        const templateSource = source.templateSource;
+        const templateId = source.templateId;
+        if (templateSource === 'alias') {
+            body.TemplateAlias = templateId;
+        }
+        else {
+            const id = parseInt(templateId, 10);
+            if (Number.isNaN(id)) {
+                throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Template ID must be numeric, got '${templateId}'`, { itemIndex });
+            }
+            body.TemplateId = id;
+        }
+        const modelRaw = source.templateModel ?? '{}';
+        let model;
+        try {
+            model = typeof modelRaw === 'string'
+                ? JSON.parse(modelRaw)
+                : modelRaw;
+        }
+        catch (err) {
+            throw new n8n_workflow_1.NodeOperationError(ctx.getNode(), `Invalid Template Model JSON: ${err.message}`, { itemIndex });
+        }
+        body.TemplateModel = model;
+    }
+    const additionalFields = source.additionalFields ?? {};
+    (0, mergeAdditionalFields_1.mergeAdditionalFields)(body, additionalFields);
+    return body;
+}

package/dist/nodes/PostmarkEmail/helpers/errors.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapPostmarkError = wrapPostmarkError;
+const n8n_workflow_1 = require("n8n-workflow");
+function wrapPostmarkError(ctx, err, itemIndex) {
+    // The HTTP helper surfaces Postmark's { ErrorCode, Message } body on error responses.
+    // Pull it through so workflow authors see the API's reason rather than a generic 422.
+    const e = err;
+    const postmarkMessage = e.response?.body?.Message;
+    const postmarkCode = e.response?.body?.ErrorCode;
+    const detail = postmarkMessage
+        ? `Postmark error ${postmarkCode ?? '?'}: ${postmarkMessage}`
+        : (e.message ?? 'Unknown error');
+    return new n8n_workflow_1.NodeOperationError(ctx.getNode(), detail, { itemIndex });
+}

package/dist/nodes/PostmarkEmail/helpers/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mergeAdditionalFields"), exports);
+__exportStar(require("./buildEmailBody"), exports);
+__exportStar(require("./errors"), exports);

package/dist/nodes/PostmarkEmail/helpers/mergeAdditionalFields.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeAdditionalFields = mergeAdditionalFields;
+exports.applyDefaultMessageStream = applyDefaultMessageStream;
+function mergeAdditionalFields(body, additional) {
+    for (const [key, value] of Object.entries(additional)) {
+        if (value === undefined || value === null || value === '') {
+            continue;
+        }
+        if (key === 'Metadata') {
+            const pairs = unwrapFixedCollection(value, 'pair');
+            const metadata = {};
+            for (const pair of pairs) {
+                const k = pair.key;
+                const v = pair.value;
+                if (k) {
+                    metadata[k] = v;
+                }
+            }
+            if (Object.keys(metadata).length > 0) {
+                body.Metadata = metadata;
+            }
+        }
+        else if (key === 'Headers') {
+            const headers = unwrapFixedCollection(value, 'header')
+                .filter((h) => h.Name)
+                .map((h) => ({
+                Name: h.Name,
+                Value: h.Value ?? '',
+            }));
+            if (headers.length > 0) {
+                body.Headers = headers;
+            }
+        }
+        else if (key === 'Attachments') {
+            const attachments = unwrapFixedCollection(value, 'attachment')
+                .filter((a) => a.Name && a.Content)
+                .map((a) => {
+                const att = {
+                    Name: a.Name,
+                    Content: a.Content,
+                    ContentType: a.ContentType || 'application/octet-stream',
+                };
+                if (a.ContentID) {
+                    att.ContentID = a.ContentID;
+                }
+                return att;
+            });
+            if (attachments.length > 0) {
+                body.Attachments = attachments;
+            }
+        }
+        else {
+            body[key] = value;
+        }
+    }
+}
+// Sets MessageStream on the body if not already present and a default is provided.
+// Per-message MessageStream (set via Additional Fields) wins over the top-level default.
+function applyDefaultMessageStream(body, defaultStream) {
+    if (defaultStream && !body.MessageStream) {
+        body.MessageStream = defaultStream;
+    }
+}
+// fixedCollection with multipleValues=true wraps the items array under a single key
+// (defined as `name` on the option). Pull that array out, defending against missing or
+// malformed shapes that n8n sometimes hands us when a user adds zero items.
+function unwrapFixedCollection(value, innerKey) {
+    const obj = value;
+    const collection = obj?.[innerKey];
+    if (!Array.isArray(collection)) {
+        return [];
+    }
+    return collection;
+}

package/dist/nodes/PostmarkEmail/operations.js

@@ -0,0 +1,21 @@
+"use strict";
+// Single source of truth for the operation identifiers this node supports. Used both
+// by description files (option values, displayOptions) and by the execute() switch
+// logic, so a typo anywhere becomes a TypeScript error rather than a silent runtime
+// no-op.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OPERATION_ENDPOINTS = exports.Operation = void 0;
+exports.Operation = {
+    Send: 'send',
+    SendWithTemplate: 'sendWithTemplate',
+    SendBatch: 'sendBatch',
+    SendBatchWithTemplates: 'sendBatchWithTemplates',
+};
+// Every operation must have an endpoint — TypeScript's exhaustiveness check on
+// `Record<Operation, string>` keeps this in lockstep with the const above.
+exports.OPERATION_ENDPOINTS = {
+    [exports.Operation.Send]: '/email',
+    [exports.Operation.SendWithTemplate]: '/email/withTemplate',
+    [exports.Operation.SendBatch]: '/email/batch',
+    [exports.Operation.SendBatchWithTemplates]: '/email/batchWithTemplates',
+};

package/dist/nodes/PostmarkEmail/postmarkEmail.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 60 60" width="60" height="60">
+  <rect width="60" height="60" rx="10" fill="#FFDE00"/>
+  <path d="M14 20 H46 V44 H14 Z" fill="none" stroke="#1A1A1A" stroke-width="3" stroke-linejoin="round"/>
+  <path d="M14 20 L30 34 L46 20" fill="none" stroke="#1A1A1A" stroke-width="3" stroke-linejoin="round"/>
+</svg>

package/dist/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@estaldo/n8n-nodes-postmarkapp",
+  "version": "0.1.0",
+  "description": "Postmark integration nodes for n8n",
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "nodes": [
+      "nodes/PostmarkEmail/PostmarkEmail.node.js"
+    ]
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}