@davidfuchs/mcp-uptime-kuma 0.7.0 → 0.10.0

package/dist/uptime-kuma-client.d.ts

@@ -1,6 +1,6 @@
 import { Socket } from 'socket.io-client';
 import type { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
-import type { MonitorBaseWithExtendedData, MonitorWithExtendedData, ApiResponse, LoginResponse, MonitorList, MonitorSummary, Heartbeat, GetSettingsResponse, Notification, Maintenance, StatusPage } from './types/index.js';
+import type { MonitorBaseWithExtendedData, MonitorWithExtendedData, ApiResponse, LoginResponse, MonitorList, MonitorSummary, Heartbeat, GetSettingsResponse, Notification, Maintenance, StatusPage, DockerHost } from './types/index.js';
 /**
  * Uptime Kuma Socket.io API Client
  */
@@ -15,6 +15,7 @@ export declare class UptimeKumaClient {
     private tagListCache;
     private maintenanceListCache;
     private statusPageListCache;
+    private dockerHostListCache;
     private server?;
     private shouldLog;
     private loginCredentials;
@@ -148,8 +149,11 @@ export declare class UptimeKumaClient {
     private setupTagListListeners;
     private setupMaintenanceListListeners;
     private setupStatusPageListListeners;
+    private setupDockerHostListListeners;
     /**
-     * Create a new monitor
+     * Create a new monitor. If `tags` are supplied, they are applied after
+     * creation using the separate `addMonitorTag` socket event — the `add`
+     * socket handler does not process tags.
      *
      * @param monitorData - Monitor configuration (type-specific fields should be included)
      * @returns Promise resolving to the API response with the new monitorID
@@ -158,7 +162,11 @@ export declare class UptimeKumaClient {
         monitorID?: number;
     }>;
     /**
-     * Update an existing monitor
+     * Update an existing monitor. If `tags` are supplied, they are reconciled
+     * against the monitor's current tag set using `addMonitorTag` /
+     * `deleteMonitorTag` — the `editMonitor` socket handler does not process
+     * tags. Tags whose name is not yet in the catalog are auto-created via
+     * `addTag` before binding.
      *
      * @param monitorData - Monitor configuration including the id field
      * @returns Promise resolving to the API response
@@ -166,6 +174,26 @@ export declare class UptimeKumaClient {
     updateMonitor(monitorData: Record<string, unknown>): Promise<ApiResponse & {
         monitorID?: number;
     }>;
+    /**
+     * Fetch the tag catalog synchronously from the server. Uptime Kuma does
+     * not push `tagList` events — it only responds to the `getTags` request —
+     * so relying on the push-populated cache returns stale (often empty) data.
+     * This method also refreshes `tagListCache` so subsequent cache reads work.
+     */
+    private fetchTagList;
+    /**
+     * Bind a tag to a monitor (socket: `addMonitorTag`).
+     */
+    private addMonitorTag;
+    /**
+     * Unbind a tag from a monitor (socket: `deleteMonitorTag`).
+     */
+    private deleteMonitorTag;
+    /**
+     * Reconcile a monitor's tags against the desired list. Auto-creates any
+     * tag name that isn't yet in the catalog. Tag identity is `(name, value)`.
+     */
+    private reconcileMonitorTags;
     /**
      * Delete a monitor
      *
@@ -195,13 +223,45 @@ export declare class UptimeKumaClient {
      */
     deleteNotification(notificationID: number): Promise<ApiResponse>;
     /**
-     * Get the cached tag list
+     * Get the cached docker host list
+     */
+    getDockerHostList(): DockerHost[];
+    /**
+     * Add or update a docker host
+     *
+     * @param dockerHost - Docker host configuration (name, dockerType, dockerDaemon)
+     * @param dockerHostID - If provided, updates existing; otherwise creates new
+     * @returns Promise resolving to the API response with the docker host id
+     */
+    addDockerHost(dockerHost: Record<string, unknown>, dockerHostID?: number): Promise<ApiResponse & {
+        id?: number;
+    }>;
+    /**
+     * Delete a docker host. Any monitors referencing it will have their docker_host
+     * field cleared by Uptime Kuma.
+     *
+     * @param dockerHostID - The ID of the docker host to delete
+     * @returns Promise resolving to the API response
+     */
+    deleteDockerHost(dockerHostID: number): Promise<ApiResponse>;
+    /**
+     * Test connectivity to a docker host without persisting it. Returns a friendly
+     * message containing the number of containers when reachable.
+     *
+     * @param dockerHost - Docker host configuration to test (name, dockerType, dockerDaemon)
+     * @returns Promise resolving to the API response
      */
-    getTagList(): Array<{
+    testDockerHost(dockerHost: Record<string, unknown>): Promise<ApiResponse>;
+    /**
+     * Get the tag list. Actively fetches from the server since Uptime Kuma
+     * does not push `tagList` events on login (issue #46).
+     * Falls back to the cache if the socket is not connected.
+     */
+    getTagList(): Promise<Array<{
         id: number;
         name: string;
         color: string;
-    }>;
+    }>>;
     /**
      * Create a new tag
      *
@@ -240,6 +300,48 @@ export declare class UptimeKumaClient {
      * Get the cached status page list
      */
     getStatusPageList(): StatusPage[];
+    /**
+     * Get full details of a single status page, including publicGroupList with monitors
+     * and any active incidents. Uses the public HTTP API (`/api/status-page/{slug}`),
+     * which returns the same data the status page UI renders — richer than the
+     * socket `getStatusPage` event, which only returns config.
+     *
+     * @param slug - The status page slug
+     * @returns Promise resolving to the status page config, groups, and incidents
+     */
+    getStatusPage(slug: string): Promise<ApiResponse & {
+        config?: StatusPage;
+        publicGroupList?: unknown[];
+        incidents?: unknown[];
+    }>;
+    /**
+     * Create a new (empty) status page with the given title and slug
+     *
+     * Note: This creates a blank status page. Use updateStatusPage afterwards to
+     * set description, theme, groups, monitors, etc.
+     *
+     * @param title - Display title of the status page
+     * @param slug - URL slug (lowercase letters, digits, and dashes only)
+     * @returns Promise resolving to the API response
+     */
+    createStatusPage(title: string, slug: string): Promise<ApiResponse>;
+    /**
+     * Update an existing status page's config and group/monitor list
+     *
+     * @param slug - The status page slug (immutable identifier)
+     * @param config - Status page configuration (title, description, theme, published, etc.)
+     * @param publicGroupList - Ordered groups, each with a name, weight, and monitorList `[{id}]`
+     * @param imgDataUrl - Optional icon as data URL (pass empty string to keep existing)
+     * @returns Promise resolving to the API response
+     */
+    updateStatusPage(slug: string, config: Record<string, unknown>, publicGroupList?: Array<Record<string, unknown>>, imgDataUrl?: string): Promise<ApiResponse>;
+    /**
+     * Delete a status page
+     *
+     * @param slug - The status page slug
+     * @returns Promise resolving to the API response
+     */
+    deleteStatusPage(slug: string): Promise<ApiResponse>;
     /**
      * Get the socket instance (for advanced usage)
      */

package/dist/uptime-kuma-client.d.ts.map

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

package/dist/uptime-kuma-client.js

@@ -30,6 +30,7 @@ export class UptimeKumaClient {
     tagListCache = [];
     maintenanceListCache = {};
     statusPageListCache = {};
+    dockerHostListCache = [];
     server;
     shouldLog;
     loginCredentials = null;
@@ -138,6 +139,7 @@ export class UptimeKumaClient {
             this.socket.off('tagList');
             this.socket.off('maintenanceList');
             this.socket.off('statusPageList');
+            this.socket.off('dockerHostList');
             this.socket.disconnect();
             this.socket = null;
         }
@@ -150,6 +152,7 @@ export class UptimeKumaClient {
         this.tagListCache = [];
         this.maintenanceListCache = {};
         this.statusPageListCache = {};
+        this.dockerHostListCache = [];
     }
     /**
      * Login using username and password, or JWT token
@@ -177,6 +180,7 @@ export class UptimeKumaClient {
             this.setupTagListListeners();
             this.setupMaintenanceListListeners();
             this.setupStatusPageListListeners();
+            this.setupDockerHostListListeners();
             // If JWT token is provided, use token-based authentication
             if (jwtToken) {
                 this.socket.emit('loginByToken', jwtToken, (response) => {
@@ -611,8 +615,9 @@ export class UptimeKumaClient {
         if (!this.socket)
             return;
         this.socket.on('tagList', (tagList) => {
-            this.safeLog('debug', `Received tagList with ${tagList.length} tags`);
-            this.tagListCache = tagList;
+            const tags = Array.isArray(tagList) ? tagList : Object.values(tagList);
+            this.safeLog('debug', `Received tagList with ${tags.length} tags`);
+            this.tagListCache = tags;
         });
     }
     setupMaintenanceListListeners() {
@@ -631,53 +636,177 @@ export class UptimeKumaClient {
             this.statusPageListCache = statusPageList;
         });
     }
+    setupDockerHostListListeners() {
+        if (!this.socket)
+            return;
+        this.socket.on('dockerHostList', (dockerHostList) => {
+            this.safeLog('debug', `Received dockerHostList with ${dockerHostList.length} docker hosts`);
+            this.dockerHostListCache = dockerHostList;
+        });
+    }
     // ─── Monitor write operations ───────────────────────────────────────────────
     /**
-     * Create a new monitor
+     * Create a new monitor. If `tags` are supplied, they are applied after
+     * creation using the separate `addMonitorTag` socket event — the `add`
+     * socket handler does not process tags.
      *
      * @param monitorData - Monitor configuration (type-specific fields should be included)
      * @returns Promise resolving to the API response with the new monitorID
      */
-    createMonitor(monitorData) {
-        return new Promise((resolve, reject) => {
+    async createMonitor(monitorData) {
+        const { tags, ...payload } = monitorData;
+        const response = await new Promise((resolve, reject) => {
             if (!this.socket || !this.socket.connected) {
                 reject(new Error('Not connected to server'));
                 return;
             }
-            this.socket.emit('add', monitorData, (response) => {
-                if (response.ok) {
-                    this.safeLog('info', `Successfully created monitor (ID: ${response.monitorID})`);
-                    resolve(response);
+            this.socket.emit('add', payload, (res) => {
+                if (res.ok) {
+                    this.safeLog('info', `Successfully created monitor (ID: ${res.monitorID})`);
+                    resolve(res);
                 }
                 else {
-                    reject(new Error(response.msg || 'Failed to create monitor'));
+                    reject(new Error(res.msg || 'Failed to create monitor'));
                 }
             });
         });
+        if (tags && Array.isArray(tags) && response.monitorID != null) {
+            await this.reconcileMonitorTags(response.monitorID, tags);
+        }
+        return response;
     }
     /**
-     * Update an existing monitor
+     * Update an existing monitor. If `tags` are supplied, they are reconciled
+     * against the monitor's current tag set using `addMonitorTag` /
+     * `deleteMonitorTag` — the `editMonitor` socket handler does not process
+     * tags. Tags whose name is not yet in the catalog are auto-created via
+     * `addTag` before binding.
      *
      * @param monitorData - Monitor configuration including the id field
      * @returns Promise resolving to the API response
      */
-    updateMonitor(monitorData) {
-        return new Promise((resolve, reject) => {
+    async updateMonitor(monitorData) {
+        const { tags, ...payload } = monitorData;
+        const response = await new Promise((resolve, reject) => {
             if (!this.socket || !this.socket.connected) {
                 reject(new Error('Not connected to server'));
                 return;
             }
-            this.socket.emit('editMonitor', monitorData, (response) => {
-                if (response.ok) {
+            this.socket.emit('editMonitor', payload, (res) => {
+                if (res.ok) {
                     this.safeLog('info', `Successfully updated monitor (ID: ${monitorData['id']})`);
-                    resolve(response);
+                    resolve(res);
+                }
+                else {
+                    reject(new Error(res.msg || 'Failed to update monitor'));
+                }
+            });
+        });
+        if (tags && Array.isArray(tags) && monitorData['id'] != null) {
+            await this.reconcileMonitorTags(Number(monitorData['id']), tags);
+        }
+        return response;
+    }
+    /**
+     * Fetch the tag catalog synchronously from the server. Uptime Kuma does
+     * not push `tagList` events — it only responds to the `getTags` request —
+     * so relying on the push-populated cache returns stale (often empty) data.
+     * This method also refreshes `tagListCache` so subsequent cache reads work.
+     */
+    fetchTagList() {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('getTags', (res) => {
+                if (res.ok && res.tags) {
+                    this.tagListCache = res.tags;
+                    resolve(res.tags);
                 }
                 else {
-                    reject(new Error(response.msg || 'Failed to update monitor'));
+                    reject(new Error(res.msg || 'Failed to fetch tag list'));
                 }
             });
         });
     }
+    /**
+     * Bind a tag to a monitor (socket: `addMonitorTag`).
+     */
+    addMonitorTag(tagID, monitorID, value) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('addMonitorTag', tagID, monitorID, value, (res) => {
+                if (res.ok)
+                    resolve(res);
+                else
+                    reject(new Error(res.msg || `Failed to add tag ${tagID} to monitor ${monitorID}`));
+            });
+        });
+    }
+    /**
+     * Unbind a tag from a monitor (socket: `deleteMonitorTag`).
+     */
+    deleteMonitorTag(tagID, monitorID, value) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('deleteMonitorTag', tagID, monitorID, value, (res) => {
+                if (res.ok)
+                    resolve(res);
+                else
+                    reject(new Error(res.msg || `Failed to remove tag ${tagID} from monitor ${monitorID}`));
+            });
+        });
+    }
+    /**
+     * Reconcile a monitor's tags against the desired list. Auto-creates any
+     * tag name that isn't yet in the catalog. Tag identity is `(name, value)`.
+     */
+    async reconcileMonitorTags(monitorID, desiredTags) {
+        const currentMonitor = this.monitorListCache[String(monitorID)];
+        const currentTags = (currentMonitor?.tags ?? []);
+        const key = (name, value) => `${name}\u0000${value ?? ''}`;
+        const currentKeys = new Set(currentTags.map((t) => key(t.name, t.value)));
+        const desiredKeys = new Set(desiredTags.map((t) => key(String(t.name), t.value)));
+        // Uptime Kuma never pushes `tagList` events, so the cache is unreliable
+        // — fetch the catalog synchronously via the `getTags` socket request.
+        const freshTags = await this.fetchTagList();
+        const nameToID = new Map();
+        for (const t of freshTags)
+            nameToID.set(t.name, t.id);
+        for (const desired of desiredTags) {
+            const name = String(desired.name);
+            const value = desired.value ?? '';
+            if (currentKeys.has(key(name, value)))
+                continue;
+            let tagID = nameToID.get(name);
+            if (tagID == null) {
+                const color = desired.color ?? '#808080';
+                const created = await this.addTag(name, color);
+                tagID = created.tag?.id;
+                if (tagID != null)
+                    nameToID.set(name, tagID);
+            }
+            if (tagID == null) {
+                throw new Error(`Could not resolve tag ID for "${name}"`);
+            }
+            await this.addMonitorTag(tagID, monitorID, value);
+        }
+        for (const existing of currentTags) {
+            if (desiredKeys.has(key(existing.name, existing.value)))
+                continue;
+            const tagID = existing.tag_id ?? nameToID.get(existing.name);
+            if (tagID == null)
+                continue;
+            await this.deleteMonitorTag(tagID, monitorID, existing.value ?? '');
+        }
+    }
     /**
      * Delete a monitor
      *
@@ -756,12 +885,96 @@ export class UptimeKumaClient {
             });
         });
     }
+    // ─── Docker host operations ─────────────────────────────────────────────────
+    /**
+     * Get the cached docker host list
+     */
+    getDockerHostList() {
+        return this.dockerHostListCache;
+    }
+    /**
+     * Add or update a docker host
+     *
+     * @param dockerHost - Docker host configuration (name, dockerType, dockerDaemon)
+     * @param dockerHostID - If provided, updates existing; otherwise creates new
+     * @returns Promise resolving to the API response with the docker host id
+     */
+    addDockerHost(dockerHost, dockerHostID) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            const id = dockerHostID ?? null;
+            this.socket.emit('addDockerHost', dockerHost, id, (response) => {
+                if (response.ok) {
+                    this.safeLog('info', `Successfully saved docker host (ID: ${response.id})`);
+                    resolve(response);
+                }
+                else {
+                    reject(new Error(response.msg || 'Failed to save docker host'));
+                }
+            });
+        });
+    }
+    /**
+     * Delete a docker host. Any monitors referencing it will have their docker_host
+     * field cleared by Uptime Kuma.
+     *
+     * @param dockerHostID - The ID of the docker host to delete
+     * @returns Promise resolving to the API response
+     */
+    deleteDockerHost(dockerHostID) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('deleteDockerHost', dockerHostID, (response) => {
+                if (response.ok) {
+                    this.safeLog('info', `Successfully deleted docker host ${dockerHostID}`);
+                    resolve(response);
+                }
+                else {
+                    reject(new Error(response.msg || 'Failed to delete docker host'));
+                }
+            });
+        });
+    }
+    /**
+     * Test connectivity to a docker host without persisting it. Returns a friendly
+     * message containing the number of containers when reachable.
+     *
+     * @param dockerHost - Docker host configuration to test (name, dockerType, dockerDaemon)
+     * @returns Promise resolving to the API response
+     */
+    testDockerHost(dockerHost) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('testDockerHost', dockerHost, (response) => {
+                // Resolve either way so callers can inspect ok/msg without try/catch
+                // (matches the pattern used by UK's UI, which shows both success and
+                // failure messages from the same callback).
+                resolve(response);
+            });
+        });
+    }
     // ─── Tag operations ─────────────────────────────────────────────────────────
     /**
-     * Get the cached tag list
+     * Get the tag list. Actively fetches from the server since Uptime Kuma
+     * does not push `tagList` events on login (issue #46).
+     * Falls back to the cache if the socket is not connected.
      */
