n8n-nodes-postaro 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Postaro
+
+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,3 +1,44 @@
-# Temporary Holding Version
+# n8n-nodes-postaro
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An [n8n](https://n8n.io) community node for [Postaro](https://postaro.app), the social media scheduler for agencies.
+Schedule posts to Instagram, TikTok, LinkedIn, YouTube, X, Threads, Facebook, Pinterest and Bluesky from any workflow.
+
+## Install
+
+In n8n: **Settings → Community Nodes → Install**, then enter `n8n-nodes-postaro`.
+
+## Credentials
+
+1. In Postaro, open **API & agents** and create a key (it starts with `pst_`).
+2. In n8n, add a **Postaro API** credential and paste the key. Leave **Server** as `https://postaro.app` unless you run Postaro somewhere else.
+
+The credential test calls `GET /api/v1/me`.
+
+## Operations
+
+| Resource | Operation | Postaro API |
+|---|---|---|
+| Post | Create (at a time, next free posting time, now, draft, or send to the client for approval) | `POST /api/v1/posts` |
+| Post | Get | `GET /api/v1/posts/{id}` |
+| Post | Get Many (filter by status) | `GET /api/v1/posts` |
+| Post | Move (change the time of a post that hasn't gone out) | `PATCH /api/v1/posts/{id}` |
+| Post | Cancel | `DELETE /api/v1/posts/{id}` |
+| Account | Get Many | `GET /api/v1/accounts` |
+| Media | Import From URL (returns a media id for a post's media) | `POST /api/v1/media` |
+
+Every operation takes an optional **Workspace** (id or exact name). Without it, the key's first workspace is used.
+
+Account ids come from **Account → Get Many**. Posts are checked against each network's rules (length, media) the same way as in the app; a post that breaks a rule is refused with a message that says which rule.
+
+Limits: 60 requests a minute per key.
+
+## Development
+
+```bash
+npm install
+npm test   # builds, then checks the package wiring and that every operation calls a real v1 route
+```
+
+## License
+
+MIT

package/dist/credentials/PostaroApi.credentials.d.ts

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

package/dist/credentials/PostaroApi.credentials.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostaroApi = void 0;
+class PostaroApi {
+    constructor() {
+        this.name = "postaroApi";
+        this.displayName = "Postaro API";
+        this.icon = "file:../nodes/Postaro/postaro.svg";
+        this.documentationUrl = "https://postaro.app";
+        this.properties = [
+            {
+                displayName: "API Key",
+                name: "apiKey",
+                type: "string",
+                typeOptions: { password: true },
+                default: "",
+                placeholder: "pst_…",
+                description: "Create a key in Postaro under API & agents",
+            },
+            {
+                displayName: "Server",
+                name: "baseUrl",
+                type: "string",
+                default: "https://postaro.app",
+                description: "Change only if you were given another address",
+            },
+        ];
+        this.authenticate = {
+            type: "generic",
+            properties: {
+                headers: {
+                    Authorization: "=Bearer {{$credentials.apiKey}}",
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: "={{$credentials.baseUrl}}",
+                url: "/api/v1/me",
+                method: "GET",
+            },
+        };
+    }
+}
+exports.PostaroApi = PostaroApi;

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

@@ -0,0 +1,4 @@
+import type { INodeType, INodeTypeDescription } from "n8n-workflow";
+export declare class Postaro implements INodeType {
+    description: INodeTypeDescription;
+}

package/dist/nodes/Postaro/Postaro.node.js

@@ -0,0 +1,268 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Postaro = void 0;
+const workspace = {
+    displayName: "Workspace",
+    name: "workspace",
+    type: "string",
+    default: "",
+    description: "Workspace (client or brand) name or ID. Empty = the API key's first workspace.",
+};
+const postOperations = [
+    {
+        displayName: "Operation",
+        name: "operation",
+        type: "options",
+        noDataExpression: true,
+        displayOptions: { show: { resource: ["post"] } },
+        default: "create",
+        options: [
+            {
+                name: "Create",
+                value: "create",
+                action: "Create a post",
+                description: "Schedule, publish now, queue, or save a draft",
+                routing: { request: { method: "POST", url: "/api/v1/posts" } },
+            },
+            {
+                name: "Get",
+                value: "get",
+                action: "Get a post",
+                description: "A post with each account's result: live link, or the reason it failed",
+                routing: { request: { method: "GET", url: "=/api/v1/posts/{{$parameter.postId}}", qs: { workspace: "={{$parameter.workspace || undefined}}" } } },
+            },
+            {
+                name: "Get Many",
+                value: "getMany",
+                action: "Get many posts",
+                routing: {
+                    request: { method: "GET", url: "/api/v1/posts", qs: { workspace: "={{$parameter.workspace || undefined}}", status: "={{$parameter.status || undefined}}", limit: "={{$parameter.limit}}" } },
+                    output: { postReceive: [{ type: "rootProperty", properties: { property: "posts" } }] },
+                },
+            },
+            {
+                name: "Move",
+                value: "move",
+                action: "Move a post",
+                description: "Change the time of a post that hasn't started going out",
+                routing: { request: { method: "PATCH", url: "=/api/v1/posts/{{$parameter.postId}}", body: { scheduledAt: "={{$parameter.scheduledAt}}", workspace: "={{$parameter.workspace || undefined}}" } } },
+            },
+            {
+                name: "Cancel",
+                value: "cancel",
+                action: "Cancel a post",
+                description: "Cancel what hasn't gone out yet",
+                routing: { request: { method: "DELETE", url: "=/api/v1/posts/{{$parameter.postId}}", qs: { workspace: "={{$parameter.workspace || undefined}}" } } },
+            },
+        ],
+    },
+];
+const postFields = [
+    // create sends it in the body; the other operations put it in their URL or body above
+    { ...workspace, displayOptions: { show: { resource: ["post"], operation: ["create"] } }, routing: { send: { type: "body", property: "workspace", value: "={{$value || undefined}}" } } },
+    { ...workspace, displayOptions: { show: { resource: ["post"], operation: ["get", "getMany", "move", "cancel"] } } },
+    {
+        displayName: "Post ID",
+        name: "postId",
+        type: "string",
+        required: true,
+        default: "",
+        displayOptions: { show: { resource: ["post"], operation: ["get", "move", "cancel"] } },
+    },
+    {
+        displayName: "Text",
+        name: "text",
+        type: "string",
+        typeOptions: { rows: 4 },
+        default: "",
+        displayOptions: { show: { resource: ["post"], operation: ["create"] } },
+        routing: { send: { type: "body", property: "text" } },
+    },
+    {
+        displayName: "Account IDs",
+        name: "accounts",
+        type: "string",
+        required: true,
+        default: "",
+        placeholder: "id1, id2",
+        description: "Comma-separated account IDs (Account → Get Many)",
+        displayOptions: { show: { resource: ["post"], operation: ["create"] } },
+        routing: { send: { type: "body", property: "accounts", value: "={{$value.split(',').map(s => s.trim()).filter(Boolean)}}" } },
+    },
+    {
+        displayName: "When",
+        name: "when",
+        type: "options",
+        default: "schedule",
+        displayOptions: { show: { resource: ["post"], operation: ["create"] } },
+        options: [
+            { name: "At a Time", value: "schedule" },
+            { name: "Next Free Posting Time (Queue)", value: "queue" },
+            { name: "Now", value: "now" },
+            { name: "Draft", value: "draft" },
+            { name: "Send to Client for Approval", value: "approval" },
+        ],
+        routing: { send: { type: "body", property: "when" } },
+    },
+    {
+        displayName: "Scheduled At",
+        name: "scheduledAt",
+        type: "dateTime",
+        default: "",
+        description: "When it goes out (with a time zone). Needed for At a Time and Approval.",
+        displayOptions: { show: { resource: ["post"], operation: ["create"], when: ["schedule", "approval"] } },
+        routing: { send: { type: "body", property: "scheduledAt" } },
+    },
+    {
+        displayName: "Scheduled At",
+        name: "scheduledAt",
+        type: "dateTime",
+        required: true,
+        default: "",
+        displayOptions: { show: { resource: ["post"], operation: ["move"] } },
+    },
+    {
+        displayName: "Options",
+        name: "options",
+        type: "collection",
+        placeholder: "Add option",
+        default: {},
+        displayOptions: { show: { resource: ["post"], operation: ["create"] } },
+        options: [
+            {
+                displayName: "Media IDs",
+                name: "mediaIds",
+                type: "string",
+                default: "",
+                description: "Comma-separated media IDs from Media → Import From URL, in order",
+                routing: { send: { type: "body", property: "mediaIds", value: "={{$value ? $value.split(',').map(s => s.trim()).filter(Boolean) : undefined}}" } },
+            },
+            {
+                displayName: "Thread / First Comment",
+                name: "followups",
+                type: "string",
+                typeOptions: { rows: 3 },
+                default: "",
+                description: "One per line. The rest of the thread on Bluesky and Threads; comments on Instagram, Facebook and YouTube.",
+                routing: { send: { type: "body", property: "followups", value: "={{$value ? $value.split('\\n').map(s => s.trim()).filter(Boolean) : undefined}}" } },
+            },
+        ],
+    },
+    {
+        displayName: "Status",
+        name: "status",
+        type: "options",
+        default: "",
+        displayOptions: { show: { resource: ["post"], operation: ["getMany"] } },
+        options: [
+            { name: "Any", value: "" },
+            { name: "Scheduled", value: "scheduled" },
+            { name: "Published", value: "published" },
+            { name: "Partly Published", value: "partial" },
+            { name: "Failed", value: "failed" },
+            { name: "Draft", value: "draft" },
+        ],
+    },
+    {
+        displayName: "Limit",
+        name: "limit",
+        type: "number",
+        typeOptions: { minValue: 1, maxValue: 100 },
+        default: 50,
+        description: "Max number of results to return",
+        displayOptions: { show: { resource: ["post"], operation: ["getMany"] } },
+    },
+];
+const accountOperations = [
+    {
+        displayName: "Operation",
+        name: "operation",
+        type: "options",
+        noDataExpression: true,
+        displayOptions: { show: { resource: ["account"] } },
+        default: "getMany",
+        options: [
+            {
+                name: "Get Many",
+                value: "getMany",
+                action: "Get many accounts",
+                description: "Connected accounts; canPost=false means it must be reconnected in Postaro",
+                routing: {
+                    request: { method: "GET", url: "/api/v1/accounts", qs: { workspace: "={{$parameter.workspace || undefined}}" } },
+                    output: { postReceive: [{ type: "rootProperty", properties: { property: "accounts" } }] },
+                },
+            },
+        ],
+    },
+    { ...workspace, displayOptions: { show: { resource: ["account"] } } },
+];
+const mediaOperations = [
+    {
+        displayName: "Operation",
+        name: "operation",
+        type: "options",
+        noDataExpression: true,
+        displayOptions: { show: { resource: ["media"] } },
+        default: "importUrl",
+        options: [
+            {
+                name: "Import From URL",
+                value: "importUrl",
+                action: "Import an image from a URL",
+                description: "Copies a public image into Postaro and returns its media ID",
+                routing: { request: { method: "POST", url: "/api/v1/media" } },
+            },
+        ],
+    },
+    {
+        displayName: "Image URL",
+        name: "url",
+        type: "string",
+        required: true,
+        default: "",
+        displayOptions: { show: { resource: ["media"] } },
+        routing: { send: { type: "body", property: "url" } },
+    },
+    { ...workspace, displayOptions: { show: { resource: ["media"] } }, routing: { send: { type: "body", property: "workspace", value: "={{$value || undefined}}" } } },
+];
+class Postaro {
+    constructor() {
+        this.description = {
+            displayName: "Postaro",
+            name: "postaro",
+            icon: "file:postaro.svg",
+            group: ["output"],
+            version: 1,
+            subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+            description: "Schedule posts to Instagram, TikTok, LinkedIn, YouTube, X, Threads, Facebook, Pinterest and Bluesky",
+            defaults: { name: "Postaro" },
+            usableAsTool: true,
+            inputs: ["main"],
+            outputs: ["main"],
+            credentials: [{ name: "postaroApi", required: true }],
+            requestDefaults: {
+                baseURL: "={{$credentials.baseUrl}}",
+                headers: { Accept: "application/json", "Content-Type": "application/json" },
+            },
+            properties: [
+                {
+                    displayName: "Resource",
+                    name: "resource",
+                    type: "options",
+                    noDataExpression: true,
+                    default: "post",
+                    options: [
+                        { name: "Post", value: "post" },
+                        { name: "Account", value: "account" },
+                        { name: "Media", value: "media" },
+                    ],
+                },
+                ...postOperations,
+                ...postFields,
+                ...accountOperations,
+                ...mediaOperations,
+            ],
+        };
+    }
+}
+exports.Postaro = Postaro;

package/dist/nodes/Postaro/postaro.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><path d="M3.7 2 L5.8999999999999995 2 A1.7 1.7 0 0 0 9.299999999999999 2 L11.5 2 A1.7 1.7 0 0 0 14.899999999999999 2 L17.1 2 A1.7 1.7 0 0 0 20.5 2 L22.7 2 A1.7 1.7 0 0 0 26.099999999999998 2 L28.3 2 A1.7 1.7 0 0 0 30 3.7 L30 5.8999999999999995 A1.7 1.7 0 0 0 30 9.299999999999999 L30 11.5 A1.7 1.7 0 0 0 30 14.899999999999999 L30 17.1 A1.7 1.7 0 0 0 30 20.5 L30 22.7 A1.7 1.7 0 0 0 30 26.099999999999998 L30 28.3 A1.7 1.7 0 0 0 28.3 30 L26.099999999999998 30 A1.7 1.7 0 0 0 22.7 30 L20.5 30 A1.7 1.7 0 0 0 17.1 30 L14.899999999999999 30 A1.7 1.7 0 0 0 11.5 30 L9.299999999999999 30 A1.7 1.7 0 0 0 5.8999999999999995 30 L3.7 30 A1.7 1.7 0 0 0 2 28.3 L2 26.099999999999998 A1.7 1.7 0 0 0 2 22.7 L2 20.5 A1.7 1.7 0 0 0 2 17.1 L2 14.899999999999999 A1.7 1.7 0 0 0 2 11.5 L2 9.299999999999999 A1.7 1.7 0 0 0 2 5.8999999999999995 L2 3.7 A1.7 1.7 0 0 0 3.7 2 Z" fill="#cf3f17"/><path d="M10.2 8.2h6.6a5.6 5.6 0 0 1 0 11.2h-3v4.4h-3.6zm3.6 3.2v4.8h2.9a2.4 2.4 0 0 0 0-4.8z" fill="#fff" fill-rule="evenodd"/></svg>

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "n8n-nodes-postaro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "n8n node for Postaro: schedule posts to Instagram, TikTok, LinkedIn, YouTube, X, Threads, Facebook, Pinterest and Bluesky.",
+  "license": "MIT",
+  "homepage": "https://postaro.app",
+  "keywords": [
+    "n8n-community-node-package",
+    "postaro",
+    "social media",
+    "scheduler"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/copy-icons.mjs",
+    "test": "npm run build && node --test test/node.test.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "LICENSE"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "strict": true,
+    "credentials": [
+      "dist/credentials/PostaroApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Postaro/Postaro.node.js"
+    ]
+  },
+  "devDependencies": {
+    "n8n-workflow": "2.16.0",
+    "typescript": "5.9.3"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "bugs": {
+    "email": "hello@postaro.app"
+  }
+}