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

package/build/esm/lib/adapter/managers/AliasManager.d.ts

@@ -0,0 +1,103 @@
+import type { AliasTargetEntry } from '../../_Types.js';
+import type { ValidateIdOptions } from '../../../lib/adapter/validator.js';
+import type { AdapterContext } from '../../../lib/adapter/context.js';
+import { AdapterContextBase } from '../../../lib/adapter/managers/AdapterContextBase.js';
+/** Validates a (possibly foreign) id; throws on invalid. Bound to the adapter's Validator. */
+export type ValidateId = (id: string, isForeignId: boolean, options?: ValidateIdOptions | null) => void;
+/**
+ * Owns the alias subscription cache and its bookkeeping: which real (source) states feed which
+ * `alias.*` targets, the alias subscription patterns, and the single `alias.*` object subscription.
+ * The source-state change fan-out ({@link resolveSourceChange}) is synchronous by contract so the
+ * state-change handler cannot interleave a cache mutation mid-fan-out.
+ */
+export declare class AliasManager extends AdapterContextBase {
+    #private;
+    /**
+     * @param ctx Shared adapter context providing live runtime state
+     * @param validateId Bound id validator from the adapter's Validator instance
+     */
+    constructor(ctx: AdapterContext, validateId: ValidateId);
+    /**
+     * Whether the given source (real) state id currently feeds any alias.
+     *
+     * @param id the real source state id
+     */
+    hasSource(id: string): boolean;
+    /** Number of tracked source states. */
+    get size(): number;
+    /**
+     * Whether the given subscription pattern is tracked.
+     *
+     * @param pattern the subscription pattern
+     */
+    hasPattern(pattern: string): boolean;
+    /**
+     * Track a subscription pattern.
+     *
+     * @param pattern the subscription pattern
+     */
+    addPattern(pattern: string): void;
+    /**
+     * Stop tracking a subscription pattern.
+     *
+     * @param pattern the subscription pattern
+     */
+    deletePattern(pattern: string): void;
+    /**
+     * Whether `id` falls into any tracked alias pattern (wildcards via pattern2RegEx).
+     *
+     * @param id the id to test against the tracked patterns
+     */
+    matchesAnyPattern(id: string): boolean;
+    /**
+     * Reacts to a change of an `alias.*` object: re-points, updates, or removes the target across the
+     * tracked sources, and picks up a newly-appeared alias that falls into a tracked pattern.
+     * Live-iterates the cache while awaiting add/remove — the loop lives here, with the map, to
+     * preserve the original mutation-during-iteration semantics exactly.
+     *
+     * @param id the changed alias object id
+     * @param obj the new object (null/undefined if deleted)
+     */
+    handleAliasObjectChange(id: string, obj: ioBroker.Object | null | undefined): Promise<void>;
+    /**
+     * Removes every target subscribed under the given pattern, live-iterating the cache so a removal
+     * mutating the map mid-loop keeps the original semantics. Awaits each removal.
+     *
+     * @param pattern the subscription pattern being unsubscribed
+     */
+    removeTargetsForPattern(pattern: string): Promise<void>;
+    /**
+     * Synchronously computes the fan-out of a source (real) state change to its alias targets.
+     * Returns one `{ targetId, state }` per unique target. MUST NOT await — the caller relies on the
+     * cache not mutating between read and emit.
+     *
+     * @param sourceId the changed real state id
+     * @param state the new state value (or null on deletion)
+     */
+    resolveSourceChange(sourceId: string, state: ioBroker.State | null | undefined): Array<{
+        targetId: string;
+        state: ioBroker.State | null;
+    }>;
+    /** Subscribe the `alias.*` object range once (idempotent). */
+    ensureAliasObjectSubscription(): void;
+    /** Drop the `alias.*` object subscription when no aliases remain. */
+    maybeDropAliasObjectSubscription(): void;
+    /**
+     * Register an alias target for its source state, subscribing the source state (and reading its
+     * metadata once). Preserves the create-before-await ordering and the post-await existence
+     * re-check that guard a concurrent removal.
+     *
+     * @param aliasObj the `alias.*` object being subscribed
+     * @param pattern the subscription pattern that pulled it in
+     */
+    addAliasSubscribe(aliasObj: ioBroker.AnyObject, pattern: string): Promise<void>;
+    /**
+     * Remove one alias target from its source; when the source has no targets left, delete the entry
+     * and unsubscribe the source state.
+     *
+     * @param sourceId the real source state id
+     * @param aliasObjOrIdx the target entry or its index in the targets array
+     */
+    removeAliasSubscribe(sourceId: string, aliasObjOrIdx: number | AliasTargetEntry): Promise<void>;
+}
+//# sourceMappingURL=AliasManager.d.ts.map