-    getTagList() {
-        return this.tagListCache;
+    async getTagList() {
+        try {
+            return await this.fetchTagList();
+        }
+        catch {
+            return this.tagListCache;
+        }
     }
     /**
      * Create a new tag
@@ -847,6 +1060,114 @@ export class UptimeKumaClient {
     getStatusPageList() {
         return Object.values(this.statusPageListCache);
     }
+    /**
+     * Get full details of a single status page, including publicGroupList with monitors
+     * and any active incidents. Uses the public HTTP API (`/api/status-page/{slug}`),
+     * which returns the same data the status page UI renders — richer than the
+     * socket `getStatusPage` event, which only returns config.
+     *
+     * @param slug - The status page slug
+     * @returns Promise resolving to the status page config, groups, and incidents
+     */
+    async getStatusPage(slug) {
+        try {
+            const baseUrl = this.url.replace(/\/$/, '');
+            const res = await fetch(`${baseUrl}/api/status-page/${encodeURIComponent(slug)}`);
+            if (res.status === 404) {
+                return { ok: false, msg: `Status page ${slug} not found` };
+            }
+            if (!res.ok) {
+                throw new Error(`HTTP ${res.status} ${res.statusText}`);
+            }
+            const data = await res.json();
+            return {
+                ok: true,
+                config: data.config,
+                publicGroupList: data.publicGroupList,
+                incidents: data.incidents ?? [],
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error(`Failed to get status page ${slug}: ${msg}`);
+        }
+    }
+    /**
+     * Create a new (empty) status page with the given title and slug
+     *
+     * Note: This creates a blank status page. Use updateStatusPage afterwards to
+     * set description, theme, groups, monitors, etc.
+     *
+     * @param title - Display title of the status page
+     * @param slug - URL slug (lowercase letters, digits, and dashes only)
+     * @returns Promise resolving to the API response
+     */
+    createStatusPage(title, slug) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('addStatusPage', title, slug, (response) => {
+                if (response.ok) {
+                    this.safeLog('info', `Successfully created status page ${slug}`);
+                    resolve(response);
+                }
+                else {
+                    reject(new Error(response.msg || `Failed to create status page ${slug}`));
+                }
+            });
+        });
+    }
+    /**
+     * Update an existing status page's config and group/monitor list
+     *
+     * @param slug - The status page slug (immutable identifier)
+     * @param config - Status page configuration (title, description, theme, published, etc.)
+     * @param publicGroupList - Ordered groups, each with a name, weight, and monitorList `[{id}]`
+     * @param imgDataUrl - Optional icon as data URL (pass empty string to keep existing)
+     * @returns Promise resolving to the API response
+     */
+    updateStatusPage(slug, config, publicGroupList = [], imgDataUrl = '') {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('saveStatusPage', slug, config, imgDataUrl, publicGroupList, (response) => {
+                if (response.ok) {
+                    this.safeLog('info', `Successfully updated status page ${slug}`);
+                    resolve(response);
+                }
+                else {
+                    reject(new Error(response.msg || `Failed to update status page ${slug}`));
+                }
+            });
+        });
+    }
+    /**
+     * Delete a status page
+     *
+     * @param slug - The status page slug
+     * @returns Promise resolving to the API response
+     */
+    deleteStatusPage(slug) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || !this.socket.connected) {
+                reject(new Error('Not connected to server'));
+                return;
+            }
+            this.socket.emit('deleteStatusPage', slug, (response) => {
+                if (response.ok) {
+                    this.safeLog('info', `Successfully deleted status page ${slug}`);
+                    resolve(response);
+                }
+                else {
+                    reject(new Error(response.msg || `Failed to delete status page ${slug}`));
+                }
+            });
+        });
+    }
     // ─── Socket accessor ─────────────────────────────────────────────────────────
     /**
      * Get the socket instance (for advanced usage)