@iobroker/js-controller-adapter 7.2.3 → 8.0.0-alpha.1-20260921-e5941ca8a

package/build/cjs/lib/adapter/managers/SubscriptionManager.d.ts

@@ -0,0 +1,107 @@
+import type { Pattern } from '../../_Types.js';
+import type { AdapterContext } from '../../../lib/adapter/context.js';
+import { AdapterContextBase } from '../../../lib/adapter/managers/AdapterContextBase.js';
+import type { AliasManager } from '../../../lib/adapter/managers/AliasManager.js';
+/** Prefixes an id or pattern with this adapter's namespace unless already namespaced. Bound to the adapter's Validator. */
+export type FixId = (id: string, isPattern?: boolean) => string;
+type SubOptions = {
+    user?: ioBroker.ObjectIDs.User;
+} | null | undefined;
+/** Reads the objects matching a pattern, used to discover alias objects during state subscription. */
+export interface ObjectAccess {
+    /**
+     * Objects matching `pattern`, keyed by id. Bound to the legacy `getForeignObjects(pattern, null, null, options)`
+     * call, whose `null` type/enums args clobber `options` — so no type filter and no user-ACL are applied;
+     * only `alias.*` ids in the result are consumed. Kept as-is for behavior parity.
+     */
+    getForeignStateObjects(pattern: string, options?: {
+        user?: ioBroker.ObjectIDs.User;
+    } | null): Promise<Record<string, ioBroker.AnyObject>>;
+}
+/** Owns object-, file- and state-change subscriptions plus the auto-subscribe bookkeeping. */
+export declare class SubscriptionManager extends AdapterContextBase {
+    #private;
+    /**
+     * @param ctx Shared adapter context providing live runtime state
+     * @param fixId Namespace-prefixer bound to the adapter's Validator
+     * @param aliasManager Alias subscription cache and bookkeeping
+     * @param objectAccess Reader for state-typed objects matching a pattern
+     */
+    constructor(ctx: AdapterContext, fixId: FixId, aliasManager: AliasManager, objectAccess: ObjectAccess);
+    /**
+     * Subscribe to object changes within this instance's namespace.
+     *
+     * @param pattern pattern without namespace, `*` for all own objects, or an array of patterns
+     *        passed through as-is (not namespaced)
+     * @param options optional user context
+     */
+    subscribeObjects(pattern: Pattern, options?: SubOptions): Promise<void>;
+    /**
+     * Unsubscribe from object changes within this instance's namespace.
+     *
+     * @param pattern pattern without namespace, `*` for all own objects, or an array of patterns
+     *        passed through as-is (not namespaced)
+     * @param options optional user context
+     */
+    unsubscribeObjects(pattern: Pattern, options?: SubOptions): Promise<void>;
+    /**
+     * Subscribe to object changes in any instance.
+     *
+     * @param pattern pattern or array of patterns
+     * @param options optional user context
+     */
+    subscribeForeignObjects(pattern: Pattern, options?: SubOptions): Promise<void>;
+    /**
+     * Unsubscribe from object changes in any instance.
+     *
+     * @param pattern pattern or array of patterns (defaults to `*`)
+     * @param options optional user context
+     */
+    unsubscribeForeignObjects(pattern: Pattern, options?: SubOptions): Promise<void>;
+    /**
+     * Subscribe to file changes in a specific instance.
+     *
+     * @param id adapter id, e.g. `vis-2.0`
+     * @param pattern pattern or array of patterns
+     * @param options optional user context
+     */
+    subscribeForeignFiles(id: string, pattern: Pattern, options?: SubOptions): Promise<void>;
+    /**
+     * Unsubscribe from file changes in a specific instance.
+     *
+     * @param id adapter id, e.g. `vis-2.0`
+     * @param pattern pattern or array of patterns (defaults to `*`)
+     * @param options optional user context
+     */
+    unsubscribeForeignFiles(id: string, pattern: Pattern, options?: SubOptions): Promise<void>;
+    /**
+     * Register an instance as auto-subscribable (its `subscribes` counter is maintained on subscribe/unsubscribe).
+     *
+     * @param id instance id, e.g. `pushover.0`
+     */
+    addSubscribableInstance(id: string): void;
+    /**
+     * Stop treating an instance as auto-subscribable.
+     *
+     * @param id instance id, e.g. `pushover.0`
+     */
+    removeSubscribableInstance(id: string): void;
+    /** Populate the auto-subscribe instance list from the objects DB. */
+    autoSubscribeOn(): Promise<void>;
+    /**
+     * Subscribe to state changes in any instance, resolving aliases and maintaining auto-subscribe counters.
+     *
+     * @param pattern pattern, `*`, an `alias.*` id, or an array of ids/patterns
+     * @param options optional user context
+     */
+    subscribeForeignStates(pattern: Pattern, options?: SubOptions): Promise<void>;
+    /**
+     * Unsubscribe from state changes in any instance, mirroring {@link subscribeForeignStates}.
+     *
+     * @param pattern pattern, `*`, an `alias.*` id, or an array of ids/patterns
+     * @param options optional user context
+     */
+    unsubscribeForeignStates(pattern: Pattern, options?: SubOptions): Promise<void>;
+}
+export {};
+//# sourceMappingURL=SubscriptionManager.d.ts.map

