n8n-nodes-orbitpage 0.1.0

package/dist/nodes/OrbitPage/transport.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orbitPageApiRequest = orbitPageApiRequest;
+exports.fullResponse = fullResponse;
+exports.responseRevision = responseRevision;
+function credentialBaseUrl(baseUrl) {
+    const normalized = String(baseUrl || 'https://orbitpage.com').trim().replace(/\/+$/, '');
+    const parsed = new URL(normalized);
+    const localDevelopment = ['localhost', '127.0.0.1', '::1'].includes(parsed.hostname);
+    if (parsed.protocol !== 'https:' && !(parsed.protocol === 'http:' && localDevelopment)) {
+        throw new Error('OrbitPage Base URL must use HTTPS. HTTP is allowed only for local development.');
+    }
+    return parsed;
+}
+async function orbitPageApiRequest(context, request) {
+    const credentials = await context.getCredentials('orbitPageApi');
+    const baseUrl = credentialBaseUrl(credentials.baseUrl);
+    if (!request.path.startsWith('/') || request.path.startsWith('//')) {
+        throw new Error('OrbitPage API paths must be relative paths beginning with one slash.');
+    }
+    const options = {
+        method: request.method,
+        url: `${baseUrl.toString().replace(/\/$/, '')}/api/v1${request.path}`,
+        qs: request.qs,
+        headers: request.headers,
+        body: request.body,
+        json: true,
+        returnFullResponse: request.returnFullResponse,
+        sendCredentialsOnCrossOriginRedirect: false,
+        allowedDomains: baseUrl.hostname,
+    };
+    return await context.helpers.httpRequestWithAuthentication.call(context, 'orbitPageApi', options);
+}
+function fullResponse(value) {
+    if (!value || typeof value !== 'object' || !('headers' in value) || !('statusCode' in value)) {
+        throw new Error('OrbitPage did not return the expected HTTP response metadata.');
+    }
+    return value;
+}
+function responseRevision(response) {
+    var _a, _b;
+    const etag = (_a = response.headers.etag) !== null && _a !== void 0 ? _a : response.headers.ETag;
+    if (typeof etag === 'string' && etag.trim())
+        return etag;
+    const revisionHeader = (_b = response.headers['x-orbitpage-revision']) !== null && _b !== void 0 ? _b : response.headers['X-OrbitPage-Revision'];
+    if (typeof revisionHeader === 'string' && revisionHeader.trim())
+        return revisionHeader;
+    if (response.body &&
+        typeof response.body === 'object' &&
+        !Array.isArray(response.body) &&
+        'revision' in response.body) {
+        const revision = response.body.revision;
+        if (typeof revision === 'number' || typeof revision === 'string')
+            return String(revision);
+    }
+    throw new Error('The revision preflight response did not include an ETag or revision.');
+}
+//# sourceMappingURL=transport.js.map

package/dist/nodes/OrbitPage/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../nodes/OrbitPage/transport.ts"],"names":[],"mappings":";;AA2BA,kDA2BC;AAED,oCAKC;AAED,4CAgBC;AA9DD,SAAS,iBAAiB,CAAC,OAAgB;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,MAAM,gBAAgB,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrF,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,gBAAgB,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAEM,KAAK,UAAU,mBAAmB,CACxC,OAA6B,EAC7B,OAAyB;IAEzB,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,OAAO,GAAwB;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,OAAO,CAAC,IAAI,EAAE;QACrE,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,IAAI;QACV,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,oCAAoC,EAAE,KAAK;QAC3C,cAAc,EAAE,OAAO,CAAC,QAAQ;KAChC,CAAC;IAEF,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,6BAA6B,CAAC,IAAI,CAC9D,OAAO,EACP,cAAc,EACd,OAAO,CACP,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,KAA6B,CAAC;AACtC,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAA8B;;IAC9D,MAAM,IAAI,GAAG,MAAA,QAAQ,CAAC,OAAO,CAAC,IAAI,mCAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,cAAc,GACnB,MAAA,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,mCAAI,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACtF,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,EAAE;QAAE,OAAO,cAAc,CAAC;IACvF,IACC,QAAQ,CAAC,IAAI;QACb,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ;QACjC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7B,UAAU,IAAI,QAAQ,CAAC,IAAI,EAC1B,CAAC;QACF,MAAM,QAAQ,GAAI,QAAQ,CAAC,IAAoB,CAAC,QAAQ,CAAC;QACzD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3F,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;AACzF,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { INodeExecutionData, INodeType, INodeTypeDescription, IPollFunctions } from 'n8n-workflow';
+export declare class OrbitPageTrigger implements INodeType {
+    description: INodeTypeDescription;
+    poll(this: IPollFunctions): Promise<INodeExecutionData[][] | null>;
+}

