@iobroker/types 7.2.4 → 7.2.5

package/build/shared.d.ts

@@ -293,6 +293,22 @@ declare global {
             message: MessagePayload;
             /** The source of this message */
             from: string;
+            /**
+             * The user this message is sent on behalf of, if the sender named one (`options.user` of
+             * `sendTo`/`sendToHost`). A socket server such as `admin` or `web` puts the authenticated
+             * user of the connection here, so the receiving instance can check what that user may do
+             * instead of acting with its own rights.
+             *
+             * It is only as trustworthy as `from`: every instance can claim any user here, and all of
+             * them run with full database rights anyway. Trust it when `from` is an instance you trust
+             * to have authenticated the user, and never as a substitute for your own permission check.
+             *
+             * Set from js-controller 7.2.5 on; an older one never sets it. A message that was sent
+             * without a user does not carry the field at all, so the absence of the field means
+             * "nobody was named" - for whichever of the two reasons, and in both cases there is
+             * nothing to check against.
+             */
+            user?: ioBroker.ObjectIDs.User;
             /** Callback information. This is set when the source expects a response */
             callback?: MessageCallbackInfo;
         }

package/build/types.d.ts

@@ -166,7 +166,7 @@ export declare interface AdapterClass {
      * Sends a message to a specific host or all hosts.
      */
     sendToHostAsync(hostName: string, message: ioBroker.MessagePayload): Promise<ioBroker.Message | undefined>;
-    sendToHostAsync(hostName: string, command: string, message: ioBroker.MessagePayload): Promise<ioBroker.Message | undefined>;
+    sendToHostAsync(hostName: string, command: string, message: ioBroker.MessagePayload, options?: SendToOptions): Promise<ioBroker.Message | undefined>;
     /**
      * Sends a message to a specific instance or all instances of some specific adapter.
      */
@@ -714,7 +714,7 @@ export declare class AdapterClass extends EventEmitter {
     sendTo(instanceName: string, command: string, message: any, callback?: ioBroker.MessageCallback | ioBroker.MessageCallbackInfo, options?: SendToOptions): void;
     private _sendTo;
     sendToHost(hostName: string | null, message: any, callback?: ioBroker.MessageCallback | ioBroker.MessageCallbackInfo): void;
-    sendToHost(hostName: string | null, command: string, message: any, callback?: ioBroker.MessageCallback | ioBroker.MessageCallbackInfo): void;
+    sendToHost(hostName: string | null, command: string, message: any, callback?: ioBroker.MessageCallback | ioBroker.MessageCallbackInfo, options?: SendToOptions): void;
     private _sendToHost;
     sendToUI(options: SendToUserInterfaceClientOptions): Promise<void>;
     registerNotification<Scope extends keyof ioBroker.NotificationScopes>(scope: Scope, category: ioBroker.NotificationScopes[Scope] | null, message: string, options?: NotificationOptions): Promise<void>;
@@ -1257,6 +1257,7 @@ export declare interface InternalSendToHostOptions {
     command: string;
     message: any;
     callback?: ioBroker.MessageCallback | ioBroker.MessageCallbackInfo;
+    options?: SendToOptions;
 }
 
 export declare interface InternalSendToOptions {
@@ -1378,6 +1379,8 @@ declare type Pattern_2 = string | string[];
 export declare interface SendToOptions {
     /** Method throws or calls error cb, if callback not called in time, works for single targets only */
     timeout?: number;
+    /** The user on whose behalf the message is sent */
+    user?: ioBroker.ObjectIDs.User;
 }
 
 export declare interface SendToUserInterfaceClientOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@iobroker/types",
-    "version": "7.2.4",
+    "version": "7.2.5",
     "engines": {
         "node": ">=12.0.0"
     },
@@ -41,5 +41,5 @@
             ]
         }
     },
-    "gitHead": "1849f5d9d69ad07fdf61f7d132ddc6ee9824a394"
+    "gitHead": "9bc56bf00b9eedf53f0028d88c1e19d6d769615a"
 }