@pakoor/n8n-nodes-instagram 0.1.0

package/dist/services/WebhookHandler.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * WebhookHandler Service
+ * Handles Instagram webhook verification, signature validation, and event processing
+ *
+ * Requirements covered:
+ * - 12.1: Webhook verification with hub.challenge response
+ * - 12.2: Incoming message event parsing (sender, text, attachments)
+ * - 12.3: Postback event parsing (title, payload)
+ * - 12.4: Opt-in event parsing (ref, user_ref)
+ * - 12.5: X-Hub-Signature-256 validation using HMAC SHA256
+ * - 12.6: Signature validation failure handling
+ * - 13.1: Comment event parsing (media_id, comment text, commenter info)
+ * - 13.2: Mention event parsing (media_id, mentioned by)
+ * - 13.3: Dual output system (Output 1: messaging, Output 2: content)
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookHandler = void 0;
+const crypto = __importStar(require("crypto"));
+class WebhookHandler {
+    /**
+     * Verify webhook subscription request (Requirement 12.1)
+     * Returns challenge if verify token matches, null otherwise
+     *
+     * @param query - The query parameters from the verification request
+     * @param expectedVerifyToken - The expected verify token configured in the app
+     * @returns The challenge string if verification succeeds, null otherwise
+     */
+    verifyWebhook(query, expectedVerifyToken) {
+        if (query['hub.mode'] === 'subscribe' &&
+            query['hub.verify_token'] === expectedVerifyToken &&
+            query['hub.challenge']) {
+            return query['hub.challenge'];
+        }
+        return null;
+    }
+    /**
+     * Validate webhook signature using HMAC SHA256 (Requirements 12.5, 12.6)
+     * Uses timing-safe comparison to prevent timing attacks
+     *
+     * @param payload - The raw request body as a string
+     * @param signature - The X-Hub-Signature-256 header value
+     * @param appSecret - The app secret used for HMAC calculation
+     * @returns true if signature is valid, false otherwise
+     */
+    validateSignature(payload, signature, appSecret) {
+        if (!signature || !signature.startsWith('sha256=')) {
+            return false;
+        }
+        const expectedSignature = crypto
+            .createHmac('sha256', appSecret)
+            .update(payload)
+            .digest('hex');
+        const providedSignature = signature.replace('sha256=', '');
+        // Ensure both signatures have the same length before comparison
+        if (expectedSignature.length !== providedSignature.length) {
+            return false;
+        }
+        try {
+            return crypto.timingSafeEqual(Buffer.from(expectedSignature, 'hex'), Buffer.from(providedSignature, 'hex'));
+        }
+        catch {
+            // Handle invalid hex strings
+            return false;
+        }
+    }
+    /**
+     * Process webhook payload and route events to appropriate outputs (Requirement 13.3)
+     * Output 1: Messaging events (messages, postbacks, optins)
+     * Output 2: Content events (comments, mentions)
+     *
+     * @param body - The webhook body from Instagram
+     * @returns Separated messaging and content events
+     */
+    processWebhook(body) {
+        const messagingEvents = [];
+        const contentEvents = [];
+        if (body.object !== 'instagram' || !body.entry) {
+            return { messagingEvents, contentEvents };
+        }
+        for (const entry of body.entry) {
+            // Collect messaging events (Output 1) - Requirements 12.2, 12.3, 12.4
+            if (entry.messaging && Array.isArray(entry.messaging)) {
+                messagingEvents.push(...entry.messaging);
+            }
+            // Collect content events (Output 2) - Requirements 13.1, 13.2
+            if (entry.changes && Array.isArray(entry.changes)) {
+                contentEvents.push(...entry.changes);
+            }
+        }
+        return { messagingEvents, contentEvents };
+    }
+    /**
+     * Parse a messaging event into a more consumable format (Requirements 12.2, 12.3, 12.4)
+     * Extracts sender ID, message ID, text/attachments for messages
+     * Extracts sender ID, title, payload for postbacks
+     * Extracts ref, user_ref for optins
+     *
+     * @param event - The raw messaging event
+     * @returns Parsed event with extracted fields, or null if invalid
+     */
+    parseMessagingEvent(event) {
+        const baseFields = {
+            senderId: event.sender?.id,
+            recipientId: event.recipient?.id,
+            timestamp: event.timestamp,
+        };
+        // Validate required base fields
+        if (!baseFields.senderId || !baseFields.recipientId) {
+            return null;
+        }
+        // Parse message event (Requirement 12.2)
+        if (event.message) {
+            return {
+                type: 'message',
+                ...baseFields,
+                messageId: event.message.mid,
+                text: event.message.text,
+                attachments: event.message.attachments,
+            };
+        }
+        // Parse postback event (Requirement 12.3)
+        if (event.postback) {
+            return {
+                type: 'postback',
+                ...baseFields,
+                messageId: event.postback.mid,
+                title: event.postback.title,
+                payload: event.postback.payload,
+            };
+        }
+        // Parse opt-in event (Requirement 12.4)
+        if (event.optin) {
+            return {
+                type: 'optin',
+                ...baseFields,
+                ref: event.optin.ref,
+                userRef: event.optin.user_ref,
+            };
+        }
+        return null;
+    }
+    /**
+     * Parse a content event into a more consumable format (Requirements 13.1, 13.2)
+     * Extracts media ID, comment ID, text, commenter info for comments
+     * Extracts media ID, mentioned by info for mentions
+     *
+     * @param event - The raw change event
+     * @returns Parsed event with extracted fields, or null if invalid
+     */
+    parseContentEvent(event) {
+        if (!event.value || !event.value.media_id || !event.value.id || !event.value.from) {
+            return null;
+        }
+        // Parse comment event (Requirement 13.1)
+        if (event.field === 'comments') {
+            return {
+                type: 'comment',
+                mediaId: event.value.media_id,
+                commentId: event.value.id,
+                text: event.value.text,
+                from: event.value.from,
+            };
+        }
+        // Parse mention event (Requirement 13.2)
+        if (event.field === 'mentions') {
+            return {
+                type: 'mention',
+                mediaId: event.value.media_id,
+                mentionId: event.value.id,
+                from: event.value.from,
+            };
+        }
+        return null;
+    }
+    /**
+     * Process and parse all events from a webhook body
+     * Returns fully parsed events ready for n8n output
+     *
+     * @param body - The webhook body from Instagram
+     * @returns Parsed messaging and content events
+     */
+    processAndParseWebhook(body) {
+        const { messagingEvents, contentEvents } = this.processWebhook(body);
+        const parsedMessaging = messagingEvents
+            .map((event) => this.parseMessagingEvent(event))
+            .filter((event) => event !== null);
+        const parsedContent = contentEvents
+            .map((event) => this.parseContentEvent(event))
+            .filter((event) => event !== null);
+        return {
+            messagingEvents: parsedMessaging,
+            contentEvents: parsedContent,
+        };
+    }
+    /**
+     * Check if a messaging event is a message type
+     */
+    isMessageEvent(event) {
+        return !!event.message;
+    }
+    /**
+     * Check if a messaging event is a postback type
+     */
+    isPostbackEvent(event) {
+        return !!event.postback;
+    }
+    /**
+     * Check if a messaging event is an opt-in type
+     */
+    isOptinEvent(event) {
+        return !!event.optin;
+    }
+    /**
+     * Check if a content event is a comment type
+     */
+    isCommentEvent(event) {
+        return event.field === 'comments';
+    }
+    /**
+     * Check if a content event is a mention type
+     */
+    isMentionEvent(event) {
+        return event.field === 'mentions';
+    }
+}
+exports.WebhookHandler = WebhookHandler;
+//# sourceMappingURL=WebhookHandler.js.map

