@bambuser/n8n-nodes-livecommerce 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bambuser AB
+
+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,188 @@
+# n8n-nodes-livecommerce
+
+[![CI](https://github.com/bambuser/n8n-nodes-livecommerce/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/bambuser/n8n-nodes-livecommerce/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@bambuser/n8n-nodes-livecommerce.svg)](https://www.npmjs.com/package/@bambuser/n8n-nodes-livecommerce)
+[![npm downloads](https://img.shields.io/npm/dm/@bambuser/n8n-nodes-livecommerce.svg)](https://www.npmjs.com/package/@bambuser/n8n-nodes-livecommerce)
+[![Node 24+](https://img.shields.io/node/v/@bambuser/n8n-nodes-livecommerce.svg)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+
+Community [n8n](https://n8n.io) nodes for the [Bambuser](https://bambuser.com) video-commerce platform. Connect **Bambuser Live**, **Bambuser Shoppable Videos**, **Bambuser Video Consultation**, the product catalog, shopper-data records, and webhook events into n8n's 400+ integrations without writing custom HTTP code.
+
+## About
+
+Bambuser powers live, on-demand, and one-to-one video commerce for retailers and brands. This package wraps the public Bambuser APIs as native n8n nodes so non-engineers can wire video-commerce events into CRMs, data warehouses, messaging platforms, and analytics tools by dragging nodes onto a canvas. The package is maintained by Bambuser and developed in the open.
+
+## Available nodes
+
+All nodes share a single `Bambuser API` credential. Each maps to a Bambuser product area and exposes resource/operation pairs in the standard n8n style.
+
+**Bambuser Webhook Trigger** — Start a workflow when Bambuser fires an event. The node registers and tears down the subscription against the Bambuser API on workflow activation/deactivation, and re-registers automatically if the webhook URL changes.
+- `show.*`, `broadcast.*`, `product.*`, `product-highlight.*`, `user.*` topics
+- Requires the `WRITE_WEBHOOKS` API-key scope
+
+**Bambuser Live** — Read and write live show data mid-workflow.
+- List, create, update, publish, and schedule shows
+- Pin and unpin chat messages
+- Manage product highlights and pull viewer/sales metrics
+
+**Bambuser Shoppable Videos** — Create and manage VOD assets.
+- Clip a broadcast into a VOD
+- Manage media assets, captions, and video playlists
+- Query the video library
+
+**Bambuser Product Catalog** — Search and manage the product catalog.
+- Search and count products
+- Create, update, delete
+- Suitable for AI enrichment and stock-sync workflows
+
+**Bambuser Video Consultation** — Automate one-to-one video calls and connect links.
+- Create connect links
+- Fetch call transcripts
+- Manage agents, appointments, and availability
+
+**Bambuser Shopper Data** — Read and erase shopper-data records.
+- List and get records
+- Drive GDPR erasure pipelines from a webhook
+
+### Credential
+
+The `Bambuser API` credential takes an API key, a region (`EU` or `US`), and an optional base-URL override. The key is sent as `Authorization: Token <key>`. Scopes are granted per-key in the Bambuser dashboard; relevant scopes include `VOD_MANAGE`, `VOD_READ`, `PRODUCT_CATALOG_READ`, `PRODUCT_CATALOG_MANAGE`, `WRITE_WEBHOOKS`, and `READ_SHOPPER_DATA`. Grant only the scopes the workflow needs.
+
+## Prerequisites
+
+- [n8n](https://n8n.io) 1.57.0 or later
+- Node.js 24 or later (only required for local development of the nodes themselves)
+
+## Installation
+
+### n8n Cloud and self-hosted (Community Nodes UI)
+
+1. Open n8n and go to **Settings → Community Nodes**.
+2. Click **Install** and enter `@bambuser/n8n-nodes-livecommerce`.
+3. Confirm the install. The Bambuser nodes appear in the node panel after a short refresh.
+
+See the n8n [community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) for the full UI walkthrough and the security caveats around third-party nodes.
+
+### Self-hosted via npm
+
+For self-hosted n8n instances that install community nodes from the file system:
+
+```bash
+cd ~/.n8n/custom
+npm init -y       # only if package.json does not already exist
+npm install @bambuser/n8n-nodes-livecommerce
+```
+
+Restart n8n. The nodes load from `~/.n8n/custom/node_modules`.
+
+## Credentials
+
+A Bambuser account is required. You can create one for free at [bambuser.com](https://bambuser.com).
+
+1. Sign in to your Bambuser dashboard ([EU](https://lcx-eu.bambuser.com/) or [US](https://lcx.bambuser.com/), matching your org's data residency) and open **Settings → API Keys**.
+2. Create a new key and grant the scopes your workflow needs (see the list under [Available nodes](#available-nodes)).
+3. In n8n, create a new credential of type **Bambuser API**:
+   - **API Key** — the key from the dashboard.
+   - **Region** — `EU` or `US`, matching the org's data residency.
+   - **Base URL Override** — leave empty in production. Used for pointing at a non-default API host (staging, a tunnel, a local proxy).
+
+The credential is reused across every node in this package.
+
+## Compatibility
+
+Built and tested against n8n 1.57 and later. Earlier versions are not supported.
+
+## Quick start
+
+A minimal workflow that reacts to a Bambuser show ending:
+
+1. Add a **Bambuser Webhook Trigger** node. Select the `show` topic.
+2. Activate the workflow. The node registers a webhook subscription against the Bambuser API automatically.
+3. Add downstream nodes (Slack, HTTP Request, database, etc.) consuming the event payload.
+
+End the show in the Bambuser dashboard. n8n receives the webhook and runs the workflow.
+
+## What you can build
+
+A few workflows that merchants commonly assemble from these nodes plus n8n's built-in integrations:
+
+- **Go-live notification blast** — `show.started` → SMS via Twilio + email via Klaviyo + Instagram Story post.
+- **Automatic show recap** — `show.ended` → pull stats → AI summary → post to Slack and save to Notion.
+- **Live → VOD → CMS pipeline** — `broadcast.ended` → create VOD → AI writes description → push to Contentful or a Shopify product page.
+- **Data warehouse sync** — `show.ended` → append views, carts, and revenue to BigQuery or Google Sheets.
+- **Low-stock alerts** — daily catalog scan → Gemini drafts a restock recommendation → append to a shared Google Doc.
+- **GDPR shopper data erasure** — erasure webhook fires → delete shopper record → log confirmation for the audit trail.
+
+See [`examples/workflows/`](./examples/workflows/) for ready-to-import JSON workflows demonstrating each of these patterns.
+
+## Examples
+
+Ready-to-import workflow JSON files live under [`examples/workflows/`](./examples/workflows/). Import a file from the n8n UI via **Workflows → Import from File**, then attach your Bambuser API credential.
+
+## Local development
+
+```bash
+git clone https://github.com/bambuser/n8n-nodes-livecommerce.git
+cd n8n-nodes-livecommerce
+nvm use        # picks up .nvmrc → Node 24
+npm install
+npm run build
+```
+
+To link the local build into a local n8n install:
+
+```bash
+cd ~/.n8n/custom
+npm link /absolute/path/to/n8n-nodes-livecommerce
+```
+
+Restart n8n and the nodes load from the local build directory.
+
+### Docker development environment
+
+The repo ships a Docker Compose setup that runs n8n with Postgres and bind-mounts the compiled nodes, so a rebuild + restart picks up changes without rebuilding the image.
+
+```bash
+cp .env.example .env
+openssl rand -hex 32   # paste into N8N_ENCRYPTION_KEY in .env
+docker compose up --build
+```
+
+n8n is available at `http://localhost:5678`.
+
+After editing anything under `credentials/`, `lib/`, or `nodes/`:
+
+```bash
+npm run build
+docker compose restart n8n
+```
+
+### Webhook testing with a Cloudflare tunnel
+
+Bambuser needs a public HTTPS URL to deliver webhook events. To run n8n behind a free `*.trycloudflare.com` tunnel:
+
+```bash
+docker compose -f docker-compose.yml -f docker-compose.tunnel.yml up --build
+```
+
+The tunnel URL changes on every restart. To push the new URL to Bambuser, deactivate and reactivate the workflow in the n8n UI — the Bambuser Webhook Trigger node re-registers the subscription with the new URL automatically.
+
+## Publishing
+
+Releases are tag-driven and run from GitHub Actions with npm provenance.
+
+1. A maintainer runs `npm run release` from the repo root. [release-it](https://github.com/release-it/release-it) prompts for a version bump, updates `package.json`, commits, tags, and pushes the tag.
+2. The tag push triggers `.github/workflows/publish.yml`, which builds the package and publishes it to npm under the `@bambuser` scope with an [npm provenance statement](https://docs.npmjs.com/generating-provenance-statements).
+
+Both Trusted Publishers (OIDC) and a long-lived `NPM_TOKEN` secret are supported. See the comments in `.github/workflows/publish.yml` for setup.
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [n8n node-development reference](https://docs.n8n.io/integrations/creating-nodes/)
+- [Bambuser developer documentation](https://bambuser.com/docs)
+- [Sign up for a Bambuser account](https://bambuser.com)
+
+## License
+
+[MIT](./LICENSE)

package/dist/credentials/BambuserApi.credentials.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BambuserApi = void 0;
+const resolveOrigin_1 = require("../lib/resolveOrigin");
+class BambuserApi {
+    name = 'bambuserApi';
+    displayName = 'Bambuser API';
+    icon = 'file:bambuser.svg';
+    documentationUrl = 'https://bambuser.com/docs';
+    properties = [
+        {
+            displayName: 'API Key',
+            name: 'apiKey',
+            type: 'string',
+            typeOptions: { password: true },
+            default: '',
+            required: true,
+        },
+        {
+            displayName: 'Region',
+            name: 'region',
+            type: 'options',
+            options: [
+                { name: 'EU', value: 'eu' },
+                { name: 'US', value: 'us' },
+            ],
+            default: 'eu',
+            required: true,
+        },
+        {
+            displayName: 'Base URL Override',
+            name: 'baseUrl',
+            type: 'string',
+            default: '',
+            placeholder: 'https://liveshopping-api.bambuser.com',
+            description: 'Leave empty to use the production URL for the selected region. Set to a stage or local mock URL to override.',
+        },
+    ];
+    authenticate = {
+        type: 'generic',
+        properties: {
+            headers: {
+                Authorization: '=Token {{$credentials.apiKey}}',
+            },
+        },
+    };
+    test = {
+        request: {
+            baseURL: resolveOrigin_1.RESOLVE_ORIGIN_EXPRESSION,
+            url: '/v1/shows',
+            qs: { limit: 1 },
+        },
+    };
+}
+exports.BambuserApi = BambuserApi;

package/dist/credentials/bambuser.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80">
+  <rect width="80" height="80" fill="#000000"/>
+  <g fill="#ffffff" transform="translate(4.5, 19.5)">
+    <path d="M4.08921,20.0677 L4.02518,20.0677 L4.02518,22.0405 L0,22.0405 L0,0 L4.18069,0 L4.18069,8.13904 L4.27218,8.13904 C5.1321,6.8177 6.48602,5.79918 8.66328,5.79918 C12.6244,5.79918 15.4512,9.22179 15.4512,14.1493 C15.4512,19.2694 12.7433,22.4993 8.7822,22.4993 C6.5775,22.4993 5.01317,21.545 4.08921,20.0677 Z M11.2156,14.1493 C11.2156,11.2221 10.0446,9.18509 7.71187,9.18509 C5.06806,9.18509 4.08921,11.3139 4.08921,14.241 C4.08921,17.1406 5.53462,18.985 7.86739,18.985 C10.0172,18.985 11.2156,17.1957 11.2156,14.1493 Z"/>
+    <path d="M25.8814,20.2802 L25.8174,20.2802 C25.0215,21.4822 23.878,22.409 21.1793,22.409 C17.95,22.409 15.6813,20.7115 15.6813,17.5733 C15.6813,14.0864 18.508,12.9762 22.0118,12.4898 C24.6281,12.1228 25.8265,11.9026 25.8265,10.7005 C25.8265,9.56272 24.9392,8.81947 23.1827,8.81947 C21.2159,8.81947 20.2645,9.52602 20.1364,11.04 L16.4223,11.04 C16.5412,8.26892 18.6087,5.82812 23.2102,5.82812 C27.9397,5.82812 29.8517,7.95694 29.8517,11.6548 L29.8517,19.7021 C29.8517,20.9042 30.0347,21.6107 30.4006,21.8952 L30.4006,22.0511 L26.3754,22.0511 C26.1193,21.73 25.9729,20.9959 25.8814,20.2802 Z M25.9089,16.463 L25.9089,14.0864 C25.1679,14.5177 24.0335,14.7655 22.9906,15.0132 C20.8042,15.5087 19.7339,15.995 19.7339,17.4815 C19.7339,18.9589 20.7127,19.4819 22.1947,19.4819 C24.5915,19.4819 25.9089,18.0046 25.9089,16.463 Z"/>
+    <path d="M31.3501,6.22951 L35.3753,6.22951 L35.3753,8.34914 L35.4668,8.34914 C36.3267,6.89935 37.8636,5.78906 40.05,5.78906 C42.0443,5.78906 43.6452,6.89935 44.4136,8.56019 L44.4777,8.56019 C45.5572,6.83512 47.213,5.78906 49.2073,5.78906 C52.528,5.78906 54.4034,7.9454 54.4034,11.3955 L54.4034,22.0304 L50.2227,22.0304 L50.2227,12.1113 C50.2227,10.322 49.3353,9.3952 47.7985,9.3952 C46.0512,9.3952 44.9717,10.7532 44.9717,12.8453 L44.9717,22.0304 L40.791,22.0304 L40.791,12.1113 C40.791,10.322 39.9036,9.3952 38.3667,9.3952 C36.6743,9.3952 35.54,10.7532 35.54,12.8453 L35.54,22.0304 L31.3593,22.0304 L31.3593,6.22951 L31.3501,6.22951 Z"/>
+    <path d="M4.08921,37.8041 L4.02518,37.8041 L4.02518,39.7769 L0,39.7769 L0,17.7363 L4.18069,17.7363 L4.18069,25.8754 L4.27218,25.8754 C5.1321,24.554 6.48602,23.5355 8.66328,23.5355 C12.6244,23.5355 15.4512,26.9581 15.4512,31.8856 C15.4512,37.0058 12.7433,40.2357 8.7822,40.2357 C6.5775,40.2357 5.01317,39.2814 4.08921,37.8041 Z M11.2156,31.8856 C11.2156,28.9585 10.0446,26.9214 7.71187,26.9214 C5.06806,26.9214 4.08921,29.0502 4.08921,31.9774 C4.08921,34.8769 5.53462,36.7213 7.86739,36.7213 C10.0172,36.7213 11.2156,34.932 11.2156,31.8856 Z"/>
+    <path d="M26.4004,39.7789 L26.4004,37.9253 L26.3089,37.9253 C25.2295,39.3751 24.0036,40.2101 21.7898,40.2101 C18.286,40.2101 16.3192,37.962 16.3192,34.5119 L16.3192,23.9688 L20.4633,23.9688 L20.4633,33.8053 C20.4633,35.6589 21.2958,36.6682 23.0796,36.6682 C25.0465,36.6682 26.2449,35.1909 26.2449,33.0896 L26.2449,23.9688 L30.4256,23.9688 L30.4256,39.7789 L26.4004,39.7789 Z"/>
+    <path d="M31.1063,34.6564 L34.9759,34.6564 C35.2504,36.4732 36.5403,37.2807 38.4156,37.2807 C40.2635,37.2807 41.3064,36.5741 41.3064,35.4638 C41.3064,33.9498 39.3121,33.803 37.1623,33.3717 C34.3356,32.8212 31.5728,32.0504 31.5728,28.5911 C31.5728,25.1685 34.3996,23.5352 37.9948,23.5352 C42.1389,23.5352 44.4442,25.5997 44.7553,28.7746 L40.9771,28.7746 C40.7941,27.0771 39.7147,26.4623 37.9308,26.4623 C36.3024,26.4623 35.2229,27.0771 35.2229,28.2149 C35.2229,29.5729 37.3087,29.6922 39.5591,30.1602 C42.2029,30.7107 45.1212,31.454 45.1212,35.1519 C45.1212,38.3267 42.4134,40.2353 38.4797,40.2353 C33.9056,40.2353 31.3533,38.0148 31.1063,34.6564 Z"/>
+    <path d="M45.3332,31.8479 C45.3332,27.1591 48.4984,23.5254 53.1091,23.5254 C58.1772,23.5254 60.885,27.4068 60.885,33.05 L49.4499,33.05 C49.7609,35.4816 51.1057,36.9956 53.475,36.9956 C55.1034,36.9956 56.0548,36.2524 56.5214,35.0503 L60.638,35.0503 C60.0525,37.8582 57.5642,40.2256 53.5116,40.2256 C48.288,40.2347 45.3332,36.5644 45.3332,31.8479 Z M49.5139,30.1596 L56.5214,30.1596 C56.4024,28.1592 55.076,26.7645 53.1731,26.7645 C50.9593,26.7645 49.8798,28.095 49.5139,30.1596 Z"/>
+    <path d="M65.6228,26.4895 L65.7142,26.4895 C66.6656,24.7002 67.7451,23.7734 69.5839,23.7734 C70.0413,23.7734 70.3249,23.801 70.5719,23.8927 L70.5719,27.5631 L70.4804,27.5631 C67.7451,27.2878 65.7783,28.7376 65.7783,32.0593 L65.7783,39.7671 L61.5976,39.7671 L61.5976,23.9661 L65.6228,23.9661 L65.6228,26.4895 Z"/>
+  </g>
+</svg>

package/dist/lib/resolveOrigin.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOLVE_ORIGIN_EXPRESSION = exports.resolveOrigin = void 0;
+const ORIGIN_BY_REGION = {
+    eu: 'https://liveshopping-api-eu.bambuser.com',
+    us: 'https://liveshopping-api-us.bambuser.com',
+};
+const resolveOrigin = (baseUrl, region) => (baseUrl || ORIGIN_BY_REGION[region] || ORIGIN_BY_REGION.eu).replace(/\/$/, '');
+exports.resolveOrigin = resolveOrigin;
+// n8n expression form of resolveOrigin, evaluated at request-build time by n8n
+// against `$credentials`. Shared with the BambuserApi credential's baseUrl
+// binding so runtime helper calls and credential URL resolution always agree
+// on the same per-region origins.
+exports.RESOLVE_ORIGIN_EXPRESSION = `={{ ($credentials.baseUrl || "").replace(/\\/$/, "") || ($credentials.region === "us" ? "${ORIGIN_BY_REGION.us}" : "${ORIGIN_BY_REGION.eu}") }}`;

package/dist/nodes/BambuserCalls/BambuserCalls.node.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BambuserCalls = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const resolveOrigin_1 = require("../../lib/resolveOrigin");
+const filterEmpty = (obj) => Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== '' && v !== undefined && v !== null));
+const buildOperationHandlers = (ctx, baseUrl) => ({
+    // ─── Call ─────────────────────────────────────────────────────────────────
+    'call:get': async (i) => ({
+        method: 'GET',
+        url: `${baseUrl}/calls/${ctx.getNodeParameter('callId', i)}`,
+    }),
+    'call:getTranscriptions': async (i) => ({
+        method: 'GET',
+        url: `${baseUrl}/calls/${ctx.getNodeParameter('callId', i)}/transcriptions`,
+        qs: filterEmpty({ cursor: ctx.getNodeParameter('cursor', i, '') }),
+    }),
+    // ─── Connect Link ─────────────────────────────────────────────────────────
+    'connectLink:get': async (i) => ({
+        method: 'GET',
+        url: `${baseUrl}/connect-links/${ctx.getNodeParameter('connectLinkId', i)}`,
+    }),
+    'connectLink:getByExternalId': async (i) => ({
+        method: 'GET',
+        url: `${baseUrl}/connect-links`,
+        qs: { externalId: ctx.getNodeParameter('externalId', i) },
+    }),
+    'connectLink:create': async (i) => ({
+        method: 'POST',
+        url: `${baseUrl}/connect-links`,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.parse(ctx.getNodeParameter('connectLinkBody', i, '{}')),
+    }),
+    'connectLink:update': async (i) => ({
+        method: 'PATCH',
+        url: `${baseUrl}/connect-links/${ctx.getNodeParameter('connectLinkId', i)}`,
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.parse(ctx.getNodeParameter('connectLinkBody', i, '{}')),
+    }),
+    'connectLink:updateByExternalId': async (i) => ({
+        method: 'PATCH',
+        url: `${baseUrl}/connect-links`,
+        qs: { externalId: ctx.getNodeParameter('externalId', i) },
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.parse(ctx.getNodeParameter('connectLinkBody', i, '{}')),
+    }),
+    'connectLink:delete': async (i) => ({
+        method: 'DELETE',
+        url: `${baseUrl}/connect-links/${ctx.getNodeParameter('connectLinkId', i)}`,
+    }),
+    'connectLink:deleteByExternalId': async (i) => ({
+        method: 'DELETE',
+        url: `${baseUrl}/connect-links`,
+        qs: { externalId: ctx.getNodeParameter('externalId', i) },
+    }),
+    // ─── Stats ────────────────────────────────────────────────────────────────
+    'stats:getAccepted': async (i) => ({
+        method: 'GET',
+        url: `${baseUrl}/stats/calls/accepted`,
+        qs: filterEmpty({
+            from: ctx.getNodeParameter('from', i),
+            to: ctx.getNodeParameter('to', i, ''),
+            excludeShortCalls: ctx.getNodeParameter('excludeShortCalls', i, ''),
+            excludeTestCalls: ctx.getNodeParameter('excludeTestCalls', i, ''),
+        }),
+    }),
+    'stats:getMissed': async (i) => ({
+        method: 'GET',
+        url: `${baseUrl}/stats/calls/missed`,
+        qs: filterEmpty({
+            from: ctx.getNodeParameter('from', i),
+            to: ctx.getNodeParameter('to', i, ''),
+            excludeShortQueueTime: ctx.getNodeParameter('excludeShortQueueTime', i, ''),
+        }),
+    }),
+});
+class BambuserCalls {
+    description = {
+        // `displayName` is the UI label and may follow public product branding freely.
+        // `name` is the persisted node type (`<package>.<name>`) baked into every saved
+        // workflow — changing it breaks existing flows, so it is frozen to the internal
+        // concept (calls) and must NOT track marketing renames.
+        displayName: 'Bambuser Video Consultation',
+        name: 'bambuserCalls',
+        icon: 'file:bambuser-live.svg',
+        group: ['transform'],
+        version: 1,
+        subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
+        description: 'Interact with the Bambuser Video Consultation API',
+        defaults: { name: 'Bambuser Video Consultation' },
+        inputs: ['main'],
+        outputs: ['main'],
+        credentials: [{ name: 'bambuserApi', required: true }],
+        properties: [
+            // ── Resource ───────────────────────────────────────────────────────────
+            {
+                displayName: 'Resource',
+                name: 'resource',
+                type: 'options',
+                noDataExpression: true,
+                options: [
+                    { name: 'Call', value: 'call' },
+                    { name: 'Connect Link', value: 'connectLink' },
+                    { name: 'Stat', value: 'stats' },
+                ],
+                default: 'call',
+            },
+            // ── Operation: Call ────────────────────────────────────────────────────
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                displayOptions: { show: { resource: ['call'] } },
+                options: [
+                    { name: 'Get', value: 'get', action: 'Get a call by ID' },
+                    { name: 'Get Transcriptions', value: 'getTranscriptions', action: 'Get transcriptions for a call' },
+                ],
+                default: 'get',
+            },
+            // ── Operation: Connect Link ────────────────────────────────────────────
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                displayOptions: { show: { resource: ['connectLink'] } },
+                options: [
+                    { name: 'Create', value: 'create', action: 'Create a connect link' },
+                    { name: 'Delete', value: 'delete', action: 'Delete a connect link by ID' },
+                    { name: 'Delete by External ID', value: 'deleteByExternalId', action: 'Delete a connect link by external ID' },
+                    { name: 'Get', value: 'get', action: 'Get a connect link by ID' },
+                    { name: 'Get by External ID', value: 'getByExternalId', action: 'Get a connect link by external ID' },
+                    { name: 'Update', value: 'update', action: 'Update a connect link by ID' },
+                    { name: 'Update by External ID', value: 'updateByExternalId', action: 'Update a connect link by external ID' },
+                ],
+                default: 'get',
+            },
+            // ── Operation: Stats ───────────────────────────────────────────────────
+            {
+                displayName: 'Operation',
+                name: 'operation',
+                type: 'options',
+                noDataExpression: true,
+                displayOptions: { show: { resource: ['stats'] } },
+                options: [
+                    { name: 'Get Accepted Calls', value: 'getAccepted', action: 'Get statistics for accepted calls' },
+                    { name: 'Get Missed Calls', value: 'getMissed', action: 'Get statistics for missed calls' },
+                ],
+                default: 'getAccepted',
+            },
+            // ── callId ─────────────────────────────────────────────────────────────
+            {
+                displayName: 'Call ID',
+                name: 'callId',
+                type: 'string',
+                required: true,
+                default: '',
+                displayOptions: { show: { resource: ['call'], operation: ['get', 'getTranscriptions'] } },
+            },
+            // ── connectLinkId ──────────────────────────────────────────────────────
+            {
+                displayName: 'Connect Link ID',
+                name: 'connectLinkId',
+                type: 'string',
+                required: true,
+                default: '',
+                displayOptions: {
+                    show: { resource: ['connectLink'], operation: ['get', 'update', 'delete'] },
+                },
+            },
+            // ── externalId ─────────────────────────────────────────────────────────
+            {
+                displayName: 'External ID',
+                name: 'externalId',
+                type: 'string',
+                required: true,
+                default: '',
+                description: 'Caller-supplied external ID for the connect link',
+                displayOptions: {
+                    show: { resource: ['connectLink'], operation: ['getByExternalId', 'updateByExternalId', 'deleteByExternalId'] },
+                },
+            },
+            // ── connectLinkBody (create) ───────────────────────────────────────────
+            {
+                displayName: 'Connect Link Data (JSON)',
+                name: 'connectLinkBody',
+                type: 'string',
+                required: true,
+                default: '{}',
+                placeholder: '{"externalId": "my-ID", "title": "My Link", "validTo": "2024-12-31T23:59:59Z"}',
+                description: 'JSON body. Supported fields: externalId, title, validFrom, validTo, firstName, lastName, email, queue.',
+                typeOptions: { rows: 3 },
+                displayOptions: { show: { resource: ['connectLink'], operation: ['create'] } },
+            },
+            // ── connectLinkBody (update) ───────────────────────────────────────────
+            {
+                displayName: 'Fields to Update (JSON)',
+                name: 'connectLinkBody',
+                type: 'string',
+                required: true,
+                default: '{}',
+                placeholder: '{"title": "New Title", "validTo": "2024-12-31T23:59:59Z"}',
+                description: 'JSON object with fields to update. Supported fields: title, validFrom, validTo, firstName, lastName, email, queue.',
+                typeOptions: { rows: 3 },
+                displayOptions: { show: { resource: ['connectLink'], operation: ['update', 'updateByExternalId'] } },
+            },
+            // ── cursor (call:getTranscriptions) ────────────────────────────────────
+            {
+                displayName: 'Cursor',
+                name: 'cursor',
+                type: 'string',
+                default: '',
+                description: 'Pagination cursor from the previous response',
+                displayOptions: { show: { resource: ['call'], operation: ['getTranscriptions'] } },
+            },
+            // ── from / to (stats) ─────────────────────────────────────────────────
+            {
+                displayName: 'From',
+                name: 'from',
+                type: 'string',
+                required: true,
+                default: '',
+                placeholder: '2024-01-01T00:00:00Z',
+                description: 'ISO date string — start of range (required)',
+                displayOptions: { show: { resource: ['stats'], operation: ['getAccepted', 'getMissed'] } },
+            },
+            {
+                displayName: 'To',
+                name: 'to',
+                type: 'string',
+                default: '',
+                placeholder: '2024-12-31T23:59:59Z',
+                description: 'ISO date string — end of range (defaults to now)',
+                displayOptions: { show: { resource: ['stats'], operation: ['getAccepted', 'getMissed'] } },
+            },
+            // ── excludeShortCalls / excludeTestCalls (stats:getAccepted) ──────────
+            {
+                displayName: 'Exclude Short Calls',
+                name: 'excludeShortCalls',
+                type: 'options',
+                options: [
+                    { name: 'No', value: '' },
+                    { name: 'Yes', value: 'true' },
+                ],
+                default: '',
+                displayOptions: { show: { resource: ['stats'], operation: ['getAccepted'] } },
+            },
+            {
+                displayName: 'Exclude Test Calls',
+                name: 'excludeTestCalls',
+                type: 'options',
+                options: [
+                    { name: 'No', value: '' },
+                    { name: 'Yes', value: 'true' },
+                ],
+                default: '',
+                displayOptions: { show: { resource: ['stats'], operation: ['getAccepted'] } },
+            },
+            // ── excludeShortQueueTime (stats:getMissed) ────────────────────────────
+            {
+                displayName: 'Exclude Short Queue Time',
+                name: 'excludeShortQueueTime',
+                type: 'options',
+                options: [
+                    { name: 'No', value: '' },
+                    { name: 'Yes', value: 'true' },
+                ],
+                default: '',
+                displayOptions: { show: { resource: ['stats'], operation: ['getMissed'] } },
+            },
+        ],
+        usableAsTool: true,
+    };
+    async execute() {
+        const items = this.getInputData();
+        const credentials = await this.getCredentials('bambuserApi');
+        const origin = (0, resolveOrigin_1.resolveOrigin)(credentials.baseUrl, credentials.region);
+        const handlers = buildOperationHandlers(this, `${origin}/v1`);
+        const results = await Promise.all(items.map(async (_, i) => {
+            const resource = this.getNodeParameter('resource', i);
+            const operation = this.getNodeParameter('operation', i);
+            const key = `${resource}:${operation}`;
+            const handler = handlers[key];
+            if (!handler) {
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation "${operation}" for resource "${resource}"`, { itemIndex: i });
+            }
+            const requestOptions = await handler(i);
+            const responseData = await this.helpers.httpRequestWithAuthentication.call(this, 'bambuserApi', requestOptions) ?? { success: true };
+            return { json: responseData };
+        }));
+        return [results];
+    }
+}
+exports.BambuserCalls = BambuserCalls;

package/dist/nodes/BambuserCalls/bambuser-live.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 73 72">
+  <circle cx="36.3354" cy="36" r="36" fill="#FB752B"/>
+</svg>