@mseep/safe-omada-mcp 0.17.0

package/dist/omadaClient/client.js

@@ -0,0 +1,237 @@
+/**
+ * Client-related operations for the Omada API.
+ */
+export class ClientOperations {
+    request;
+    site;
+    buildPath;
+    constructor(request, site, buildPath) {
+        this.request = request;
+        this.site = site;
+        this.buildPath = buildPath;
+    }
+    /**
+     * List all clients in a site.
+     */
+    async listClients(siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        return await this.request.fetchPaginated(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/clients`), {}, customHeaders);
+    }
+    /**
+     * Get a specific client by MAC address or client ID.
+     */
+    async getClient(identifier, siteId, customHeaders) {
+        const clients = await this.listClients(siteId, customHeaders);
+        return clients.find((client) => client.mac === identifier || client.id === identifier);
+    }
+    /**
+     * Get most active clients in a site (dashboard endpoint).
+     * Returns clients sorted by total traffic.
+     *
+     * @param siteId - Optional site ID, uses default from config if not provided
+     * @returns Array of active client information
+     */
+    async listMostActiveClients(siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const response = await this.request.get(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/dashboard/active-clients`), undefined, customHeaders);
+        return response.result ?? [];
+    }
+    /**
+     * Get client activity statistics over time (dashboard endpoint).
+     * Returns time-series data about new, active, and disconnected clients.
+     *
+     * @param options - Options including optional siteId, start, and end timestamps
+     * @returns Array of client activity snapshots over time
+     */
+    async listClientsActivity(options = {}, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(options.siteId);
+        const params = {};
+        if (options.start !== undefined) {
+            params.start = options.start;
+        }
+        if (options.end !== undefined) {
+            params.end = options.end;
+        }
+        const response = await this.request.get(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/dashboard/client-activity`), params, customHeaders);
+        return response.result ?? [];
+    }
+    /**
+     * Get client past connection list (insight endpoint).
+     * Returns historical client connection data with support for pagination, filtering, and sorting.
+     *
+     * @param options - Options including siteId, pagination, filters, and search parameters
+     * @returns Array of client past connection information
+     */
+    async listClientsPastConnections(options, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(options.siteId);
+        const params = {
+            page: options.page,
+            pageSize: options.pageSize,
+        };
+        // Add optional sort parameter
+        if (options.sortLastSeen !== undefined) {
+            params['sorts.lastSeen'] = options.sortLastSeen;
+        }
+        // Add optional filter parameters
+        if (options.timeStart !== undefined) {
+            params['filters.timeStart'] = String(options.timeStart);
+        }
+        if (options.timeEnd !== undefined) {
+            params['filters.timeEnd'] = String(options.timeEnd);
+        }
+        if (options.guest !== undefined) {
+            params['filters.guest'] = String(options.guest);
+        }
+        // Add optional search parameter
+        if (options.searchKey !== undefined) {
+            params.searchKey = options.searchKey;
+        }
+        const response = await this.request.get(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/insight/past-connection`), params, customHeaders);
+        const result = this.request.ensureSuccess(response);
+        return result.data ?? [];
+    }
+    /**
+     * Get rate limit profile list for a site.
+     * Returns available rate limit profiles that can be applied to clients.
+     *
+     * @param siteId - Optional site ID, uses default from config if not provided
+     * @returns Array of rate limit profiles
+     */
+    async getRateLimitProfiles(siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const response = await this.request.get(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/rate-limit-profiles`), undefined, customHeaders);
+        return this.request.ensureSuccess(response) ?? [];
+    }
+    /**
+     * Set custom rate limit for a client.
+     * Configures download and upload bandwidth limits directly without using a profile.
+     *
+     * @param clientMac - MAC address of the client
+     * @param downLimit - Download limit in Kbps
+     * @param upLimit - Upload limit in Kbps
+     * @param siteId - Optional site ID, uses default from config if not provided
+     * @returns Updated rate limit setting
+     */
+    async setClientRateLimit(clientMac, downLimit, upLimit, siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const requestBody = {
+            mode: 0, // 0 = custom rate limit
+            customRateLimit: {
+                enable: true,
+                upEnable: true,
+                upLimit: upLimit,
+                downEnable: true,
+                downLimit: downLimit,
+            },
+        };
+        const response = await this.request.patch(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/clients/${encodeURIComponent(clientMac)}/ratelimit`), requestBody, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Set rate limit profile for a client.
+     * Applies a predefined rate limit profile to the client.
+     *
+     * @param clientMac - MAC address of the client
+     * @param profileId - Rate limit profile ID
+     * @param siteId - Optional site ID, uses default from config if not provided
+     * @returns Updated rate limit setting
+     */
+    async setClientRateLimitProfile(clientMac, profileId, siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const requestBody = {
+            mode: 1, // 1 = use rate limit profile
+            rateLimitProfileId: profileId,
+        };
+        const response = await this.request.patch(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/clients/${encodeURIComponent(clientMac)}/ratelimit`), requestBody, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Disable rate limit for a client.
+     * Removes any rate limiting applied to the client.
+     *
+     * @param clientMac - MAC address of the client
+     * @param siteId - Optional site ID, uses default from config if not provided
+     * @returns Updated rate limit setting
+     */
+    async disableClientRateLimit(clientMac, siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        // To disable rate limiting, use mode 0 with enable: false and minimal valid limit values
+        const requestBody = {
+            mode: 0,
+            customRateLimit: {
+                enable: false,
+                upEnable: false,
+                upLimit: 1,
+                downEnable: false,
+                downLimit: 1,
+            },
+        };
+        const response = await this.request.patch(this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/clients/${encodeURIComponent(clientMac)}/ratelimit`), requestBody, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get full detail for a single client by MAC address.
+     * OperationId: getClientDetail
+     */
+    async getClientDetail(clientMac, siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/clients/${encodeURIComponent(clientMac)}`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get historical known clients list (paginated).
+     * OperationId: getGridKnownClients
+     */
+    async getGridKnownClients(page, pageSize, options, siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/insight/clients`);
+        const params = { page, pageSize };
+        if (options?.sortLastSeen !== undefined)
+            params['sorts.lastSeen'] = options.sortLastSeen;
+        if (options?.timeStart !== undefined)
+            params['filters.timeStart'] = options.timeStart;
+        if (options?.timeEnd !== undefined)
+            params['filters.timeEnd'] = options.timeEnd;
+        if (options?.guest !== undefined)
+            params['filters.guest'] = options.guest;
+        if (options?.searchKey !== undefined)
+            params.searchKey = options.searchKey;
+        const response = await this.request.get(path, params, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get per-client connection history (paginated).
+     * OperationId: getGridClientHistory
+     */
+    async getGridClientHistory(clientMac, page, pageSize, searchKey, siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/clients/${encodeURIComponent(clientMac)}/client-history`);
+        const params = { page, pageSize };
+        if (searchKey !== undefined)
+            params.searchKey = searchKey;
+        const response = await this.request.get(path, params, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get client count distribution by type/band.
+     * OperationId: getClientsDistribution
+     */
+    async getClientsDistribution(siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/dashboard/client-distribution`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get historical client count trend over a time range.
+     * OperationId: getPastClientNum
+     */
+    async getPastClientNum(start, end, siteId, customHeaders) {
+        const resolvedSiteId = this.site.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/dashboard/past-client-num`);
+        const response = await this.request.get(path, { start, end }, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/omadaClient/client.js.map

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

package/dist/omadaClient/controller.d.ts

@@ -0,0 +1,46 @@
+import type { CustomHeaders } from '../types/index.js';
+import type { RequestHandler } from './request.js';
+/**
+ * Controller-level operations for the Omada API.
+ * Covers global system settings, retention, ports, certificates, and related controller settings.
+ */
+export declare class ControllerOperations {
+    private readonly request;
+    private readonly buildPath;
+    constructor(request: RequestHandler, buildPath: (path: string) => string);
+    /**
+     * Get data retention settings.
+     * OperationId: getDataRetention
+     */
+    getDataRetention(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get controller port setting.
+     * OperationId: getControllerPort
+     */
+    getControllerPort(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get portal port setting.
+     * OperationId: getPortalPort
+     */
+    getPortalPort(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get certificate configuration.
+     * OperationId: getCertificate
+     */
+    getCertificate(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get experience improvement setting.
+     * OperationId: getExpImprove
+     */
+    getExperienceImprovement(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get global dashboard overview (without client data).
+     * OperationId: getGernalSettings_1
+     */
+    getGlobalDashboardOverview(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get client history data enable setting.
+     * OperationId: getClientHistoryDataEnable
+     */
+    getClientHistoryDataEnable(customHeaders?: CustomHeaders): Promise<unknown>;
+}

package/dist/omadaClient/controller.js

@@ -0,0 +1,76 @@
+/**
+ * Controller-level operations for the Omada API.
+ * Covers global system settings, retention, ports, certificates, and related controller settings.
+ */
+export class ControllerOperations {
+    request;
+    buildPath;
+    constructor(request, buildPath) {
+        this.request = request;
+        this.buildPath = buildPath;
+    }
+    /**
+     * Get data retention settings.
+     * OperationId: getDataRetention
+     */
+    async getDataRetention(customHeaders) {
+        const path = this.buildPath('/retention');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get controller port setting.
+     * OperationId: getControllerPort
+     */
+    async getControllerPort(customHeaders) {
+        const path = this.buildPath('/system/setting/controller-port');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get portal port setting.
+     * OperationId: getPortalPort
+     */
+    async getPortalPort(customHeaders) {
+        const path = this.buildPath('/system/setting/portal-port');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get certificate configuration.
+     * OperationId: getCertificate
+     */
+    async getCertificate(customHeaders) {
+        const path = this.buildPath('/system/setting/certificate');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get experience improvement setting.
+     * OperationId: getExpImprove
+     */
+    async getExperienceImprovement(customHeaders) {
+        const path = this.buildPath('/global/controller/setting/exp-improve');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get global dashboard overview (without client data).
+     * OperationId: getGernalSettings_1
+     */
+    async getGlobalDashboardOverview(customHeaders) {
+        const path = this.buildPath('/dashboard/overview-without-client');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get client history data enable setting.
+     * OperationId: getClientHistoryDataEnable
+     */
+    async getClientHistoryDataEnable(customHeaders) {
+        const path = this.buildPath('/controller/client/history-enable');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/omadaClient/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/omadaClient/controller.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IAER;IACA;IAFrB,YACqB,OAAuB,EACvB,SAAmC;QADnC,YAAO,GAAP,OAAO,CAAgB;QACvB,cAAS,GAAT,SAAS,CAA0B;IACrD,CAAC;IAEJ;;;OAGG;IACI,KAAK,CAAC,gBAAgB,CAAC,aAA6B;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA4B,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,iBAAiB,CAAC,aAA6B;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA4B,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,aAAa,CAAC,aAA6B;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA4B,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,cAAc,CAAC,aAA6B;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA4B,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,wBAAwB,CAAC,aAA6B;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,wCAAwC,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA4B,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,0BAA0B,CAAC,aAA6B;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA4B,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,0BAA0B,CAAC,aAA6B;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA4B,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;CACJ"}

package/dist/omadaClient/device.d.ts

@@ -0,0 +1,263 @@
+import type { CustomHeaders, GetDeviceStatsOptions, OmadaDeviceInfo, OmadaDeviceStats, OswStackDetail } from '../types/index.js';
+import type { RequestHandler } from './request.js';
+import type { SiteOperations } from './site.js';
+/**
+ * Device-related operations for the Omada API.
+ */
+export declare class DeviceOperations {
+    private readonly request;
+    private readonly site;
+    private readonly buildPath;
+    constructor(request: RequestHandler, site: SiteOperations, buildPath: (path: string) => string);
+    /**
+     * List all devices in a site.
+     */
+    listDevices(siteId?: string, customHeaders?: CustomHeaders): Promise<OmadaDeviceInfo[]>;
+    /**
+     * Get a specific device by MAC address or device ID.
+     */
+    getDevice(identifier: string, siteId?: string, customHeaders?: CustomHeaders): Promise<OmadaDeviceInfo | undefined>;
+    /**
+     * Get detailed information about a switch stack.
+     */
+    getSwitchStackDetail(stackId: string, siteId?: string, customHeaders?: CustomHeaders): Promise<OswStackDetail>;
+    /**
+     * Search for devices globally across all sites the user has access to.
+     */
+    searchDevices(searchKey: string, customHeaders?: CustomHeaders): Promise<OmadaDeviceInfo[]>;
+    /**
+     * Get statistics for global adopted devices with filtering and pagination.
+     */
+    listDevicesStats(options: GetDeviceStatsOptions, customHeaders?: CustomHeaders): Promise<OmadaDeviceStats>;
+    /**
+     * Get detailed information for a specific switch.
+     * OperationId: getSwitch
+     */
+    getSwitchDetail(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get detailed information for a specific gateway.
+     * OperationId: getGateway
+     */
+    getGatewayDetail(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get WAN status for a specific gateway.
+     * OperationId: getGatewayWanPortStatus
+     */
+    getGatewayWanStatus(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get LAN status for a specific gateway.
+     * OperationId: getGatewayLanPortStatus
+     */
+    getGatewayLanStatus(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get port information for a specific gateway.
+     * OperationId: getGatewayPorts
+     */
+    getGatewayPorts(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * Get detailed information for a specific AP.
+     * OperationId: getAp
+     */
+    getApDetail(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get radio information for a specific AP.
+     * OperationId: getApRadios
+     */
+    getApRadios(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * Get port information for a switch stack.
+     * OperationId: getStackPorts
+     */
+    getStackPorts(stackId: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * List devices pending adoption in a site.
+     * OperationId: getGridPendingDevices
+     */
+    listPendingDevices(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * Get all devices in a site including offline devices.
+     * OperationId: getAllDeviceBySite
+     */
+    getAllDeviceBySite(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * Get latest firmware info for a device.
+     * OperationId: getFirmwareInfo
+     */
+    getFirmwareInfo(deviceMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get auto-check upgrade plan list.
+     * OperationId: getGridAutoCheckUpgrade
+     */
+    getGridAutoCheckUpgrade(page: number, pageSize: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * List switch VLAN network assignments.
+     * OperationId: listSwitchNetworks
+     */
+    listSwitchNetworks(switchMac: string, page: number, pageSize: number, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get switch general configuration.
+     * OperationId: getGeneralConfig (switch)
+     */
+    getSwitchGeneralConfig(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get cable test logs for a switch.
+     * OperationId: getCableTestLogs
+     */
+    getCableTestLogs(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get cable test full results for a switch.
+     * OperationId: getCableTestFullResults
+     */
+    getCableTestFullResults(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get stack LAG list.
+     * OperationId: getOswStackLagList
+     */
+    getOswStackLagList(stackId: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * Get stack VLAN network list.
+     * OperationId: getStackNetworkList
+     */
+    getStackNetworkList(stackId: string, page: number, pageSize: number, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get AP uplink configuration.
+     * OperationId: getApUplinkConfig
+     */
+    getApUplinkConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * Get AP per-radio configuration.
+     * OperationId: getRadiosConfig
+     */
+    getRadiosConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Update AP per-radio configuration.
+     * OperationId: modifyRadiosConfig
+     */
+    setRadiosConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get AP VLAN configuration.
+     * OperationId: getApVlanConfig
+     */
+    getApVlanConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get per-AP mesh link statistics.
+     * OperationId: getMeshStatistics
+     */
+    getMeshStatistics(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get RF scan results for an AP.
+     * OperationId: getRFScanResult
+     */
+    getRFScanResult(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get speed test results for an AP.
+     * OperationId: getSpeedTestResults
+     */
+    getSpeedTestResults(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get AP SNMP configuration.
+     * OperationId: getApSnmpConfig
+     */
+    getApSnmpConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get AP LLDP configuration.
+     * OperationId: getApLldpConfig
+     */
+    getApLldpConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get AP general configuration.
+     * OperationId: getGeneralConfig_2
+     */
+    getApGeneralConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Update AP general configuration.
+     * OperationId: modifyGeneralConfig_2
+     */
+    setApGeneralConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get AP wired uplink detail.
+     * OperationId: getUplinkWiredDetail
+     */
+    getUplinkWiredDetail(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get AP wired downlink device list.
+     * OperationId: getDownlinkWiredDevices
+     */
+    getDownlinkWiredDevices(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    getFirmwareUpgradePlan(page: number, pageSize: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    getUpgradeLogs(page: number, pageSize: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    getDeviceTagList(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getApQosConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setApQosConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getApIpv6Config(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setApIpv6Config(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesGatewaysGeneralConfig(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysGeneralConfig(gatewayMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysConfigGeneral(gatewayMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysConfigServices(gatewayMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysConfigAdvanced(gatewayMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysConfigRadios(gatewayMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysConfigWlans(gatewayMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysPortConfig(gatewayMac: string, portName: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesGatewaysMultiPortsConfig(gatewayMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesGatewaysPin(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesGatewaysSimCardUsed(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesHealthGatewaysWansDetails(gatewayMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsIpSetting(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesApsIpSetting(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsChannelLimit(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsAvailableChannel(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setApChannelConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getAfcConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setAfcConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsLoadBalance(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesApsLoadBalance(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsOfdma(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesApsOfdma(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsPowerSaving(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesApsPowerSaving(apMac: string, payload: {
+        timeEnable: boolean;
+        bandEnable: boolean;
+        startTimeH?: number;
+        startTimeM?: number;
+        endTimeH?: number;
+        endTimeM?: number;
+        bands?: number[];
+        idleDuration?: number;
+    }, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsTrunkSetting(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesApsTrunkSetting(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesApsChannelLimit(apMac: string, payload: {
+        channelLimitType: number;
+    }, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesApsBridge(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setSitesApsBridge(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setApServiceConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setApWlanGroup(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getAntennaGainConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    setAntennaGainConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    listSitesApsPorts(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    setSitesApsPortConfig(apMac: string, payload: unknown, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesSwitchesEs(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesSwitchesEsGeneralConfig(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    listSitesCableTestSwitchesPorts(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown[]>;
+    listSitesCableTestSwitchesIncrementResults(switchMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    getUpgradeOverviewCritical(customHeaders?: CustomHeaders): Promise<unknown>;
+    getUpgradeOverviewTryBeta(customHeaders?: CustomHeaders): Promise<unknown>;
+    listUpgradeFirmwares(page: number, pageSize: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    listUpgradeOverviewFirmwares(page: number, pageSize: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    listSitesStacks(siteId?: string, page?: number, pageSize?: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    getSitesDeviceWhiteList(siteId?: string, page?: number, pageSize?: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get load balance configuration for a specific AP.
+     * OperationId: getApLoadBalanceConfig
+     * Delegates to getSitesApsLoadBalance to avoid duplication and ensure consistent apMac validation.
+     */
+    getApLoadBalance(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get OFDMA configuration for a specific AP.
+     * OperationId: getApOfdmaConfig
+     * Delegates to getSitesApsOfdma to avoid duplication and ensure consistent apMac validation.
+     */
+    getApOfdmaConfig(apMac: string, siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+}