n8n-nodes-tareno 1.0.0

package/README.md

@@ -0,0 +1,100 @@
+# n8n-nodes-tareno
+
+This is an n8n community node for [Tareno](https://tareno.co) - a Social Media Management Platform.
+
+Automate your social media posting across Instagram, Facebook, YouTube, TikTok, Twitter/X, Threads, and Pinterest.
+
+## Features
+
+- **Publish Posts** - Post immediately to any connected platform
+- **Schedule Posts** - Schedule posts for later
+- **Get Accounts** - List all your connected social media accounts
+- **Usage Statistics** - Monitor your API usage
+
+## Prerequisites
+
+1. A Tareno account at [tareno.co](https://tareno.co)
+2. Connected social media accounts in Tareno
+3. An API key (create one in Settings → API)
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Go to **Settings → Community Nodes**
+2. Select **Install**
+3. Enter `n8n-nodes-tareno`
+4. Click **Install**
+
+### Manual Installation
+
+```bash
+cd ~/.n8n/custom
+npm install n8n-nodes-tareno
+```
+
+## Credentials
+
+1. In n8n, go to **Credentials**
+2. Click **Add Credential**
+3. Search for **Tareno API**
+4. Enter your API Key from Tareno Settings → API
+
+## Operations
+
+### Post
+
+#### Publish
+Publish a post immediately to a social media platform.
+
+| Parameter | Description |
+|-----------|-------------|
+| Platform | Instagram, Facebook, YouTube, TikTok, Twitter, Threads, or Pinterest |
+| Account ID | Your connected account ID (use "Get Accounts" to find this) |
+| Text/Caption | The post content |
+| Media URLs | Comma-separated URLs of images/videos |
+
+#### Schedule
+Schedule a post for later.
+
+Same parameters as Publish, plus:
+| Parameter | Description |
+|-----------|-------------|
+| Schedule Time | When to publish (ISO 8601 format) |
+
+### Account
+
+#### Get All
+Returns all your connected social media accounts with their IDs.
+
+### Usage
+
+#### Get Statistics
+Returns your API usage statistics including:
+- Current month usage
+- Monthly limit
+- Success rate
+- Breakdown by platform
+
+## Example Workflow
+
+```
+[Trigger] → [Tareno: Get Accounts] → [Set: Pick Account] → [Tareno: Publish Post]
+```
+
+## Rate Limits
+
+API limits depend on your Tareno plan:
+- Free: 50 calls/month
+- Starter: 500 calls/month
+- Pro: 2,000 calls/month
+- Business: 10,000 calls/month
+
+## Support
+
+- Documentation: [tareno.co/docs/api](https://tareno.co/docs/api)
+- Email: support@tareno.co
+
+## License
+
+MIT

package/dist/credentials/TarenoApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import { IAuthenticateGeneric, ICredentialTestRequest, ICredentialType, INodeProperties } from 'n8n-workflow';
+export declare class TarenoApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+    test: ICredentialTestRequest;
+}

package/dist/credentials/TarenoApi.credentials.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TarenoApi = void 0;
+class TarenoApi {
+    constructor() {
+        this.name = 'tarenoApi';
+        this.displayName = 'Tareno API';
+        this.documentationUrl = 'https://tareno.co/docs/api';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: {
+                    password: true,
+                },
+                default: '',
+                required: true,
+                description: 'Your Tareno API Key. Get one from Settings → API in your Tareno dashboard.',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://tareno.co',
+                description: 'The base URL of the Tareno API',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    'X-Tareno-API-Key': '={{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/api/external/usage',
+                method: 'GET',
+            },
+        };
+    }
+}
+exports.TarenoApi = TarenoApi;

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