package/build/cjs/lib/adapter/managers/SubscriptionManager.js

@@ -0,0 +1,349 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var SubscriptionManager_exports = {};
+__export(SubscriptionManager_exports, {
+  SubscriptionManager: () => SubscriptionManager
+});
+module.exports = __toCommonJS(SubscriptionManager_exports);
+var import_js_controller_common = require("@iobroker/js-controller-common");
+var import_AdapterContextBase = require("../../../lib/adapter/managers/AdapterContextBase.js");
+var import_constants = require("../../../lib/adapter/constants.js");
+class SubscriptionManager extends import_AdapterContextBase.AdapterContextBase {
+  static {
+    __name(this, "SubscriptionManager");
+  }
+  #fixId;
+  #alias;
+  #objectAccess;
+  #autoSubscribe = [];
+  /**
+   * @param ctx Shared adapter context providing live runtime state
+   * @param fixId Namespace-prefixer bound to the adapter's Validator
+   * @param aliasManager Alias subscription cache and bookkeeping
+   * @param objectAccess Reader for state-typed objects matching a pattern
+   */
+  constructor(ctx, fixId, aliasManager, objectAccess) {
+    super(ctx);
+    this.#fixId = fixId;
+    this.#alias = aliasManager;
+    this.#objectAccess = objectAccess;
+  }
+  /**
+   * Subscribe to object changes within this instance's namespace.
+   *
+   * @param pattern pattern without namespace, `*` for all own objects, or an array of patterns
+   *        passed through as-is (not namespaced)
+   * @param options optional user context
+   */
+  async subscribeObjects(pattern, options) {
+    const fixed = pattern === "*" ? `${this.namespace}.*` : Array.isArray(pattern) ? pattern : this.#fixId(pattern, true);
+    return this.objects.subscribeUserAsync(fixed, options ?? null);
+  }
+  /**
+   * Unsubscribe from object changes within this instance's namespace.
+   *
+   * @param pattern pattern without namespace, `*` for all own objects, or an array of patterns
+   *        passed through as-is (not namespaced)
+   * @param options optional user context
+   */
+  async unsubscribeObjects(pattern, options) {
+    const fixed = pattern === "*" ? `${this.namespace}.*` : Array.isArray(pattern) ? pattern : this.#fixId(pattern, true);
+    return this.objects.unsubscribeUserAsync(fixed, options ?? null);
+  }
+  /**
+   * Subscribe to object changes in any instance.
+   *
+   * @param pattern pattern or array of patterns
+   * @param options optional user context
+   */
+  async subscribeForeignObjects(pattern, options) {
+    return this.objects.subscribeUserAsync(pattern, options ?? null);
+  }
+  /**
+   * Unsubscribe from object changes in any instance.
+   *
+   * @param pattern pattern or array of patterns (defaults to `*`)
+   * @param options optional user context
+   */
+  async unsubscribeForeignObjects(pattern, options) {
+    return this.objects.unsubscribeUserAsync(pattern || "*", options ?? null);
+  }
+  /**
+   * Subscribe to file changes in a specific instance.
+   *
+   * @param id adapter id, e.g. `vis-2.0`
+   * @param pattern pattern or array of patterns
+   * @param options optional user context
+   */
+  async subscribeForeignFiles(id, pattern, options) {
+    return this.objects.subscribeUserFile(id, pattern, options ?? void 0);
+  }
+  /**
+   * Unsubscribe from file changes in a specific instance.
+   *
+   * @param id adapter id, e.g. `vis-2.0`
+   * @param pattern pattern or array of patterns (defaults to `*`)
+   * @param options optional user context
+   */
+  async unsubscribeForeignFiles(id, pattern, options) {
+    return this.objects.unsubscribeUserFile(id, pattern || "*", options ?? void 0);
+  }
+  /**
+   * Register an instance as auto-subscribable (its `subscribes` counter is maintained on subscribe/unsubscribe).
+   *
+   * @param id instance id, e.g. `pushover.0`
+   */
+  addSubscribableInstance(id) {
+    if (!this.#autoSubscribe.includes(id)) {
+      this.#autoSubscribe.push(id);
+    }
+  }
+  /**
+   * Stop treating an instance as auto-subscribable.
+   *
+   * @param id instance id, e.g. `pushover.0`
+   */
+  removeSubscribableInstance(id) {
+    const pos = this.#autoSubscribe.indexOf(id);
+    if (pos !== -1) {
+      this.#autoSubscribe.splice(pos, 1);
+    }
+  }
+  /** Populate the auto-subscribe instance list from the objects DB. */
+  async autoSubscribeOn() {
+    if (!this.#autoSubscribe && this.objects) {
+      try {
+        const res = await this.objects.getObjectViewAsync("system", "instance", {
+          startkey: "system.adapter.",
+          endkey: "system.adapter.\u9999"
+        });
+        this.#autoSubscribe = [];
+        for (const row of res.rows) {
+          if (row.value?.common.subscribable) {
+            const _id = row.id.substring(15);
+            if (!this.#autoSubscribe.includes(_id)) {
+              this.#autoSubscribe.push(_id);
+            }
+          }
+        }
+        await this.objects.subscribeAsync("system.adapter.*");
+      } catch {
+      }
+    }
+  }
+  /**
+   * Subscribe to state changes in any instance, resolving aliases and maintaining auto-subscribe counters.
+   *
+   * @param pattern pattern, `*`, an `alias.*` id, or an array of ids/patterns
+   * @param options optional user context
+   */
+  async subscribeForeignStates(pattern, options) {
+    await this.autoSubscribeOn();
+    void this.states;
+    void this.objects;
+    for (const autoSubEntry of this.#autoSubscribe) {
+      if (typeof pattern === "string" && (pattern === "*" || pattern.startsWith(`${autoSubEntry}.`))) {
+        let state;
+        try {
+          state = await this.states.getState(`system.adapter.${autoSubEntry}.subscribes`);
+        } catch {
+        }
+        state = state || { val: "{}" };
+        state.val = state.val || "{}";
+        let subs;
+        try {
+          subs = JSON.parse(state.val);
+        } catch {
+          this.logger.error(`${this.namespaceLog} Cannot parse subscribes for "${autoSubEntry}.subscribes"`);
+        }
+        subs = import_js_controller_common.tools.isObject(subs) ? Object.assign(/* @__PURE__ */ Object.create(null), subs) : /* @__PURE__ */ Object.create(null);
+        if (!import_js_controller_common.tools.isObject(subs[pattern])) {
+          subs[pattern] = {};
+        }
+        if (typeof subs[pattern][this.namespace] !== "number") {
+          subs[pattern][this.namespace] = 0;
+        }
+        subs[pattern][this.namespace]++;
+        this.countOutput();
+        await this.states.setState(`system.adapter.${autoSubEntry}.subscribes`, JSON.stringify(subs));
+      }
+    }
+    if (Array.isArray(pattern)) {
+      const aliasesIds = pattern.map((id) => id.startsWith(import_constants.ALIAS_STARTS_WITH) ? id : null).filter((id) => id);
+      const nonAliasesIds = pattern.map((id) => !id.startsWith(import_constants.ALIAS_STARTS_WITH) ? id : null).filter((id) => id);
+      for (const aliasPattern of pattern) {
+        if ((aliasPattern.startsWith(import_constants.ALIAS_STARTS_WITH) || aliasPattern.includes("*")) && !this.#alias.hasPattern(aliasPattern)) {
+          this.#alias.addPattern(aliasPattern);
+        }
+      }
+      const promises = new Array();
+      if (aliasesIds.length) {
+        this.#alias.ensureAliasObjectSubscription();
+        let aliasObjs;
+        try {
+          aliasObjs = await this.objects.getObjects(aliasesIds, options);
+        } catch (e) {
+          this.logger.error(`Could not get objects by array: ${e.message}`);
+          aliasObjs = [];
+        }
+        for (const aliasObj of aliasObjs) {
+          if (aliasObj) {
+            promises.push(this.#alias.addAliasSubscribe(aliasObj, aliasObj._id));
+          }
+        }
+      }
+      if (nonAliasesIds.length) {
+        for (const id of nonAliasesIds) {
+          promises.push(new Promise((resolve) => this.states.subscribeUser(id, () => resolve())));
+        }
+      }
+      try {
+        await Promise.all(promises);
+      } catch (e) {
+        this.logger.error(`${this.namespaceLog} Error on "subscribeForeignStates": ${e.message}`);
+      }
+      return;
+    } else if (pattern.includes("*")) {
+      if (pattern === "*" || pattern.startsWith(import_constants.ALIAS_STARTS_WITH)) {
+        this.#alias.ensureAliasObjectSubscription();
+        try {
+          const objs = await this.#objectAccess.getForeignStateObjects(pattern, options);
+          const promises = new Array();
+          if (!this.#alias.hasPattern(pattern)) {
+            this.#alias.addPattern(pattern);
+          }
+          for (const id of Object.keys(objs)) {
+            if (id.startsWith(import_constants.ALIAS_STARTS_WITH)) {
+              const aliasObj = objs[id];
+              promises.push(this.#alias.addAliasSubscribe(aliasObj, pattern));
+            }
+          }
+          try {
+            await Promise.all(promises);
+          } catch (e) {
+            this.logger.error(`${this.namespaceLog} Error on "subscribeForeignStates": ${e.message}`);
+          }
+          const states = this.states;
+          if (promises.length && pattern !== "*") {
+            return;
+          }
+          return states.subscribeUser(pattern);
+        } catch (e) {
+          this.logger.warn(`${this.namespaceLog} Cannot subscribe to ${pattern}: ${e.message}`);
+          throw e;
+        }
+      } else {
+        return this.states.subscribeUser(pattern);
+      }
+    } else if (pattern.startsWith(import_constants.ALIAS_STARTS_WITH)) {
+      this.#alias.ensureAliasObjectSubscription();
+      try {
+        const aliasObj = await this.objects.getObject(pattern, options);
+        if (aliasObj) {
+          await this.#alias.addAliasSubscribe(aliasObj, pattern);
+          return;
+        }
+        return;
+      } catch (e) {
+        this.logger.warn(`${this.namespaceLog} cannot subscribe on alias "${pattern}": ${e.message}`);
+      }
+    } else {
+      return this.states.subscribeUser(pattern);
+    }
+  }
+  /**
+   * Unsubscribe from state changes in any instance, mirroring {@link subscribeForeignStates}.
+   *
+   * @param pattern pattern, `*`, an `alias.*` id, or an array of ids/patterns
+   * @param options optional user context
+   */
+  async unsubscribeForeignStates(pattern, options) {
+    pattern = pattern || "*";
+    void this.states;
+    if (this.#autoSubscribe && typeof pattern === "string") {
+      for (const autoSub of this.#autoSubscribe) {
+        if (pattern === "*" || pattern.substring(0, autoSub.length + 1) === `${autoSub}.`) {
+          let state;
+          try {
+            state = await this.states.getState(`system.adapter.${autoSub}.subscribes`);
+          } catch {
+          }
+          if (!state || !state.val) {
+            continue;
+          }
+          let subs;
+          try {
+            subs = JSON.parse(state.val);
+          } catch {
+            this.logger.error(`${this.namespaceLog} Cannot parse subscribes for "${autoSub}.subscribes"`);
+            continue;
+          }
+          if (!import_js_controller_common.tools.isObject(subs) || !import_js_controller_common.tools.isObject(subs[pattern]) || subs[pattern][this.namespace] === void 0) {
+            continue;
+          }
+          subs = Object.assign(/* @__PURE__ */ Object.create(null), subs);
+          if (typeof subs[pattern][this.namespace] === "number") {
+            subs[pattern][this.namespace]--;
+            if (subs[pattern][this.namespace] <= 0) {
+              delete subs[pattern][this.namespace];
+            }
+          } else {
+            delete subs[pattern][this.namespace];
+          }
+          if (!Object.keys(subs[pattern]).length) {
+            delete subs[pattern];
+          }
+          this.countOutput();
+          await this.states.setState(`system.adapter.${autoSub}.subscribes`, JSON.stringify(subs));
+        }
+      }
+    }
+    let aliasPattern;
+    const promises = new Array();
+    if (Array.isArray(pattern)) {
+      for (const _pattern of pattern) {
+        promises.push(this.unsubscribeForeignStates(_pattern, options));
+      }
+    } else if (pattern.includes("*") || pattern.startsWith(import_constants.ALIAS_STARTS_WITH)) {
+      if (pattern === "*" || pattern.startsWith(import_constants.ALIAS_STARTS_WITH)) {
+        aliasPattern = pattern;
+        if (pattern === "*") {
+          promises.push(this.states.unsubscribeUser(pattern));
+        }
+      } else {
+        promises.push(this.states.unsubscribeUser(pattern));
+      }
+    } else {
+      promises.push(this.states.unsubscribeUser(pattern));
+    }
+    if (aliasPattern) {
+      this.#alias.deletePattern(aliasPattern);
+      promises.push(this.#alias.removeTargetsForPattern(aliasPattern));
+    }
+    await Promise.all(promises);
+    this.#alias.maybeDropAliasObjectSubscription();
+    return;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SubscriptionManager
+});
+//# sourceMappingURL=SubscriptionManager.js.map

package/build/cjs/lib/adapter/managers/SubscriptionManager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/lib/adapter/managers/SubscriptionManager.ts"],
+  "sourcesContent": ["import { tools } from '@iobroker/js-controller-common';\nimport type { Pattern } from '../../_Types.js';\nimport type { AdapterContext } from '@/lib/adapter/context.js';\nimport { AdapterContextBase } from '@/lib/adapter/managers/AdapterContextBase.js';\nimport type { AliasManager } from '@/lib/adapter/managers/AliasManager.js';\nimport { ALIAS_STARTS_WITH } from '@/lib/adapter/constants.js';\n\n/** Prefixes an id or pattern with this adapter's namespace unless already namespaced. Bound to the adapter's Validator. */\nexport type FixId = (id: string, isPattern?: boolean) => string;\n\ntype SubOptions = { user?: ioBroker.ObjectIDs.User } | null | undefined;\n\n/** Reads the objects matching a pattern, used to discover alias objects during state subscription. */\nexport interface ObjectAccess {\n    /**\n     * Objects matching `pattern`, keyed by id. Bound to the legacy `getForeignObjects(pattern, null, null, options)`\n     * call, whose `null` type/enums args clobber `options` \u2014 so no type filter and no user-ACL are applied;\n     * only `alias.*` ids in the result are consumed. Kept as-is for behavior parity.\n     */\n    getForeignStateObjects(\n        pattern: string,\n        options?: { user?: ioBroker.ObjectIDs.User } | null,\n    ): Promise<Record<string, ioBroker.AnyObject>>;\n}\n\n/** Owns object-, file- and state-change subscriptions plus the auto-subscribe bookkeeping. */\nexport class SubscriptionManager extends AdapterContextBase {\n    readonly #fixId: FixId;\n    readonly #alias: AliasManager;\n    readonly #objectAccess: ObjectAccess;\n    #autoSubscribe: string[] = [];\n\n    /**\n     * @param ctx Shared adapter context providing live runtime state\n     * @param fixId Namespace-prefixer bound to the adapter's Validator\n     * @param aliasManager Alias subscription cache and bookkeeping\n     * @param objectAccess Reader for state-typed objects matching a pattern\n     */\n    constructor(ctx: AdapterContext, fixId: FixId, aliasManager: AliasManager, objectAccess: ObjectAccess) {\n        super(ctx);\n        this.#fixId = fixId;\n        this.#alias = aliasManager;\n        this.#objectAccess = objectAccess;\n    }\n\n    /**\n     * Subscribe to object changes within this instance's namespace.\n     *\n     * @param pattern pattern without namespace, `*` for all own objects, or an array of patterns\n     *        passed through as-is (not namespaced)\n     * @param options optional user context\n     */\n    async subscribeObjects(pattern: Pattern, options?: SubOptions): Promise<void> {\n        const fixed =\n            pattern === '*' ? `${this.namespace}.*` : Array.isArray(pattern) ? pattern : this.#fixId(pattern, true);\n        return this.objects.subscribeUserAsync(fixed, options ?? null);\n    }\n\n    /**\n     * Unsubscribe from object changes within this instance's namespace.\n     *\n     * @param pattern pattern without namespace, `*` for all own objects, or an array of patterns\n     *        passed through as-is (not namespaced)\n     * @param options optional user context\n     */\n    async unsubscribeObjects(pattern: Pattern, options?: SubOptions): Promise<void> {\n        const fixed =\n            pattern === '*' ? `${this.namespace}.*` : Array.isArray(pattern) ? pattern : this.#fixId(pattern, true);\n        return this.objects.unsubscribeUserAsync(fixed, options ?? null);\n    }\n\n    /**\n     * Subscribe to object changes in any instance.\n     *\n     * @param pattern pattern or array of patterns\n     * @param options optional user context\n     */\n    async subscribeForeignObjects(pattern: Pattern, options?: SubOptions): Promise<void> {\n        return this.objects.subscribeUserAsync(pattern, options ?? null);\n    }\n\n    /**\n     * Unsubscribe from object changes in any instance.\n     *\n     * @param pattern pattern or array of patterns (defaults to `*`)\n     * @param options optional user context\n     */\n    async unsubscribeForeignObjects(pattern: Pattern, options?: SubOptions): Promise<void> {\n        return this.objects.unsubscribeUserAsync(pattern || '*', options ?? null);\n    }\n\n    /**\n     * Subscribe to file changes in a specific instance.\n     *\n     * @param id adapter id, e.g. `vis-2.0`\n     * @param pattern pattern or array of patterns\n     * @param options optional user context\n     */\n    async subscribeForeignFiles(id: string, pattern: Pattern, options?: SubOptions): Promise<void> {\n        return this.objects.subscribeUserFile(id, pattern, options ?? undefined);\n    }\n\n    /**\n     * Unsubscribe from file changes in a specific instance.\n     *\n     * @param id adapter id, e.g. `vis-2.0`\n     * @param pattern pattern or array of patterns (defaults to `*`)\n     * @param options optional user context\n     */\n    async unsubscribeForeignFiles(id: string, pattern: Pattern, options?: SubOptions): Promise<void> {\n        return this.objects.unsubscribeUserFile(id, pattern || '*', options ?? undefined);\n    }\n\n    /**\n     * Register an instance as auto-subscribable (its `subscribes` counter is maintained on subscribe/unsubscribe).\n     *\n     * @param id instance id, e.g. `pushover.0`\n     */\n    addSubscribableInstance(id: string): void {\n        if (!this.#autoSubscribe.includes(id)) {\n            this.#autoSubscribe.push(id);\n        }\n    }\n\n    /**\n     * Stop treating an instance as auto-subscribable.\n     *\n     * @param id instance id, e.g. `pushover.0`\n     */\n    removeSubscribableInstance(id: string): void {\n        const pos = this.#autoSubscribe.indexOf(id);\n        if (pos !== -1) {\n            this.#autoSubscribe.splice(pos, 1);\n        }\n    }\n\n    /** Populate the auto-subscribe instance list from the objects DB. */\n    async autoSubscribeOn(): Promise<void> {\n        // Known-dead guard: #autoSubscribe is always truthy so the body never runs; the live fix is tracked separately \u2014 do not \"repair\" it here.\n        if (!this.#autoSubscribe && this.objects) {\n            try {\n                // collect all\n                const res = await this.objects.getObjectViewAsync('system', 'instance', {\n                    startkey: 'system.adapter.',\n                    endkey: 'system.adapter.\\u9999',\n                });\n\n                this.#autoSubscribe = [];\n                for (const row of res.rows) {\n                    if (row.value?.common.subscribable) {\n                        const _id = row.id.substring(15); // cut system.adapter.\n                        if (!this.#autoSubscribe.includes(_id)) {\n                            this.#autoSubscribe.push(_id);\n                        }\n                    }\n                }\n\n                // because of autoSubscribe\n                await this.objects.subscribeAsync('system.adapter.*');\n            } catch {\n                // ignore\n            }\n        }\n    }\n\n    /**\n     * Subscribe to state changes in any instance, resolving aliases and maintaining auto-subscribe counters.\n     *\n     * @param pattern pattern, `*`, an `alias.*` id, or an array of ids/patterns\n     * @param options optional user context\n     */\n    async subscribeForeignStates(pattern: Pattern, options?: SubOptions): Promise<void> {\n        // Todo check rights for options\n        await this.autoSubscribeOn();\n\n        // Force the up-front connection check: a disconnected DB must reject (ERROR_DB_CLOSED) before any branch runs.\n        void this.states;\n        void this.objects;\n\n        // compare if this pattern for one of auto-subscribe adapters\n        for (const autoSubEntry of this.#autoSubscribe) {\n            if (typeof pattern === 'string' && (pattern === '*' || pattern.startsWith(`${autoSubEntry}.`))) {\n                // put this pattern into adapter list\n                let state;\n                try {\n                    state = await this.states.getState(`system.adapter.${autoSubEntry}.subscribes`);\n                } catch {\n                    // ignore\n                }\n                state = state || { val: '{}' };\n                state.val = state.val || '{}';\n                let subs;\n                try {\n                    subs = JSON.parse(state.val as any);\n                } catch {\n                    this.logger.error(`${this.namespaceLog} Cannot parse subscribes for \"${autoSubEntry}.subscribes\"`);\n                }\n\n                // rebuild without a prototype so a \"__proto__\" key in the persisted value cannot\n                // pollute Object.prototype via the subs[pattern] writes below\n                subs = tools.isObject(subs) ? Object.assign(Object.create(null), subs) : Object.create(null);\n\n                if (!tools.isObject(subs[pattern])) {\n                    subs[pattern] = {};\n                }\n\n                if (typeof subs[pattern][this.namespace] !== 'number') {\n                    subs[pattern][this.namespace] = 0;\n                }\n\n                subs[pattern][this.namespace]++;\n                this.countOutput();\n                await this.states.setState(`system.adapter.${autoSubEntry}.subscribes`, JSON.stringify(subs));\n            }\n        }\n\n        if (Array.isArray(pattern)) {\n            // get all aliases\n            const aliasesIds = pattern\n                .map(id => (id.startsWith(ALIAS_STARTS_WITH) ? id : null))\n                .filter(id => id) as string[];\n\n            // get all non aliases\n            const nonAliasesIds = pattern\n                .map(id => (!id.startsWith(ALIAS_STARTS_WITH) ? id : null))\n                .filter(id => id) as string[];\n\n            for (const aliasPattern of pattern) {\n                if (\n                    (aliasPattern.startsWith(ALIAS_STARTS_WITH) || aliasPattern.includes('*')) &&\n                    !this.#alias.hasPattern(aliasPattern)\n                ) {\n                    // it's a new alias conform pattern to store\n                    this.#alias.addPattern(aliasPattern);\n                }\n            }\n\n            const promises = new Array<Promise<void>>();\n\n            if (aliasesIds.length) {\n                this.#alias.ensureAliasObjectSubscription();\n\n                let aliasObjs: ioBroker.AnyObject[];\n                try {\n                    aliasObjs = await this.objects.getObjects(aliasesIds, options);\n                } catch (e: any) {\n                    this.logger.error(`Could not get objects by array: ${e.message}`);\n                    aliasObjs = [];\n                }\n\n                for (const aliasObj of aliasObjs) {\n                    if (aliasObj) {\n                        promises.push(this.#alias.addAliasSubscribe(aliasObj, aliasObj._id));\n                    }\n                }\n            }\n\n            if (nonAliasesIds.length) {\n                for (const id of nonAliasesIds) {\n                    promises.push(new Promise<void>(resolve => this.states.subscribeUser(id, () => resolve())));\n                }\n            }\n\n            try {\n                await Promise.all(promises);\n            } catch (e: any) {\n                this.logger.error(`${this.namespaceLog} Error on \"subscribeForeignStates\": ${e.message}`);\n            }\n            return;\n        } else if (pattern.includes('*')) {\n            if (pattern === '*' || pattern.startsWith(ALIAS_STARTS_WITH)) {\n                this.#alias.ensureAliasObjectSubscription();\n\n                // read all aliases\n                try {\n                    const objs = await this.#objectAccess.getForeignStateObjects(pattern, options);\n                    const promises = new Array<Promise<void>>();\n                    if (!this.#alias.hasPattern(pattern)) {\n                        // it's a new pattern to store\n                        this.#alias.addPattern(pattern);\n                    }\n\n                    for (const id of Object.keys(objs)) {\n                        // If alias\n                        if (id.startsWith(ALIAS_STARTS_WITH)) {\n                            const aliasObj = objs[id];\n                            promises.push(this.#alias.addAliasSubscribe(aliasObj, pattern));\n                        }\n                    }\n\n                    try {\n                        await Promise.all(promises);\n                    } catch (e: any) {\n                        this.logger.error(`${this.namespaceLog} Error on \"subscribeForeignStates\": ${e.message}`);\n                    }\n\n                    // re-check: states may have disconnected during the awaits above\n                    const states = this.states;\n\n                    if (promises.length && pattern !== '*') {\n                        return;\n                    }\n                    // no alias objects found or pattern *\n                    return states.subscribeUser(pattern);\n                } catch (e: any) {\n                    this.logger.warn(`${this.namespaceLog} Cannot subscribe to ${pattern}: ${e.message}`);\n                    throw e;\n                }\n            } else {\n                return this.states.subscribeUser(pattern);\n            }\n        } else if (pattern.startsWith(ALIAS_STARTS_WITH)) {\n            this.#alias.ensureAliasObjectSubscription();\n\n            // just read one alias Object\n            try {\n                const aliasObj = await this.objects.getObject(pattern, options);\n                if (aliasObj) {\n                    await this.#alias.addAliasSubscribe(aliasObj, pattern);\n                    return;\n                }\n                return;\n            } catch (e: any) {\n                this.logger.warn(`${this.namespaceLog} cannot subscribe on alias \"${pattern}\": ${e.message}`);\n            }\n        } else {\n            return this.states.subscribeUser(pattern);\n        }\n    }\n\n    /**\n     * Unsubscribe from state changes in any instance, mirroring {@link subscribeForeignStates}.\n     *\n     * @param pattern pattern, `*`, an `alias.*` id, or an array of ids/patterns\n     * @param options optional user context\n     */\n    async unsubscribeForeignStates(pattern: Pattern, options?: SubOptions): Promise<void> {\n        // An empty pattern means \"all\" \u2014 matches the legacy public method, and applies per element\n        // on the array-recursion path below.\n        pattern = pattern || '*';\n\n        // Force the up-front connection check (states getter throws ERROR_DB_CLOSED).\n        void this.states;\n\n        if (this.#autoSubscribe && typeof pattern === 'string') {\n            for (const autoSub of this.#autoSubscribe) {\n                if (pattern === '*' || pattern.substring(0, autoSub.length + 1) === `${autoSub}.`) {\n                    // remove this pattern from adapter list\n                    let state;\n                    try {\n                        state = await this.states.getState(`system.adapter.${autoSub}.subscribes`);\n                    } catch {\n                        // ignore\n                    }\n                    if (!state || !state.val) {\n                        continue;\n                    }\n                    let subs;\n                    try {\n                        subs = JSON.parse(state.val as any);\n                    } catch {\n                        this.logger.error(`${this.namespaceLog} Cannot parse subscribes for \"${autoSub}.subscribes\"`);\n                        continue;\n                    }\n\n                    if (\n                        !tools.isObject(subs) ||\n                        !tools.isObject(subs[pattern]) ||\n                        subs[pattern][this.namespace] === undefined\n                    ) {\n                        // check subs is a valid object, because it comes from state.val\n                        continue;\n                    }\n\n                    // rebuild without a prototype so a \"__proto__\" key cannot pollute Object.prototype\n                    subs = Object.assign(Object.create(null), subs);\n\n                    if (typeof subs[pattern][this.namespace] === 'number') {\n                        subs[pattern][this.namespace]--;\n                        if (subs[pattern][this.namespace] <= 0) {\n                            delete subs[pattern][this.namespace];\n                        }\n                    } else {\n                        // corrupted info, we can only delete\n                        delete subs[pattern][this.namespace];\n                    }\n\n                    // if no other subs are there\n                    if (!Object.keys(subs[pattern]).length) {\n                        delete subs[pattern];\n                    }\n                    this.countOutput();\n                    await this.states.setState(`system.adapter.${autoSub}.subscribes`, JSON.stringify(subs));\n                }\n            }\n        }\n\n        let aliasPattern;\n        const promises = new Array<Promise<void>>();\n\n        if (Array.isArray(pattern)) {\n            // process every entry as single unsubscribe\n            for (const _pattern of pattern) {\n                promises.push(this.unsubscribeForeignStates(_pattern, options));\n            }\n        } else if (pattern.includes('*') || pattern.startsWith(ALIAS_STARTS_WITH)) {\n            if (pattern === '*' || pattern.startsWith(ALIAS_STARTS_WITH)) {\n                aliasPattern = pattern; // check all aliases\n                if (pattern === '*') {\n                    promises.push(this.states.unsubscribeUser(pattern));\n                }\n            } else {\n                promises.push(this.states.unsubscribeUser(pattern));\n            }\n        } else {\n            promises.push(this.states.unsubscribeUser(pattern));\n        }\n\n        if (aliasPattern) {\n            this.#alias.deletePattern(aliasPattern);\n            promises.push(this.#alias.removeTargetsForPattern(aliasPattern));\n        }\n\n        await Promise.all(promises);\n        this.#alias.maybeDropAliasObjectSubscription();\n        return;\n    }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/build/cjs/lib/adapter/userInterfaceMessagingController.d.ts

@@ -1,12 +1,14 @@
 import type { Client as StatesInRedisClient } from '@iobroker/db-states-redis';
 import type { AdapterClass } from '../../lib/adapter/adapter.js';
 import type { UserInterfaceClientRemoveMessage, UserInterfaceClientSubscribeHandler, UserInterfaceClientSubscribeReturnType, UserInterfaceClientUnsubscribeHandler } from '../../lib/_Types.js';
+/** A heartbeat timer for a subscribed UI client */
 export interface HeartbeatTimer {
     /** The actual timer */
     timer: NodeJS.Timeout;
     /** The heartbeat interval */
     heartbeat: number;
 }
+/** Options for the UI messaging controller */
 export interface MessagingControllerOptions {
     /** The adapter using this messaging controller */
     adapter: AdapterClass;
@@ -15,6 +17,7 @@ export interface MessagingControllerOptions {
     /** Callback to call if successfully unsubscribed */
     unsubscribeCallback?: UserInterfaceClientUnsubscribeHandler;
 }
+/** Options for sending a message to a single UI client */
 export interface SendToClientOptions {
     /** ID of the client to send the message to, will send to all if omitted */
     clientId: string;
@@ -24,6 +27,7 @@ export interface SendToClientOptions {
     states: StatesInRedisClient;
 }
 export type SendToAllClientOptions = Omit<SendToClientOptions, 'clientId'>;
+/** Handler describing a subscribed UI client */
 export interface ClientHandler {
     /** The session id of the client connection */
     sid: string;
@@ -32,6 +36,9 @@ export interface ClientHandler {
     /** Individual type which can be specified */
     type: string;
 }
+/**
+ * Controller for messaging with UI clients (subscribe, heartbeat and sending data)
+ */
 export declare class UserInterfaceMessagingController {
     /** The adapter using this messaging controller */
     private readonly adapter;
@@ -43,6 +50,9 @@ export declare class UserInterfaceMessagingController {
     private readonly handlers;
     /** Collection of current heartbeat timers */
     private heartbeatTimers;
+    /**
+     * @param options The adapter and the subscribe/unsubscribe callbacks
+     */
     constructor(options: MessagingControllerOptions);
     /**
      * Send a message to the given clientId

package/build/cjs/lib/adapter/userInterfaceMessagingController.js

@@ -3,6 +3,7 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -22,6 +23,9 @@ __export(userInterfaceMessagingController_exports, {
 });
 module.exports = __toCommonJS(userInterfaceMessagingController_exports);
 class UserInterfaceMessagingController {
+  static {
+    __name(this, "UserInterfaceMessagingController");
+  }
   /** The adapter using this messaging controller */
   adapter;
   /** Callback to call if successfully subscribed */
@@ -32,6 +36,9 @@ class UserInterfaceMessagingController {
   handlers = /* @__PURE__ */ new Map();
   /** Collection of current heartbeat timers */
   heartbeatTimers = /* @__PURE__ */ new Map();
+  /**
+   * @param options The adapter and the subscribe/unsubscribe callbacks
+   */
   constructor(options) {
     const { adapter, unsubscribeCallback, subscribeCallback } = options;
     this.adapter = adapter;
@@ -120,7 +127,7 @@ class UserInterfaceMessagingController {
       }
       this.handlers.delete(clientId);
       if (this.unsubscribeCallback) {
-        this.unsubscribeCallback({ clientId, message: msg, reason });
+        Promise.resolve(this.unsubscribeCallback({ clientId, message: msg, reason })).catch((e) => this.adapter.log.error(`Error in unsubscribe callback: ${e.message}`));
       }
     }
   }
@@ -150,7 +157,7 @@ class UserInterfaceMessagingController {
     this.handlers.delete(clientId);
     this.heartbeatTimers.delete(clientId);
     if (this.unsubscribeCallback) {
-      this.unsubscribeCallback({ clientId, reason: "timeout" });
+      Promise.resolve(this.unsubscribeCallback({ clientId, reason: "timeout" })).catch((e) => this.adapter.log.error(`Error in unsubscribe callback: ${e.message}`));
     }
   }
 }