n8n-nodes-arubacentral/dist/nodes/ArubaCentral/api/monitoring/client/operations/getMobility.methods.ts

n8n community node for Aruba Central API integration with comprehensive monitoring, configuration, and management capabilities

import { IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
import { apiRequest } from '../../../../helpers/apiRequest';
import { logger } from '../../../../helpers/logger';
import { handleApiError } from '../../../../helpers/errorHandler';
import { validateClientResponse } from '../client.types';

/**
 * Get client mobility trail from Aruba Central
 *
 * @param this The n8n execution context
 * @returns Client mobility trail
 */
export async function getMobility(this: IExecuteFunctions): Promise<INodeExecutionData[]> {
	try {
		const macaddr = this.getNodeParameter('macaddr', 0) as string;
		logger.debug('monitoring:client:getMobility', `Getting mobility trail for ${macaddr}`);

		if (!macaddr) {
			throw new Error('MAC address is required');
		}

		const queryParameters: Record<string, string | number | boolean> = {};

		// Add optional parameters from UI
		const additionalFields = this.getNodeParameter('additionalFields', 0, {}) as {
			calculate_total?: boolean;
			offset?: number;
			limit?: number;
			from_timestamp?: number;
			to_timestamp?: number;
		};

		if (additionalFields.calculate_total)
			queryParameters.calculate_total = additionalFields.calculate_total;
		if (additionalFields.offset) queryParameters.offset = additionalFields.offset;
		if (additionalFields.limit) queryParameters.limit = additionalFields.limit;
		if (additionalFields.from_timestamp)
			queryParameters.from_timestamp = additionalFields.from_timestamp;
		if (additionalFields.to_timestamp) queryParameters.to_timestamp = additionalFields.to_timestamp;

		// Make API request to get client mobility trail
		const response = await apiRequest.call(
			this,
			'GET',
			`/monitoring/v1/clients/wireless/${macaddr}/mobility_trail`,
			{},
			queryParameters,
		);

		logger.debug('monitoring:client:getMobility', 'Got client mobility trail', { macaddr });

		// Validate and return the response
		if (validateClientResponse(response)) {
			return [{ json: response }];
		} else {
			logger.warn('monitoring:client:getMobility', 'Response validation failed', response);
			return [{ json: response }];
		}
	} catch (error) {
		return handleApiError.call(this, error, 'Failed to get client mobility trail');
	}
}