n8n-nodes-hudu 1.3.0 → 1.3.1

package/README.md

@@ -1,4 +1,28 @@
 # n8n-nodes-hudu
+This community node enables seamless integration with Hudu documentation platform in your n8n workflows, allowing you to automate and manage your IT documentation tasks.
+
+![n8n-nodes-hudu](https://img.shields.io/badge/n8n--nodes--hudu-latest-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow.svg)](https://buymeacoffee.com/msoukhomlinov)
+
+## Recent Changes
+
+### [1.3.1] - 2025-04-21
+- Aligned package general content such as README and documentation
+
+### [1.3.0] - 2025-03-20
+- Fixed missing company_id field in asset delete, archive, and unarchive operations
+
+### [1.2.9] - 2025-01-25
+- Improved Asset operations with enhanced UI, custom asset tags support, and optimised asset creation/update
+- Added streamlined workflow for using asset data between operations
+
+### [1.2.8] - 2025-01-21
+- Fixed asset passwords create/update operations with required fields and enhanced validation
+- Improved field validation and error handling for asset password operations
+
+> **IMPORTANT**: When updating between versions, make sure to restart your n8n instance after the update. UI changes and new features are only picked up after a restart. The recommended update process is:
 
 This n8n community node enables the integration of Hudu within your n8n workflows.
 
@@ -8,19 +32,39 @@ This n8n community node enables the integration of Hudu within your n8n workflow
 
 This node was built against Hudu v2.34.4. Future versions of Hudu may not be 100% compatible without node updates.
 
+[Installation](#installation)  
+[Credentials](#credentials)  
+[Features](#features)  
+[Supported Resources & Operations](#supported-resources--operations)  
+[Resources](#resources)  
+[Contributing](#contributing)  
+[Support](#support)  
+[License](#license)
+
 ## Installation
 
 Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation.
 
-## Important Update Note
+## Credentials
+
+To use this node, you need to:
 
-When updating between versions, make sure to restart your n8n instance after the update. UI changes and new features are only picked up after a restart. The recommended update process is:
+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
 
-1. Update the node (`npm install n8n-nodes-hudu@latest`)
-2. Restart n8n instance
-3. Clear browser cache if needed
+## Features
 
-This is particularly important for version 1.2.9 and above where significant UI and functionality changes were introduced.
+- 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
 
 ## Supported Resources & Operations
 
@@ -170,27 +214,6 @@ Note: Custom field support has some limitations:
 - 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/)
@@ -215,3 +238,13 @@ Please ensure your PR:
 - Includes tests if applicable
 
 For bug reports or feature requests, please use the GitHub issues section.
+
+## Support
+
+If you find this node helpful and would like to support its development:
+
+[![Buy Me A Coffee](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/msoukhomlinov)
+
+## License
+
+[MIT](LICENSE)

package/dist/nodes/Hudu/optionLoaders/asset_layouts/getAssetLayoutFields.ts

@@ -1,235 +1,235 @@
-import type { ILoadOptionsFunctions, IDataObject, ResourceMapperFields, FieldType, INodePropertyOptions } from 'n8n-workflow';
-import { NodeOperationError } from 'n8n-workflow';
-import { handleGetOperation } from '../../utils/operations';
-import type { IAssetLayoutFieldEntity } from '../../resources/asset_layout_fields/asset_layout_fields.types';
-import { ASSET_LAYOUT_FIELD_TYPES } from '../../utils/constants';
-import { debugLog } from '../../utils/debugConfig';
-import { huduApiRequest } from '../../utils/requestUtils';
-import type { IAssetResponse } from '../../resources/assets/assets.types';
-
-interface IAssetLayout extends IDataObject {
-	active: boolean;
-	name: string;
-	fields: IAssetLayoutFieldEntity[];
-}
-
-interface IAssetLayoutResponse extends IDataObject {
-	asset_layout: IAssetLayout;
-}
-
-interface IMappedField {
-	id: string;
-	displayName: string;
-	required: boolean;
-	defaultMatch: boolean;
-	type: FieldType | undefined;
-	display: boolean;
-	canBeUsedToMatch: boolean;
-	description: string | undefined;
-	options?: INodePropertyOptions[];
-	label: string;
-}
-
-async function getFieldTypeAndOptions(
-	this: ILoadOptionsFunctions,
-	huduType: string,
-	field: IAssetLayoutFieldEntity,
-): Promise<{ type: FieldType | undefined; options?: INodePropertyOptions[] }> {
-	debugLog('[FieldTypeMapping] Starting type mapping for field:', { huduType, field });
-	
-	// Map Hudu field types to n8n types
-	switch (huduType) {
-		case ASSET_LAYOUT_FIELD_TYPES.NUMBER:
-			return { type: 'number' };
-		case ASSET_LAYOUT_FIELD_TYPES.DATE:
-			return { type: 'dateTime' };
-		case ASSET_LAYOUT_FIELD_TYPES.CHECKBOX:
-			return { type: 'boolean' };
-		case ASSET_LAYOUT_FIELD_TYPES.LIST_SELECT:
-			return { type: 'string' };
-		case ASSET_LAYOUT_FIELD_TYPES.ASSET_TAG:
-		case ASSET_LAYOUT_FIELD_TYPES.PASSWORD:
-		case ASSET_LAYOUT_FIELD_TYPES.TEXT:
-		case ASSET_LAYOUT_FIELD_TYPES.RICH_TEXT:
-		case ASSET_LAYOUT_FIELD_TYPES.HEADING:
-		case ASSET_LAYOUT_FIELD_TYPES.WEBSITE:
-		case ASSET_LAYOUT_FIELD_TYPES.EMBED:
-		case ASSET_LAYOUT_FIELD_TYPES.EMAIL:
-		case ASSET_LAYOUT_FIELD_TYPES.PHONE:
-		case ASSET_LAYOUT_FIELD_TYPES.ADDRESS_DATA:
-			return { type: 'string' };
-		default:
-			return { type: undefined };
-	}
-}
-
-async function getLayoutFields(
-	this: ILoadOptionsFunctions,
-	includeAssetTags = false,
-): Promise<ResourceMapperFields> {
-	debugLog('[ResourceMapping] Starting getLayoutFields');
-	
-	let layoutId: string;
-	const operation = this.getNodeParameter('operation', 0) as string;
-
-	if (operation === 'update') {
-		// For update operation, get layout ID from asset details
-		const assetId = this.getNodeParameter('id', 0) as string;
-		debugLog('[ResourceMapping] Getting layout ID from asset:', assetId);
-
-		// Use huduApiRequest directly since handleGetAllOperation expects IExecuteFunctions
-		const response = await huduApiRequest.call(
-			this,
-			'GET',
-			'/assets',
-			{},
-			{ id: assetId },
-		) as IAssetResponse;
-
-		if (!response || !response.assets || !response.assets.length) {
-			throw new Error(`Asset with ID ${assetId} not found`);
-		}
-
-		const asset = response.assets[0] as { asset_layout_id: number };
-		layoutId = asset.asset_layout_id.toString();
-		debugLog('[ResourceMapping] Got layout ID from asset:', layoutId);
-	} else {
-		// For create operation, get layout ID from UI
-		layoutId = this.getNodeParameter('asset_layout_id', 0) as string;
-		debugLog('[ResourceMapping] Got layout ID from UI:', layoutId);
-	}
-	
-	debugLog('[ResourceMapping] Context:', { 
-		node: this.getNode().name,
-		layoutId,
-		includeAssetTags,
-	});
-
-	if (!layoutId) {
-		debugLog('[ResourceMapping] No layout ID available, returning empty fields');
-		return {
-			fields: [],
-		};
-	}
-
-	// Fetch the layout details
-	debugLog('[ResourceMapping] Fetching layout details for ID:', layoutId);
-	const layout = await handleGetOperation.call(this, '/asset_layouts', layoutId) as IAssetLayoutResponse;
-	debugLog('[ResourceMapping] Layout response:', layout);
-	
-	// Check if layout exists
-	if (!layout || !layout.asset_layout) {
-		debugLog('[ResourceMapping] Layout not found or inaccessible');
-		throw new NodeOperationError(this.getNode(), 'Asset layout not found or inaccessible');
-	}
-
-	const layoutData = layout.asset_layout;
-	const fields = layoutData.fields || [];
-	debugLog('[ResourceMapping] Found fields:', fields);
-
-	// If no fields are found
-	if (fields.length === 0) {
-		debugLog('[ResourceMapping] No fields found in layout, returning empty fields');
-		return {
-			fields: [],
-		};
-	}
-
-	// Map fields to ResourceMapperFields format
-	debugLog('[ResourceMapping] Starting field mapping process');
-	const mappedFields = await Promise.all(fields
-		.filter((field: IAssetLayoutFieldEntity) => {
-			const isAssetTag = field.field_type === ASSET_LAYOUT_FIELD_TYPES.ASSET_TAG;
-			const include = !field.is_destroyed && (includeAssetTags ? isAssetTag : !isAssetTag);
-			debugLog(`[ResourceMapping] Filtering field ${field.label}:`, { include, field });
-			return include;
-		})
-		.map(async (field: IAssetLayoutFieldEntity) => {
-			debugLog(`[ResourceMapping] Processing field ${field.label} of type ${field.field_type}`);
-			const { type, options } = await getFieldTypeAndOptions.call(this, field.field_type, field);
-			debugLog(`[ResourceMapping] Mapped field ${field.label}:`, { field, type, options });
-			
-			const mappedField: IMappedField = {
-				id: field.id.toString(),
-				displayName: `${field.label} (${field.field_type})${!layoutData.active ? ' [Archived Layout]' : ''}`,
-				required: field.required || false,
-				defaultMatch: false,
-				type,
-				display: true,
-				canBeUsedToMatch: true,
-				description: field.hint || undefined,
-				label: field.label,
-			};
-
-			if (options) {
-				debugLog(`[ResourceMapping] Adding options to field ${field.label}:`, options);
-				mappedField.options = options;
-			}
-
-			debugLog(`[ResourceMapping] Final mapped field ${field.label}:`, mappedField);
-			return mappedField;
-		}))
-		.then(fields => fields.sort((a, b) => a.displayName.localeCompare(b.displayName)));
-
-	debugLog('[ResourceMapping] Final mapped fields:', mappedFields);
-	return {
-		fields: mappedFields,
-	};
-}
-
-export async function mapAssetLayoutFieldsForResource(
-	this: ILoadOptionsFunctions,
-): Promise<ResourceMapperFields> {
-	try {
-		const parameterName = this.getNodeParameter('name', 0) as string;
-		const includeAssetTags = parameterName === 'tagFieldMappings';
-		return getLayoutFields.call(this, includeAssetTags);
-	} catch (error) {
-		debugLog('[ResourceMapping] Error in getAssetLayoutFields:', error);
-		if (error instanceof NodeOperationError) {
-			throw error;
-		}
-		throw new NodeOperationError(this.getNode(), `Failed to load asset layout fields: ${(error as Error).message}`);
-	}
-}
-
-export async function getAssetLayoutFields(
-	this: ILoadOptionsFunctions,
-): Promise<INodePropertyOptions[]> {
-	try {
-		const layoutId = this.getNodeParameter('asset_layout_id', 0) as string;
-		
-		debugLog('[FieldLoading] Starting getAssetLayoutFields for layout:', layoutId);
-
-		if (!layoutId) {
-			return [];
-		}
-
-		// Fetch the layout details
-		const layout = await handleGetOperation.call(this, '/asset_layouts', layoutId) as IAssetLayoutResponse;
-		
-		if (!layout || !layout.asset_layout) {
-			throw new NodeOperationError(this.getNode(), 'Asset layout not found or inaccessible');
-		}
-
-		const layoutData = layout.asset_layout;
-		const fields = layoutData.fields || [];
-
-		// Map fields to INodePropertyOptions format
-		return fields
-			.filter((field: IAssetLayoutFieldEntity) => !field.is_destroyed)
-			.map((field: IAssetLayoutFieldEntity) => ({
-				name: `${field.label} (${field.field_type})${!layoutData.active ? ' [Archived Layout]' : ''}`,
-				value: field.id.toString(),
-				description: field.hint || undefined,
-			}))
-			.sort((a, b) => a.name.localeCompare(b.name));
-
-	} catch (error) {
-		debugLog('[FieldLoading] Error in getAssetLayoutFields:', error);
-		if (error instanceof NodeOperationError) {
-			throw error;
-		}
-		throw new NodeOperationError(this.getNode(), `Failed to load asset layout fields: ${(error as Error).message}`);
-	}
+import type { ILoadOptionsFunctions, IDataObject, ResourceMapperFields, FieldType, INodePropertyOptions } from 'n8n-workflow';
+import { NodeOperationError } from 'n8n-workflow';
+import { handleGetOperation } from '../../utils/operations';
+import type { IAssetLayoutFieldEntity } from '../../resources/asset_layout_fields/asset_layout_fields.types';
+import { ASSET_LAYOUT_FIELD_TYPES } from '../../utils/constants';
+import { debugLog } from '../../utils/debugConfig';
+import { huduApiRequest } from '../../utils/requestUtils';
+import type { IAssetResponse } from '../../resources/assets/assets.types';
+
+interface IAssetLayout extends IDataObject {
+	active: boolean;
+	name: string;
+	fields: IAssetLayoutFieldEntity[];
+}
+
+interface IAssetLayoutResponse extends IDataObject {
+	asset_layout: IAssetLayout;
+}
+
+interface IMappedField {
+	id: string;
+	displayName: string;
+	required: boolean;
+	defaultMatch: boolean;
+	type: FieldType | undefined;
+	display: boolean;
+	canBeUsedToMatch: boolean;
+	description: string | undefined;
+	options?: INodePropertyOptions[];
+	label: string;
+}
+
+async function getFieldTypeAndOptions(
+	this: ILoadOptionsFunctions,
+	huduType: string,
+	field: IAssetLayoutFieldEntity,
+): Promise<{ type: FieldType | undefined; options?: INodePropertyOptions[] }> {
+	debugLog('[FieldTypeMapping] Starting type mapping for field:', { huduType, field });
+	
+	// Map Hudu field types to n8n types
+	switch (huduType) {
+		case ASSET_LAYOUT_FIELD_TYPES.NUMBER:
+			return { type: 'number' };
+		case ASSET_LAYOUT_FIELD_TYPES.DATE:
+			return { type: 'dateTime' };
+		case ASSET_LAYOUT_FIELD_TYPES.CHECKBOX:
+			return { type: 'boolean' };
+		case ASSET_LAYOUT_FIELD_TYPES.LIST_SELECT:
+			return { type: 'string' };
+		case ASSET_LAYOUT_FIELD_TYPES.ASSET_TAG:
+		case ASSET_LAYOUT_FIELD_TYPES.PASSWORD:
+		case ASSET_LAYOUT_FIELD_TYPES.TEXT:
+		case ASSET_LAYOUT_FIELD_TYPES.RICH_TEXT:
+		case ASSET_LAYOUT_FIELD_TYPES.HEADING:
+		case ASSET_LAYOUT_FIELD_TYPES.WEBSITE:
+		case ASSET_LAYOUT_FIELD_TYPES.EMBED:
+		case ASSET_LAYOUT_FIELD_TYPES.EMAIL:
+		case ASSET_LAYOUT_FIELD_TYPES.PHONE:
+		case ASSET_LAYOUT_FIELD_TYPES.ADDRESS_DATA:
+			return { type: 'string' };
+		default:
+			return { type: undefined };
+	}
+}
+
+async function getLayoutFields(
+	this: ILoadOptionsFunctions,
+	includeAssetTags = false,
+): Promise<ResourceMapperFields> {
+	debugLog('[ResourceMapping] Starting getLayoutFields');
+	
+	let layoutId: string;
+	const operation = this.getNodeParameter('operation', 0) as string;
+
+	if (operation === 'update') {
+		// For update operation, get layout ID from asset details
+		const assetId = this.getNodeParameter('id', 0) as string;
+		debugLog('[ResourceMapping] Getting layout ID from asset:', assetId);
+
+		// Use huduApiRequest directly since handleGetAllOperation expects IExecuteFunctions
+		const response = await huduApiRequest.call(
+			this,
+			'GET',
+			'/assets',
+			{},
+			{ id: assetId },
+		) as IAssetResponse;
+
+		if (!response || !response.assets || !response.assets.length) {
+			throw new Error(`Asset with ID ${assetId} not found`);
+		}
+
+		const asset = response.assets[0] as { asset_layout_id: number };
+		layoutId = asset.asset_layout_id.toString();
+		debugLog('[ResourceMapping] Got layout ID from asset:', layoutId);
+	} else {
+		// For create operation, get layout ID from UI
+		layoutId = this.getNodeParameter('asset_layout_id', 0) as string;
+		debugLog('[ResourceMapping] Got layout ID from UI:', layoutId);
+	}
+	
+	debugLog('[ResourceMapping] Context:', { 
+		node: this.getNode().name,
+		layoutId,
+		includeAssetTags,
+	});
+
+	if (!layoutId) {
+		debugLog('[ResourceMapping] No layout ID available, returning empty fields');
+		return {
+			fields: [],
+		};
+	}
+
+	// Fetch the layout details
+	debugLog('[ResourceMapping] Fetching layout details for ID:', layoutId);
+	const layout = await handleGetOperation.call(this, '/asset_layouts', layoutId) as IAssetLayoutResponse;
+	debugLog('[ResourceMapping] Layout response:', layout);
+	
+	// Check if layout exists
+	if (!layout || !layout.asset_layout) {
+		debugLog('[ResourceMapping] Layout not found or inaccessible');
+		throw new NodeOperationError(this.getNode(), 'Asset layout not found or inaccessible');
+	}
+
+	const layoutData = layout.asset_layout;
+	const fields = layoutData.fields || [];
+	debugLog('[ResourceMapping] Found fields:', fields);
+
+	// If no fields are found
+	if (fields.length === 0) {
+		debugLog('[ResourceMapping] No fields found in layout, returning empty fields');
+		return {
+			fields: [],
+		};
+	}
+
+	// Map fields to ResourceMapperFields format
+	debugLog('[ResourceMapping] Starting field mapping process');
+	const mappedFields = await Promise.all(fields
+		.filter((field: IAssetLayoutFieldEntity) => {
+			const isAssetTag = field.field_type === ASSET_LAYOUT_FIELD_TYPES.ASSET_TAG;
+			const include = !field.is_destroyed && (includeAssetTags ? isAssetTag : !isAssetTag);
+			debugLog(`[ResourceMapping] Filtering field ${field.label}:`, { include, field });
+			return include;
+		})
+		.map(async (field: IAssetLayoutFieldEntity) => {
+			debugLog(`[ResourceMapping] Processing field ${field.label} of type ${field.field_type}`);
+			const { type, options } = await getFieldTypeAndOptions.call(this, field.field_type, field);
+			debugLog(`[ResourceMapping] Mapped field ${field.label}:`, { field, type, options });
+			
+			const mappedField: IMappedField = {
+				id: field.id.toString(),
+				displayName: `${field.label} (${field.field_type})${!layoutData.active ? ' [Archived Layout]' : ''}`,
+				required: field.required || false,
+				defaultMatch: false,
+				type,
+				display: true,
+				canBeUsedToMatch: true,
+				description: field.hint || undefined,
+				label: field.label,
+			};
+
+			if (options) {
+				debugLog(`[ResourceMapping] Adding options to field ${field.label}:`, options);
+				mappedField.options = options;
+			}
+
+			debugLog(`[ResourceMapping] Final mapped field ${field.label}:`, mappedField);
+			return mappedField;
+		}))
+		.then(fields => fields.sort((a, b) => a.displayName.localeCompare(b.displayName)));
+
+	debugLog('[ResourceMapping] Final mapped fields:', mappedFields);
+	return {
+		fields: mappedFields,
+	};
+}
+
+export async function mapAssetLayoutFieldsForResource(
+	this: ILoadOptionsFunctions,
+): Promise<ResourceMapperFields> {
+	try {
+		const parameterName = this.getNodeParameter('name', 0) as string;
+		const includeAssetTags = parameterName === 'tagFieldMappings';
+		return getLayoutFields.call(this, includeAssetTags);
+	} catch (error) {
+		debugLog('[ResourceMapping] Error in getAssetLayoutFields:', error);
+		if (error instanceof NodeOperationError) {
+			throw error;
+		}
+		throw new NodeOperationError(this.getNode(), `Failed to load asset layout fields: ${(error as Error).message}`);
+	}
+}
+
+export async function getAssetLayoutFields(
+	this: ILoadOptionsFunctions,
+): Promise<INodePropertyOptions[]> {
+	try {
+		const layoutId = this.getNodeParameter('asset_layout_id', 0) as string;
+		
+		debugLog('[FieldLoading] Starting getAssetLayoutFields for layout:', layoutId);
+
+		if (!layoutId) {
+			return [];
+		}
+
+		// Fetch the layout details
+		const layout = await handleGetOperation.call(this, '/asset_layouts', layoutId) as IAssetLayoutResponse;
+		
+		if (!layout || !layout.asset_layout) {
+			throw new NodeOperationError(this.getNode(), 'Asset layout not found or inaccessible');
+		}
+
+		const layoutData = layout.asset_layout;
+		const fields = layoutData.fields || [];
+
+		// Map fields to INodePropertyOptions format
+		return fields
+			.filter((field: IAssetLayoutFieldEntity) => !field.is_destroyed)
+			.map((field: IAssetLayoutFieldEntity) => ({
+				name: `${field.label} (${field.field_type})${!layoutData.active ? ' [Archived Layout]' : ''}`,
+				value: field.id.toString(),
+				description: field.hint || undefined,
+			}))
+			.sort((a, b) => a.name.localeCompare(b.name));
+
+	} catch (error) {
+		debugLog('[FieldLoading] Error in getAssetLayoutFields:', error);
+		if (error instanceof NodeOperationError) {
+			throw error;
+		}
+		throw new NodeOperationError(this.getNode(), `Failed to load asset layout fields: ${(error as Error).message}`);
+	}
 }