package/dist/services/WebhookHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookHandler.js","sourceRoot":"","sources":["../../src/services/WebhookHandler.ts"],"names":[],"mappings":"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"}

package/dist/services/index.d.ts

@@ -0,0 +1,5 @@
+export * from './TokenManager';
+export * from './InstagramApiClient';
+export * from './WebhookHandler';
+export * from './ValidationUtils';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,21 @@
+"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("./TokenManager"), exports);
+__exportStar(require("./InstagramApiClient"), exports);
+__exportStar(require("./WebhookHandler"), exports);
+__exportStar(require("./ValidationUtils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,uDAAqC;AACrC,mDAAiC;AACjC,oDAAkC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@pakoor/n8n-nodes-instagram",
+  "version": "0.1.0",
+  "description": "n8n community node for Instagram Messaging API integration",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "instagram",
+    "messaging",
+    "social-media"
+  ],
+  "license": "MIT",
+  "homepage": "",
+  "author": {
+    "name": ""
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && gulp build:icons",
+    "dev": "tsc --watch",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/InstagramOAuth2Api.credentials.js",
+      "dist/credentials/InstagramAccessTokenApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Instagram/Instagram.node.js",
+      "dist/nodes/Instagram/InstagramTrigger.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-n8n-nodes-base": "^1.16.1",
+    "fast-check": "^3.15.0",
+    "gulp": "^4.0.2",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "dependencies": {
+    "n8n-core": "^1.0.0"
+  }
+}