n8n-nodes-socialfetch 0.13.4 → 0.14.0

package/README.md

@@ -1,8 +1,8 @@
 # n8n-nodes-socialfetch
 
-This is an [n8n](https://n8n.io) community node that lets you fetch real-time social media and web data using the [SocialFetch API](https://www.socialfetch.dev).
+This is an [n8n](https://n8n.io) community node that lets you fetch real-time social media and web data using the [Social Fetch API](https://www.socialfetch.dev).
 
-It exposes a single **SocialFetch** node with one resource per platform (TikTok, Twitter/X, Telegram, Facebook, Instagram, Threads, LinkedIn, Reddit, Spotify, YouTube, Web) plus account operations under **Account** (Whoami, Balance). Each operation maps directly to a SocialFetch public API endpoint.
+It exposes a single **Social Fetch** node with one resource per platform (TikTok, Twitter/X, Telegram, Facebook, Instagram, Threads, LinkedIn, Reddit, Spotify, YouTube, Web) plus account operations under **Account** (Whoami, Balance). Each operation maps directly to a Social Fetch public API endpoint.
 
 [Installation](#installation) · [Credentials](#credentials) · [Operations](#operations) · [Example](#example-workflow) · [Development](#development) · [Publishing](PUBLISHING.md)
 
@@ -12,9 +12,9 @@ Follow the [community nodes installation guide](https://docs.n8n.io/integrations
 
 ## Credentials
 
-You need a SocialFetch API key (it starts with `sfk_`). Create one in your [SocialFetch dashboard](https://www.socialfetch.dev).
+You need a Social Fetch API key (it starts with `sfk_`). Create one in your [Social Fetch API Keys](https://app.socialfetch.dev/api-keys).
 
-In n8n, create a new **SocialFetch API** credential and paste your key. The credential is validated against `GET /v1/whoami` when you save it.
+In n8n, create a new **Social Fetch API** credential and paste your key. The credential is validated against `GET /v1/whoami` when you save it.
 
 ## Operations
 
@@ -22,18 +22,18 @@ Pick a **Resource** (platform) and an **Operation**. Required inputs appear as d
 
 ### Pagination and “Return All”
 
-Only list endpoints that use SocialFetch’s **cursor** query parameter show a **Return All** toggle. When enabled, the node follows `data.page.nextCursor` until `data.page.hasMore` is false. Each page is a separate output item containing the full API JSON body (`data`, `meta`, etc.). Use n8n’s **Item Lists** or **Code** node if you need a single merged array.
+Only list endpoints that use Social Fetch’s **cursor** query parameter show a **Return All** toggle. When enabled, the node follows `data.page.nextCursor` until `data.page.hasMore` is false. Each page is a separate output item containing the full API JSON body (`data`, `meta`, etc.). Use n8n’s **Item Lists** or **Code** node if you need a single merged array.
 
 List endpoints that return everything in one response (no cursor), or that paginate with other parameters such as `page`, do not show **Return All**—you get the first response only unless you pass those parameters under **Additional Fields**.
 
-Every request consumes credits from your SocialFetch balance (most endpoints cost 1 credit; some search and media-download options cost more). The credits charged for each call are returned in `meta.creditsCharged`.
+Every request consumes credits from your Social Fetch balance (most endpoints cost 1 credit; some search and media-download options cost more). The credits charged for each call are returned in `meta.creditsCharged`.
 
 ## Example workflow
 
 This example fetches a TikTok creator's recent videos and keeps only the high-performing ones.
 
 1. **Manual Trigger** — start the workflow manually for testing.
-2. **SocialFetch** — set **Resource** to `TikTok` and **Operation** to `Profile videos`.
+2. **Social Fetch** — set **Resource** to `TikTok` and **Operation** to `Profile Videos`.
    - **Handle**: `n8n`
    - Turn on **Return All** to page through every video, or leave it off to fetch the first page.
    - Under **Additional Fields**, set **Sort By** to `Popular`.
@@ -41,7 +41,7 @@ This example fetches a TikTok creator's recent videos and keeps only the high-pe
 4. **Filter** — keep videos above a view threshold:
    - Condition: `{{ $json.stats.views }}` _is greater than_ `100000`.
 
-Each SocialFetch item is one API page. With **Return All** off you get a single page; with it on you get one item per page, each containing `data.videos`, `data.page`, and `meta`. **Split Out** turns the videos array into individual items so the Filter node can evaluate `stats.views` on each video.
+Each Social Fetch item is one API page. With **Return All** off you get a single page; with it on you get one item per page, each containing `data.videos`, `data.page`, and `meta`. **Split Out** turns the videos array into individual items so the Filter node can evaluate `stats.views` on each video.
 
 Example response shape (first video on a page):
 
@@ -68,19 +68,27 @@ Example response shape (first video on a page):
 }
 ```
 
-A second common pattern is enrichment: use **TikTok → User search** (or **Search videos**) to discover handles, then loop those results back into **Profile videos** or **Profile** to pull full details for each match.
+A second common pattern is enrichment: use **TikTok → User Search** (or **Search Videos**) to discover handles, then loop those results back into **Profile Videos** or **Profile** to pull full details for each match.
 
 ## Development
 
-The node descriptions are generated from the SocialFetch OpenAPI spec.
+The node descriptions are generated from the Social Fetch OpenAPI spec. Parameter labels and operation dropdown names follow [n8n node UX guidelines](https://docs.n8n.io/integrations/creating-nodes/build/reference/ux-guidelines/): Title Case with canonical acronyms (`URL`, `ID`, `AI`) on parameters and operation names; sentence case on operation `action` strings and descriptions.
+
+Label formatting lives in `scripts/n8n-label-formatting.mts` and is covered by unit and integration tests.
 
 ```bash
 # from the repo root (codegen + eslint fix on generated descriptions)
 pnpm generate:n8n
 
+# label formatting tests (unit + committed generated output; lives in monorepo tests/)
+pnpm test:n8n
+
 # full derived check before a PR (openapi, sdk, zapier, n8n, …)
 pnpm check:derived
 
+# lint, build, and label tests for the n8n package only
+pnpm check:n8n
+
 # local dev (standalone pnpm project — not part of the root pnpm workspace)
 cd integrations/n8n
 pnpm install --ignore-workspace
@@ -88,7 +96,7 @@ pnpm run build
 pnpm run dev   # http://localhost:5678
 ```
 
-`generate:n8n` syncs the package **version** from `@socialfetch/sdk`, regenerates descriptions, and runs `lint:fix`. `check:derived` also runs `check:n8n` (install, lint, build).
+`generate:n8n` syncs the package **version** from `@socialfetch/sdk`, regenerates descriptions, and runs `lint:fix`. `check:n8n` runs label tests, lint, and build. `check:derived` also runs `check:n8n`.
 
 Releases and syncing to [n8n-nodes-socialfetch](https://github.com/social-freak-ltd/n8n-nodes-socialfetch) are automated from the monorepo — see [PUBLISHING.md](PUBLISHING.md).
 

package/dist/credentials/SocialFetchApi.credentials.js

@@ -4,7 +4,7 @@ exports.SocialFetchApi = void 0;
 class SocialFetchApi {
     constructor() {
         this.name = "socialFetchApi";
-        this.displayName = "SocialFetch API";
+        this.displayName = "Social Fetch API";
         this.documentationUrl = "https://www.socialfetch.dev/docs";
         this.icon = "file:socialfetch.svg";
         this.properties = [
@@ -15,7 +15,7 @@ class SocialFetchApi {
                 typeOptions: { password: true },
                 default: "",
                 required: true,
-                description: "Your SocialFetch API key (starts with sfk_). Create one in the SocialFetch dashboard.",
+                description: "Your Social Fetch API key (starts with sfk_). Create one in the Social Fetch dashboard.",
             },
         ];
         this.authenticate = {

package/dist/nodes/SocialFetch/SocialFetch.node.js

@@ -6,14 +6,14 @@ const index_generated_1 = require("./descriptions/index.generated");
 class SocialFetch {
     constructor() {
         this.description = {
-            displayName: "SocialFetch",
+            displayName: "Social Fetch",
             name: "socialFetch",
             icon: "file:socialfetch.svg",
             group: ["input"],
             version: 1,
             subtitle: '={{$parameter["operation"].replace(/\\./g, " › ").replace(/^[^›]+ › /, "")}}',
-            description: "Fetch social media and web data via the SocialFetch API",
-            defaults: { name: "SocialFetch" },
+            description: "Fetch social media and web data via the Social Fetch API",
+            defaults: { name: "Social Fetch" },
             inputs: [n8n_workflow_1.NodeConnectionTypes.Main],
             outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
             credentials: [{ name: "socialFetchApi", required: true }],

package/dist/nodes/SocialFetch/descriptions/facebook.generated.js

@@ -30,7 +30,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Profile posts",
+                "name": "Profile Posts",
                 "value": "facebook.profile.posts.list",
                 "action": "List Facebook profile posts",
                 "description": "Get posts from a Facebook profile or page.",
@@ -48,7 +48,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Profile reels",
+                "name": "Profile Reels",
                 "value": "facebook.profile.reels.list",
                 "action": "List Facebook profile reels",
                 "description": "Get Reels from a Facebook profile or page.",
@@ -66,7 +66,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Profile photos",
+                "name": "Profile Photos",
                 "value": "facebook.profile.photos.list",
                 "action": "List Facebook profile photos",
                 "description": "Get photos from a Facebook profile or page.",
@@ -84,7 +84,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Post or reel",
+                "name": "Post or Reel",
                 "value": "facebook.post.get",
                 "action": "Get Facebook post or reel",
                 "description": "Get a Facebook post or Reel.",
@@ -126,7 +126,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Group posts",
+                "name": "Group Posts",
                 "value": "facebook.group.posts.list",
                 "action": "List Facebook group posts",
                 "description": "Get posts from a Facebook group.",
@@ -144,7 +144,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Marketplace item",
+                "name": "Marketplace Item",
                 "value": "facebook.marketplace.item.get",
                 "action": "Get Facebook Marketplace item",
                 "description": "Get details for a Facebook Marketplace listing.",
@@ -156,7 +156,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Marketplace location search",
+                "name": "Marketplace Location Search",
                 "value": "facebook.marketplace.locations.search",
                 "action": "Search Facebook Marketplace locations",
                 "description": "Search Facebook Marketplace locations to obtain coordinates for listing search.",
@@ -168,7 +168,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Marketplace search",
+                "name": "Marketplace Search",
                 "value": "facebook.marketplace.search.list",
                 "action": "Search Facebook Marketplace listings",
                 "description": "Search Facebook Marketplace listings by keyword near a latitude and longitude.",
@@ -186,7 +186,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Ad library ad",
+                "name": "Ad Library Ad",
                 "value": "facebook.adLibrary.ad.get",
                 "action": "Get Facebook Ad Library ad",
                 "description": "Get a single Facebook Ad Library ad by archive id or public Ad Library URL.",
@@ -198,7 +198,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Ad Library search",
+                "name": "Ad Library Search",
                 "value": "facebook.adLibrary.ads.search.get",
                 "action": "Search Facebook Ad Library ads",
                 "description": "Search Facebook Ad Library ads by keyword.",
@@ -216,7 +216,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Company ads",
+                "name": "Company Ads",
                 "value": "facebook.company.ads.list",
                 "action": "List Facebook company ads",
                 "description": "List ads a company or page is running in the Facebook Ad Library.",
@@ -234,7 +234,7 @@ exports.facebook = [
                 }
             },
             {
-                "name": "Ad library companies",
+                "name": "Ad Library Companies",
                 "value": "facebook.adLibrary.companies.search",
                 "action": "Search Facebook ad library companies",
                 "description": "Search Facebook ad library companies by name.",
@@ -248,7 +248,7 @@ exports.facebook = [
         ]
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -339,7 +339,7 @@ exports.facebook = [
         },
         "options": [
             {
-                "displayName": "Url",
+                "displayName": "URL",
                 "name": "url",
                 "type": "string",
                 "default": "",
@@ -353,7 +353,7 @@ exports.facebook = [
                 }
             },
             {
-                "displayName": "Page Id",
+                "displayName": "Page ID",
                 "name": "pageId",
                 "type": "string",
                 "default": "",
@@ -385,7 +385,7 @@ exports.facebook = [
         }
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -427,7 +427,7 @@ exports.facebook = [
         }
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -452,7 +452,7 @@ exports.facebook = [
         }
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -556,7 +556,7 @@ exports.facebook = [
         },
         "options": [
             {
-                "displayName": "Url",
+                "displayName": "URL",
                 "name": "url",
                 "type": "string",
                 "default": "",
@@ -570,7 +570,7 @@ exports.facebook = [
                 }
             },
             {
-                "displayName": "Feedback Id",
+                "displayName": "Feedback ID",
                 "name": "feedbackId",
                 "type": "string",
                 "default": "",
@@ -585,7 +585,7 @@ exports.facebook = [
         ]
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -627,7 +627,7 @@ exports.facebook = [
         }
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -719,7 +719,7 @@ exports.facebook = [
         },
         "options": [
             {
-                "displayName": "Item Id",
+                "displayName": "Item ID",
                 "name": "itemId",
                 "type": "string",
                 "default": "",
@@ -732,7 +732,7 @@ exports.facebook = [
                 }
             },
             {
-                "displayName": "Url",
+                "displayName": "URL",
                 "name": "url",
                 "type": "string",
                 "default": "",
@@ -1092,7 +1092,7 @@ exports.facebook = [
         },
         "options": [
             {
-                "displayName": "Ad Id",
+                "displayName": "Ad ID",
                 "name": "adId",
                 "type": "string",
                 "default": "",
@@ -1105,7 +1105,7 @@ exports.facebook = [
                 }
             },
             {
-                "displayName": "Url",
+                "displayName": "URL",
                 "name": "url",
                 "type": "string",
                 "default": "",
@@ -1261,7 +1261,7 @@ exports.facebook = [
                         "value": "all"
                     },
                     {
-                        "name": "Political And Issue",
+                        "name": "Political and Issue",
                         "value": "political-and-issue"
                     }
                 ],
@@ -1336,7 +1336,7 @@ exports.facebook = [
                         "value": "meme"
                     },
                     {
-                        "name": "Image And Meme",
+                        "name": "Image and Meme",
                         "value": "image-and-meme"
                     },
                     {
@@ -1429,7 +1429,7 @@ exports.facebook = [
         },
         "options": [
             {
-                "displayName": "Page Id",
+                "displayName": "Page ID",
                 "name": "pageId",
                 "type": "string",
                 "default": "",
@@ -1516,7 +1516,7 @@ exports.facebook = [
                         "value": "meme"
                     },
                     {
-                        "name": "Image And Meme",
+                        "name": "Image and Meme",
                         "value": "image-and-meme"
                     },
                     {

package/dist/nodes/SocialFetch/descriptions/instagram.generated.js

@@ -30,7 +30,7 @@ exports.instagram = [
                 }
             },
             {
-                "name": "Basic profile",
+                "name": "Basic Profile",
                 "value": "instagram.profile.basic.get",
                 "action": "Get Instagram basic profile",
                 "description": "Get a lightweight Instagram profile by numeric user ID.",
@@ -42,7 +42,7 @@ exports.instagram = [
                 }
             },
             {
-                "name": "Profile posts",
+                "name": "Profile Posts",
                 "value": "instagram.profile.posts.list",
                 "action": "List Instagram profile posts",
                 "description": "Get posts from a specific Instagram profile.",
@@ -60,7 +60,7 @@ exports.instagram = [
                 }
             },
             {
-                "name": "Profile reels",
+                "name": "Profile Reels",
                 "value": "instagram.profile.reels.list",
                 "action": "List Instagram profile reels",
                 "description": "Get Reels from a specific Instagram profile.",
@@ -78,7 +78,7 @@ exports.instagram = [
                 }
             },
             {
-                "name": "Profile highlights",
+                "name": "Profile Highlights",
                 "value": "instagram.profile.highlights.list",
                 "action": "List Instagram profile highlights",
                 "description": "List story highlight albums for an Instagram profile.",
@@ -102,7 +102,7 @@ exports.instagram = [
                 }
             },
             {
-                "name": "Post or reel",
+                "name": "Post or Reel",
                 "value": "instagram.post.get",
                 "action": "Get Instagram post or reel",
                 "description": "Get a single Instagram post or Reel.",
@@ -144,7 +144,7 @@ exports.instagram = [
                 }
             },
             {
-                "name": "Search reels",
+                "name": "Search Reels",
                 "value": "instagram.search.reels.list",
                 "action": "Search Instagram Reels",
                 "description": "Search Instagram Reels by keyword with optional date filters and page-based pagination.",
@@ -177,7 +177,7 @@ exports.instagram = [
         }
     },
     {
-        "displayName": "User Id",
+        "displayName": "User ID",
         "name": "userId",
         "type": "string",
         "default": "",
@@ -286,7 +286,7 @@ exports.instagram = [
         }
     },
     {
-        "displayName": "Highlight Id",
+        "displayName": "Highlight ID",
         "name": "highlightId",
         "type": "string",
         "default": "",
@@ -304,7 +304,7 @@ exports.instagram = [
         }
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -404,7 +404,7 @@ exports.instagram = [
         }
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",
@@ -429,7 +429,7 @@ exports.instagram = [
         }
     },
     {
-        "displayName": "Url",
+        "displayName": "URL",
         "name": "url",
         "type": "string",
         "default": "",