@rizkifirmansyah/n8n-nodes-threads-api 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rizki Firmansyah
+
+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

@@ -0,0 +1,165 @@
+# @rizkifirmansyah/n8n-nodes-threads-api
+
+![Threads Node](nodes/Threads/threads.svg)
+
+An official community node package for **n8n** to interact with the **Meta Threads API**.
+
+Manage your Threads presence at scale: create posts (text, images, videos, carousels), moderate replies, fetch user profiles, retrieve insights/analytics, search posts, and listen to webhook events.
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Credentials & Authentication](#credentials--authentication)
+  - [1. OAuth2 Authentication](#1-oauth2-authentication)
+  - [2. User Access Token Authentication](#2-user-access-token-authentication)
+- [Available Resources & Operations](#available-resources--operations)
+  - [Post](#post)
+  - [Reply](#reply)
+  - [User](#user)
+  - [Insight](#insight)
+  - [Search](#search)
+  - [Threads Trigger (Webhook)](#threads-trigger-webhook)
+- [Meta Threads API Requirements](#meta-threads-api-requirements)
+- [Development & Contributing](#development--contributing)
+- [License](#license)
+
+---
+
+## Features
+
+- ✨ **Seamless Post Creation**: Auto-handles the 2-step media container creation & publishing workflow in a single action.
+- 🖼️ **Multi-Format Support**: Create **Text**, **Single Image**, **Single Video**, and multi-media **Carousels** (2–10 items).
+- 💬 **Reply & Conversation Management**: Create replies, view full discussion threads, and hide/unhide replies.
+- 📊 **Rich Analytics**: Retrieve engagement metrics (views, likes, replies, reposts, quotes) for posts and user accounts.
+- 🔍 **Keyword Search**: Discover and monitor public Threads conversations.
+- ⚡ **Webhook Trigger**: Receive real-time events (`threads_mentions`, `threads_replies`) with automated Meta Hub challenge verification.
+
+---
+
+## Installation
+
+### Community Nodes (Recommended)
+1. Go to **Settings > Community Nodes** in your n8n instance.
+2. Select **Install**.
+3. Enter `@rizkifirmansyah/n8n-nodes-threads-api` in the **npm Package Name** field.
+4. Agree to the risks and select **Install**.
+
+### Manual Installation (Self-Hosted / Docker)
+Inside your n8n root directory or custom nodes directory:
+```bash
+npm install @rizkifirmansyah/n8n-nodes-threads-api
+```
+
+---
+
+## Credentials & Authentication
+
+The node supports two authentication methods:
+
+### 1. OAuth2 Authentication
+Best for multi-user apps or standard OAuth authorization flows.
+
+1. Create an App in the [Meta Developer Dashboard](https://developers.facebook.com/).
+2. Add the **Threads API** use case.
+3. Configure your OAuth redirect URI (found in the n8n credential setup).
+4. Enter the **Client ID** and **Client Secret** into n8n.
+5. Click **Connect my account** to authorize with your Threads profile.
+
+### 2. User Access Token Authentication
+Best for personal automation and bot accounts using Long-Lived User Tokens (valid for 60 days).
+
+1. Generate a Threads User Access Token via the Meta Graph API Explorer or Token Exchange endpoint.
+2. Paste the **Access Token** into the n8n **Threads API** credential.
+
+---
+
+## Available Resources & Operations
+
+### Post
+| Operation | Description |
+| :--- | :--- |
+| **Create and Publish** | Creates media container (Text, Image, Video, Carousel) and immediately publishes it |
+| **Create Media Container** | Creates a media container ID without publishing |
+| **Publish Container** | Publishes a previously created media container using its `creation_id` |
+| **Get** | Retrieves details of a specific post or media by ID |
+| **Get Many** | Lists posts published by the user with pagination and date filters |
+| **Delete** | Deletes a post by its ID |
+
+### Reply
+| Operation | Description |
+| :--- | :--- |
+| **Create** | Replies to a specific post or reply |
+| **Get Many** | Retrieves direct replies made to a post |
+| **Get Conversation** | Retrieves all replies in a conversation thread |
+| **Manage (Hide/Unhide)** | Toggles visibility of a reply on your post (`hide=true/false`) |
+
+### User
+| Operation | Description |
+| :--- | :--- |
+| **Get Me** | Retrieves the authenticated user's profile info (`id`, `username`, `name`, `profile picture`, `bio`) |
+| **Get Profile** | Retrieves profile details for a given Threads User ID |
+| **Get Publishing Limit** | Retrieves current rate limit and quota usage (`/me/threads_publishing_limit`) |
+
+### Insight
+| Operation | Description |
+| :--- | :--- |
+| **Get Media Insights** | Retrieves post performance (`views`, `likes`, `replies`, `reposts`, `quotes`) |
+| **Get User Insights** | Retrieves account-level metrics over time with optional date range (`since`/`until`) |
+
+### Search
+| Operation | Description |
+| :--- | :--- |
+| **Keyword Search** | Searches public Threads posts matching a keyword query |
+
+### Threads Trigger (Webhook)
+Listens for incoming webhooks from Meta:
+- **Automatic Challenge Verification**: Responds to Meta `GET` challenge requests with `hub.challenge`.
+- **Event Filtering**: Supports `All Events`, `threads_mentions`, and `threads_replies`.
+- **Payload Extraction**: Cleanly separates changes or passes the full JSON payload.
+
+---
+
+## Meta Threads API Requirements
+
+- **Media URLs**: Any image or video URL passed to Threads API must be publicly accessible on the web.
+- **Publishing Limits**: Meta enforces a standard quota of 250 posts per 24-hour window per user.
+- **Scopes Required**:
+  - `threads_basic` (profile reading & general API access)
+  - `threads_content_publish` (posting content)
+  - `threads_read_replies` / `threads_manage_replies` (reply management)
+  - `threads_manage_insights` (analytics)
+  - `threads_keyword_search` (search)
+
+---
+
+## Development & Contributing
+
+To contribute or build locally:
+
+```bash
+# Clone repository
+git clone https://github.com/legenhand/n8n-nodes-threads.git
+cd n8n-nodes-threads
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Lint
+npm run lint
+
+# Start n8n in dev mode with live reload
+npm run dev
+```
+
+---
+
+## License
+
+[MIT](LICENSE) © [Rizki Firmansyah](https://github.com/legenhand)
+

package/dist/credentials/ThreadsApi.credentials.d.ts

@@ -0,0 +1,10 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ThreadsApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    icon: "file:threads.svg";
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ThreadsApi.credentials.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThreadsApi = void 0;
+class ThreadsApi {
+    constructor() {
+        this.name = 'threadsApi';
+        this.displayName = 'Threads API';
+        this.documentationUrl = 'https://developers.facebook.com/documentation/threads';
+        this.icon = 'file:threads.svg';
+        this.properties = [
+            {
+                displayName: 'Access Token',
+                name: 'accessToken',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'Threads User Access Token or Long-Lived User Access Token',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.accessToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://graph.threads.net/v1.0',
+                url: '/me',
+                qs: {
+                    fields: 'id,username,name',
+                },
+            },
+        };
+    }
+}
+exports.ThreadsApi = ThreadsApi;
+//# sourceMappingURL=ThreadsApi.credentials.js.map

package/dist/credentials/ThreadsApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadsApi.credentials.js","sourceRoot":"","sources":["../../credentials/ThreadsApi.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,UAAU;IAAvB;QACC,SAAI,GAAG,YAAY,CAAC;QACpB,gBAAW,GAAG,aAAa,CAAC;QAC5B,qBAAgB,GAAG,uDAAuD,CAAC;QAC3E,SAAI,GAAG,kBAA2B,CAAC;QAEnC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,cAAc;gBAC3B,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;oBACZ,QAAQ,EAAE,IAAI;iBACd;gBACD,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,2DAA2D;aACxE;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,sCAAsC;iBACrD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,gCAAgC;gBACzC,GAAG,EAAE,KAAK;gBACV,EAAE,EAAE;oBACH,MAAM,EAAE,kBAAkB;iBAC1B;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAtCD,gCAsCC"}

package/dist/credentials/ThreadsOAuth2Api.credentials.d.ts

@@ -0,0 +1,11 @@
+import type { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class ThreadsOAuth2Api implements ICredentialType {
+    name: string;
+    displayName: string;
+    extends: string[];
+    documentationUrl: string;
+    icon: "file:threads.svg";
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/ThreadsOAuth2Api.credentials.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThreadsOAuth2Api = void 0;
+class ThreadsOAuth2Api {
+    constructor() {
+        this.name = 'threadsOAuth2Api';
+        this.displayName = 'Threads OAuth2 API';
+        this.extends = ['oAuth2Api'];
+        this.documentationUrl = 'https://developers.facebook.com/documentation/threads';
+        this.icon = 'file:threads.svg';
+        this.properties = [
+            {
+                displayName: 'Grant Type',
+                name: 'grantType',
+                type: 'hidden',
+                default: 'authorizationCode',
+            },
+            {
+                displayName: 'Authorization URL',
+                name: 'authUrl',
+                type: 'hidden',
+                default: 'https://threads.net/oauth/authorize',
+            },
+            {
+                displayName: 'Access Token URL',
+                name: 'accessTokenUrl',
+                type: 'hidden',
+                default: 'https://graph.threads.net/oauth/access_token',
+            },
+            {
+                displayName: 'Scope',
+                name: 'scope',
+                type: 'hidden',
+                default: 'threads_basic,threads_content_publish,threads_read_replies,threads_manage_replies,threads_manage_insights,threads_keyword_search',
+            },
+            {
+                displayName: 'Auth URI Query Parameters',
+                name: 'authQueryParameters',
+                type: 'hidden',
+                default: 'response_type=code',
+            },
+            {
+                displayName: 'Authentication',
+                name: 'authentication',
+                type: 'hidden',
+                default: 'header',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.accessToken}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://graph.threads.net/v1.0',
+                url: '/me',
+                qs: {
+                    fields: 'id,username,name',
+                },
+            },
+        };
+    }
+}
+exports.ThreadsOAuth2Api = ThreadsOAuth2Api;
+//# sourceMappingURL=ThreadsOAuth2Api.credentials.js.map

package/dist/credentials/ThreadsOAuth2Api.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadsOAuth2Api.credentials.js","sourceRoot":"","sources":["../../credentials/ThreadsOAuth2Api.credentials.ts"],"names":[],"mappings":";;;AAOA,MAAa,gBAAgB;IAA7B;QACC,SAAI,GAAG,kBAAkB,CAAC;QAC1B,gBAAW,GAAG,oBAAoB,CAAC;QACnC,YAAO,GAAG,CAAC,WAAW,CAAC,CAAC;QACxB,qBAAgB,GAAG,uDAAuD,CAAC;QAC3E,SAAI,GAAG,kBAA2B,CAAC;QAEnC,eAAU,GAAsB;YAC/B;gBACC,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,mBAAmB;aAC5B;YACD;gBACC,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,qCAAqC;aAC9C;YACD;gBACC,WAAW,EAAE,kBAAkB;gBAC/B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,8CAA8C;aACvD;YACD;gBACC,WAAW,EAAE,OAAO;gBACpB,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,kIAAkI;aAC3I;YACD;gBACC,WAAW,EAAE,2BAA2B;gBACxC,IAAI,EAAE,qBAAqB;gBAC3B,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,oBAAoB;aAC7B;YACD;gBACC,WAAW,EAAE,gBAAgB;gBAC7B,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,QAAQ;aACjB;SACD,CAAC;QAEF,iBAAY,GAAyB;YACpC,IAAI,EAAE,SAAS;YACf,UAAU,EAAE;gBACX,OAAO,EAAE;oBACR,aAAa,EAAE,sCAAsC;iBACrD;aACD;SACD,CAAC;QAEF,SAAI,GAA2B;YAC9B,OAAO,EAAE;gBACR,OAAO,EAAE,gCAAgC;gBACzC,GAAG,EAAE,KAAK;gBACV,EAAE,EAAE;oBACH,MAAM,EAAE,kBAAkB;iBAC1B;aACD;SACD,CAAC;IACH,CAAC;CAAA;AAhED,4CAgEC"}

package/dist/credentials/threads.dark.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 960">
+  <path d="M804.6 960H155.4C69.58 960 0 890.42 0 804.6V155.4C0 69.58 69.58 0 155.4 0h649.2C890.42 0 960 69.58 960 155.4v649.2c0 85.82-69.58 155.4-155.4 155.4z"/>
+  <path fill="#FFF" d="M404.63 392.13c-11.92-7.93-51.53-35.49-51.53-35.49 33.4-47.88 77.46-66.52 138.36-66.52 43.07 0 79.64 14.52 105.75 42 26.12 27.49 41.02 66.8 44.41 117.07 14.48 6.07 27.85 13.22 39.99 21.4 48.96 33 75.92 82.34 75.92 138.91 0 120.23-98.34 224.67-276.35 224.67-152.84 0-311.63-89.11-311.63-354.45 0-263.83 153.81-353.92 311.2-353.92 72.68 0 243.16 10.76 307.27 222.94l-60.12 15.63C678.33 213.2 574.4 189.14 479.11 189.14c-157.52 0-246.62 96.13-246.62 300.65 0 183.38 99.59 280.8 248.71 280.8 122.68 0 214.15-63.9 214.15-157.44 0-63.66-53.37-94.14-56.1-94.14-10.42 54.62-38.36 146.5-161.01 146.5-71.46 0-133.07-49.47-133.07-114.29 0-92.56 87.61-126.06 156.8-126.06 25.91 0 57.18 1.75 73.46 5.07 0-28.21-23.81-76.49-83.96-76.49-55.15-.01-69.14 17.92-86.84 38.39zm105.8 96.25c-90.13 0-101.79 38.51-101.79 62.7 0 38.86 46.07 51.74 70.65 51.74 45.06 0 91.35-12.52 98.63-107.31-22.85-5.14-39.88-7.13-67.49-7.13z"/>
+</svg>

package/dist/credentials/threads.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 960">
+  <path d="M804.6 960H155.4C69.58 960 0 890.42 0 804.6V155.4C0 69.58 69.58 0 155.4 0h649.2C890.42 0 960 69.58 960 155.4v649.2c0 85.82-69.58 155.4-155.4 155.4z"/>
+  <path fill="#FFF" d="M404.63 392.13c-11.92-7.93-51.53-35.49-51.53-35.49 33.4-47.88 77.46-66.52 138.36-66.52 43.07 0 79.64 14.52 105.75 42 26.12 27.49 41.02 66.8 44.41 117.07 14.48 6.07 27.85 13.22 39.99 21.4 48.96 33 75.92 82.34 75.92 138.91 0 120.23-98.34 224.67-276.35 224.67-152.84 0-311.63-89.11-311.63-354.45 0-263.83 153.81-353.92 311.2-353.92 72.68 0 243.16 10.76 307.27 222.94l-60.12 15.63C678.33 213.2 574.4 189.14 479.11 189.14c-157.52 0-246.62 96.13-246.62 300.65 0 183.38 99.59 280.8 248.71 280.8 122.68 0 214.15-63.9 214.15-157.44 0-63.66-53.37-94.14-56.1-94.14-10.42 54.62-38.36 146.5-161.01 146.5-71.46 0-133.07-49.47-133.07-114.29 0-92.56 87.61-126.06 156.8-126.06 25.91 0 57.18 1.75 73.46 5.07 0-28.21-23.81-76.49-83.96-76.49-55.15-.01-69.14 17.92-86.84 38.39zm105.8 96.25c-90.13 0-101.79 38.51-101.79 62.7 0 38.86 46.07 51.74 70.65 51.74 45.06 0 91.35-12.52 98.63-107.31-22.85-5.14-39.88-7.13-67.49-7.13z"/>
+</svg>

package/dist/nodes/Threads/GenericFunctions.d.ts

@@ -0,0 +1,6 @@
+import type { IDataObject, IExecuteFunctions, IHookFunctions, IHttpRequestMethods, IWebhookFunctions } from 'n8n-workflow';
+export declare const THREADS_API_BASE_URL = "https://graph.threads.net/v1.0";
+export declare function threadsApiRequest(this: IExecuteFunctions | IWebhookFunctions | IHookFunctions, method: IHttpRequestMethods, endpoint: string, body?: IDataObject, qs?: IDataObject): Promise<IDataObject>;
+export declare function threadsApiRequestAllItems(this: IExecuteFunctions, endpoint: string, qs?: IDataObject, limit?: number): Promise<IDataObject[]>;
+export declare function waitForContainerReady(this: IExecuteFunctions, containerId: string, maxAttempts?: number, delayMs?: number): Promise<IDataObject>;
+export declare function publishContainer(this: IExecuteFunctions, userId: string, containerId: string): Promise<IDataObject>;

package/dist/nodes/Threads/GenericFunctions.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THREADS_API_BASE_URL = void 0;
+exports.threadsApiRequest = threadsApiRequest;
+exports.threadsApiRequestAllItems = threadsApiRequestAllItems;
+exports.waitForContainerReady = waitForContainerReady;
+exports.publishContainer = publishContainer;
+const n8n_workflow_1 = require("n8n-workflow");
+exports.THREADS_API_BASE_URL = 'https://graph.threads.net/v1.0';
+async function threadsApiRequest(method, endpoint, body = {}, qs = {}) {
+    const authenticationMethod = this.getNodeParameter('authentication', 0, 'oAuth2');
+    const credentialType = authenticationMethod === 'oAuth2' ? 'threadsOAuth2Api' : 'threadsApi';
+    const options = {
+        method,
+        baseURL: exports.THREADS_API_BASE_URL,
+        url: endpoint,
+        qs,
+        json: true,
+    };
+    if (method === 'POST' || method === 'PUT' || method === 'PATCH') {
+        if (Object.keys(body).length > 0) {
+            options.body = body;
+        }
+    }
+    try {
+        return await this.helpers.httpRequestWithAuthentication.call(this, credentialType, options);
+    }
+    catch (error) {
+        throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+    }
+}
+async function threadsApiRequestAllItems(endpoint, qs = {}, limit = 50) {
+    var _a;
+    const returnData = [];
+    let responseData;
+    const query = {
+        ...qs,
+        limit: Math.min(limit, 100),
+    };
+    let nextUrl;
+    do {
+        if (nextUrl) {
+            const authenticationMethod = this.getNodeParameter('authentication', 0, 'oAuth2');
+            const credentialType = authenticationMethod === 'oAuth2' ? 'threadsOAuth2Api' : 'threadsApi';
+            try {
+                responseData = await this.helpers.httpRequestWithAuthentication.call(this, credentialType, {
+                    method: 'GET',
+                    url: nextUrl,
+                    json: true,
+                });
+            }
+            catch (error) {
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error);
+            }
+        }
+        else {
+            responseData = await threadsApiRequest.call(this, 'GET', endpoint, {}, query);
+        }
+        if (Array.isArray(responseData.data)) {
+            for (const item of responseData.data) {
+                returnData.push(item);
+                if (limit > 0 && returnData.length >= limit) {
+                    return returnData.slice(0, limit);
+                }
+            }
+        }
+        else {
+            break;
+        }
+        nextUrl = (_a = responseData.paging) === null || _a === void 0 ? void 0 : _a.next;
+    } while (nextUrl && (limit === 0 || returnData.length < limit));
+    return returnData;
+}
+async function waitForContainerReady(containerId, maxAttempts = 30, delayMs = 2000) {
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const statusResponse = await threadsApiRequest.call(this, 'GET', `/${containerId}`, {}, { fields: 'id,status,error_message' });
+        const status = statusResponse.status;
+        if (status === 'FINISHED') {
+            return statusResponse;
+        }
+        if (status === 'ERROR') {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Media container ${containerId} processing failed: ${statusResponse.error_message || 'Unknown error'}`);
+        }
+        if (status === 'EXPIRED') {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Media container ${containerId} has expired.`);
+        }
+        await (0, n8n_workflow_1.sleep)(delayMs);
+    }
+    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Media container ${containerId} was not ready within timeout period.`);
+}
+async function publishContainer(userId, containerId) {
+    return await threadsApiRequest.call(this, 'POST', `/${userId}/threads_publish`, {}, { creation_id: containerId });
+}
+//# sourceMappingURL=GenericFunctions.js.map

package/dist/nodes/Threads/GenericFunctions.js.map

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

package/dist/nodes/Threads/InsightDescription.d.ts

@@ -0,0 +1,3 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const insightOperations: INodeProperties[];
+export declare const insightFields: INodeProperties[];

package/dist/nodes/Threads/InsightDescription.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insightFields = exports.insightOperations = void 0;
+exports.insightOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['insight'],
+            },
+        },
+        options: [
+            {
+                name: 'Get Media Insights',
+                value: 'getMedia',
+                description: 'Get insights for a specific post/media',
+                action: 'Get media insights',
+            },
+            {
+                name: 'Get User Insights',
+                value: 'getUser',
+                description: 'Get insights for an authenticated user account',
+                action: 'Get user insights',
+            },
+        ],
+        default: 'getMedia',
+    },
+];
+exports.insightFields = [
+    {
+        displayName: 'Media ID',
+        name: 'mediaId',
+        type: 'string',
+        default: '',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['insight'],
+                operation: ['getMedia'],
+            },
+        },
+        description: 'The ID of the post/media to retrieve insights for',
+    },
+    {
+        displayName: 'Metrics',
+        name: 'mediaMetrics',
+        type: 'multiOptions',
+        options: [
+            {
+                name: 'Likes',
+                value: 'likes',
+            },
+            {
+                name: 'Quotes',
+                value: 'quotes',
+            },
+            {
+                name: 'Replies',
+                value: 'replies',
+            },
+            {
+                name: 'Reposts',
+                value: 'reposts',
+            },
+            {
+                name: 'Views',
+                value: 'views',
+            },
+        ],
+        default: ['views', 'likes', 'replies', 'reposts', 'quotes'],
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['insight'],
+                operation: ['getMedia'],
+            },
+        },
+        description: 'The metrics to retrieve for the post',
+    },
+    {
+        displayName: 'User ID',
+        name: 'userId',
+        type: 'string',
+        default: 'me',
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['insight'],
+                operation: ['getUser'],
+            },
+        },
+        description: 'The Threads User ID or "me" for authenticated user',
+    },
+    {
+        displayName: 'Metrics',
+        name: 'userMetrics',
+        type: 'multiOptions',
+        options: [
+            {
+                name: 'Follower Demographics',
+                value: 'follower_demographics',
+            },
+            {
+                name: 'Followers Count',
+                value: 'followers_count',
+            },
+            {
+                name: 'Likes',
+                value: 'likes',
+            },
+            {
+                name: 'Quotes',
+                value: 'quotes',
+            },
+            {
+                name: 'Replies',
+                value: 'replies',
+            },
+            {
+                name: 'Reposts',
+                value: 'reposts',
+            },
+            {
+                name: 'Views',
+                value: 'views',
+            },
+        ],
+        default: ['views', 'likes', 'replies', 'reposts', 'quotes', 'followers_count'],
+        required: true,
+        displayOptions: {
+            show: {
+                resource: ['insight'],
+                operation: ['getUser'],
+            },
+        },
+        description: 'The metrics to retrieve for the account',
+    },
+    {
+        displayName: 'Options',
+        name: 'options',
+        type: 'collection',
+        placeholder: 'Add Option',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['insight'],
+                operation: ['getUser'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Since',
+                name: 'since',
+                type: 'dateTime',
+                default: '',
+                description: 'Start of the reporting period',
+            },
+            {
+                displayName: 'Until',
+                name: 'until',
+                type: 'dateTime',
+                default: '',
+                description: 'End of the reporting period',
+            },
+        ],
+    },
+];
+//# sourceMappingURL=InsightDescription.js.map

package/dist/nodes/Threads/InsightDescription.js.map

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

package/dist/nodes/Threads/PostDescription.d.ts

@@ -0,0 +1,3 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const postOperations: INodeProperties[];
+export declare const postFields: INodeProperties[];