@cuehq/n8n-nodes-cue 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# @cuehq/n8n-nodes-cue
+
+This is the official n8n community node for [Cue](https://oncue.so) - the social media scheduling API.
+
+## Features
+
+- **Create Post** - Schedule posts to one or multiple platforms
+- **List Posts** - Get all posts for a profile
+- **Get Post** - Get details of a specific post
+- **Delete Post** - Delete a draft or scheduled post
+- **Publish Post** - Publish a post immediately
+- **List Profiles** - Get available profiles
+- **List Social Accounts** - Get connected social accounts
+
+## Installation
+
+### Community Nodes (Recommended)
+
+1. Go to **Settings > Community Nodes**
+2. Select **Install**
+3. Enter `@cuehq/n8n-nodes-cue`
+4. Agree to the risks and select **Install**
+
+### Manual Installation
+
+```bash
+npm install @cuehq/n8n-nodes-cue
+```
+
+## Credentials
+
+You need a Cue API key to use this node:
+
+1. Log in to [Cue](https://app.oncue.so)
+2. Go to Settings -> API Keys
+3. Create a new API key
+4. Copy the key and add it to n8n credentials
+
+## Resources
+
+- [Cue API Documentation](https://docs.oncue.so)
+- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)

package/dist/credentials/CueApi.credentials.d.ts

@@ -0,0 +1,9 @@
+import type { IAuthenticateGeneric, ICredentialType, INodeProperties } from "n8n-workflow";
+export declare class CueApi implements ICredentialType {
+    name: string;
+    displayName: string;
+    documentationUrl: string;
+    properties: INodeProperties[];
+    authenticate: IAuthenticateGeneric;
+}
+//# sourceMappingURL=CueApi.credentials.d.ts.map

package/dist/credentials/CueApi.credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CueApi.credentials.d.ts","sourceRoot":"","sources":["../../src/credentials/CueApi.credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3F,qBAAa,MAAO,YAAW,eAAe;IAC5C,IAAI,SAAY;IAChB,WAAW,SAAa;IACxB,gBAAgB,SAA+D;IAE/E,UAAU,EAAE,eAAe,EAAE,CAmB3B;IAEF,YAAY,EAAE,oBAAoB,CAOhC;CACH"}

package/dist/credentials/CueApi.credentials.js

@@ -0,0 +1,33 @@
+export class CueApi {
+    name = "cueApi";
+    displayName = "Cue API";
+    documentationUrl = "https://docs.oncue.so/docs/getting-started/authentication";
+    properties = [
+        {
+            displayName: "API Key",
+            name: "apiKey",
+            type: "string",
+            typeOptions: {
+                password: true,
+            },
+            default: "",
+            required: true,
+            description: "Your Cue API key (starts with cue_sk_)",
+        },
+        {
+            displayName: "Base URL",
+            name: "baseUrl",
+            type: "string",
+            default: "https://api.oncue.so",
+            description: "The base URL for the Cue API",
+        },
+    ];
+    authenticate = {
+        type: "generic",
+        properties: {
+            headers: {
+                Authorization: "=Bearer {{$credentials.apiKey}}",
+            },
+        },
+    };
+}

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

@@ -0,0 +1,11 @@
+import type { ILoadOptionsFunctions, INodeListSearchResult, INodeType, INodeTypeDescription } from "n8n-workflow";
+export declare class Cue implements INodeType {
+    description: INodeTypeDescription;
+    methods: {
+        listSearch: {
+            getProfiles(this: ILoadOptionsFunctions): Promise<INodeListSearchResult>;
+            getSocialAccounts(this: ILoadOptionsFunctions): Promise<INodeListSearchResult>;
+        };
+    };
+}
+//# sourceMappingURL=Cue.node.d.ts.map

package/dist/nodes/Cue/Cue.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cue.node.d.ts","sourceRoot":"","sources":["../../../src/nodes/Cue/Cue.node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACrB,MAAM,cAAc,CAAC;AAEtB,qBAAa,GAAI,YAAW,SAAS;IACnC,WAAW,EAAE,oBAAoB,CAqb/B;IAEF,OAAO;;8BAEqB,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;oCAuBhD,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;;MAyBtF;CACH"}

package/dist/nodes/Cue/Cue.node.js

@@ -0,0 +1,461 @@
+export class Cue {
+    description = {
+        displayName: "Cue",
+        name: "cue",
+        icon: "file:cue.svg",
+        group: ["transform"],
+        version: 1,
+        subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+        description: "Schedule and publish social media posts with Cue",
+        defaults: {
+            name: "Cue",
+        },
+        inputs: ["main"],
+        outputs: ["main"],
+        credentials: [
+            {
+                name: "cueApi",
+                required: true,
+            },
+        ],
+        requestDefaults: {
+            baseURL: "={{$credentials.baseUrl}}/v1",
+            headers: {
+                Accept: "application/json",
+                "Content-Type": "application/json",
+            },
+        },
+        properties: [
+            // Resource selector
+            {
+                displayName: "Resource",
+                name: "resource",
+                type: "options",
+                noDataExpression: true,
+                options: [
+                    {
+                        name: "Post",
+                        value: "post",
+                    },
+                    {
+                        name: "Profile",
+                        value: "profile",
+                    },
+                    {
+                        name: "Social Account",
+                        value: "socialAccount",
+                    },
+                ],
+                default: "post",
+            },
+            // ===== POST OPERATIONS =====
+            {
+                displayName: "Operation",
+                name: "operation",
+                type: "options",
+                noDataExpression: true,
+                displayOptions: {
+                    show: {
+                        resource: ["post"],
+                    },
+                },
+                options: [
+                    {
+                        name: "Create",
+                        value: "create",
+                        action: "Create a post",
+                        description: "Create and schedule a new post",
+                        routing: {
+                            request: {
+                                method: "POST",
+                                url: "/posts",
+                            },
+                            send: {
+                                preSend: [
+                                    async function (requestOptions) {
+                                        // Extract profileId - resourceLocator returns { mode, value } object
+                                        const profileIdParam = this.getNodeParameter("profileId");
+                                        const profileId = typeof profileIdParam === "string" ? profileIdParam : profileIdParam.value;
+                                        const platforms = this.getNodeParameter("platforms.platform", []);
+                                        const scheduledAt = this.getNodeParameter("scheduledAt", "");
+                                        const publishNow = this.getNodeParameter("publishNow", false);
+                                        // Build V2 format body
+                                        const platformsObj = {};
+                                        for (const platform of platforms) {
+                                            // Extract socialAccountId - resourceLocator returns { mode, value } object
+                                            const socialAccountId = typeof platform.socialAccountId === "string"
+                                                ? platform.socialAccountId
+                                                : platform.socialAccountId.value;
+                                            platformsObj[socialAccountId] = {
+                                                items: [{ content: platform.content }],
+                                            };
+                                        }
+                                        requestOptions.body = {
+                                            profileId,
+                                            platforms: platformsObj,
+                                            ...(scheduledAt && { scheduledAt }),
+                                            ...(publishNow && { publishNow }),
+                                        };
+                                        return requestOptions;
+                                    },
+                                ],
+                            },
+                        },
+                    },
+                    {
+                        name: "Delete",
+                        value: "delete",
+                        action: "Delete a post",
+                        description: "Delete a draft or scheduled post",
+                        routing: {
+                            request: {
+                                method: "DELETE",
+                                url: '=/posts/{{$parameter["postId"]}}',
+                            },
+                        },
+                    },
+                    {
+                        name: "Get",
+                        value: "get",
+                        action: "Get a post",
+                        description: "Get details of a specific post",
+                        routing: {
+                            request: {
+                                method: "GET",
+                                url: '=/posts/{{$parameter["postId"]}}',
+                            },
+                        },
+                    },
+                    {
+                        name: "Get Many",
+                        value: "getMany",
+                        action: "Get many posts",
+                        description: "Get all posts for a profile",
+                        routing: {
+                            request: {
+                                method: "GET",
+                                url: "/posts",
+                            },
+                        },
+                    },
+                    {
+                        name: "Publish",
+                        value: "publish",
+                        action: "Publish a post",
+                        description: "Publish a post immediately",
+                        routing: {
+                            request: {
+                                method: "POST",
+                                url: '=/posts/{{$parameter["postId"]}}/publish',
+                            },
+                        },
+                    },
+                ],
+                default: "create",
+            },
+            // ===== PROFILE OPERATIONS =====
+            {
+                displayName: "Operation",
+                name: "operation",
+                type: "options",
+                noDataExpression: true,
+                displayOptions: {
+                    show: {
+                        resource: ["profile"],
+                    },
+                },
+                options: [
+                    {
+                        name: "Get Many",
+                        value: "getMany",
+                        action: "Get many profiles",
+                        description: "Get all profiles",
+                        routing: {
+                            request: {
+                                method: "GET",
+                                url: "/profiles",
+                            },
+                        },
+                    },
+                ],
+                default: "getMany",
+            },
+            // ===== SOCIAL ACCOUNT OPERATIONS =====
+            {
+                displayName: "Operation",
+                name: "operation",
+                type: "options",
+                noDataExpression: true,
+                displayOptions: {
+                    show: {
+                        resource: ["socialAccount"],
+                    },
+                },
+                options: [
+                    {
+                        name: "Get Many",
+                        value: "getMany",
+                        action: "Get many social accounts",
+                        description: "Get all connected social accounts",
+                        routing: {
+                            request: {
+                                method: "GET",
+                                url: "/social-accounts",
+                            },
+                        },
+                    },
+                ],
+                default: "getMany",
+            },
+            // ===== POST PARAMETERS =====
+            // Post ID (for get, delete, publish)
+            {
+                displayName: "Post ID",
+                name: "postId",
+                type: "string",
+                required: true,
+                default: "",
+                displayOptions: {
+                    show: {
+                        resource: ["post"],
+                        operation: ["get", "delete", "publish"],
+                    },
+                },
+                description: "The ID of the post",
+            },
+            // Profile ID (for create) - with dynamic dropdown
+            {
+                displayName: "Profile",
+                name: "profileId",
+                type: "resourceLocator",
+                default: { mode: "list", value: "" },
+                required: true,
+                displayOptions: {
+                    show: {
+                        resource: ["post"],
+                        operation: ["create"],
+                    },
+                },
+                description: "The profile to create the post under",
+                modes: [
+                    {
+                        displayName: "From List",
+                        name: "list",
+                        type: "list",
+                        typeOptions: {
+                            searchListMethod: "getProfiles",
+                            searchable: true,
+                        },
+                    },
+                    {
+                        displayName: "By ID",
+                        name: "id",
+                        type: "string",
+                        placeholder: "prf_xxx",
+                    },
+                ],
+            },
+            // Platforms object for V2 format
+            {
+                displayName: "Platforms",
+                name: "platforms",
+                type: "fixedCollection",
+                typeOptions: {
+                    multipleValues: true,
+                },
+                displayOptions: {
+                    show: {
+                        resource: ["post"],
+                        operation: ["create"],
+                    },
+                },
+                default: {},
+                options: [
+                    {
+                        name: "platform",
+                        displayName: "Platform",
+                        values: [
+                            {
+                                displayName: "Social Account",
+                                name: "socialAccountId",
+                                type: "resourceLocator",
+                                default: { mode: "list", value: "" },
+                                required: true,
+                                description: "The social account to post to",
+                                modes: [
+                                    {
+                                        displayName: "From List",
+                                        name: "list",
+                                        type: "list",
+                                        typeOptions: {
+                                            searchListMethod: "getSocialAccounts",
+                                            searchable: true,
+                                        },
+                                    },
+                                    {
+                                        displayName: "By ID",
+                                        name: "id",
+                                        type: "string",
+                                        placeholder: "sac_xxx",
+                                    },
+                                ],
+                            },
+                            {
+                                displayName: "Content",
+                                name: "content",
+                                type: "string",
+                                typeOptions: {
+                                    rows: 4,
+                                },
+                                default: "",
+                                required: true,
+                                description: "The post content for this platform",
+                            },
+                        ],
+                    },
+                ],
+                description: "The platforms to post to with their content",
+            },
+            // Scheduled At
+            {
+                displayName: "Scheduled At",
+                name: "scheduledAt",
+                type: "dateTime",
+                default: "",
+                displayOptions: {
+                    show: {
+                        resource: ["post"],
+                        operation: ["create"],
+                    },
+                },
+                description: "When to publish the post (ISO 8601 format). Leave empty for draft.",
+            },
+            // Publish Now
+            {
+                displayName: "Publish Immediately",
+                name: "publishNow",
+                type: "boolean",
+                default: false,
+                displayOptions: {
+                    show: {
+                        resource: ["post"],
+                        operation: ["create"],
+                    },
+                },
+                description: "Whether to publish the post immediately instead of scheduling",
+            },
+            // Query parameters for listing posts
+            {
+                displayName: "Filters",
+                name: "filters",
+                type: "collection",
+                placeholder: "Add Filter",
+                default: {},
+                displayOptions: {
+                    show: {
+                        resource: ["post"],
+                        operation: ["getMany"],
+                    },
+                },
+                options: [
+                    {
+                        displayName: "Profile",
+                        name: "profile_id",
+                        type: "resourceLocator",
+                        default: { mode: "list", value: "" },
+                        description: "Filter posts by profile",
+                        modes: [
+                            {
+                                displayName: "From List",
+                                name: "list",
+                                type: "list",
+                                typeOptions: {
+                                    searchListMethod: "getProfiles",
+                                    searchable: true,
+                                },
+                            },
+                            {
+                                displayName: "By ID",
+                                name: "id",
+                                type: "string",
+                                placeholder: "prf_xxx",
+                            },
+                        ],
+                        routing: {
+                            request: {
+                                qs: {
+                                    // resourceLocator returns { mode, value } object, extract .value
+                                    profile_id: "={{$value.value || $value}}",
+                                },
+                            },
+                        },
+                    },
+                    {
+                        displayName: "Status",
+                        name: "status",
+                        type: "options",
+                        options: [
+                            { name: "Draft", value: "draft" },
+                            { name: "Scheduled", value: "scheduled" },
+                            { name: "Queued", value: "queued" },
+                            { name: "Publishing", value: "publishing" },
+                            { name: "Published", value: "published" },
+                            { name: "Failed", value: "failed" },
+                        ],
+                        default: "",
+                        description: "Filter posts by status",
+                        routing: {
+                            request: {
+                                qs: {
+                                    status: "={{$value}}",
+                                },
+                            },
+                        },
+                    },
+                ],
+            },
+        ],
+    };
+    methods = {
+        listSearch: {
+            async getProfiles() {
+                const credentials = await this.getCredentials("cueApi");
+                const baseUrl = credentials.baseUrl || "https://api.oncue.so";
+                const response = await this.helpers.httpRequest({
+                    method: "GET",
+                    url: `${baseUrl}/v1/profiles`,
+                    headers: {
+                        Authorization: `Bearer ${credentials.apiKey}`,
+                        Accept: "application/json",
+                    },
+                });
+                const profiles = response.data || [];
+                return {
+                    results: profiles.map((profile) => ({
+                        name: profile.name,
+                        value: profile.id,
+                    })),
+                };
+            },
+            async getSocialAccounts() {
+                const credentials = await this.getCredentials("cueApi");
+                const baseUrl = credentials.baseUrl || "https://api.oncue.so";
+                const response = await this.helpers.httpRequest({
+                    method: "GET",
+                    url: `${baseUrl}/v1/social-accounts`,
+                    headers: {
+                        Authorization: `Bearer ${credentials.apiKey}`,
+                        Accept: "application/json",
+                    },
+                });
+                const accounts = response.data || [];
+                return {
+                    results: accounts.map((account) => ({
+                        name: `${account.platform}: ${account.platformUsername}`,
+                        value: account.id,
+                    })),
+                };
+            },
+        },
+    };
+}

package/dist/nodes/Cue/Cue.node.json

@@ -0,0 +1,18 @@
+{
+  "node": "@cuehq/n8n-nodes-cue.cue",
+  "nodeVersion": "1.0",
+  "codexVersion": "1.0",
+  "categories": ["Marketing & Content"],
+  "resources": {
+    "credentialDocumentation": [
+      {
+        "url": "https://docs.oncue.so/docs/getting-started/authentication"
+      }
+    ],
+    "primaryDocumentation": [
+      {
+        "url": "https://docs.oncue.so"
+      }
+    ]
+  }
+}

package/dist/nodes/Cue/cue.svg

@@ -0,0 +1,4 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="512" height="512" rx="100" fill="#6469F0"/>
+<path d="M129.18 326.8C119.1 326.8 109.98 325.3 101.82 322.3C93.78 319.3 86.82 314.98 80.94 309.34C75.06 303.58 70.56 296.5 67.44 288.1C64.32 279.7 62.76 270.1 62.76 259.3C62.76 248.5 64.32 238.96 67.44 230.68C70.56 222.28 75.06 215.26 80.94 209.62C86.82 203.86 93.78 199.48 101.82 196.48C109.98 193.48 119.1 191.98 129.18 191.98C140.58 191.98 150.72 193.96 159.6 197.92C168.6 201.88 175.8 207.46 181.2 214.66C186.72 221.74 190.02 230.02 191.1 239.5H158.34C157.38 235.54 155.52 232.06 152.76 229.06C150.12 226.06 146.76 223.72 142.68 222.04C138.72 220.36 134.22 219.52 129.18 219.52C122.46 219.52 116.58 220.96 111.54 223.84C106.62 226.6 102.78 230.92 100.02 236.8C97.26 242.68 95.88 250.18 95.88 259.3C95.88 266.14 96.66 272.14 98.22 277.3C99.9 282.34 102.18 286.48 105.06 289.72C107.94 292.96 111.42 295.36 115.5 296.92C119.58 298.48 124.14 299.26 129.18 299.26C134.1 299.26 138.54 298.42 142.5 296.74C146.58 295.06 150 292.72 152.76 289.72C155.64 286.72 157.5 283.18 158.34 279.1H191.1C190.02 288.58 186.66 296.92 181.02 304.12C175.5 311.32 168.3 316.9 159.42 320.86C150.54 324.82 140.46 326.8 129.18 326.8ZM239.076 326.8C231.516 326.8 225.156 325.36 219.996 322.48C214.836 319.48 210.936 315.16 208.296 309.52C205.776 303.76 204.516 296.86 204.516 288.82V227.8H234.936V280.54C234.936 285.22 235.476 289.18 236.556 292.42C237.756 295.54 239.556 297.94 241.956 299.62C244.356 301.3 247.476 302.14 251.316 302.14C255.276 302.14 258.636 301.18 261.396 299.26C264.156 297.34 266.256 294.88 267.696 291.88C269.136 288.88 269.856 285.64 269.856 282.16V227.8H300.276V325H270.936L269.856 308.08H268.416C266.136 314.2 262.356 318.88 257.076 322.12C251.796 325.24 245.796 326.8 239.076 326.8ZM364.472 326.8C354.152 326.8 345.332 324.76 338.012 320.68C330.812 316.48 325.292 310.66 321.452 303.22C317.612 295.78 315.692 287.08 315.692 277.12C315.692 266.68 317.612 257.62 321.452 249.94C325.412 242.26 330.992 236.38 338.192 232.3C345.392 228.1 353.792 226 363.392 226C374.792 226 384.152 228.52 391.472 233.56C398.792 238.48 404.012 245.26 407.132 253.9C410.372 262.54 411.452 272.38 410.372 283.42H345.572C345.452 287.86 346.172 291.64 347.732 294.76C349.412 297.76 351.632 300.1 354.392 301.78C357.272 303.34 360.632 304.12 364.472 304.12C369.032 304.12 372.632 303.28 375.272 301.6C378.032 299.92 379.892 297.7 380.852 294.94H409.472C408.632 301.42 406.172 307.06 402.092 311.86C398.132 316.54 392.912 320.2 386.432 322.84C379.952 325.48 372.632 326.8 364.472 326.8ZM345.572 267.58L343.052 264.88H383.192L380.492 267.58C380.732 263.38 380.132 259.9 378.692 257.14C377.372 254.38 375.392 252.28 372.752 250.84C370.112 249.4 366.992 248.68 363.392 248.68C359.672 248.68 356.492 249.46 353.852 251.02C351.212 252.46 349.172 254.62 347.732 257.5C346.292 260.38 345.572 263.74 345.572 267.58ZM435.226 326.44C430.666 326.44 426.946 325.12 424.066 322.48C421.306 319.84 419.926 316.36 419.926 312.04C419.926 307.72 421.306 304.3 424.066 301.78C426.946 299.14 430.666 297.82 435.226 297.82C439.666 297.82 443.266 299.14 446.026 301.78C448.906 304.3 450.346 307.72 450.346 312.04C450.346 316.36 448.906 319.84 446.026 322.48C443.266 325.12 439.666 326.44 435.226 326.44Z" fill="white"/>
+</svg>

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@cuehq/n8n-nodes-cue",
+  "version": "0.1.0",
+  "description": "n8n community node for Cue - Social media scheduling API",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "social-media",
+    "scheduling",
+    "cue"
+  ],
+  "license": "MIT",
+  "homepage": "https://oncue.so",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cueso/cue"
+  },
+  "main": "dist/nodes/Cue/Cue.node.js",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/CueApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Cue/Cue.node.js"
+    ]
+  },
+  "devDependencies": {
+    "n8n-workflow": "^1.0.0",
+    "shx": "0.4.0",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc && pnpm copy-assets",
+    "copy-assets": "shx cp src/nodes/Cue/cue.svg dist/nodes/Cue/ && shx cp src/nodes/Cue/Cue.node.json dist/nodes/Cue/",
+    "typecheck": "tsc --noEmit"
+  }
+}