@heines/n8n-nodes-pax8 0.1.0 → 0.2.0

package/README.md

@@ -28,7 +28,6 @@ Use the **Pax8 OAuth2 (Client Credentials)** credential:
 - Token URL: `https://token-manager.pax8.com/oauth/token`
 - Audience: `https://api.pax8.com`
 
-### Access Token
 If you already have an access token, use **Pax8 API Token** and paste it.
 
 ## Node usage

package/dist/credentials/Pax8OAuth2Api.credentials.d.ts

@@ -3,6 +3,5 @@ export declare class Pax8OAuth2Api implements ICredentialType {
     name: string;
     displayName: string;
     documentationUrl: string;
-    extends: string[];
     properties: INodeProperties[];
 }

package/dist/credentials/Pax8OAuth2Api.credentials.js

@@ -5,8 +5,7 @@ class Pax8OAuth2Api {
     constructor() {
         this.name = 'pax8OAuth2Api';
         this.displayName = 'Pax8 OAuth2 (Client Credentials)';
-        this.documentationUrl = 'https://developer.pax8.com/'; // adjust if different
-        this.extends = ['oAuth2Api'];
+        this.documentationUrl = 'https://devx.pax8.com/reference/createaccesstoken';
         this.properties = [
             {
                 displayName: 'Client ID',
@@ -23,39 +22,21 @@ class Pax8OAuth2Api {
                 default: '',
                 required: true,
             },
-            {
-                displayName: 'Token URL',
-                name: 'accessTokenUrl',
-                type: 'string',
-                default: 'https://token-manager.pax8.com/oauth/token',
-                required: true,
-            },
             {
                 displayName: 'Audience',
                 name: 'audience',
                 type: 'string',
                 default: 'https://api.pax8.com',
-                description: 'Pax8 API audience to request in the token call.',
                 required: true,
+                description: 'Audience to request in the token call. For Pax8 Partner API use https://api.pax8.com',
             },
             {
-                displayName: 'Scope',
-                name: 'scope',
+                displayName: 'Token URL',
+                name: 'tokenUrl',
                 type: 'string',
-                default: '',
-                description: 'Optional. Leave blank unless Pax8 provided you scopes.',
-            },
-            {
-                displayName: 'Grant Type',
-                name: 'grantType',
-                type: 'hidden',
-                default: 'clientCredentials',
-            },
-            {
-                displayName: 'Authentication',
-                name: 'authentication',
-                type: 'hidden',
-                default: 'body',
+                default: 'https://api.pax8.com/v1/token',
+                required: true,
+                description: 'Pax8 access token endpoint.',
             },
         ];
     }

package/dist/index.d.ts

@@ -1,3 +1,2 @@
 export * from './nodes/Pax8/Pax8.node';
 export * from './credentials/Pax8OAuth2Api.credentials';
-export * from './credentials/Pax8ApiToken.credentials';

package/dist/index.js

@@ -16,4 +16,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./nodes/Pax8/Pax8.node"), exports);
 __exportStar(require("./credentials/Pax8OAuth2Api.credentials"), exports);
-__exportStar(require("./credentials/Pax8ApiToken.credentials"), exports);

package/dist/nodes/Pax8/Pax8.node.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Pax8 = void 0;
-const OP_DEFS = {
-    'createAccessToken': { resource: 'accessToken', method: 'POST', path: '/token', params: [], hasBody: true },
-    'createCompany': { resource: 'companies', method: 'POST', path: '/companies', params: [], hasBody: true },
+async function pax8HttpRequest(ctx, options) {
+    const token = await getPax8AccessToken(ctx);
+    options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}`, accept: 'application/json' };
+    return ctx.helpers.httpRequest(options);
+}
+const OP_DEFS = { 'createCompany': { resource: 'companies', method: 'POST', path: '/companies', params: [], hasBody: true },
     'get_companies_companyId': { resource: 'companies', method: 'GET', path: '/companies/{companyId}', params: [{ name: 'companyId', in: 'path', required: true }], hasBody: false },
     'findCompanies': { resource: 'companies', method: 'GET', path: '/companies', params: [{ name: 'page', in: 'query', required: false }, { name: 'size', in: 'query', required: false }, { name: 'sort', in: 'query', required: false }, { name: 'city', in: 'query', required: false }, { name: 'country', in: 'query', required: false }, { name: 'stateOrProvince', in: 'query', required: false }, { name: 'postalCode', in: 'query', required: false }, { name: 'selfServiceAllowed', in: 'query', required: false }, { name: 'billOnBehalfOfEnabled', in: 'query', required: false }, { name: 'orderApprovalRequired', in: 'query', required: false }, { name: 'status', in: 'query', required: false }], hasBody: false },
     'updateCompany': { resource: 'companies', method: 'PATCH', path: '/companies/{companyId}', params: [{ name: 'companyId', in: 'path', required: true }], hasBody: true },
@@ -104,11 +107,50 @@ const OP_DEFS = {
     'updateConfiguration': { resource: 'webhooks', method: 'POST', path: '/webhooks/{id}/configuration', params: [{ name: 'id', in: 'path', required: true }], hasBody: true },
     'updateStatus': { resource: 'webhooks', method: 'POST', path: '/webhooks/{id}/status', params: [{ name: 'id', in: 'path', required: true }], hasBody: true },
 };
+function pax8TokenExpiryMs(r) {
+    if (r.expires_at)
+        return new Date(r.expires_at).getTime();
+    if (typeof r.expires_in === 'number')
+        return Date.now() + r.expires_in * 1000;
+    return Date.now() + 23 * 60 * 60 * 1000;
+}
+async function getPax8AccessToken(ctx) {
+    const creds = (await ctx.getCredentials('pax8OAuth2Api'));
+    const tokenUrl = creds.tokenUrl || 'https://api.pax8.com/v1/token';
+    const audience = creds.audience || 'https://api.pax8.com';
+    const clientId = creds.clientId;
+    const clientSecret = creds.clientSecret;
+    const staticData = ctx.getWorkflowStaticData('global');
+    const cachedToken = staticData.pax8AccessToken;
+    const cachedExpiry = staticData.pax8AccessTokenExpiresAt;
+    // 60s safety margin
+    if (cachedToken && cachedExpiry && cachedExpiry - 60_000 > Date.now()) {
+        return cachedToken;
+    }
+    const tokenResp = (await ctx.helpers.httpRequest({
+        method: 'POST',
+        url: tokenUrl,
+        headers: {
+            accept: 'application/json',
+            'content-type': 'application/json',
+        },
+        body: {
+            audience,
+            grant_type: 'client_credentials',
+            client_id: clientId,
+            client_secret: clientSecret,
+        },
+        json: true,
+    }));
+    staticData.pax8AccessToken = tokenResp.access_token;
+    staticData.pax8AccessTokenExpiresAt = pax8TokenExpiryMs(tokenResp);
+    return tokenResp.access_token;
+}
 function applyPathParams(endpoint, params) {
     let result = endpoint;
     for (const [key, value] of Object.entries(params)) {
-        result = result.replaceAll(`{${key}}`, encodeURIComponent(String(value)));
-        result = result.replaceAll(`:${key}`, encodeURIComponent(String(value)));
+        result = result.split(`{${key}}`).join(encodeURIComponent(String(value)));
+        result = result.split(`:${key}`).join(encodeURIComponent(String(value)));
     }
     return result;
 }
@@ -161,21 +203,12 @@ class Pax8 {
             inputs: ['main'],
             outputs: ['main'],
             credentials: [
-                { name: 'pax8OAuth2Api', required: false },
-                { name: 'pax8ApiToken', required: false },
-            ],
-            properties: [
                 {
-                    displayName: 'Authentication',
-                    name: 'authMode',
-                    type: 'options',
-                    default: 'oauth2',
-                    options: [
-                        { name: 'OAuth2 (Client Credentials)', value: 'oauth2' },
-                        { name: 'Access Token', value: 'token' },
-                    ],
-                    description: 'Choose how the node should authenticate',
+                    name: 'pax8OAuth2Api',
+                    required: true,
                 },
+            ],
+            properties: [
                 {
                     displayName: 'Base URL',
                     name: 'baseUrl',
@@ -187,9 +220,8 @@ class Pax8 {
                     displayName: 'Resource',
                     name: 'resource',
                     type: 'options',
-                    default: 'accessToken',
+                    default: 'companies',
                     options: [
-                        { name: 'Access Token', value: 'accessToken' },
                         { name: 'Companies', value: 'companies' },
                         { name: 'Contacts', value: 'contacts' },
                         { name: 'Invoices', value: 'invoices' },
@@ -2880,7 +2912,6 @@ class Pax8 {
         this.methods = {
             loadOptions: {
                 async getCompanies() {
-                    const authMode = this.getCurrentNodeParameter('authMode') || 'oauth2';
                     const baseUrl = String(this.getCurrentNodeParameter('baseUrl') || 'https://api.pax8.com').replace(/\/$/, '');
                     const items = [];
                     let page = 0;
@@ -2888,14 +2919,7 @@ class Pax8 {
                     for (let guard = 0; guard < 20; guard++) {
                         const url = `${baseUrl}/companies`;
                         const options = { method: 'GET', url, json: true, qs: { page, size } };
-                        const res = authMode === 'oauth2'
-                            ? await this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options)
-                            : await (async () => {
-                                const creds = await this.getCredentials('pax8ApiToken');
-                                const token = creds.accessToken;
-                                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                                return this.helpers.httpRequest(options);
-                            })();
+                        const res = await pax8HttpRequest(this, options);
                         const batch = extractListItems(res) || [];
                         items.push(...batch);
                         if (batch.length < size)
@@ -2908,7 +2932,6 @@ class Pax8 {
                     })).filter((o) => o.value);
                 },
                 async getProducts() {
-                    const authMode = this.getCurrentNodeParameter('authMode') || 'oauth2';
                     const baseUrl = String(this.getCurrentNodeParameter('baseUrl') || 'https://api.pax8.com').replace(/\/$/, '');
                     const items = [];
                     let page = 0;
@@ -2916,14 +2939,7 @@ class Pax8 {
                     for (let guard = 0; guard < 20; guard++) {
                         const url = `${baseUrl}/products`;
                         const options = { method: 'GET', url, json: true, qs: { page, size } };
-                        const res = authMode === 'oauth2'
-                            ? await this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options)
-                            : await (async () => {
-                                const creds = await this.getCredentials('pax8ApiToken');
-                                const token = creds.accessToken;
-                                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                                return this.helpers.httpRequest(options);
-                            })();
+                        const res = await pax8HttpRequest(this, options);
                         const batch = extractListItems(res) || [];
                         items.push(...batch);
                         if (batch.length < size)
@@ -2936,7 +2952,6 @@ class Pax8 {
                     })).filter((o) => o.value);
                 },
                 async getSubscriptions() {
-                    const authMode = this.getCurrentNodeParameter('authMode') || 'oauth2';
                     const baseUrl = String(this.getCurrentNodeParameter('baseUrl') || 'https://api.pax8.com').replace(/\/$/, '');
                     const companyId = this.getCurrentNodeParameter('companyId');
                     const items = [];
@@ -2948,14 +2963,7 @@ class Pax8 {
                         if (companyId)
                             qs.companyId = companyId;
                         const options = { method: 'GET', url, json: true, qs };
-                        const res = authMode === 'oauth2'
-                            ? await this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options)
-                            : await (async () => {
-                                const creds = await this.getCredentials('pax8ApiToken');
-                                const token = creds.accessToken;
-                                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                                return this.helpers.httpRequest(options);
-                            })();
+                        const res = await pax8HttpRequest(this, options);
                         const batch = extractListItems(res) || [];
                         items.push(...batch);
                         if (batch.length < size)
@@ -2968,7 +2976,6 @@ class Pax8 {
                     })).filter((o) => o.value);
                 },
                 async getInvoices() {
-                    const authMode = this.getCurrentNodeParameter('authMode') || 'oauth2';
                     const baseUrl = String(this.getCurrentNodeParameter('baseUrl') || 'https://api.pax8.com').replace(/\/$/, '');
                     const companyId = this.getCurrentNodeParameter('companyId');
                     const items = [];
@@ -2980,14 +2987,7 @@ class Pax8 {
                         if (companyId)
                             qs.companyId = companyId;
                         const options = { method: 'GET', url, json: true, qs };
-                        const res = authMode === 'oauth2'
-                            ? await this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options)
-                            : await (async () => {
-                                const creds = await this.getCredentials('pax8ApiToken');
-                                const token = creds.accessToken;
-                                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                                return this.helpers.httpRequest(options);
-                            })();
+                        const res = await pax8HttpRequest(this, options);
                         const batch = extractListItems(res) || [];
                         items.push(...batch);
                         if (batch.length < size)
@@ -3000,7 +3000,6 @@ class Pax8 {
                     })).filter((o) => o.value);
                 },
                 async getQuotes() {
-                    const authMode = this.getCurrentNodeParameter('authMode') || 'oauth2';
                     const baseUrl = String(this.getCurrentNodeParameter('baseUrl') || 'https://api.pax8.com').replace(/\/$/, '');
                     const items = [];
                     let page = 0;
@@ -3008,14 +3007,7 @@ class Pax8 {
                     for (let guard = 0; guard < 20; guard++) {
                         const url = `${baseUrl}/v2/quotes`;
                         const options = { method: 'GET', url, json: true, qs: { page, limit } };
-                        const res = authMode === 'oauth2'
-                            ? await this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options)
-                            : await (async () => {
-                                const creds = await this.getCredentials('pax8ApiToken');
-                                const token = creds.accessToken;
-                                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                                return this.helpers.httpRequest(options);
-                            })();
+                        const res = await pax8HttpRequest(this, options);
                         const batch = extractListItems(res) || [];
                         items.push(...batch);
                         if (batch.length < limit)
@@ -3028,7 +3020,6 @@ class Pax8 {
                     })).filter((o) => o.value);
                 },
                 async getWebhooks() {
-                    const authMode = this.getCurrentNodeParameter('authMode') || 'oauth2';
                     const baseUrl = String(this.getCurrentNodeParameter('baseUrl') || 'https://api.pax8.com').replace(/\/$/, '');
                     const items = [];
                     let page = 0;
@@ -3036,14 +3027,7 @@ class Pax8 {
                     for (let guard = 0; guard < 20; guard++) {
                         const url = `${baseUrl}/webhooks`;
                         const options = { method: 'GET', url, json: true, qs: { page, size } };
-                        const res = authMode === 'oauth2'
-                            ? await this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options)
-                            : await (async () => {
-                                const creds = await this.getCredentials('pax8ApiToken');
-                                const token = creds.accessToken;
-                                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                                return this.helpers.httpRequest(options);
-                            })();
+                        const res = await pax8HttpRequest(this, options);
                         const batch = extractListItems(res) || [];
                         items.push(...batch);
                         if (batch.length < size)
@@ -3056,7 +3040,6 @@ class Pax8 {
                     })).filter((o) => o.value);
                 },
                 async getContacts() {
-                    const authMode = this.getCurrentNodeParameter('authMode') || 'oauth2';
                     const baseUrl = String(this.getCurrentNodeParameter('baseUrl') || 'https://api.pax8.com').replace(/\/$/, '');
                     const companyId = this.getCurrentNodeParameter('companyId');
                     if (!companyId)
@@ -3067,14 +3050,7 @@ class Pax8 {
                     for (let guard = 0; guard < 20; guard++) {
                         const url = `${baseUrl}/companies/${encodeURIComponent(companyId)}/contacts`;
                         const options = { method: 'GET', url, json: true, qs: { page, size } };
-                        const res = authMode === 'oauth2'
-                            ? await this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options)
-                            : await (async () => {
-                                const creds = await this.getCredentials('pax8ApiToken');
-                                const token = creds.accessToken;
-                                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                                return this.helpers.httpRequest(options);
-                            })();
+                        const res = await pax8HttpRequest(this, options);
                         const batch = extractListItems(res) || [];
                         items.push(...batch);
                         if (batch.length < size)
@@ -3093,7 +3069,6 @@ class Pax8 {
         const items = this.getInputData();
         const returnData = [];
         for (let i = 0; i < items.length; i++) {
-            const authMode = this.getNodeParameter('authMode', i);
             const baseUrl = this.getNodeParameter('baseUrl', i).replace(/\/$/, '');
             const resource = this.getNodeParameter('resource', i);
             const operation = this.getNodeParameter('operation', i);
@@ -3129,20 +3104,18 @@ class Pax8 {
                     url,
                     json: true,
                     qs: cleanQuery(qs),
+                    headers: {
+                        accept: 'application/json',
+                    },
                 };
                 if (def.hasBody) {
                     const body = this.getNodeParameter('body', i);
                     options.body = body;
                 }
-                if (authMode === 'oauth2') {
-                    return this.helpers.httpRequestWithAuthentication.call(this, 'pax8OAuth2Api', options);
-                }
-                else {
-                    const creds = await this.getCredentials('pax8ApiToken');
-                    const token = creds.accessToken;
-                    options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
-                    return this.helpers.httpRequest(options);
-                }
+                // Pax8 OAuth2 token (JSON body token endpoint) -> Bearer header
+                const token = await getPax8AccessToken(this);
+                options.headers = { ...(options.headers || {}), Authorization: `Bearer ${token}` };
+                return this.helpers.httpRequest(options);
             };
             if (pagination && returnAll) {
                 const all = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heines/n8n-nodes-pax8",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "n8n community node for the Pax8 API (Partner endpoints).",
   "keywords": [
     "n8n-community-node-package",
@@ -37,11 +37,13 @@
   "n8n": {
     "n8nNodesApiVersion": 1,
     "credentials": [
-      "dist/credentials/Pax8OAuth2Api.credentials.js",
-      "dist/credentials/Pax8ApiToken.credentials.js"
+      "dist/credentials/Pax8OAuth2Api.credentials.js"
     ],
     "nodes": [
       "dist/nodes/Pax8/Pax8.node.js"
     ]
+  },
+  "engines": {
+    "node": ">=18 <23"
   }
-}
+}