@mseep/safe-omada-mcp 0.17.0

package/dist/omadaClient/security.d.ts

@@ -0,0 +1,92 @@
+import type { CustomHeaders, PaginatedResult } from '../types/index.js';
+import type { GetThreatListOptions, ThreatInfo } from '../types/threatInfo.js';
+import type { RequestHandler } from './request.js';
+/**
+ * Security-related operations for the Omada API.
+ * Handles threat management and security features.
+ */
+export declare class SecurityOperations {
+    private readonly request;
+    private readonly buildPath;
+    constructor(request: RequestHandler, buildPath: (path: string) => string);
+    /**
+     * Get the global view threat management list.
+     * operationId: getGlobalThreatList
+     *
+     * @param options - Threat list query options
+     * @returns Paginated list of threat information
+     */
+    getThreatList(options: GetThreatListOptions, customHeaders?: CustomHeaders): Promise<PaginatedResult<ThreatInfo>>;
+    /**
+     * Get top threats from the global view threat management.
+     * OperationId: getTopThreatList
+     */
+    getTopThreats(customHeaders?: CustomHeaders): Promise<unknown[]>;
+    /**
+     * Get threat severity summary from the global view.
+     * OperationId: getThreatSeverity
+     */
+    getThreatSeverity(startTime: number, endTime: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get controller status/health.
+     * OperationId: getControllerStatus
+     */
+    getControllerStatus(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get global general settings.
+     * OperationId: getGeneralSettings
+     */
+    getGeneralSettings(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get data retention setting.
+     * OperationId: getRetention
+     */
+    getRetention(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get client inactivity timeout.
+     * OperationId: getClientActiveTimeout
+     */
+    getClientActiveTimeout(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get global syslog/remote logging config.
+     * OperationId: getRemoteLogging
+     */
+    getRemoteLogging(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get global RADIUS server config.
+     * OperationId: getRadiusServer
+     */
+    getRadiusServer(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get controller logging config.
+     * OperationId: getLogging
+     */
+    getLogging(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get UI interface settings.
+     * OperationId: getUiInterface
+     */
+    getUiInterface(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get device access management settings.
+     * OperationId: getDeviceAccessManagement
+     */
+    getDeviceAccessManagement(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get webhook notification settings.
+     * OperationId: getWebhookForGlobal
+     */
+    getWebhookForGlobal(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get webhook dispatch logs (paginated, required filters).
+     * OperationId: getWebhookLogsForGlobal
+     * @param timeStart - Start of time range in epoch milliseconds (e.g. 1679297710438)
+     * @param timeEnd - End of time range in epoch milliseconds (e.g. 1681889710438)
+     */
+    getWebhookLogsForGlobal(page: number, pageSize: number, webhookId: string, timeStart: number, timeEnd: number, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get mail server status.
+     * OperationId: getMailServerStatus
+     */
+    getMailServerStatus(customHeaders?: CustomHeaders): Promise<unknown>;
+}

package/dist/omadaClient/security.js

@@ -0,0 +1,176 @@
+/**
+ * Security-related operations for the Omada API.
+ * Handles threat management and security features.
+ */
+export class SecurityOperations {
+    request;
+    buildPath;
+    constructor(request, buildPath) {
+        this.request = request;
+        this.buildPath = buildPath;
+    }
+    /**
+     * Get the global view threat management list.
+     * operationId: getGlobalThreatList
+     *
+     * @param options - Threat list query options
+     * @returns Paginated list of threat information
+     */
+    async getThreatList(options, customHeaders) {
+        const params = {
+            archived: options.archived,
+            page: options.page,
+            pageSize: options.pageSize,
+            'filters.startTime': options.startTime,
+            'filters.endTime': options.endTime,
+        };
+        if (options.siteList) {
+            params.siteList = options.siteList;
+        }
+        if (options.severity !== undefined) {
+            params['filters.severity'] = options.severity;
+        }
+        if (options.sortTime) {
+            params['sorts.time'] = options.sortTime;
+        }
+        if (options.searchKey) {
+            params.searchKey = options.searchKey;
+        }
+        const path = this.buildPath('/security/threat-management');
+        return await this.request.request({
+            method: 'GET',
+            url: path,
+            params,
+        }, true, customHeaders);
+    }
+    /**
+     * Get top threats from the global view threat management.
+     * OperationId: getTopThreatList
+     */
+    async getTopThreats(customHeaders) {
+        const path = this.buildPath('/security/threat-management/top');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return response.result ?? [];
+    }
+    /**
+     * Get threat severity summary from the global view.
+     * OperationId: getThreatSeverity
+     */
+    async getThreatSeverity(startTime, endTime, customHeaders) {
+        const path = this.buildPath('/security/threat-management/severity');
+        const response = await this.request.get(path, { startTime, endTime }, customHeaders);
+        return response.result;
+    }
+    // Global Controller settings (issue #41)
+    /**
+     * Get controller status/health.
+     * OperationId: getControllerStatus
+     */
+    async getControllerStatus(customHeaders) {
+        const path = this.buildPath('/system/setting/controller-status');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get global general settings.
+     * OperationId: getGeneralSettings
+     */
+    async getGeneralSettings(customHeaders) {
+        const path = this.buildPath('/global/controller/setting/general');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get data retention setting.
+     * OperationId: getRetention
+     */
+    async getRetention(customHeaders) {
+        const path = this.buildPath('/controller/setting/retention');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get client inactivity timeout.
+     * OperationId: getClientActiveTimeout
+     */
+    async getClientActiveTimeout(customHeaders) {
+        const path = this.buildPath('/controller/setting/active-timeout');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get global syslog/remote logging config.
+     * OperationId: getRemoteLogging
+     */
+    async getRemoteLogging(customHeaders) {
+        const path = this.buildPath('/global/controller/setting/syslog');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get global RADIUS server config.
+     * OperationId: getRadiusServer
+     */
+    async getRadiusServer(customHeaders) {
+        const path = this.buildPath('/global/controller/setting/network/radius-server');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get controller logging config.
+     * OperationId: getLogging
+     */
+    async getLogging(customHeaders) {
+        const path = this.buildPath('/system/setting/logging');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get UI interface settings.
+     * OperationId: getUiInterface
+     */
+    async getUiInterface(customHeaders) {
+        const path = this.buildPath('/controller/setting/ui-interface');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get device access management settings.
+     * OperationId: getDeviceAccessManagement
+     */
+    async getDeviceAccessManagement(customHeaders) {
+        const path = this.buildPath('/controller/setting/services/device-access');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get webhook notification settings.
+     * OperationId: getWebhookForGlobal
+     */
+    async getWebhookForGlobal(customHeaders) {
+        const path = this.buildPath('/webhook/settings');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get webhook dispatch logs (paginated, required filters).
+     * OperationId: getWebhookLogsForGlobal
+     * @param timeStart - Start of time range in epoch milliseconds (e.g. 1679297710438)
+     * @param timeEnd - End of time range in epoch milliseconds (e.g. 1681889710438)
+     */
+    async getWebhookLogsForGlobal(page, pageSize, webhookId, timeStart, timeEnd, customHeaders) {
+        const path = this.buildPath('/webhook/settings/dispatch-logs');
+        const response = await this.request.get(path, { page, pageSize, 'filters.webhookId': webhookId, 'filters.timeStart': timeStart, 'filters.timeEnd': timeEnd }, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get mail server status.
+     * OperationId: getMailServerStatus
+     */
+    async getMailServerStatus(customHeaders) {
+        const path = this.buildPath('/mail/status');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+}
+//# sourceMappingURL=security.js.map

package/dist/omadaClient/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/omadaClient/security.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAEN;IACA;IAFrB,YACqB,OAAuB,EACvB,SAAmC;QADnC,YAAO,GAAP,OAAO,CAAgB;QACvB,cAAS,GAAT,SAAS,CAA0B;IACrD,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,OAA6B,EAAE,aAA6B;QAC5E,MAAM,MAAM,GAA8C;YACtD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,mBAAmB,EAAE,OAAO,CAAC,SAAS;YACtC,iBAAiB,EAAE,OAAO,CAAC,OAAO;SACrC,CAAC;QAEF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACvC,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC5C,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACzC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAE3D,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAC7B;YACI,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,IAAI;YACT,MAAM;SACT,EACD,IAAI,EACJ,aAAa,CAChB,CAAC;IACN,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,aAAa,CAAC,aAA6B;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAA2C,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAClH,OAAO,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,iBAAiB,CAAC,SAAiB,EAAE,OAAe,EAAE,aAA6B;QAC5F,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,sCAAsC,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAyC,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;QAC7H,OAAO,QAAQ,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,yCAAyC;IAEzC;;;OAGG;IACI,KAAK,CAAC,mBAAmB,CAAC,aAA6B;QAC1D,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;IAED;;;OAGG;IACI,KAAK,CAAC,kBAAkB,CAAC,aAA6B;QACzD,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,YAAY,CAAC,aAA6B;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;QAC7D,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,sBAAsB,CAAC,aAA6B;QAC7D,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,gBAAgB,CAAC,aAA6B;QACvD,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;IAED;;;OAGG;IACI,KAAK,CAAC,eAAe,CAAC,aAA6B;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,kDAAkD,CAAC,CAAC;QAChF,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,UAAU,CAAC,aAA6B;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QACvD,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,kCAAkC,CAAC,CAAC;QAChE,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,yBAAyB,CAAC,aAA6B;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,4CAA4C,CAAC,CAAC;QAC1E,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,mBAAmB,CAAC,aAA6B;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACjD,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;;;;;OAKG;IACI,KAAK,CAAC,uBAAuB,CAChC,IAAY,EACZ,QAAgB,EAChB,SAAiB,EACjB,SAAiB,EACjB,OAAe,EACf,aAA6B;QAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACnC,IAAI,EACJ,EAAE,IAAI,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAC9G,aAAa,CAChB,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,mBAAmB,CAAC,aAA6B;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC5C,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/site.d.ts

@@ -0,0 +1,70 @@
+import type { CustomHeaders, OmadaSiteSummary } from '../types/index.js';
+import type { RequestHandler } from './request.js';
+/**
+ * Site-related operations for the Omada API.
+ */
+export declare class SiteOperations {
+    private readonly request;
+    private readonly buildPath;
+    private readonly defaultSiteId?;
+    constructor(request: RequestHandler, buildPath: (path: string) => string, defaultSiteId?: string | undefined);
+    /**
+     * List all sites accessible to the authenticated user.
+     */
+    listSites(customHeaders?: CustomHeaders): Promise<OmadaSiteSummary[]>;
+    /**
+     * Resolve a site ID from the parameter or default configuration.
+     * @throws {Error} If no site ID is available
+     */
+    resolveSiteId(siteId?: string): string;
+    /**
+     * Get site detail by site ID.
+     * OperationId: getSiteEntity
+     */
+    getSiteDetail(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site URL.
+     * OperationId: getSiteUrlByOpenApi
+     */
+    getSiteUrl(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site NTP server status.
+     * OperationId: getNtpServerStatus
+     */
+    getSiteNtpStatus(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site specification.
+     * OperationId: getSiteSpecification
+     */
+    getSiteSpecification(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site remember device setting.
+     * OperationId: getSiteRememberSettingByOpenApi
+     */
+    getSiteRememberSetting(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site device account setting.
+     * OperationId: getSiteDeviceAccountSetting
+     */
+    getSiteDeviceAccount(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site capacity.
+     * OperationId: getSiteSettingCap
+     */
+    getSiteCapacity(siteId?: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site template list.
+     * OperationId: getSiteTemplateList
+     */
+    getSiteTemplateList(customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site template detail by template ID.
+     * OperationId: getSiteTemplateEntity
+     */
+    getSiteTemplateDetail(siteTemplateId: string, customHeaders?: CustomHeaders): Promise<unknown>;
+    /**
+     * Get site template configuration.
+     * OperationId: getSiteTemplateConfiguration
+     */
+    getSiteTemplateConfig(siteTemplateId: string, customHeaders?: CustomHeaders): Promise<unknown>;
+}

package/dist/omadaClient/site.js

@@ -0,0 +1,130 @@
+/**
+ * Site-related operations for the Omada API.
+ */
+export class SiteOperations {
+    request;
+    buildPath;
+    defaultSiteId;
+    constructor(request, buildPath, defaultSiteId) {
+        this.request = request;
+        this.buildPath = buildPath;
+        this.defaultSiteId = defaultSiteId;
+    }
+    /**
+     * List all sites accessible to the authenticated user.
+     */
+    async listSites(customHeaders) {
+        return await this.request.fetchPaginated(this.buildPath('/sites'), {}, customHeaders);
+    }
+    /**
+     * Resolve a site ID from the parameter or default configuration.
+     * @throws {Error} If no site ID is available
+     */
+    resolveSiteId(siteId) {
+        if (siteId) {
+            return siteId;
+        }
+        if (this.defaultSiteId) {
+            return this.defaultSiteId;
+        }
+        throw new Error('A site id must be provided either in the environment or as a parameter.');
+    }
+    /**
+     * Get site detail by site ID.
+     * OperationId: getSiteEntity
+     */
+    async getSiteDetail(siteId, customHeaders) {
+        const resolvedSiteId = this.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site URL.
+     * OperationId: getSiteUrlByOpenApi
+     */
+    async getSiteUrl(siteId, customHeaders) {
+        const resolvedSiteId = this.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/url`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site NTP server status.
+     * OperationId: getNtpServerStatus
+     */
+    async getSiteNtpStatus(siteId, customHeaders) {
+        const resolvedSiteId = this.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/setting/ntp`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site specification.
+     * OperationId: getSiteSpecification
+     */
+    async getSiteSpecification(siteId, customHeaders) {
+        const resolvedSiteId = this.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/specification`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site remember device setting.
+     * OperationId: getSiteRememberSettingByOpenApi
+     */
+    async getSiteRememberSetting(siteId, customHeaders) {
+        const resolvedSiteId = this.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/remember-device`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site device account setting.
+     * OperationId: getSiteDeviceAccountSetting
+     */
+    async getSiteDeviceAccount(siteId, customHeaders) {
+        const resolvedSiteId = this.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/device-account`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site capacity.
+     * OperationId: getSiteSettingCap
+     */
+    async getSiteCapacity(siteId, customHeaders) {
+        const resolvedSiteId = this.resolveSiteId(siteId);
+        const path = this.buildPath(`/sites/${encodeURIComponent(resolvedSiteId)}/capacity`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site template list.
+     * OperationId: getSiteTemplateList
+     */
+    async getSiteTemplateList(customHeaders) {
+        const path = this.buildPath('/sitetemplates');
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site template detail by template ID.
+     * OperationId: getSiteTemplateEntity
+     */
+    async getSiteTemplateDetail(siteTemplateId, customHeaders) {
+        const path = this.buildPath(`/sitetemplates/${encodeURIComponent(siteTemplateId)}`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+    /**
+     * Get site template configuration.
+     * OperationId: getSiteTemplateConfiguration
+     */
+    async getSiteTemplateConfig(siteTemplateId, customHeaders) {
+        const path = this.buildPath(`/sitetemplates/${encodeURIComponent(siteTemplateId)}/setting/configuration`);
+        const response = await this.request.get(path, undefined, customHeaders);
+        return this.request.ensureSuccess(response);
+    }
+}
+//# sourceMappingURL=site.js.map

package/dist/omadaClient/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../src/omadaClient/site.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,cAAc;IAEF;IACA;IACA;IAHrB,YACqB,OAAuB,EACvB,SAAmC,EACnC,aAAsB;QAFtB,YAAO,GAAP,OAAO,CAAgB;QACvB,cAAS,GAAT,SAAS,CAA0B;QACnC,kBAAa,GAAb,aAAa,CAAS;IACxC,CAAC;IAEJ;;OAEG;IACI,KAAK,CAAC,SAAS,CAAC,aAA6B;QAChD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAmB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC;IAC5G,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,MAAe;QAChC,IAAI,MAAM,EAAE,CAAC;YACT,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,aAAa,CAAC;QAC9B,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC/F,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,aAAa,CAAC,MAAe,EAAE,aAA6B;QACrE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAC5E,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,UAAU,CAAC,MAAe,EAAE,aAA6B;QAClE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAChF,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,gBAAgB,CAAC,MAAe,EAAE,aAA6B;QACxE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QACxF,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,oBAAoB,CAAC,MAAe,EAAE,aAA6B;QAC5E,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAC1F,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,sBAAsB,CAAC,MAAe,EAAE,aAA6B;QAC9E,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QAC5F,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,oBAAoB,CAAC,MAAe,EAAE,aAA6B;QAC5E,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QAC3F,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,eAAe,CAAC,MAAe,EAAE,aAA6B;QACvE,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,kBAAkB,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACrF,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,mBAAmB,CAAC,aAA6B;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC9C,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,qBAAqB,CAAC,cAAsB,EAAE,aAA6B;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACpF,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,qBAAqB,CAAC,cAAsB,EAAE,aAA6B;QACpF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,wBAAwB,CAAC,CAAC;QAC1G,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/server/common.d.ts

@@ -0,0 +1,98 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { type CallToolResult, type ServerNotification, type ServerRequest } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const customHeadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+export declare const deviceMacSchema: z.ZodString;
+export declare const siteInputSchema: z.ZodObject<{
+    siteId: z.ZodOptional<z.ZodString>;
+    customHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}, {
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}>;
+export declare const clientIdSchema: z.ZodObject<{
+    siteId: z.ZodOptional<z.ZodString>;
+    customHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    clientId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    clientId: string;
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}, {
+    clientId: string;
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}>;
+export declare const deviceIdSchema: z.ZodObject<{
+    siteId: z.ZodOptional<z.ZodString>;
+    customHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    deviceId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    deviceId: string;
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}, {
+    deviceId: string;
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}>;
+export declare const customRequestSchema: z.ZodObject<{
+    method: z.ZodDefault<z.ZodString>;
+    url: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    data: z.ZodOptional<z.ZodUnknown>;
+    siteId: z.ZodOptional<z.ZodString>;
+    customHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    method: string;
+    params?: Record<string, unknown> | undefined;
+    siteId?: string | undefined;
+    data?: unknown;
+    customHeaders?: Record<string, string> | undefined;
+}, {
+    url: string;
+    params?: Record<string, unknown> | undefined;
+    siteId?: string | undefined;
+    data?: unknown;
+    method?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}>;
+export declare const stackIdSchema: z.ZodObject<{
+    siteId: z.ZodOptional<z.ZodString>;
+    customHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+} & {
+    stackId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    stackId: string;
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}, {
+    stackId: string;
+    siteId?: string | undefined;
+    customHeaders?: Record<string, string> | undefined;
+}>;
+export declare function toToolResult(value: unknown): CallToolResult;
+export declare function safeSerialize(value: unknown): string;
+export type ToolExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
+export interface MutationSummary {
+    action: string;
+    target: string;
+    siteId?: string;
+    mode: 'apply' | 'dry-run';
+    status: 'planned' | 'applied';
+    summary: string;
+    result?: unknown;
+}
+export declare function wrapToolHandler<Args extends z.ZodRawShape>(name: string, handler: (args: z.objectOutputType<Args, z.ZodTypeAny>, extra: ToolExtra) => Promise<CallToolResult>): (args: z.objectOutputType<Args, z.ZodTypeAny>, extra: ToolExtra) => Promise<CallToolResult>;
+export declare function toMutationResult(summary: MutationSummary): CallToolResult;
+export declare function wrapMutationToolHandler<Args extends z.ZodRawShape>(name: string, summary: (args: z.objectOutputType<Args, z.ZodTypeAny>, result: unknown, mode: 'apply' | 'dry-run') => MutationSummary, handler: (args: z.objectOutputType<Args, z.ZodTypeAny>, extra: ToolExtra) => Promise<unknown>): (args: z.objectOutputType<Args, z.ZodTypeAny>, extra: ToolExtra) => Promise<CallToolResult>;
+declare function setupServerLogging(server: McpServer): void;
+export declare function createServer(): McpServer;
+export { setupServerLogging };