add empty method for future homebridge version

Author: bwp91

CHANGELOG.md

@@ -8,6 +8,7 @@ All notable changes to `@homebridge/plugin-ui-utils` will be documented in this
 
 - updated dependencies
 - update release script for oidc releases
+- add empty method for future homebridge version
 
 ## v2.1.2 (2025-11-22)
 

README.md

@@ -180,7 +180,7 @@ const schema = await homebridge.getPluginConfigSchema()
 
 > `homebridge.getCachedAccessories(): Promise<CachedAccessory[]>;`
 
-Returns the cached accessories for the plugin
+Returns the cached accessories for the plugin.
 
 ```ts
 const cachedAccessories = await homebridge.getCachedAccessories()

src/ui.interface.ts

@@ -71,6 +71,8 @@ export interface CachedAccessory {
   services: any[]
 }
 
+export interface CachedMatterAccessory { /* coming soon */ }
+
 export declare type PluginConfig = Record<string, any>
 
 export declare class IHomebridgePluginUi extends EventTarget {
@@ -267,6 +269,11 @@ export declare class IHomebridgePluginUi extends EventTarget {
    */
   public getCachedAccessories(): Promise<CachedAccessory[]>
 
+  /**
+   * Return an array of cached Matter accessories for your plugin.
+   */
+  public getCachedMatterAccessories(): Promise<CachedMatterAccessory[]>
+
   /**
    * Make a request to the plugins server side script
    * @param path - the path handler on the server that the request should be sent to

src/ui.mock.ts

@@ -111,6 +111,10 @@ export class MockHomebridgePluginUi extends EventTarget implements IHomebridgePl
   public async getCachedAccessories() {
     return []
   }
+
+  public async getCachedMatterAccessories() {
+    return []
+  }
 }
 
 export class MockHomebridgeUiToastHelper implements IHomebridgeUiToastHelper {

src/ui.ts

@@ -243,10 +243,14 @@ class HomebridgePluginUi extends EventTargetConstructor {
     return await this._requestResponse({ action: 'config.schema' })
   }
 
-  public async getCachedAccessories(): Promise<Record<string, string>> {
+  public async getCachedAccessories(): Promise<Record<string, any>[]> {
     return await this._requestResponse({ action: 'cachedAccessories.get' })
   }
 
+  public async getCachedMatterAccessories(): Promise<Record<string, any>[]> {
+    return []
+  }
+
   public async request(path: string, body?: any) {
     return await this._requestResponse({ action: 'request', path, body })
   }