@@ -0,0 +1,5 @@
+import { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from 'n8n-workflow';
+export declare class Tareno implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/Tareno/Tareno.node.js

@@ -0,0 +1,356 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tareno = void 0;
+class Tareno {
+    constructor() {
+        this.description = {
+            displayName: 'Tareno',
+            name: 'tareno',
+            icon: 'file:tareno.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: 'Publish and manage social media posts via Tareno',
+            defaults: {
+                name: 'Tareno',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'tarenoApi',
+                    required: true,
+                },
+            ],
+            properties: [
+                // Resource Selection
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        {
+                            name: 'Post',
+                            value: 'post',
+                            description: 'Create and manage social media posts',
+                        },
+                        {
+                            name: 'Account',
+                            value: 'account',
+                            description: 'Get connected social media accounts',
+                        },
+                        {
+                            name: 'Usage',
+                            value: 'usage',
+                            description: 'Get API usage statistics',
+                        },
+                    ],
+                    default: 'post',
+                },
+                // ========================
+                // POST OPERATIONS
+                // ========================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['post'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Publish',
+                            value: 'publish',
+                            description: 'Publish a post immediately',
+                            action: 'Publish a post',
+                        },
+                        {
+                            name: 'Schedule',
+                            value: 'schedule',
+                            description: 'Schedule a post for later',
+                            action: 'Schedule a post',
+                        },
+                    ],
+                    default: 'publish',
+                },
+                // Platform Selection
+                {
+                    displayName: 'Platform',
+                    name: 'platform',
+                    type: 'options',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['post'],
+                        },
+                    },
+                    options: [
+                        { name: 'Instagram', value: 'instagram' },
+                        { name: 'Facebook', value: 'facebook' },
+                        { name: 'YouTube', value: 'youtube' },
+                        { name: 'TikTok', value: 'tiktok' },
+                        { name: 'Twitter/X', value: 'twitter' },
+                        { name: 'Threads', value: 'threads' },
+                        { name: 'Pinterest', value: 'pinterest' },
+                    ],
+                    default: 'instagram',
+                    description: 'The platform to post to',
+                },
+                // Account ID
+                {
+                    displayName: 'Account ID',
+                    name: 'accountId',
+                    type: 'string',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['post'],
+                        },
+                    },
+                    default: '',
+                    description: 'The ID of your connected social account. Use "Get Accounts" to find this.',
+                },
+                // Post Text
+                {
+                    displayName: 'Text/Caption',
+                    name: 'text',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 4,
+                    },
+                    displayOptions: {
+                        show: {
+                            resource: ['post'],
+                        },
+                    },
+                    default: '',
+                    description: 'The text content of your post',
+                },
+                // Media URLs
+                {
+                    displayName: 'Media URLs',
+                    name: 'mediaUrls',
+                    type: 'string',
+                    typeOptions: {
+                        rows: 2,
+                    },
+                    displayOptions: {
+                        show: {
+                            resource: ['post'],
+                        },
+                    },
+                    default: '',
+                    description: 'Comma-separated list of media URLs (images/videos)',
+                },
+                // Schedule Time (only for schedule operation)
+                {
+                    displayName: 'Schedule Time',
+                    name: 'scheduledAt',
+                    type: 'dateTime',
+                    required: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['post'],
+                            operation: ['schedule'],
+                        },
+                    },
+                    default: '',
+                    description: 'When to publish the post (ISO 8601 format)',
+                },
+                // Additional Options
+                {
+                    displayName: 'Additional Options',
+                    name: 'additionalOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    displayOptions: {
+                        show: {
+                            resource: ['post'],
+                        },
+                    },
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'YouTube Title',
+                            name: 'youtubeTitle',
+                            type: 'string',
+                            default: '',
+                            description: 'Title for YouTube videos',
+                        },
+                        {
+                            displayName: 'YouTube Description',
+                            name: 'youtubeDescription',
+                            type: 'string',
+                            typeOptions: { rows: 3 },
+                            default: '',
+                            description: 'Description for YouTube videos',
+                        },
+                        {
+                            displayName: 'Pinterest Board',
+                            name: 'pinterestBoard',
+                            type: 'string',
+                            default: '',
+                            description: 'Pinterest board name or ID',
+                        },
+                        {
+                            displayName: 'Pinterest Link',
+                            name: 'pinterestLink',
+                            type: 'string',
+                            default: '',
+                            description: 'URL to link the pin to',
+                        },
+                    ],
+                },
+                // ========================
+                // ACCOUNT OPERATIONS
+                // ========================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['account'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Get All',
+                            value: 'getAll',
+                            description: 'Get all connected accounts',
+                            action: 'Get all accounts',
+                        },
+                    ],
+                    default: 'getAll',
+                },
+                // ========================
+                // USAGE OPERATIONS
+                // ========================
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: {
+                        show: {
+                            resource: ['usage'],
+                        },
+                    },
+                    options: [
+                        {
+                            name: 'Get Statistics',
+                            value: 'getStats',
+                            description: 'Get API usage statistics',
+                            action: 'Get usage statistics',
+                        },
+                    ],
+                    default: 'getStats',
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('tarenoApi');
+        const baseUrl = credentials.baseUrl || 'https://tareno.co';
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const resource = this.getNodeParameter('resource', i);
+                const operation = this.getNodeParameter('operation', i);
+                let responseData;
+                // ========================
+                // POST RESOURCE
+                // ========================
+                if (resource === 'post') {
+                    const platform = this.getNodeParameter('platform', i);
+                    const accountId = this.getNodeParameter('accountId', i);
+                    const text = this.getNodeParameter('text', i);
+                    const mediaUrlsRaw = this.getNodeParameter('mediaUrls', i);
+                    const additionalOptions = this.getNodeParameter('additionalOptions', i);
+                    const mediaUrls = mediaUrlsRaw
+                        ? mediaUrlsRaw.split(',').map(url => url.trim()).filter(Boolean)
+                        : [];
+                    const body = {
+                        platform,
+                        accountId,
+                        text,
+                        mediaUrls,
+                    };
+                    // Add schedule time if scheduling
+                    if (operation === 'schedule') {
+                        const scheduledAt = this.getNodeParameter('scheduledAt', i);
+                        body.scheduledAt = scheduledAt;
+                    }
+                    // Add metadata for platform-specific options
+                    if (Object.keys(additionalOptions).length > 0) {
+                        body.metadata = additionalOptions;
+                    }
+                    responseData = await this.helpers.httpRequest({
+                        method: 'POST',
+                        url: `${baseUrl}/api/external/publish`,
+                        headers: {
+                            'Content-Type': 'application/json',
+                            'X-Tareno-API-Key': credentials.apiKey,
+                        },
+                        body,
+                        json: true,
+                    });
+                }
+                // ========================
+                // ACCOUNT RESOURCE
+                // ========================
+                if (resource === 'account' && operation === 'getAll') {
+                    responseData = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: `${baseUrl}/api/external/accounts`,
+                        headers: {
+                            'X-Tareno-API-Key': credentials.apiKey,
+                        },
+                        json: true,
+                    });
+                }
+                // ========================
+                // USAGE RESOURCE
+                // ========================
+                if (resource === 'usage' && operation === 'getStats') {
+                    responseData = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: `${baseUrl}/api/external/usage`,
+                        headers: {
+                            'X-Tareno-API-Key': credentials.apiKey,
+                        },
+                        json: true,
+                    });
+                }
+                // Add result to output
+                if (responseData) {
+                    if (Array.isArray(responseData)) {
+                        returnData.push(...responseData.map(item => ({ json: item })));
+                    }
+                    else {
+                        returnData.push({ json: responseData });
+                    }
+                }
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: {
+                            error: error.message,
+                        },
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Tareno = Tareno;