package/dist/nodes/OrbitPageTrigger/OrbitPageTrigger.node.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrbitPageTrigger = void 0;
+const node_crypto_1 = require("node:crypto");
+const n8n_workflow_1 = require("n8n-workflow");
+const transport_1 = require("../OrbitPage/transport");
+const eventPaths = {
+    workspaceRevisionChanged: '/workspace',
+    publicationChanged: '/publication',
+    domainChanged: '/domains',
+    shopChanged: '/shop',
+};
+function stableValue(value) {
+    if (Array.isArray(value))
+        return value.map(stableValue);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => [key, stableValue(nested)]));
+    }
+    return value;
+}
+function observedValue(event, response) {
+    if (event === 'workspaceRevisionChanged' &&
+        response &&
+        typeof response === 'object' &&
+        !Array.isArray(response)) {
+        const workspace = response;
+        return { revision: workspace.revision };
+    }
+    return response;
+}
+function fingerprint(value) {
+    return (0, node_crypto_1.createHash)('sha256').update(JSON.stringify(stableValue(value))).digest('hex');
+}
+function outputValue(value) {
+    return value;
+}
+class OrbitPageTrigger {
+    constructor() {
+        this.description = {
+            displayName: 'OrbitPage Trigger',
+            name: 'orbitPageTrigger',
+            icon: {
+                light: 'file:../../icons/orbitpage.svg',
+                dark: 'file:../../icons/orbitpage.dark.svg',
+            },
+            group: ['trigger'],
+            version: 1,
+            subtitle: '={{$parameter["event"]}}',
+            description: 'Starts a workflow when selected OrbitPage state changes',
+            defaults: { name: 'OrbitPage Trigger' },
+            usableAsTool: true,
+            inputs: [],
+            outputs: [n8n_workflow_1.NodeConnectionTypes.Main],
+            credentials: [{ name: 'orbitPageApi', required: true }],
+            polling: true,
+            properties: [
+                {
+                    displayName: 'Poll Times',
+                    name: 'pollTimes',
+                    type: 'fixedCollection',
+                    typeOptions: { multipleValues: true, multipleValueButtonText: 'Add Poll Time' },
+                    default: { item: [{ mode: 'everyMinute' }] },
+                    description: 'Time at which polling should occur',
+                    placeholder: 'Add Poll Time',
+                    options: n8n_workflow_1.cronNodeOptions,
+                },
+                {
+                    displayName: 'Event',
+                    name: 'event',
+                    type: 'options',
+                    options: [
+                        {
+                            name: 'Custom Domain Changed',
+                            value: 'domainChanged',
+                            description: 'DNS requirements, verification or active domain changed',
+                        },
+                        {
+                            name: 'Publication State Changed',
+                            value: 'publicationChanged',
+                            description: 'Draft revision, published revision, status or public URL changed',
+                        },
+                        {
+                            name: 'Shop State Changed',
+                            value: 'shopChanged',
+                            description: 'Products, commerce connection, appearance or publication state changed',
+                        },
+                        {
+                            name: 'Workspace Revision Changed',
+                            value: 'workspaceRevisionChanged',
+                            description: 'The editable workspace revision changed',
+                        },
+                    ],
+                    default: 'workspaceRevisionChanged',
+                },
+                {
+                    displayName: 'Emit Initial State',
+                    name: 'emitInitialState',
+                    type: 'boolean',
+                    default: false,
+                    description: 'Whether the first production poll should emit the current state. Manual tests always return the current state.',
+                },
+            ],
+        };
+    }
+    async poll() {
+        const event = String(this.getNodeParameter('event'));
+        const path = eventPaths[event];
+        if (!path) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unsupported OrbitPage trigger event: ${event}`);
+        }
+        const current = await (0, transport_1.orbitPageApiRequest)(this, { method: 'GET', path });
+        const signature = fingerprint(observedValue(event, current));
+        const staticData = this.getWorkflowStaticData('node');
+        const previousSignature = typeof staticData.signature === 'string' ? staticData.signature : null;
+        const manual = this.getMode() === 'manual';
+        const emitInitialState = this.getNodeParameter('emitInitialState', false) === true;
+        if (!manual)
+            staticData.signature = signature;
+        if (!manual && previousSignature === null && !emitInitialState)
+            return null;
+        if (!manual && previousSignature === signature)
+            return null;
+        return [
+            this.helpers.returnJsonArray([
+                {
+                    event,
+                    initial: previousSignature === null,
+                    previousSignature,
+                    currentSignature: signature,
+                    observedAt: new Date().toISOString(),
+                    data: outputValue(current),
+                },
+            ]),
+        ];
+    }
+}
+exports.OrbitPageTrigger = OrbitPageTrigger;
+//# sourceMappingURL=OrbitPageTrigger.node.js.map

package/dist/nodes/OrbitPageTrigger/OrbitPageTrigger.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitPageTrigger.node.js","sourceRoot":"","sources":["../../../nodes/OrbitPageTrigger/OrbitPageTrigger.node.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -0,0 +1,77 @@
+{
+    "name": "n8n-nodes-orbitpage",
+    "version": "0.1.0",
+    "description": "n8n community nodes for the complete OrbitPage Automation REST API",
+    "license": "MIT",
+    "homepage": "https://orbitpage.com/en-US/docs/api-tokens",
+    "keywords": [
+        "n8n-community-node-package",
+        "n8n",
+        "orbitpage",
+        "automation",
+        "website-builder",
+        "link-in-bio"
+    ],
+    "author": {
+        "name": "Paolo Ronco",
+        "email": "paolo.ronco2000@gmail.com"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/paoloronco/n8n-nodes-orbitpage.git"
+    },
+    "bugs": {
+        "url": "https://github.com/paoloronco/n8n-nodes-orbitpage/issues"
+    },
+    "engines": {
+        "node": ">=22.0.0"
+    },
+    "scripts": {
+        "build": "n8n-node build",
+        "build:watch": "tsc --watch",
+        "dev": "n8n-node dev",
+        "lint": "n8n-node lint",
+        "lint:fix": "n8n-node lint --fix",
+        "test": "vitest run test",
+        "docs:generate": "node scripts/generate-operation-docs.cjs",
+        "docs:check": "node scripts/generate-operation-docs.cjs --check",
+        "check": "npm run lint && npm run build && npm run docs:check && npm run test",
+        "release": "n8n-node release",
+        "prepublishOnly": "n8n-node prerelease"
+    },
+    "files": [
+        "dist",
+        "docs",
+        "examples",
+        "README.md",
+        "CHANGELOG.md",
+        "LICENSE.md"
+    ],
+    "n8n": {
+        "n8nNodesApiVersion": 1,
+        "strict": true,
+        "credentials": [
+            "dist/credentials/OrbitPageApi.credentials.js"
+        ],
+        "nodes": [
+            "dist/nodes/OrbitPage/OrbitPage.node.js",
+            "dist/nodes/OrbitPageTrigger/OrbitPageTrigger.node.js"
+        ]
+    },
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "devDependencies": {
+        "@n8n/node-cli": "0.42.0",
+        "eslint": "9.39.4",
+        "n8n-workflow": "2.16.0",
+        "prettier": "3.8.3",
+        "release-it": "20.2.0",
+        "typescript": "5.9.3",
+        "vitest": "4.1.4"
+    },
+    "peerDependencies": {
+        "n8n-workflow": "*"
+    }
+}

package/docs/OPERATIONS.md

@@ -0,0 +1,184 @@
+# OrbitPage operation matrix
+
+This file is generated from the typed n8n operation catalog. It covers every operation in the OrbitPage OpenAPI 3.1 contract at `https://orbitpage.com/api/openapi.json`.
+
+All paths below are relative to `/api/v1`. Guided operations authenticate with the selected **OrbitPage API** credential. Operations marked with a revision source automatically read that endpoint and send its latest `ETag` or revision as `If-Match`.
+
+## AI
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Allowance | GET | `/ai/allowance` | `ai:read` | none | — |
+| Plan Changes | POST | `/ai/plan` | `ai:write` | required | — |
+| Commit Changes | POST | `/ai/commit` | `ai:write` | required | — |
+
+## Analytics
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Analytics | GET | `/analytics` | `analytics:read` | none | — |
+
+## Backup and Version
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Many Versions | GET | `/versions` | `backup:read` | none | — |
+| Restore Version | POST | `/versions/{revision}/restore` | `backup:write` | none | `/draft` |
+| Export Backup | GET | `/backup` | `backup:read` | none | — |
+| Restore Backup | POST | `/backup/restore` | `backup:write` | required | `/draft` |
+
+## Billing
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Billing | GET | `/billing` | `billing:read` | none | — |
+| Create Checkout | POST | `/billing/checkout` | `billing:write` | required | — |
+| Create Portal Session | POST | `/billing/portal` | `billing:write` | optional | — |
+| Redeem Promotion Code | POST | `/billing/promotion-code` | `billing:write` | required | — |
+
+## Block
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Many Blocks | GET | `/links` | `links:read` | none | — |
+| Replace Blocks | PUT | `/links` | `links:write` | required | `/links` |
+| Update Block | PATCH | `/links/{linkId}` | `links:write` | required | `/links` |
+
+## Custom Domain
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Domain | GET | `/domains` | `domains:read` | none | — |
+| Connect Domain | POST | `/domains` | `domains:write` | required | — |
+| Refresh Domain | POST | `/domains/refresh` | `domains:write` | none | — |
+| Disconnect Domain | DELETE | `/domains` | `domains:write` | none | — |
+
+## Media
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Many Media Items | GET | `/media` | `media:read` | none | — |
+| Clean Up Media | POST | `/media/cleanup` | `media:write` | optional | — |
+| Reserve Video Upload | POST | `/media/uploads/reserve` | `media:write` | required | — |
+| Finalize Video Upload | POST | `/media/uploads/finalize` | `media:write` | required | — |
+| Abort Video Upload | DELETE | `/media/uploads` | `media:write` | required | — |
+
+## Newsletter
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Newsletter | GET | `/newsletter` | `newsletter:read` | none | — |
+| Update SMTP Settings | PUT | `/newsletter/settings` | `newsletter:write` | required | — |
+| Test SMTP Settings | POST | `/newsletter/settings/test` | `newsletter:write` | required | — |
+| Add Subscriber | POST | `/newsletter/subscribers` | `newsletter:write` | required | — |
+| Remove Subscriber | DELETE | `/newsletter/subscribers/{subscriberId}` | `newsletter:write` | none | — |
+| Save Campaign | POST | `/newsletter/campaigns` | `newsletter:write` | required | — |
+| Delete Campaign | DELETE | `/newsletter/campaigns/{campaignId}` | `newsletter:write` | none | — |
+| Send or Schedule Campaign | POST | `/newsletter/campaigns/{campaignId}/send` | `newsletter:write` | optional | — |
+| Cancel Campaign | DELETE | `/newsletter/campaigns/{campaignId}/send` | `newsletter:write` | none | — |
+
+## Operator
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Overview | GET | `/operator/overview` | `operator:read` | none | — |
+| Get Many CRM Prospects | GET | `/operator/crm` | `operator:read` | none | — |
+| Create CRM Prospect | POST | `/operator/crm` | `operator:write` | required | — |
+| Get CRM Prospect | GET | `/operator/crm/{prospectId}` | `operator:read` | none | — |
+| Update CRM Prospect | PATCH | `/operator/crm/{prospectId}` | `operator:write` | required | — |
+| Save CRM Note | POST | `/operator/crm/{prospectId}/notes` | `operator:write` | required | — |
+| Save CRM Message | POST | `/operator/crm/{prospectId}/messages` | `operator:write` | required | — |
+| Update CRM Activity | PATCH | `/operator/crm/{prospectId}/activities/{activityId}` | `operator:write` | required | — |
+| Link CRM Workspace | POST | `/operator/crm/{prospectId}/link` | `operator:write` | required | — |
+| Onboard CRM Prospect | POST | `/operator/crm/{prospectId}/onboard` | `operator:write` | required | — |
+| Preview Account Email | GET | `/operator/crm/{prospectId}/account-email` | `operator:read` | none | — |
+| Send Account Email | POST | `/operator/crm/{prospectId}/account-email` | `operator:write` | required | — |
+| Get Many Promotion Codes | GET | `/operator/promotion-codes` | `operator:read` | none | — |
+| Create Promotion Code | POST | `/operator/promotion-codes` | `operator:write` | required | — |
+| Update Promotion Code | PATCH | `/operator/promotion-codes/{promotionCodeId}` | `operator:write` | required | — |
+| Moderate Tenant | POST | `/operator/tenants/{tenantId}/moderation` | `operator:write` | required | — |
+| Change Tenant Plan | POST | `/operator/tenants/{tenantId}/plan` | `operator:write` | required | — |
+| Create Demo Access | POST | `/operator/tenants/{tenantId}/demo-access` | `operator:write` | required | — |
+| Revoke Demo Access | DELETE | `/operator/tenants/{tenantId}/demo-access` | `operator:write` | required | — |
+| Delete Tenant | DELETE | `/operator/tenants/{tenantId}` | `operator:write` | required | — |
+
+## Page
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Many Pages | GET | `/pages` | `pages:read` | none | — |
+| Replace Pages | PUT | `/pages` | `pages:write` | required | `/pages` |
+
+## Profile
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Profile | GET | `/profile` | `profile:read` | none | — |
+| Update Profile | PATCH | `/profile` | `profile:write` | required | `/profile` |
+
+## Publication
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Publication Status | GET | `/publication` | `publication:read` | none | — |
+| Publish Page | POST | `/publication` | `publication:write` | none | — |
+
+## Settings
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Settings | GET | `/settings` | `settings:read` | none | — |
+| Update Menu | PUT | `/settings/menu` | `settings:write` | required | `/settings` |
+| Update Privacy | PUT | `/settings/privacy` | `settings:write` | required | `/settings` |
+| Create Text File | POST | `/settings/text-files` | `settings:write` | required | `/settings` |
+| Update Text File | PUT | `/settings/text-files/{key}` | `settings:write` | required | `/settings` |
+| Delete Text File | DELETE | `/settings/text-files/{key}` | `settings:write` | none | `/settings` |
+| Generate Sitemap | POST | `/settings/sitemap` | `settings:write` | none | `/settings` |
+
+## Shop
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Shop | GET | `/shop` | `shop:read` | none | — |
+| Connect Shop | POST | `/shop/connect` | `shop:write` | optional | — |
+| Save Product | POST | `/shop/products` | `shop:write` | required | — |
+| Delete Product | DELETE | `/shop/products/{productId}` | `shop:write` | none | — |
+| Update Appearance | PUT | `/shop/appearance` | `shop:write` | required | — |
+| Publish Shop | POST | `/shop/publish` | `shop:write` | none | — |
+| Unpublish Shop | POST | `/shop/unpublish` | `shop:write` | none | — |
+| Reserve File Upload | POST | `/shop/uploads/reserve` | `shop:write` | required | — |
+| Finalize File Upload | POST | `/shop/uploads/finalize` | `shop:write` | required | — |
+
+## Team
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Team | GET | `/team` | `team:read` | none | — |
+| Invite Member | POST | `/team/invitations` | `team:write` | required | — |
+| Update Member | PATCH | `/team/members/{memberUid}` | `team:write` | required | — |
+| Remove Member | DELETE | `/team/members/{memberUid}` | `team:write` | none | — |
+| Revoke Invitation | DELETE | `/team/invitations/{invitationId}` | `team:write` | none | — |
+
+## Theme
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Theme | GET | `/theme` | `theme:read` | none | — |
+| Replace Theme | PUT | `/theme` | `theme:write` | required | `/theme` |
+
+## Workspace
+
+| Operation | Method | Path | Required scope | Body | Revision source |
+| --- | --- | --- | --- | --- | --- |
+| Get Workspace | GET | `/workspace` | `workspace:read` | none | — |
+| Get Complete Draft | GET | `/draft` | `workspace:read` | none | — |
+
+## n8n convenience operations
+
+| Operation | Resource | Behavior |
+| --- | --- | --- |
+| Upload Video Binary | media | Reserve, upload and finalize an n8n MP4 or WebM binary in one operation |
+| Upload Product File Binary | shop | Reserve, upload and finalize an n8n binary for a digital product in one operation |
+| Custom API Request | advanced | Call a relative OrbitPage API v1 path while keeping authentication in the credential |
+
+API operations: **84**. n8n convenience operations: **3**.

package/examples/read-workspace.json

@@ -0,0 +1,41 @@
+{
+  "name": "OrbitPage - Read workspace",
+  "nodes": [
+    {
+      "parameters": {},
+      "id": "28f851c6-18d0-49d5-a1bd-38135ef09030",
+      "name": "When clicking Execute Workflow",
+      "type": "n8n-nodes-base.manualTrigger",
+      "typeVersion": 1,
+      "position": [260, 300]
+    },
+    {
+      "parameters": {
+        "resource": "workspace",
+        "operation": "getWorkspace",
+        "options": {}
+      },
+      "id": "023da1b6-7a94-4870-93c4-8c0211cfad65",
+      "name": "Get OrbitPage Workspace",
+      "type": "n8n-nodes-orbitpage.orbitPage",
+      "typeVersion": 1,
+      "position": [500, 300],
+      "credentials": {
+        "orbitPageApi": {
+          "id": "REPLACE_WITH_YOUR_CREDENTIAL_ID",
+          "name": "OrbitPage API account"
+        }
+      }
+    }
+  ],
+  "connections": {
+    "When clicking Execute Workflow": {
+      "main": [[{ "node": "Get OrbitPage Workspace", "type": "main", "index": 0 }]]
+    }
+  },
+  "active": false,
+  "settings": {},
+  "versionId": "3c82ccb4-bd33-4266-9d40-a0c4685e917c",
+  "meta": { "templateCredsSetupCompleted": false },
+  "tags": []
+}

package/examples/watch-publication.json

@@ -0,0 +1,29 @@
+{
+  "name": "OrbitPage - Watch publication",
+  "nodes": [
+    {
+      "parameters": {
+        "pollTimes": { "item": [{ "mode": "everyMinute" }] },
+        "event": "publicationChanged",
+        "emitInitialState": false
+      },
+      "id": "df1b8386-a861-45dd-b7bd-10b6b292aab5",
+      "name": "When OrbitPage Publication Changes",
+      "type": "n8n-nodes-orbitpage.orbitPageTrigger",
+      "typeVersion": 1,
+      "position": [300, 300],
+      "credentials": {
+        "orbitPageApi": {
+          "id": "REPLACE_WITH_YOUR_CREDENTIAL_ID",
+          "name": "OrbitPage API account"
+        }
+      }
+    }
+  ],
+  "connections": {},
+  "active": false,
+  "settings": {},
+  "versionId": "6ba2c023-7054-4ec9-8cb2-34ef8bd57fb1",
+  "meta": { "templateCredsSetupCompleted": false },
+  "tags": []
+}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "n8n-nodes-orbitpage",
+  "version": "0.1.0",
+  "description": "n8n community nodes for the complete OrbitPage Automation REST API",
+  "license": "MIT",
+  "homepage": "https://orbitpage.com/en-US/docs/api-tokens",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "orbitpage",
+    "automation",
+    "website-builder",
+    "link-in-bio"
+  ],
+  "author": {
+    "name": "Paolo Ronco",
+    "email": "paolo.ronco2000@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paoloronco/n8n-nodes-orbitpage.git"
+  },
+  "bugs": {
+    "url": "https://github.com/paoloronco/n8n-nodes-orbitpage/issues"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "n8n-node build",
+    "build:watch": "tsc --watch",
+    "dev": "n8n-node dev",
+    "lint": "n8n-node lint",
+    "lint:fix": "n8n-node lint --fix",
+    "test": "vitest run test",
+    "docs:generate": "node scripts/generate-operation-docs.cjs",
+    "docs:check": "node scripts/generate-operation-docs.cjs --check",
+    "check": "npm run lint && npm run build && npm run docs:check && npm run test",
+    "release": "n8n-node release",
+    "prepublishOnly": "n8n-node prerelease"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "examples",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE.md"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "strict": true,
+    "credentials": [
+      "dist/credentials/OrbitPageApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/OrbitPage/OrbitPage.node.js",
+      "dist/nodes/OrbitPageTrigger/OrbitPageTrigger.node.js"
+    ]
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@n8n/node-cli": "0.42.0",
+    "eslint": "9.39.4",
+    "n8n-workflow": "2.16.0",
+    "prettier": "3.8.3",
+    "release-it": "20.2.0",
+    "typescript": "5.9.3",
+    "vitest": "4.1.4"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}