n8n-nodes-hudu 1.1.0 → 1.2.1

package/README.md

@@ -1,173 +1,199 @@
-# n8n-nodes-hudu
-
-This is an n8n community node that lets you use Hudu in your n8n workflows.
-
-[Hudu](https://www.hudu.com/) is a modern documentation platform for IT.
-
-[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
-
-This node was built against Hudu v2.34.4. Future versions of Hudu may not be 100% compatible without node updates.
-
-## Installation
-
-Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
-
-## Supported Resources & Operations
-
-### Activity Logs
-
-- Get all activity logs
-
-### API Info
-
-- Get API information
-
-### Articles
-
-- Create, read, update, and delete articles
-- List all articles with pagination support
-
-### Asset Layouts
-
-- Manage asset layout templates
-
-### Asset Passwords
-
-- Manage asset-related passwords
-
-### Assets
-
-- Create and manage assets
-- Link assets to companies
-
-### Cards
-
-- Manage cards in the system
-
-### Companies
-
-- Create a company
-- Delete a company
-- Get a company
-- Get all companies
-- Update a company
-
-### Expirations
-
-- Get all expirations with filtering support for:
-  - Company ID
-  - Expiration type
-  - Resource ID
-  - Resource type
-
-### Folders
-
-- Manage document folders
-
-### IP Addresses
-
-- Track and manage IP addresses
-
-### Magic Dash
-
-- Access Magic Dash functionality
-
-### Matchers
-
-- Configure and manage matchers
-
-### Networks
-
-- Manage network information
-
-### Password Folders
-
-- Organise and manage password folders
-
-### Procedures
-
-- Create and manage procedures
-- Handle procedure tasks
-
-### Public Photos
-
-- Manage public photos
-
-### Rack Storage
-
-- Manage rack storage
-- Handle rack storage items
-
-### Relations
-
-- Manage relationships between resources
-
-### Uploads
-
-- Handle file uploads
-- Get upload information
-- Delete uploads
-
-### Users
-
-- Get user information
-- List all users
-
-### Websites
-
-- Manage website records
-
-## Credentials
-
-To use this node, you need to:
-
-1. Have a Hudu instance
-2. Generate an API key in your Hudu settings
-3. Configure the node with:
-   - Base URL (e.g., https://your-hudu-instance.com)
-   - API Key
-
-## Features
-
-- Comprehensive date range filtering across resources:
-  - Articles: Filter by `created_at` and `updated_at`
-  - Asset Layouts: Filter by `created_at` and `updated_at`
-  - Asset Passwords: Filter by `created_at` and `updated_at`
-  - Assets: Filter by `created_at` and `updated_at`
-  - Companies: Filter by `created_at` and `updated_at`
-  - IP Addresses: Filter by `created_at` and `updated_at`
-  - Networks: Filter by `created_at` and `updated_at`
-  - Rack Storages: Filter by `created_at` and `updated_at`
-  - Rack Storage Items: Filter by `created_at` and `updated_at`
-  - Websites: Filter by `created_at` and `updated_at`
-- Pagination support for applicable resources
-- Comprehensive error handling
-- Advanced filtering capabilities for all resources
-- Supports both single and bulk operations
-- Automatic rate limiting and request optimisation
-- Standardised date range filter structure across all resources
-
-## Resources
-
-- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
-- [Hudu API Documentation](https://your-hudu-instance.com/api-docs)
-- [GitHub Repository](https://github.com/msoukhomlinov/n8n-nodes-hudu)
-
-## Contributing
-
-Contributions are welcome! If you'd like to contribute to this project:
-
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the branch (`git push origin feature/AmazingFeature`)
-5. Open a Pull Request
-
-Please ensure your PR:
-
-- Clearly describes the changes
-- Includes any relevant documentation updates
-- Follows the existing code style
-- Includes tests if applicable
-
-For bug reports or feature requests, please use the GitHub issues section.
+# n8n-nodes-hudu
+
+This n8n community node enables the integration of Hudu within your n8n workflows.
+
+[Hudu](https://www.hudu.com/) is a modern documentation platform for IT.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+This node was built against Hudu v2.34.4. Future versions of Hudu may not be 100% compatible without node updates.
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
+
+## Supported Resources & Operations
+
+### Activity Logs
+
+- Get all activity logs with filtering support
+- Filter by user, action, and date range
+
+### API Info
+
+- Get API information and version details
+
+### Articles
+
+- Create articles (name required, with optional content, company, folder, and sharing settings)
+- Update articles with flexible field updates
+- Archive and unarchive articles
+- Delete articles
+- Get single article details
+- List all articles with comprehensive filtering:
+  - Company ID
+  - Draft status
+  - Sharing status
+  - Folder ID
+  - Name exact match
+  - Fuzzy search
+  - Updated date range
+- Get article version history
+
+### Asset Layouts
+
+- Create and manage asset layout templates
+- Get layout fields and configurations
+- List all layouts with filtering support
+
+### Asset Passwords
+
+- Create and manage asset-related passwords
+- Link passwords to assets and companies
+- Filter by company and resource types
+
+### Assets
+
+- Create assets with custom fields
+- Link assets to companies
+- Update asset details
+- Archive/unarchive assets
+- Delete assets
+- Get single asset details
+- List all assets with filtering support:
+  - Company association
+  - Updated date range
+  - Custom field values
+
+### Cards
+
+- Lookup cards by integration
+- Jump to card functionality
+- Filter by integration type and slug
+
+### Companies
+
+- Create companies with detailed information
+- Update company details
+- Delete companies
+- Get single company information
+- List all companies with filtering support
+- Jump to company by integration
+
+### Expirations
+
+- Get all expirations with comprehensive filtering:
+  - Company ID
+  - Expiration type
+  - Resource ID
+  - Resource type
+  - Date ranges
+
+### Folders
+
+- Create and manage document folders
+- Support for nested folder structures
+- Filter by parent folder
+- Track child folder status
+
+### IP Addresses
+
+- Track and manage IP addresses
+- Link to companies and networks
+- Filter by company and network
+
+### Magic Dash
+
+- Access Magic Dash functionality
+- Filter by company and title
+- Delete by title and company name
+
+### Matchers
+
+- Configure and manage integration matchers
+- Filter by match status and company
+- Support for sync identifiers
+
+### Networks
+
+- Create and manage network information
+- Link to companies
+- Filter by company and attributes
+
+### Password Folders
+
+- Create and organize password folders
+- Support for folder hierarchy
+- Filter by parent folder
+
+### Procedures
+
+- Create and manage procedures
+- Create from templates
+- Duplicate existing procedures
+- Manage procedure tasks
+- Track task completion
+
+### Relations
+
+- Create and manage resource relationships
+- Support for various resource types
+- Filter by relationship types and directions
+
+### Users
+
+- Get user information
+- List all users
+- Filter by role and status
+
+### Websites
+
+- Manage website records
+- Link to companies
+- Filter by company and status
+
+## Credentials
+
+To use this node, you need to:
+
+1. Have a Hudu instance
+2. Generate an API key in your Hudu settings
+3. Configure the node with:
+   - Base URL (e.g., https://your-hudu-instance.com)
+   - API Key
+
+## Features
+
+- Comprehensive pagination support for all applicable resources
+- Robust error handling and debugging capabilities
+- Advanced filtering options with both API-side and client-side filtering
+- Support for both single and bulk operations
+- Dynamic loading of related resources (companies, layouts, etc.)
+- Date range filtering with preset options
+- Automatic type conversion and validation
+- Debug logging for troubleshooting
+
+## Resources
+
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+- [Hudu API Documentation](https://your-hudu-instance.com/api-docs)
+- [GitHub Repository](https://github.com/msoukhomlinov/n8n-nodes-hudu)
+
+## Contributing
+
+Contributions are welcome! If you'd like to contribute to this project:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+Please ensure your PR:
+
+- Clearly describes the changes
+- Includes any relevant documentation updates
+- Follows the existing code style
+- Includes tests if applicable
+
+For bug reports or feature requests, please use the GitHub issues section.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAGlD,MAAM,QAAQ,GAAG,IAAI,gBAAI,EAAE,CAAC;AACP,wBAAI;AAEZ,QAAA,KAAK,GAAgB,CAAC,QAAQ,CAAC,CAAC;AAEhC,QAAA,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,UAAU;KACxB;CACF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAGlD,MAAM,QAAQ,GAAG,IAAI,gBAAI,EAAE,CAAC;AACP,wBAAI;AAEZ,QAAA,KAAK,GAAgB,CAAC,QAAQ,CAAC,CAAC;AAEhC,QAAA,WAAW,GAAG;IAC1B;QACC,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,UAAU;KACvB;CACD,CAAC"}

package/dist/nodes/Hudu/Hudu.node.js

@@ -24,10 +24,13 @@ var __importStar = (this && this.__importStar) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Hudu = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const debugConfig_1 = require("./utils/debugConfig");
 const descriptions = __importStar(require("./descriptions"));
 const resources = __importStar(require("./resources"));
 const users_1 = require("./optionLoaders/users");
 const companies_1 = require("./optionLoaders/companies");
+const asset_layouts_1 = require("./optionLoaders/asset_layouts");
 class Hudu {
     constructor() {
         this.description = {
@@ -49,6 +52,12 @@ class Hudu {
                     required: true,
                 },
             ],
+            codex: {
+                categories: ['Communication'],
+                subcategories: {
+                    Communication: ['Documentation']
+                },
+            },
             requestDefaults: {
                 baseURL: '={{$credentials.baseUrl}}/api/v1',
                 headers: {
@@ -63,7 +72,7 @@ class Hudu {
                     noDataExpression: true,
                     options: [
                         {
-                            name: 'Activity Logs',
+                            name: 'Activity Log',
                             value: 'activity_logs',
                         },
                         {
@@ -71,85 +80,37 @@ class Hudu {
                             value: 'api_info',
                         },
                         {
-                            name: 'Articles',
+                            name: 'Article',
                             value: 'articles',
                         },
                         {
-                            name: 'Asset Layout',
-                            value: 'asset_layouts',
+                            name: 'Asset',
+                            value: 'assets',
                         },
                         {
-                            name: 'Asset Password',
-                            value: 'asset_passwords',
+                            name: 'Asset Layout',
+                            value: 'asset_layouts',
                         },
                         {
-                            name: 'Asset',
-                            value: 'assets',
+                            name: 'Asset Layout Field',
+                            value: 'asset_layout_fields',
                         },
                         {
-                            name: 'Card',
-                            value: 'cards',
+                            name: 'Asset Password',
+                            value: 'asset_passwords',
                         },
                         {
                             name: 'Company',
                             value: 'companies',
                         },
-                        {
-                            name: 'Expiration',
-                            value: 'expirations',
-                        },
                         {
                             name: 'Folder',
                             value: 'folders',
                         },
-                        {
-                            name: 'IP Address',
-                            value: 'ipAddresses',
-                        },
-                        {
-                            name: 'Magic Dash',
-                            value: 'magic_dash',
-                        },
-                        {
-                            name: 'Matcher',
-                            value: 'matchers',
-                        },
-                        {
-                            name: 'Network',
-                            value: 'networks',
-                        },
-                        {
-                            name: 'Password Folder',
-                            value: 'password_folders',
-                        },
-                        {
-                            name: 'Procedure',
-                            value: 'procedures',
-                        },
-                        {
-                            name: 'Procedure Task',
-                            value: 'procedure_tasks',
-                        },
-                        {
-                            name: 'Public Photo',
-                            value: 'public_photos',
-                        },
-                        {
-                            name: 'Rack Storage',
-                            value: 'rack_storages',
-                        },
-                        {
-                            name: 'Rack Storage Item',
-                            value: 'rack_storage_items',
-                        },
                         {
                             name: 'Relation',
                             value: 'relations',
                         },
-                        {
-                            name: 'Upload',
-                            value: 'uploads',
-                        },
                         {
                             name: 'User',
                             value: 'users',
@@ -165,6 +126,7 @@ class Hudu {
                 ...descriptions.apiInfoOperations,
                 ...descriptions.articlesOperations,
                 ...descriptions.assetLayoutOperations,
+                ...descriptions.assetLayoutFieldOperations,
                 ...descriptions.assetPasswordOperations,
                 ...descriptions.assetsOperations,
                 ...descriptions.cardsOperations,
@@ -189,6 +151,7 @@ class Hudu {
                 ...descriptions.apiInfoFields,
                 ...descriptions.articlesFields,
                 ...descriptions.assetLayoutFields,
+                ...descriptions.assetLayoutFieldFields,
                 ...descriptions.assetPasswordFields,
                 ...descriptions.assetsFields,
                 ...descriptions.cardsFields,
@@ -215,18 +178,33 @@ class Hudu {
             loadOptions: {
                 getUsers: users_1.getUsers,
                 getCompanies: companies_1.getCompanies,
+                getAssetLayouts: asset_layouts_1.getAssetLayouts,
+                getAssetLayoutFields: asset_layouts_1.getAssetLayoutFields,
+                getAssetLayoutFieldValues: asset_layouts_1.getAssetLayoutFieldValues,
             },
         };
     }
     async execute() {
         const items = this.getInputData();
         const returnData = [];
-        let operation;
+        if (debugConfig_1.DEBUG_CONFIG.NODE_INPUT) {
+            (0, debugConfig_1.debugLog)('Node Execution - Input Items', {
+                itemCount: items.length,
+                items,
+            });
+        }
         for (let i = 0; i < items.length; i++) {
             try {
-                let responseData;
                 const resource = this.getNodeParameter('resource', i);
-                operation = this.getNodeParameter('operation', i);
+                const operation = this.getNodeParameter('operation', i);
+                if (debugConfig_1.DEBUG_CONFIG.NODE_INPUT) {
+                    (0, debugConfig_1.debugLog)(`Node Execution - Item ${i}`, {
+                        resource,
+                        operation,
+                        itemData: items[i],
+                    });
+                }
+                let responseData = {};
                 switch (resource) {
                     case 'activity_logs':
                         responseData = await resources.handleActivityLogsOperation.call(this, operation, i);
@@ -240,6 +218,9 @@ class Hudu {
                     case 'asset_layouts':
                         responseData = await resources.handleAssetLayoutOperation.call(this, operation, i);
                         break;
+                    case 'asset_layout_fields':
+                        responseData = await resources.handleAssetLayoutFieldOperation.call(this, operation, i);
+                        break;
                     case 'asset_passwords':
                         responseData = await resources.handleAssetPasswordOperation.call(this, operation, i);
                         break;
@@ -301,32 +282,44 @@ class Hudu {
                         responseData = await resources.handleWebsitesOperation.call(this, operation, i);
                         break;
                     default:
-                        throw new Error(`The resource "${resource}" is not known!`);
+                        throw new n8n_workflow_1.NodeOperationError(this.getNode(), `The resource "${resource}" is not known!`);
                 }
-                if (Array.isArray(responseData)) {
-                    returnData.push(...responseData.map((item) => ({
-                        json: item,
-                        pairedItem: { item: i },
-                    })));
-                }
-                else {
-                    returnData.push({
-                        json: responseData,
-                        pairedItem: { item: i },
+                const executionData = this.helpers.returnJsonArray(responseData).map((item) => ({
+                    ...item,
+                    pairedItem: { item: i },
+                }));
+                if (debugConfig_1.DEBUG_CONFIG.NODE_OUTPUT) {
+                    (0, debugConfig_1.debugLog)(`Node Execution - Item ${i} Output`, {
+                        executionData,
                     });
                 }
+                returnData.push(...executionData);
             }
             catch (error) {
+                if (debugConfig_1.DEBUG_CONFIG.NODE_OUTPUT) {
+                    (0, debugConfig_1.debugLog)(`Node Execution - Item ${i} Error`, {
+                        error,
+                        message: error instanceof Error ? error.message : String(error),
+                        stack: error instanceof Error ? error.stack : undefined,
+                    }, 'error');
+                }
                 if (this.continueOnFail()) {
-                    returnData.push({
-                        json: { error: error.message },
+                    const executionErrorData = this.helpers.returnJsonArray({ error: error.message }).map((item) => ({
+                        ...item,
                         pairedItem: { item: i },
-                    });
+                    }));
+                    returnData.push(...executionErrorData);
                     continue;
                 }
                 throw error;
             }
         }
+        if (debugConfig_1.DEBUG_CONFIG.NODE_OUTPUT) {
+            (0, debugConfig_1.debugLog)('Node Execution - Final Output', {
+                returnDataCount: returnData.length,
+                returnData,
+            });
+        }
         return [returnData];
     }
 }