package/dist/nodes/Tareno/tareno.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" fill="none">
+  <rect width="100" height="100" rx="20" fill="#10B981"/>
+  <path d="M30 35h40v5H30zM30 47h35v5H30zM30 59h40v5H30z" fill="white"/>
+  <circle cx="70" cy="70" r="15" fill="white"/>
+  <path d="M65 70l5 5 8-10" stroke="#10B981" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/package.json

@@ -0,0 +1,55 @@
+{
+    "name": "n8n-nodes-tareno",
+    "version": "1.0.0",
+    "description": "N8N community nodes for Tareno - Social Media Management Platform",
+    "license": "MIT",
+    "homepage": "https://tareno.co",
+    "author": {
+        "name": "Tareno",
+        "email": "support@tareno.co"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/TarenoAI/n8n-nodes-tareno.git"
+    },
+    "keywords": [
+        "n8n-community-node-package",
+        "n8n",
+        "social media",
+        "tareno",
+        "automation",
+        "instagram",
+        "facebook",
+        "youtube",
+        "tiktok",
+        "twitter",
+        "pinterest",
+        "threads"
+    ],
+    "main": "dist/nodes/Tareno/Tareno.node.js",
+    "scripts": {
+        "build": "tsc && npm run copy-icons",
+        "copy-icons": "cp nodes/Tareno/*.svg dist/nodes/Tareno/ 2>/dev/null || true",
+        "dev": "tsc --watch",
+        "prepublishOnly": "npm run build"
+    },
+    "files": [
+        "dist"
+    ],
+    "n8n": {
+        "n8nNodesApiVersion": 1,
+        "credentials": [
+            "dist/credentials/TarenoApi.credentials.js"
+        ],
+        "nodes": [
+            "dist/nodes/Tareno/Tareno.node.js"
+        ]
+    },
+    "devDependencies": {
+        "@types/node": "^18.0.0",
+        "typescript": "^5.0.0"
+    },
+    "dependencies": {
+        "n8n-workflow": "^1.0.0"
+    }
+}