package/build/esm/lib/adapter/managers/AliasManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasManager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/adapter/managers/AliasManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAGlF,8FAA8F;AAC9F,MAAM,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,CAAC;AAExG;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,kBAAkB;;IAMhD;;;OAGG;gBACS,GAAG,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU;IAKvD;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9B,uCAAuC;IACvC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IActC;;;;;;;;OAQG;IACG,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCjG;;;;;OAKG;IACG,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7D;;;;;;;OAOG;IACH,mBAAmB,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,GAAG,SAAS,GACzC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAA;KAAE,CAAC;IA+B5D,8DAA8D;IAC9D,6BAA6B,IAAI,IAAI;IAOrC,qEAAqE;IACrE,gCAAgC,IAAI,IAAI;IAOxC;;;;;;;OAOG;IACG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CrF;;;;;;OAMG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAcxG"}

package/build/esm/lib/adapter/managers/AliasManager.js

@@ -0,0 +1,269 @@
+import { tools } from '@iobroker/js-controller-common';
+import deepClone from 'deep-clone';
+import { AdapterContextBase } from '../../../lib/adapter/managers/AdapterContextBase.js';
+import { ALIAS_STARTS_WITH, SYSTEM_ADMIN_USER } from '../../../lib/adapter/constants.js';
+/**
+ * Owns the alias subscription cache and its bookkeeping: which real (source) states feed which
+ * `alias.*` targets, the alias subscription patterns, and the single `alias.*` object subscription.
+ * The source-state change fan-out ({@link resolveSourceChange}) is synchronous by contract so the
+ * state-change handler cannot interleave a cache mutation mid-fan-out.
+ */
+export class AliasManager extends AdapterContextBase {
+    #aliases = new Map();
+    #aliasPatterns = new Set();
+    #aliasObjectsSubscribed = false;
+    #validateId;
+    /**
+     * @param ctx Shared adapter context providing live runtime state
+     * @param validateId Bound id validator from the adapter's Validator instance
+     */
+    constructor(ctx, validateId) {
+        super(ctx);
+        this.#validateId = validateId;
+    }
+    /**
+     * Whether the given source (real) state id currently feeds any alias.
+     *
+     * @param id the real source state id
+     */
+    hasSource(id) {
+        return this.#aliases.has(id);
+    }
+    /** Number of tracked source states. */
+    get size() {
+        return this.#aliases.size;
+    }
+    /**
+     * Whether the given subscription pattern is tracked.
+     *
+     * @param pattern the subscription pattern
+     */
+    hasPattern(pattern) {
+        return this.#aliasPatterns.has(pattern);
+    }
+    /**
+     * Track a subscription pattern.
+     *
+     * @param pattern the subscription pattern
+     */
+    addPattern(pattern) {
+        this.#aliasPatterns.add(pattern);
+    }
+    /**
+     * Stop tracking a subscription pattern.
+     *
+     * @param pattern the subscription pattern
+     */
+    deletePattern(pattern) {
+        this.#aliasPatterns.delete(pattern);
+    }
+    /**
+     * Whether `id` falls into any tracked alias pattern (wildcards via pattern2RegEx).
+     *
+     * @param id the id to test against the tracked patterns
+     */
+    matchesAnyPattern(id) {
+        for (const aliasPattern of this.#aliasPatterns) {
+            const testPattern = aliasPattern.slice(-1) === '*' ? new RegExp(tools.pattern2RegEx(aliasPattern)) : aliasPattern;
+            if ((typeof testPattern === 'string' && aliasPattern === id) ||
+                (testPattern instanceof RegExp && testPattern.test(id))) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Reacts to a change of an `alias.*` object: re-points, updates, or removes the target across the
+     * tracked sources, and picks up a newly-appeared alias that falls into a tracked pattern.
+     * Live-iterates the cache while awaiting add/remove — the loop lives here, with the map, to
+     * preserve the original mutation-during-iteration semantics exactly.
+     *
+     * @param id the changed alias object id
+     * @param obj the new object (null/undefined if deleted)
+     */
+    async handleAliasObjectChange(id, obj) {
+        let isNewAlias = true;
+        for (const [sourceId, alias] of this.#aliases) {
+            const targetAlias = alias.targets.find(entry => entry.id === id);
+            if (targetAlias) {
+                isNewAlias = false;
+                if (obj?.common?.alias?.id) {
+                    const newSourceId = typeof obj.common.alias.id.read === 'string' ? obj.common.alias.id.read : obj.common.alias.id;
+                    if (newSourceId !== sourceId) {
+                        await this.removeAliasSubscribe(sourceId, targetAlias);
+                        try {
+                            await this.addAliasSubscribe(obj, targetAlias.pattern);
+                        }
+                        catch (e) {
+                            this.logger.error(`${this.namespaceLog} Could not add alias subscription: ${e.message}`);
+                        }
+                    }
+                    else {
+                        targetAlias.min = obj.common.min;
+                        targetAlias.max = obj.common.max;
+                        targetAlias.type = obj.common.type;
+                        targetAlias.alias = deepClone(obj.common.alias);
+                    }
+                }
+                else {
+                    await this.removeAliasSubscribe(sourceId, targetAlias);
+                }
+            }
+        }
+        if (isNewAlias && obj && this.matchesAnyPattern(id)) {
+            try {
+                await this.addAliasSubscribe(obj, id);
+            }
+            catch (e) {
+                this.logger.warn(`${this.namespaceLog} Could not add alias subscription: ${e.message}`);
+            }
+        }
+    }
+    /**
+     * Removes every target subscribed under the given pattern, live-iterating the cache so a removal
+     * mutating the map mid-loop keeps the original semantics. Awaits each removal.
+     *
+     * @param pattern the subscription pattern being unsubscribed
+     */
+    async removeTargetsForPattern(pattern) {
+        const promises = new Array();
+        for (const [sourceId, alias] of this.#aliases) {
+            for (let i = alias.targets.length - 1; i >= 0; i--) {
+                if (alias.targets[i].pattern === pattern) {
+                    promises.push(this.removeAliasSubscribe(sourceId, i));
+                }
+            }
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Synchronously computes the fan-out of a source (real) state change to its alias targets.
+     * Returns one `{ targetId, state }` per unique target. MUST NOT await — the caller relies on the
+     * cache not mutating between read and emit.
+     *
+     * @param sourceId the changed real state id
+     * @param state the new state value (or null on deletion)
+     */
+    resolveSourceChange(sourceId, state) {
+        const out = new Array();
+        const alias = this.#aliases.get(sourceId);
+        if (!alias) {
+            return out;
+        }
+        const uniqueTargets = new Set();
+        for (const target of alias.targets) {
+            const targetId = target.id;
+            if (uniqueTargets.has(targetId)) {
+                continue;
+            }
+            uniqueTargets.add(targetId);
+            const aState = state
+                ? tools.formatAliasValue({
+                    sourceCommon: alias.source,
+                    targetCommon: target,
+                    state: deepClone(state),
+                    logger: this.logger,
+                    logNamespace: this.namespaceLog,
+                    sourceId,
+                    targetId,
+                })
+                : null;
+            if (aState || !state) {
+                out.push({ targetId, state: aState });
+            }
+        }
+        return out;
+    }
+    /** Subscribe the `alias.*` object range once (idempotent). */
+    ensureAliasObjectSubscription() {
+        if (!this.#aliasObjectsSubscribed) {
+            this.#aliasObjectsSubscribed = true;
+            this.objects.subscribe(`${ALIAS_STARTS_WITH}*`);
+        }
+    }
+    /** Drop the `alias.*` object subscription when no aliases remain. */
+    maybeDropAliasObjectSubscription() {
+        if (!this.#aliases.size && this.#aliasObjectsSubscribed) {
+            this.#aliasObjectsSubscribed = false;
+            this.objects.unsubscribe(`${ALIAS_STARTS_WITH}*`);
+        }
+    }
+    /**
+     * Register an alias target for its source state, subscribing the source state (and reading its
+     * metadata once). Preserves the create-before-await ordering and the post-await existence
+     * re-check that guard a concurrent removal.
+     *
+     * @param aliasObj the `alias.*` object being subscribed
+     * @param pattern the subscription pattern that pulled it in
+     */
+    async addAliasSubscribe(aliasObj, pattern) {
+        if (aliasObj.type !== 'state') {
+            return;
+        }
+        if (!aliasObj.common?.alias?.id) {
+            this.logger.warn(`${this.namespaceLog} Alias ${aliasObj._id} has no target 5`);
+            throw new Error(`Alias ${aliasObj._id} has no target`);
+        }
+        const sourceId = tools.isObject(aliasObj.common.alias.id)
+            ? aliasObj.common.alias.id.read
+            : aliasObj.common.alias.id;
+        try {
+            this.#validateId(sourceId, true, null);
+        }
+        catch (e) {
+            throw new Error(`Error validating alias id of ${aliasObj._id}: ${e.message}`);
+        }
+        const targetEntry = {
+            alias: deepClone(aliasObj.common.alias),
+            id: aliasObj._id,
+            pattern,
+            type: aliasObj.common.type,
+            max: aliasObj.common.max,
+            min: aliasObj.common.min,
+            unit: aliasObj.common.unit,
+        };
+        let aliasDetails;
+        if (!this.#aliases.has(sourceId)) {
+            aliasDetails = { targets: [] };
+            this.#aliases.set(sourceId, aliasDetails);
+        }
+        else {
+            aliasDetails = this.#aliases.get(sourceId);
+        }
+        if (!aliasDetails.source) {
+            await this.states.subscribe(sourceId);
+            const sourceObj = await this.objects.getObject(sourceId, { user: SYSTEM_ADMIN_USER });
+            if (sourceObj?.common && this.#aliases.has(sourceObj._id)) {
+                aliasDetails.source = {
+                    min: sourceObj.common.min,
+                    max: sourceObj.common.max,
+                    type: sourceObj.common.type,
+                    unit: sourceObj.common.unit,
+                };
+            }
+        }
+        aliasDetails.targets.push(targetEntry);
+    }
+    /**
+     * Remove one alias target from its source; when the source has no targets left, delete the entry
+     * and unsubscribe the source state.
+     *
+     * @param sourceId the real source state id
+     * @param aliasObjOrIdx the target entry or its index in the targets array
+     */
+    async removeAliasSubscribe(sourceId, aliasObjOrIdx) {
+        if (!this.#aliases.has(sourceId)) {
+            return;
+        }
+        const alias = this.#aliases.get(sourceId);
+        const pos = typeof aliasObjOrIdx === 'number' ? aliasObjOrIdx : alias.targets.indexOf(aliasObjOrIdx);
+        if (pos !== -1) {
+            alias.targets.splice(pos, 1);
+            if (!alias.targets.length) {
+                this.#aliases.delete(sourceId);
+                await this.states.unsubscribe(sourceId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=AliasManager.js.map

package/build/esm/lib/adapter/managers/AliasManager.js.map

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

package/build/esm/lib/adapter/managers/CertificateManager.d.ts

@@ -0,0 +1,50 @@
+import type { InternalGetCertificatesResult } from '../../_Types.js';
+import type { AdapterContext } from '../../../lib/adapter/context.js';
+import { AdapterContextBase } from '../../../lib/adapter/managers/AdapterContextBase.js';
+/** ID of the object holding all configured certificates */
+export declare const CERTIFICATES_OBJECT_ID = "system.certificates";
+/** Fetches SSL certificates from `system.certificates`, resolving file-backed values to their contents. */
+export declare class CertificateManager extends AdapterContextBase {
+    #private;
+    /**
+     * @param ctx Shared adapter context providing live runtime state
+     */
+    constructor(ctx: AdapterContext);
+    /**
+     * Tells whether a new version of the `system.certificates` object actually changes one of the
+     * certificates handed out by the last {@link getCertificates} call. Unrelated certificates being
+     * added, changed or removed are ignored, so that editing some other adapter's certificate does
+     * not restart this one.
+     *
+     * Compares the raw (unresolved) values: for a file-backed certificate that is the path, so
+     * repointing it to a different file counts as a change, while a change of the file content is
+     * left to the file watcher.
+     *
+     * @param obj the new `system.certificates` object, or null/undefined if it was deleted
+     */
+    hasRelevantChange(obj: ioBroker.OtherObject | null | undefined): boolean;
+    /**
+     * Forgets the certificates handed out by the last {@link getCertificates} call, so a subsequent
+     * change of `system.certificates` is no longer treated as relevant by {@link hasRelevantChange}.
+     * Used when the adapter stops watching its certificates.
+     */
+    stopWatching(): void;
+    /**
+     * Loads the named certificates from `system.certificates`. File-backed values (short strings that
+     * are existing paths) are read from disk and their paths collected in `certFilePaths` so the caller
+     * can watch them.
+     *
+     * @param names public/private/chained certificate names
+     * @param names.publicName Name of the public certificate
+     * @param names.privateName Name of the private key
+     * @param names.chainedName Name of the chained certificate
+     * @throws {Error} `ERROR_DB_CLOSED` when the objects database is not connected
+     * @throws {Error} `ERROR_NOT_FOUND` when the requested certificates are not configured
+     */
+    getCertificates(names: {
+        publicName?: string;
+        privateName?: string;
+        chainedName?: string;
+    }): Promise<InternalGetCertificatesResult>;
+}
+//# sourceMappingURL=CertificateManager.d.ts.map

package/build/esm/lib/adapter/managers/CertificateManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CertificateManager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/adapter/managers/CertificateManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAElF,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,wBAAwB,CAAC;AAE5D,2GAA2G;AAC3G,qBAAa,kBAAmB,SAAQ,kBAAkB;;IAQtD;;OAEG;gBACS,GAAG,EAAE,cAAc;IAI/B;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAkBxE;;;;OAIG;IACH,YAAY,IAAI,IAAI;IAIpB;;;;;;;;;;;OAWG;IACG,eAAe,CAAC,KAAK,EAAE;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,6BAA6B,CAAC;CAyF7C"}

package/build/esm/lib/adapter/managers/CertificateManager.js

@@ -0,0 +1,142 @@
+import fs from 'fs-extra';
+import { tools } from '@iobroker/js-controller-common';
+import { AdapterContextBase } from '../../../lib/adapter/managers/AdapterContextBase.js';
+/** ID of the object holding all configured certificates */
+export const CERTIFICATES_OBJECT_ID = 'system.certificates';
+/** Fetches SSL certificates from `system.certificates`, resolving file-backed values to their contents. */
+export class CertificateManager extends AdapterContextBase {
+    /**
+     * Raw (unresolved) values of the certificates handed out by the last {@link getCertificates} call,
+     * keyed by certificate name. Used to tell a relevant change of `system.certificates` from an
+     * unrelated one. `undefined` until certificates have been requested at least once.
+     */
+    #usedCertificates;
+    /**
+     * @param ctx Shared adapter context providing live runtime state
+     */
+    constructor(ctx) {
+        super(ctx);
+    }
+    /**
+     * Tells whether a new version of the `system.certificates` object actually changes one of the
+     * certificates handed out by the last {@link getCertificates} call. Unrelated certificates being
+     * added, changed or removed are ignored, so that editing some other adapter's certificate does
+     * not restart this one.
+     *
+     * Compares the raw (unresolved) values: for a file-backed certificate that is the path, so
+     * repointing it to a different file counts as a change, while a change of the file content is
+     * left to the file watcher.
+     *
+     * @param obj the new `system.certificates` object, or null/undefined if it was deleted
+     */
+    hasRelevantChange(obj) {
+        const usedCertificates = this.#usedCertificates;
+        if (!usedCertificates) {
+            // certificates were never requested, so nothing can have changed for us
+            return false;
+        }
+        const certificates = obj?.native?.certificates;
+        for (const [name, value] of usedCertificates) {
+            if (certificates?.[name] !== value) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Forgets the certificates handed out by the last {@link getCertificates} call, so a subsequent
+     * change of `system.certificates` is no longer treated as relevant by {@link hasRelevantChange}.
+     * Used when the adapter stops watching its certificates.
+     */
+    stopWatching() {
+        this.#usedCertificates = undefined;
+    }
+    /**
+     * Loads the named certificates from `system.certificates`. File-backed values (short strings that
+     * are existing paths) are read from disk and their paths collected in `certFilePaths` so the caller
+     * can watch them.
+     *
+     * @param names public/private/chained certificate names
+     * @param names.publicName Name of the public certificate
+     * @param names.privateName Name of the private key
+     * @param names.chainedName Name of the chained certificate
+     * @throws {Error} `ERROR_DB_CLOSED` when the objects database is not connected
+     * @throws {Error} `ERROR_NOT_FOUND` when the requested certificates are not configured
+     */
+    async getCertificates(names) {
+        const { publicName, privateName, chainedName } = names;
+        const objects = this.objects;
+        let obj;
+        try {
+            obj = await objects.getObject(CERTIFICATES_OBJECT_ID);
+        }
+        catch {
+            // ignore
+        }
+        if (!obj?.native.certificates ||
+            !publicName ||
+            !privateName ||
+            !obj.native.certificates[publicName] ||
+            !obj.native.certificates[privateName] ||
+            (chainedName && !obj.native.certificates[chainedName])) {
+            this.logger.error(`${this.namespaceLog} Cannot configure secure web server, because no certificates found: ${publicName}, ${privateName}, ${chainedName}`);
+            if (publicName === 'defaultPublic' || privateName === 'defaultPrivate') {
+                this.logger.info(`${this.namespaceLog} Default certificates seem to be configured but missing. You can execute "iobroker cert create" in your shell to create these.`);
+            }
+            throw new Error(tools.ERRORS.ERROR_NOT_FOUND);
+        }
+        const certFilePaths = new Array();
+        let ca;
+        if (chainedName) {
+            const chained = this.#resolveCert(obj.native.certificates[chainedName], certFilePaths).split('-----END CERTIFICATE-----\r\n');
+            if (chained.join('').length >= 512) {
+                const caArr = new Array();
+                for (const cert of chained) {
+                    if (cert.replace(/(\r\n|\r|\n)/g, '').trim()) {
+                        caArr.push(`${cert}-----END CERTIFICATE-----\r\n`);
+                    }
+                }
+                ca = caArr.join('');
+            }
+        }
+        const certs = {
+            key: this.#resolveCert(obj.native.certificates[privateName], certFilePaths),
+            cert: this.#resolveCert(obj.native.certificates[publicName], certFilePaths),
+            ca,
+        };
+        // remember the raw values, so a change of `system.certificates` can be told from an unrelated one
+        this.#usedCertificates = new Map();
+        for (const name of [publicName, privateName, chainedName]) {
+            if (name) {
+                this.#usedCertificates.set(name, obj.native.certificates[name]);
+            }
+        }
+        return { certs, useLetsEncrypt: obj.native.letsEncrypt, certFilePaths };
+    }
+    /**
+     * Returns the certificate content. When `value` is a short string that is an existing file path,
+     * reads the file, records the path in `certFilePaths` (deduped), and returns the file content.
+     * Otherwise returns `value` unchanged.
+     *
+     * @param value inline certificate or a path to one
+     * @param certFilePaths accumulator for file-backed paths (mutated)
+     */
+    #resolveCert(value, certFilePaths) {
+        if (typeof value === 'string') {
+            try {
+                if (value.length < 1024 && fs.existsSync(value)) {
+                    const content = fs.readFileSync(value, 'utf8');
+                    if (!certFilePaths.includes(value)) {
+                        certFilePaths.push(value);
+                    }
+                    return content;
+                }
+            }
+            catch (e) {
+                this.logger.error(`${this.namespaceLog} Could not read certificate from file ${value}: ${e.message}`);
+            }
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=CertificateManager.js.map

package/build/esm/lib/adapter/managers/CertificateManager.js.map

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

package/build/esm/lib/adapter/managers/MessagingManager.d.ts

@@ -0,0 +1,58 @@
+import type { InternalSendToHostOptions, InternalSendToOptions, NotificationOptions, SendToUserInterfaceClientOptions } from '../../_Types.js';
+import type { AdapterContext } from '../../../lib/adapter/context.js';
+import { AdapterContextBase } from '../../../lib/adapter/managers/AdapterContextBase.js';
+/** Owns the adapter's outbound messaging and the pending-reply registry. */
+export declare class MessagingManager extends AdapterContextBase {
+    #private;
+    /**
+     * @param ctx Shared adapter context providing live runtime state
+     */
+    constructor(ctx: AdapterContext);
+    /**
+     * Sends a message to another adapter instance.
+     *
+     * When `opts.expectReply` is true and the target is a specific instance (not broadcast),
+     * the returned promise resolves with the reply message when it arrives, or rejects with
+     * `Error('Timeout exceeded')` if `opts.options.timeout` elapses.
+     *
+     * @param opts Normalized send options
+     */
+    sendTo(opts: InternalSendToOptions): Promise<any>;
+    /**
+     * Sends a message to a host, or broadcasts to all hosts when `hostName` is `null`.
+     *
+     * When `opts.expectReply` is true and a specific host is targeted, the returned promise
+     * resolves with the reply message when it arrives, or rejects with `Error('Timeout exceeded')`
+     * if `opts.options.timeout` elapses. Broadcasts (hostName === null) resolve void.
+     *
+     * @param opts Normalized send options
+     */
+    sendToHost(opts: InternalSendToHostOptions): Promise<any>;
+    /**
+     * Resolves a pending reply promise for an acked messagebox message.
+     * Returns true if a pending entry was found and consumed.
+     *
+     * @param obj incoming message object from the messagebox
+     */
+    resolveCallback(obj: ioBroker.Message): boolean;
+    /**
+     * Rejects all pending reply promises and clears their timers (used on stop).
+     */
+    clearPendingCallbacks(): void;
+    /**
+     * Sends a message to a single UI client, or broadcasts to all connected UI clients when `clientId` is omitted.
+     *
+     * @param options clientId and data options
+     */
+    sendToUI(options: SendToUserInterfaceClientOptions): Promise<void>;
+    /**
+     * Sends an addNotification command to the host of this adapter instance.
+     *
+     * @param scope notification scope
+     * @param category notification category, or `null` to match by scope regex
+     * @param message notification message
+     * @param options additional notification options
+     */
+    registerNotification(scope: string, category: string | null, message: string, options?: NotificationOptions): Promise<void>;
+}
+//# sourceMappingURL=MessagingManager.d.ts.map

package/build/esm/lib/adapter/managers/MessagingManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagingManager.d.ts","sourceRoot":"","sources":["../../../../../src/lib/adapter/managers/MessagingManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EAEnB,gCAAgC,EACnC,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAWlF,4EAA4E;AAC5E,qBAAa,gBAAiB,SAAQ,kBAAkB;;IAKpD;;OAEG;gBACS,GAAG,EAAE,cAAc;IAI/B;;;;;;;;OAQG;IACG,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC;IA8IvD;;;;;;;;OAQG;IACG,UAAU,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,GAAG,CAAC;IA2C/D;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,GAAG,OAAO;IA0B/C;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAa7B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlE;;;;;;;OAOG;IACG,oBAAoB,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC9B,OAAO,CAAC,IAAI,CAAC;CAiBnB"}