@iobroker/js-controller-cli 7.2.2 → 7.2.3-alpha.1-20260621-61726ea22

package/build/cjs/lib/_Types.d.ts

@@ -4,10 +4,15 @@ export type ProcessExitCallback = (exitCode: number) => void;
 export type CleanDatabaseHandler = (isDeleteDb: boolean) => any;
 export type DbConnectCallback = (params: DbConnectAsyncReturn) => void;
 export type DbConnect = (onlyCheckOrParams?: boolean | Record<string, any>, paramsOrCb?: Record<string, any> | DbConnectCallback, callback?: DbConnectCallback) => void;
+/** Result returned once the database connection has been established */
 export interface DbConnectAsyncReturn {
+    /** The connected objects database client */
     objects: ObjectsRedisClient;
+    /** The connected states database client */
     states: StatesRedisClient;
+    /** Whether the controller is offline (no running host) */
     isOffline?: boolean;
+    /** Type of the objects database backend */
     objectsDBType: string;
     /** The iobroker.json config file */
     config: ioBroker.IoBrokerJson;
@@ -22,7 +27,9 @@ interface IoPackageCommon extends ioBroker.AdapterCommon {
         };
     };
 }
+/** An adapter object as stored in io-package.json */
 export interface IoPackage extends ioBroker.AdapterObject {
+    /** The common section including the plugins configuration */
     common: IoPackageCommon;
 }
 export {};

package/build/cjs/lib/cli/cliCert.d.ts

@@ -1,11 +1,14 @@
 import { CLICommand, type CLICommandOptions } from './cliCommand.js';
 /** Command ioBroker cert ... */
 export declare class CLICert extends CLICommand {
+    /**
+     * @param options The command options including context and parameters
+     */
     constructor(options: CLICommandOptions);
     /**
      * Executes a command
      *
-     * @param args
+     * @param args The command arguments (the first is the sub-command)
      */
     execute(args: any[]): void | Promise<void>;
     /**
@@ -15,7 +18,7 @@ export declare class CLICert extends CLICommand {
     /**
      * View the certificates on CLI
      *
-     * @param _args
+     * @param _args The command arguments (the second is the certificate name)
      */
     view(_args: any[]): void;
 }

package/build/cjs/lib/cli/cliCert.js

@@ -36,13 +36,16 @@ var import_cliObjects = require("./cliObjects.js");
 var messages = __toESM(require("./messages.js"), 1);
 var import_js_controller_common = require("@iobroker/js-controller-common");
 class CLICert extends import_cliCommand.CLICommand {
+  /**
+   * @param options The command options including context and parameters
+   */
   constructor(options) {
     super(options);
   }
   /**
    * Executes a command
    *
-   * @param args
+   * @param args The command arguments (the first is the sub-command)
    */
   execute(args) {
     const { callback, showHelp } = this.options;
@@ -82,7 +85,7 @@ class CLICert extends import_cliCommand.CLICommand {
   /**
    * View the certificates on CLI
    *
-   * @param _args
+   * @param _args The command arguments (the second is the certificate name)
    */
   view(_args) {
     let certName = _args[1];

package/build/cjs/lib/cli/cliCert.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/cli/cliCert.ts"],
-  "sourcesContent": ["import { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport { CLIObjects } from './cliObjects.js';\nimport * as messages from './messages.js';\nimport { tools, EXIT_CODES } from '@iobroker/js-controller-common';\n\n/** Command ioBroker cert ... */\nexport class CLICert extends CLICommand {\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n\n    /**\n     * Executes a command\n     *\n     * @param args\n     */\n    execute(args: any[]): void | Promise<void> {\n        const { callback, showHelp } = this.options;\n        const command = args[0];\n\n        switch (command) {\n            case 'renew':\n            case 'create':\n                return this.create();\n            case 'view':\n                return this.view(args);\n            default:\n                messages.error.unknownCommand('cert', command);\n                showHelp();\n                return void callback(3);\n        }\n    }\n\n    /**\n     * Create new private certificate\n     */\n    async create(): Promise<void> {\n        const id = 'system.certificates';\n        const certPropPath = 'native.certificates';\n\n        const certificates = tools.generateDefaultCertificates();\n        if (certificates) {\n            console.log(JSON.stringify(certificates, null, 2));\n            for (const [certName, cert] of Object.entries(certificates)) {\n                // use the command `iobroker object set ...` to update the certificate\n                console.log(`Update certificate ${certName}`);\n\n                const objectsCommandArgs = ['set', id, `${certPropPath}.${certName}=${cert as string}`];\n                await new Promise(resolve => {\n                    const objectsCommand = new CLIObjects({ ...this.options, callback: resolve });\n                    objectsCommand.execute(objectsCommandArgs);\n                });\n            }\n        }\n\n        this.options.callback(EXIT_CODES.NO_ERROR);\n    }\n\n    /**\n     * View the certificates on CLI\n     *\n     * @param _args\n     */\n    view(_args: any[]): void {\n        let certName = _args[1];\n        if (certName === undefined) {\n            certName = 'defaultPublic';\n        }\n        const { callback, dbConnect } = this.options;\n        dbConnect(params => {\n            const { objects } = params;\n\n            objects.getObject('system.certificates', (err, certs) => {\n                if (!err && certs?.native?.certificates?.[certName]) {\n                    const certInfo = tools.getCertificateInfo(certs.native.certificates[certName]);\n                    if (certInfo) {\n                        console.log(JSON.stringify(certInfo, null, 2));\n                        return void callback(EXIT_CODES.NO_ERROR);\n                    }\n                    messages.error.cert(certName);\n                    return void callback(3);\n                }\n                messages.error.cert(certName);\n                return void callback(3);\n            });\n        });\n    }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAAA,wBAAmD;AACnD,wBAA2B;AAC3B,eAA0B;AAC1B,kCAAkC;AAG5B,MAAO,gBAAgB,6BAAU;EACnC,YAAY,SAA0B;AAClC,UAAM,OAAO;EACjB;;;;;;EAOA,QAAQ,MAAW;AACf,UAAM,EAAE,UAAU,SAAQ,IAAK,KAAK;AACpC,UAAM,UAAU,KAAK,CAAC;AAEtB,YAAQ,SAAS;MACb,KAAK;MACL,KAAK;AACD,eAAO,KAAK,OAAM;MACtB,KAAK;AACD,eAAO,KAAK,KAAK,IAAI;MACzB;AACI,iBAAS,MAAM,eAAe,QAAQ,OAAO;AAC7C,iBAAQ;AACR,eAAO,KAAK,SAAS,CAAC;IAC9B;EACJ;;;;EAKA,MAAM,SAAM;AACR,UAAM,KAAK;AACX,UAAM,eAAe;AAErB,UAAM,eAAe,kCAAM,4BAA2B;AACtD,QAAI,cAAc;AACd,cAAQ,IAAI,KAAK,UAAU,cAAc,MAAM,CAAC,CAAC;AACjD,iBAAW,CAAC,UAAU,IAAI,KAAK,OAAO,QAAQ,YAAY,GAAG;AAEzD,gBAAQ,IAAI,sBAAsB,QAAQ,EAAE;AAE5C,cAAM,qBAAqB,CAAC,OAAO,IAAI,GAAG,YAAY,IAAI,QAAQ,IAAI,IAAc,EAAE;AACtF,cAAM,IAAI,QAAQ,aAAU;AACxB,gBAAM,iBAAiB,IAAI,6BAAW,EAAE,GAAG,KAAK,SAAS,UAAU,QAAO,CAAE;AAC5E,yBAAe,QAAQ,kBAAkB;QAC7C,CAAC;MACL;IACJ;AAEA,SAAK,QAAQ,SAAS,uCAAW,QAAQ;EAC7C;;;;;;EAOA,KAAK,OAAY;AACb,QAAI,WAAW,MAAM,CAAC;AACtB,QAAI,aAAa,QAAW;AACxB,iBAAW;IACf;AACA,UAAM,EAAE,UAAU,UAAS,IAAK,KAAK;AACrC,cAAU,YAAS;AACf,YAAM,EAAE,QAAO,IAAK;AAEpB,cAAQ,UAAU,uBAAuB,CAAC,KAAK,UAAS;AACpD,YAAI,CAAC,OAAO,OAAO,QAAQ,eAAe,QAAQ,GAAG;AACjD,gBAAM,WAAW,kCAAM,mBAAmB,MAAM,OAAO,aAAa,QAAQ,CAAC;AAC7E,cAAI,UAAU;AACV,oBAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAC7C,mBAAO,KAAK,SAAS,uCAAW,QAAQ;UAC5C;AACA,mBAAS,MAAM,KAAK,QAAQ;AAC5B,iBAAO,KAAK,SAAS,CAAC;QAC1B;AACA,iBAAS,MAAM,KAAK,QAAQ;AAC5B,eAAO,KAAK,SAAS,CAAC;MAC1B,CAAC;IACL,CAAC;EACL;;",
+  "sourcesContent": ["import { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport { CLIObjects } from './cliObjects.js';\nimport * as messages from './messages.js';\nimport { tools, EXIT_CODES } from '@iobroker/js-controller-common';\n\n/** Command ioBroker cert ... */\nexport class CLICert extends CLICommand {\n    /**\n     * @param options The command options including context and parameters\n     */\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n\n    /**\n     * Executes a command\n     *\n     * @param args The command arguments (the first is the sub-command)\n     */\n    execute(args: any[]): void | Promise<void> {\n        const { callback, showHelp } = this.options;\n        const command = args[0];\n\n        switch (command) {\n            case 'renew':\n            case 'create':\n                return this.create();\n            case 'view':\n                return this.view(args);\n            default:\n                messages.error.unknownCommand('cert', command);\n                showHelp();\n                return void callback(3);\n        }\n    }\n\n    /**\n     * Create new private certificate\n     */\n    async create(): Promise<void> {\n        const id = 'system.certificates';\n        const certPropPath = 'native.certificates';\n\n        const certificates = tools.generateDefaultCertificates();\n        if (certificates) {\n            console.log(JSON.stringify(certificates, null, 2));\n            for (const [certName, cert] of Object.entries(certificates)) {\n                // use the command `iobroker object set ...` to update the certificate\n                console.log(`Update certificate ${certName}`);\n\n                const objectsCommandArgs = ['set', id, `${certPropPath}.${certName}=${cert as string}`];\n                await new Promise(resolve => {\n                    const objectsCommand = new CLIObjects({ ...this.options, callback: resolve });\n                    objectsCommand.execute(objectsCommandArgs);\n                });\n            }\n        }\n\n        this.options.callback(EXIT_CODES.NO_ERROR);\n    }\n\n    /**\n     * View the certificates on CLI\n     *\n     * @param _args The command arguments (the second is the certificate name)\n     */\n    view(_args: any[]): void {\n        let certName = _args[1];\n        if (certName === undefined) {\n            certName = 'defaultPublic';\n        }\n        const { callback, dbConnect } = this.options;\n        dbConnect(params => {\n            const { objects } = params;\n\n            objects.getObject('system.certificates', (err, certs) => {\n                if (!err && certs?.native?.certificates?.[certName]) {\n                    const certInfo = tools.getCertificateInfo(certs.native.certificates[certName]);\n                    if (certInfo) {\n                        console.log(JSON.stringify(certInfo, null, 2));\n                        return void callback(EXIT_CODES.NO_ERROR);\n                    }\n                    messages.error.cert(certName);\n                    return void callback(3);\n                }\n                messages.error.cert(certName);\n                return void callback(3);\n            });\n        });\n    }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAAA,wBAAmD;AACnD,wBAA2B;AAC3B,eAA0B;AAC1B,kCAAkC;AAG5B,MAAO,gBAAgB,6BAAU;;;;EAInC,YAAY,SAA0B;AAClC,UAAM,OAAO;EACjB;;;;;;EAOA,QAAQ,MAAW;AACf,UAAM,EAAE,UAAU,SAAQ,IAAK,KAAK;AACpC,UAAM,UAAU,KAAK,CAAC;AAEtB,YAAQ,SAAS;MACb,KAAK;MACL,KAAK;AACD,eAAO,KAAK,OAAM;MACtB,KAAK;AACD,eAAO,KAAK,KAAK,IAAI;MACzB;AACI,iBAAS,MAAM,eAAe,QAAQ,OAAO;AAC7C,iBAAQ;AACR,eAAO,KAAK,SAAS,CAAC;IAC9B;EACJ;;;;EAKA,MAAM,SAAM;AACR,UAAM,KAAK;AACX,UAAM,eAAe;AAErB,UAAM,eAAe,kCAAM,4BAA2B;AACtD,QAAI,cAAc;AACd,cAAQ,IAAI,KAAK,UAAU,cAAc,MAAM,CAAC,CAAC;AACjD,iBAAW,CAAC,UAAU,IAAI,KAAK,OAAO,QAAQ,YAAY,GAAG;AAEzD,gBAAQ,IAAI,sBAAsB,QAAQ,EAAE;AAE5C,cAAM,qBAAqB,CAAC,OAAO,IAAI,GAAG,YAAY,IAAI,QAAQ,IAAI,IAAc,EAAE;AACtF,cAAM,IAAI,QAAQ,aAAU;AACxB,gBAAM,iBAAiB,IAAI,6BAAW,EAAE,GAAG,KAAK,SAAS,UAAU,QAAO,CAAE;AAC5E,yBAAe,QAAQ,kBAAkB;QAC7C,CAAC;MACL;IACJ;AAEA,SAAK,QAAQ,SAAS,uCAAW,QAAQ;EAC7C;;;;;;EAOA,KAAK,OAAY;AACb,QAAI,WAAW,MAAM,CAAC;AACtB,QAAI,aAAa,QAAW;AACxB,iBAAW;IACf;AACA,UAAM,EAAE,UAAU,UAAS,IAAK,KAAK;AACrC,cAAU,YAAS;AACf,YAAM,EAAE,QAAO,IAAK;AAEpB,cAAQ,UAAU,uBAAuB,CAAC,KAAK,UAAS;AACpD,YAAI,CAAC,OAAO,OAAO,QAAQ,eAAe,QAAQ,GAAG;AACjD,gBAAM,WAAW,kCAAM,mBAAmB,MAAM,OAAO,aAAa,QAAQ,CAAC;AAC7E,cAAI,UAAU;AACV,oBAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAC7C,mBAAO,KAAK,SAAS,uCAAW,QAAQ;UAC5C;AACA,mBAAS,MAAM,KAAK,QAAQ;AAC5B,iBAAO,KAAK,SAAS,CAAC;QAC1B;AACA,iBAAS,MAAM,KAAK,QAAQ;AAC5B,eAAO,KAAK,SAAS,CAAC;MAC1B,CAAC;IACL,CAAC;EACL;;",
   "names": []
 }

package/build/cjs/lib/cli/cliCommand.d.ts

@@ -1,46 +1,77 @@
 import type { DbConnectCallback } from '../_Types.js';
+/** Context provided to every CLI command */
 export interface CLICommandContext {
     /** Invoke this before doing anything in the database */
     dbConnect: (callback: DbConnectCallback) => void;
+    /** Finish the command with the given exit code */
     callback: (code?: number) => void;
+    /** Show the command help */
     showHelp: (yargs?: any) => void;
 }
+/** Parameters (CLI flags) that may be passed to a command */
 export interface CLICommandParams {
+    /** Text encoding to use for output */
     encoding?: BufferEncoding;
+    /** Pretty-print the output */
     pretty?: boolean;
+    /** Force the operation even if it would normally be refused */
     force?: boolean;
+    /** Password to use */
     password?: any;
+    /** Restrict the operation to the given group */
     ingroup?: any;
+    /** Short alias for the version flag */
     v?: any;
+    /** Show the version */
     version?: any;
+    /** Timeout in milliseconds */
     timeout?: any;
+    /** Only include enabled instances */
     enabled?: any;
+    /** Only include disabled instances */
     disabled?: any;
+    /** Port to use */
     port?: any;
+    /** Use SSL */
     ssl?: any;
+    /** IP address to bind to */
     ip?: any;
+    /** Only include updatable adapters */
     updatable?: any;
+    /** Host to operate on */
     host?: any;
+    /** Certificate to use */
     cert?: any;
+    /** Working directory */
     cwd?: string;
+    /** File system path */
     path?: string;
+    /** Module name */
     module?: string;
+    /** Wait for the operation to complete */
     wait?: boolean;
+    /** Automatically answer yes to confirmation prompts */
     yes?: boolean;
+    /** Short alias for force */
     f?: boolean;
+    /** Short alias for yes */
     y?: boolean;
+    /** Apply the operation to all matching items */
     all?: boolean;
 }
 export type CLICommandOptions = CLICommandContext & CLICommandParams;
 /** The base class for any CLI command */
 export declare class CLICommand<TCommandOptions extends CLICommandOptions = CLICommandOptions> {
     protected readonly options: TCommandOptions;
+    /**
+     * @param options The command options including the context (callback, dbConnect) and parameters
+     */
     constructor(options: TCommandOptions);
     /**
      * Ensures that an argument was passed in the options.
      * Throws otherwise
      *
-     * @param arg
+     * @param arg The name of the option that is required
      */
     requireOption(arg: keyof CLICommandOptions): void;
 }

package/build/cjs/lib/cli/cliCommand.js

@@ -23,6 +23,9 @@ __export(cliCommand_exports, {
 module.exports = __toCommonJS(cliCommand_exports);
 class CLICommand {
   options;
+  /**
+   * @param options The command options including the context (callback, dbConnect) and parameters
+   */
   constructor(options) {
     if (options === null || options === void 0) {
       throw new Error(`No options given`);
@@ -35,7 +38,7 @@ class CLICommand {
    * Ensures that an argument was passed in the options.
    * Throws otherwise
    *
-   * @param arg
+   * @param arg The name of the option that is required
    */
   requireOption(arg) {
     if (this.options[arg] === void 0) {

package/build/cjs/lib/cli/cliCommand.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/cli/cliCommand.ts"],
-  "sourcesContent": ["import type { DbConnectCallback } from '../_Types.js';\n\nexport interface CLICommandContext {\n    /** Invoke this before doing anything in the database */\n    dbConnect: (callback: DbConnectCallback) => void;\n    callback: (code?: number) => void;\n    showHelp: (yargs?: any) => void;\n}\n\nexport interface CLICommandParams {\n    encoding?: BufferEncoding;\n    pretty?: boolean;\n    force?: boolean;\n    password?: any;\n    ingroup?: any;\n    v?: any;\n    version?: any;\n    timeout?: any;\n    enabled?: any;\n    disabled?: any;\n    port?: any;\n    ssl?: any;\n    ip?: any;\n    updatable?: any;\n    host?: any;\n    cert?: any;\n    cwd?: string;\n    path?: string;\n    module?: string;\n    wait?: boolean;\n    yes?: boolean;\n    f?: boolean;\n    y?: boolean;\n    all?: boolean;\n}\n\nexport type CLICommandOptions = CLICommandContext & CLICommandParams;\n\n/** The base class for any CLI command */\nexport class CLICommand<TCommandOptions extends CLICommandOptions = CLICommandOptions> {\n    protected readonly options: TCommandOptions;\n\n    constructor(options: TCommandOptions) {\n        if (options === null || options === undefined) {\n            throw new Error(`No options given`);\n        }\n\n        this.options = options;\n        // Always require the callback and a wrapper for DB actions\n        this.requireOption('callback');\n        this.requireOption('dbConnect');\n    }\n\n    /**\n     * Ensures that an argument was passed in the options.\n     * Throws otherwise\n     *\n     * @param arg\n     */\n    requireOption(arg: keyof CLICommandOptions): void {\n        if (this.options[arg] === undefined) {\n            throw new Error(`Invalid arguments: ${arg} is missing`);\n        }\n    }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAsCA;;;;;AACM,MAAO,WAAU;EACA;EAEnB,YAAY,SAAwB;AAChC,QAAI,YAAY,QAAQ,YAAY,QAAW;AAC3C,YAAM,IAAI,MAAM,kBAAkB;IACtC;AAEA,SAAK,UAAU;AAEf,SAAK,cAAc,UAAU;AAC7B,SAAK,cAAc,WAAW;EAClC;;;;;;;EAQA,cAAc,KAA4B;AACtC,QAAI,KAAK,QAAQ,GAAG,MAAM,QAAW;AACjC,YAAM,IAAI,MAAM,sBAAsB,GAAG,aAAa;IAC1D;EACJ;;",
+  "sourcesContent": ["import type { DbConnectCallback } from '../_Types.js';\n\n/** Context provided to every CLI command */\nexport interface CLICommandContext {\n    /** Invoke this before doing anything in the database */\n    dbConnect: (callback: DbConnectCallback) => void;\n    /** Finish the command with the given exit code */\n    callback: (code?: number) => void;\n    /** Show the command help */\n    showHelp: (yargs?: any) => void;\n}\n\n/** Parameters (CLI flags) that may be passed to a command */\nexport interface CLICommandParams {\n    /** Text encoding to use for output */\n    encoding?: BufferEncoding;\n    /** Pretty-print the output */\n    pretty?: boolean;\n    /** Force the operation even if it would normally be refused */\n    force?: boolean;\n    /** Password to use */\n    password?: any;\n    /** Restrict the operation to the given group */\n    ingroup?: any;\n    /** Short alias for the version flag */\n    v?: any;\n    /** Show the version */\n    version?: any;\n    /** Timeout in milliseconds */\n    timeout?: any;\n    /** Only include enabled instances */\n    enabled?: any;\n    /** Only include disabled instances */\n    disabled?: any;\n    /** Port to use */\n    port?: any;\n    /** Use SSL */\n    ssl?: any;\n    /** IP address to bind to */\n    ip?: any;\n    /** Only include updatable adapters */\n    updatable?: any;\n    /** Host to operate on */\n    host?: any;\n    /** Certificate to use */\n    cert?: any;\n    /** Working directory */\n    cwd?: string;\n    /** File system path */\n    path?: string;\n    /** Module name */\n    module?: string;\n    /** Wait for the operation to complete */\n    wait?: boolean;\n    /** Automatically answer yes to confirmation prompts */\n    yes?: boolean;\n    /** Short alias for force */\n    f?: boolean;\n    /** Short alias for yes */\n    y?: boolean;\n    /** Apply the operation to all matching items */\n    all?: boolean;\n}\n\nexport type CLICommandOptions = CLICommandContext & CLICommandParams;\n\n/** The base class for any CLI command */\nexport class CLICommand<TCommandOptions extends CLICommandOptions = CLICommandOptions> {\n    protected readonly options: TCommandOptions;\n\n    /**\n     * @param options The command options including the context (callback, dbConnect) and parameters\n     */\n    constructor(options: TCommandOptions) {\n        if (options === null || options === undefined) {\n            throw new Error(`No options given`);\n        }\n\n        this.options = options;\n        // Always require the callback and a wrapper for DB actions\n        this.requireOption('callback');\n        this.requireOption('dbConnect');\n    }\n\n    /**\n     * Ensures that an argument was passed in the options.\n     * Throws otherwise\n     *\n     * @param arg The name of the option that is required\n     */\n    requireOption(arg: keyof CLICommandOptions): void {\n        if (this.options[arg] === undefined) {\n            throw new Error(`Invalid arguments: ${arg} is missing`);\n        }\n    }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAkEA;;;;;AACM,MAAO,WAAU;EACA;;;;EAKnB,YAAY,SAAwB;AAChC,QAAI,YAAY,QAAQ,YAAY,QAAW;AAC3C,YAAM,IAAI,MAAM,kBAAkB;IACtC;AAEA,SAAK,UAAU;AAEf,SAAK,cAAc,UAAU;AAC7B,SAAK,cAAc,WAAW;EAClC;;;;;;;EAQA,cAAc,KAA4B;AACtC,QAAI,KAAK,QAAQ,GAAG,MAAM,QAAW;AACjC,YAAM,IAAI,MAAM,sBAAsB,GAAG,aAAa;IAC1D;EACJ;;",
   "names": []
 }

package/build/cjs/lib/cli/cliCompact.d.ts

@@ -2,11 +2,14 @@ import { CLICommand, type CLICommandOptions } from './cliCommand.js';
 /** Command ioBroker compact ... */
 export declare class CLICompact extends CLICommand {
     private readonly config;
+    /**
+     * @param options The command options including context and parameters
+     */
     constructor(options: CLICommandOptions);
     /**
      * Executes a command
      *
-     * @param args
+     * @param args The command arguments (the first is the sub-command)
      */
     execute(args: any[]): void;
     /**

package/build/cjs/lib/cli/cliCompact.js

@@ -37,13 +37,16 @@ var import_js_controller_common = require("@iobroker/js-controller-common");
 var import_fs_extra = __toESM(require("fs-extra"), 1);
 class CLICompact extends import_cliCommand.CLICommand {
   config = import_fs_extra.default.readJSONSync(import_js_controller_common.tools.getConfigFileName());
+  /**
+   * @param options The command options including context and parameters
+   */
   constructor(options) {
     super(options);
   }
   /**
    * Executes a command
    *
-   * @param args
+   * @param args The command arguments (the first is the sub-command)
    */
   execute(args) {
     const { callback, showHelp } = this.options;

package/build/cjs/lib/cli/cliCompact.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/cli/cliCompact.ts"],
-  "sourcesContent": ["import * as CLI from './messages.js';\nimport { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport { tools } from '@iobroker/js-controller-common';\nimport fs from 'fs-extra';\n\n/** Command ioBroker compact ... */\nexport class CLICompact extends CLICommand {\n    private readonly config: ioBroker.IoBrokerJson = fs.readJSONSync(tools.getConfigFileName());\n\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n    /**\n     * Executes a command\n     *\n     * @param args\n     */\n    execute(args: any[]): void {\n        const { callback, showHelp } = this.options;\n        const command = args[0];\n        switch (command) {\n            case 'status':\n                return this.statusCompactModeHost();\n            case 'enable':\n            case 'on':\n                return this.setCompactModeHost(true);\n            case 'disable':\n            case 'off':\n                return this.setCompactModeHost(false);\n            default:\n                if (command && command.includes('.')) {\n                    if (args[1]) {\n                        switch (args[1]) {\n                            case 'status':\n                                return this.statusCompactModeInstance(command);\n                            case 'enable':\n                            case 'on':\n                                return this.setCompactModeInstance(command, true, args[2]);\n                            case 'disable':\n                            case 'off':\n                                return this.setCompactModeInstance(command, false);\n                            case 'group':\n                                return this.setCompactModeInstance(command, undefined, args[2]);\n                        }\n                    }\n                }\n\n                CLI.error.unknownCommand('compact', command);\n                showHelp();\n                return void callback(3);\n        }\n    }\n\n    /**\n     * Output status of compact mode for host\n     */\n    statusCompactModeHost(): void {\n        const { callback } = this.options;\n\n        const compactMode = !!this.config?.system?.compact;\n        console.log(`Compact mode for this host is currently ${compactMode ? 'enabled' : 'disabled'}`);\n\n        return void callback();\n    }\n\n    /**\n     * Set compact mode for this host\n     *\n     * @param targetState enable or disable compact mode for host\n     */\n    setCompactModeHost(targetState: boolean): void {\n        const { callback, dbConnect } = this.options;\n\n        dbConnect(params => {\n            const { isOffline } = params;\n\n            const currentState = !!this.config?.system?.compact;\n\n            if (targetState === currentState) {\n                console.log(`Compact mode for this host is already ${currentState ? 'enabled' : 'disabled'}`);\n                return void callback();\n            }\n\n            this.config.system = this.config.system || {};\n            this.config.system.compact = targetState;\n            const configFileName = tools.getConfigFileName();\n            fs.writeFileSync(configFileName, JSON.stringify(this.config, null, 4), 'utf8');\n\n            console.log();\n            console.log(`Compact mode for this host is now ${targetState ? 'enabled' : 'disabled'}`);\n\n            if (!isOffline) {\n                console.log();\n                console.log('Please restart ioBroker for this change to take effect!');\n            }\n            return void callback();\n        });\n    }\n\n    /**\n     * Output the compact mode status for a defined adapter instance\n     *\n     * @param instance instance to output status for\n     */\n    statusCompactModeInstance(instance: `${string}.${number}`): void {\n        const { callback, dbConnect } = this.options;\n\n        dbConnect(params => {\n            const { objects } = params;\n\n            if (!this.config.system?.compact) {\n                console.log('Compact mode is disabled for this host. All compact mode settings will have no effect!');\n                console.log();\n            }\n            objects.getObject(`system.adapter.${instance}`, (err, obj) => {\n                if (!err && obj) {\n                    if (!obj.common.compact) {\n                        console.log(\n                            'This adapter does not support compact mode. The below settings will have no effect!',\n                        );\n                        console.log();\n                    } else {\n                        console.log(`Adapter supports compact mode:     ${!!obj.common.compact}`);\n                    }\n                    console.log(`Compact mode enabled for instance: ${!!obj.common.runAsCompactMode}`);\n                    console.log(\n                        `Compact group:                     ${\n                            obj.common.compactGroup !== undefined ? obj.common.compactGroup : 1\n                        }`,\n                    );\n                    return void callback();\n                }\n                CLI.error.invalidInstance(instance);\n                return void callback(24);\n            });\n        });\n    }\n\n    /**\n     * Put given instance in compact mode group\n     *\n     * @param instance instance to put in group\n     * @param targetState if compact mode should be enabled for instance, if undefined `instance.common.runAsCompact` will not be updated\n     * @param groupId the compact group id, if not given, it will be put in controller group\n     */\n    setCompactModeInstance(instance: `${string}.${number}`, targetState?: boolean, groupId?: string | number): void {\n        const { callback, dbConnect } = this.options;\n\n        dbConnect(async params => {\n            const { objects } = params;\n\n            if (!this.config.system?.compact) {\n                console.log('Compact mode is disabled on this host. This setting will have no effect!');\n                console.log();\n            }\n\n            let obj: ioBroker.InstanceObject | undefined | null;\n            try {\n                obj = await objects.getObject(`system.adapter.${instance}`);\n            } catch {\n                // ignore\n            }\n\n            if (!obj) {\n                CLI.error.invalidInstance(instance);\n                return void callback(24);\n            }\n\n            if (!obj.common.compact) {\n                console.log('This adapter does not support compact mode. The below settings will have no effect!');\n                console.log();\n            } else {\n                console.log(`Adapter supports compact mode :    ${!!obj.common.compact}`);\n            }\n            let newRunAsCompactMode;\n            if (targetState !== undefined && targetState !== !!obj.common.runAsCompactMode) {\n                newRunAsCompactMode = targetState;\n            }\n            let newCompactGroup;\n            if (obj.common.compactGroup === undefined) {\n                obj.common.compactGroup = 1;\n                newCompactGroup = obj.common.compactGroup;\n            }\n            if (groupId !== undefined) {\n                groupId = typeof groupId === 'string' ? parseInt(groupId, 10) : groupId;\n                if (groupId !== obj.common.compactGroup) {\n                    newCompactGroup = groupId;\n                }\n            }\n            console.log(\n                `Compact mode enabled for instance: ${\n                    newRunAsCompactMode !== undefined ? `--> ${newRunAsCompactMode}` : !!obj.common.runAsCompactMode\n                }`,\n            );\n            console.log(\n                `Compact group:                     ${\n                    newCompactGroup !== undefined && obj.common.compactGroup !== newCompactGroup\n                        ? `--> ${newCompactGroup}`\n                        : obj.common.compactGroup\n                }`,\n            );\n            if (newRunAsCompactMode !== undefined || newCompactGroup !== undefined) {\n                if (newCompactGroup !== undefined) {\n                    obj.common.compactGroup = newCompactGroup;\n                }\n                if (newRunAsCompactMode !== undefined) {\n                    obj.common.runAsCompactMode = newRunAsCompactMode;\n                }\n\n                obj.from = `system.host.${tools.getHostName()}.cli`;\n                obj.ts = new Date().getTime();\n                objects.setObject(`system.adapter.${instance}`, obj, err => {\n                    if (err) {\n                        console.log(err);\n                    }\n                    console.log(`Instance settings for \"${instance}\" are changed.`);\n                    callback();\n                });\n            } else {\n                console.log('No settings changed.');\n                return void callback();\n            }\n        });\n    }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as CLI from './messages.js';\nimport { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport { tools } from '@iobroker/js-controller-common';\nimport fs from 'fs-extra';\n\n/** Command ioBroker compact ... */\nexport class CLICompact extends CLICommand {\n    private readonly config: ioBroker.IoBrokerJson = fs.readJSONSync(tools.getConfigFileName());\n\n    /**\n     * @param options The command options including context and parameters\n     */\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n    /**\n     * Executes a command\n     *\n     * @param args The command arguments (the first is the sub-command)\n     */\n    execute(args: any[]): void {\n        const { callback, showHelp } = this.options;\n        const command = args[0];\n        switch (command) {\n            case 'status':\n                return this.statusCompactModeHost();\n            case 'enable':\n            case 'on':\n                return this.setCompactModeHost(true);\n            case 'disable':\n            case 'off':\n                return this.setCompactModeHost(false);\n            default:\n                if (command && command.includes('.')) {\n                    if (args[1]) {\n                        switch (args[1]) {\n                            case 'status':\n                                return this.statusCompactModeInstance(command);\n                            case 'enable':\n                            case 'on':\n                                return this.setCompactModeInstance(command, true, args[2]);\n                            case 'disable':\n                            case 'off':\n                                return this.setCompactModeInstance(command, false);\n                            case 'group':\n                                return this.setCompactModeInstance(command, undefined, args[2]);\n                        }\n                    }\n                }\n\n                CLI.error.unknownCommand('compact', command);\n                showHelp();\n                return void callback(3);\n        }\n    }\n\n    /**\n     * Output status of compact mode for host\n     */\n    statusCompactModeHost(): void {\n        const { callback } = this.options;\n\n        const compactMode = !!this.config?.system?.compact;\n        console.log(`Compact mode for this host is currently ${compactMode ? 'enabled' : 'disabled'}`);\n\n        return void callback();\n    }\n\n    /**\n     * Set compact mode for this host\n     *\n     * @param targetState enable or disable compact mode for host\n     */\n    setCompactModeHost(targetState: boolean): void {\n        const { callback, dbConnect } = this.options;\n\n        dbConnect(params => {\n            const { isOffline } = params;\n\n            const currentState = !!this.config?.system?.compact;\n\n            if (targetState === currentState) {\n                console.log(`Compact mode for this host is already ${currentState ? 'enabled' : 'disabled'}`);\n                return void callback();\n            }\n\n            this.config.system = this.config.system || {};\n            this.config.system.compact = targetState;\n            const configFileName = tools.getConfigFileName();\n            fs.writeFileSync(configFileName, JSON.stringify(this.config, null, 4), 'utf8');\n\n            console.log();\n            console.log(`Compact mode for this host is now ${targetState ? 'enabled' : 'disabled'}`);\n\n            if (!isOffline) {\n                console.log();\n                console.log('Please restart ioBroker for this change to take effect!');\n            }\n            return void callback();\n        });\n    }\n\n    /**\n     * Output the compact mode status for a defined adapter instance\n     *\n     * @param instance instance to output status for\n     */\n    statusCompactModeInstance(instance: `${string}.${number}`): void {\n        const { callback, dbConnect } = this.options;\n\n        dbConnect(params => {\n            const { objects } = params;\n\n            if (!this.config.system?.compact) {\n                console.log('Compact mode is disabled for this host. All compact mode settings will have no effect!');\n                console.log();\n            }\n            objects.getObject(`system.adapter.${instance}`, (err, obj) => {\n                if (!err && obj) {\n                    if (!obj.common.compact) {\n                        console.log(\n                            'This adapter does not support compact mode. The below settings will have no effect!',\n                        );\n                        console.log();\n                    } else {\n                        console.log(`Adapter supports compact mode:     ${!!obj.common.compact}`);\n                    }\n                    console.log(`Compact mode enabled for instance: ${!!obj.common.runAsCompactMode}`);\n                    console.log(\n                        `Compact group:                     ${\n                            obj.common.compactGroup !== undefined ? obj.common.compactGroup : 1\n                        }`,\n                    );\n                    return void callback();\n                }\n                CLI.error.invalidInstance(instance);\n                return void callback(24);\n            });\n        });\n    }\n\n    /**\n     * Put given instance in compact mode group\n     *\n     * @param instance instance to put in group\n     * @param targetState if compact mode should be enabled for instance, if undefined `instance.common.runAsCompact` will not be updated\n     * @param groupId the compact group id, if not given, it will be put in controller group\n     */\n    setCompactModeInstance(instance: `${string}.${number}`, targetState?: boolean, groupId?: string | number): void {\n        const { callback, dbConnect } = this.options;\n\n        dbConnect(async params => {\n            const { objects } = params;\n\n            if (!this.config.system?.compact) {\n                console.log('Compact mode is disabled on this host. This setting will have no effect!');\n                console.log();\n            }\n\n            let obj: ioBroker.InstanceObject | undefined | null;\n            try {\n                obj = await objects.getObject(`system.adapter.${instance}`);\n            } catch {\n                // ignore\n            }\n\n            if (!obj) {\n                CLI.error.invalidInstance(instance);\n                return void callback(24);\n            }\n\n            if (!obj.common.compact) {\n                console.log('This adapter does not support compact mode. The below settings will have no effect!');\n                console.log();\n            } else {\n                console.log(`Adapter supports compact mode :    ${!!obj.common.compact}`);\n            }\n            let newRunAsCompactMode;\n            if (targetState !== undefined && targetState !== !!obj.common.runAsCompactMode) {\n                newRunAsCompactMode = targetState;\n            }\n            let newCompactGroup;\n            if (obj.common.compactGroup === undefined) {\n                obj.common.compactGroup = 1;\n                newCompactGroup = obj.common.compactGroup;\n            }\n            if (groupId !== undefined) {\n                groupId = typeof groupId === 'string' ? parseInt(groupId, 10) : groupId;\n                if (groupId !== obj.common.compactGroup) {\n                    newCompactGroup = groupId;\n                }\n            }\n            console.log(\n                `Compact mode enabled for instance: ${\n                    newRunAsCompactMode !== undefined ? `--> ${newRunAsCompactMode}` : !!obj.common.runAsCompactMode\n                }`,\n            );\n            console.log(\n                `Compact group:                     ${\n                    newCompactGroup !== undefined && obj.common.compactGroup !== newCompactGroup\n                        ? `--> ${newCompactGroup}`\n                        : obj.common.compactGroup\n                }`,\n            );\n            if (newRunAsCompactMode !== undefined || newCompactGroup !== undefined) {\n                if (newCompactGroup !== undefined) {\n                    obj.common.compactGroup = newCompactGroup;\n                }\n                if (newRunAsCompactMode !== undefined) {\n                    obj.common.runAsCompactMode = newRunAsCompactMode;\n                }\n\n                obj.from = `system.host.${tools.getHostName()}.cli`;\n                obj.ts = new Date().getTime();\n                objects.setObject(`system.adapter.${instance}`, obj, err => {\n                    if (err) {\n                        console.log(err);\n                    }\n                    console.log(`Instance settings for \"${instance}\" are changed.`);\n                    callback();\n                });\n            } else {\n                console.log('No settings changed.');\n                return void callback();\n            }\n        });\n    }\n}\n"],
+  "mappings": "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",
   "names": ["fs"]
 }

package/build/cjs/lib/cli/cliDebug.d.ts

@@ -1,6 +1,9 @@
 import { CLICommand, type CLICommandOptions } from './cliCommand.js';
 /** Command ioBroker debug ... */
 export declare class CLIDebug extends CLICommand {
+    /**
+     * @param options The command options including context and parameters
+     */
     constructor(options: CLICommandOptions);
     /**
      * Checks if the adapter instance is running
@@ -12,7 +15,7 @@ export declare class CLIDebug extends CLICommand {
     /**
      * Executes a command
      *
-     * @param args
+     * @param args The command arguments (the first is the adapter name)
      */
     execute(args: any[]): Promise<void>;
 }

package/build/cjs/lib/cli/cliDebug.js

@@ -37,6 +37,9 @@ var CLITools = __toESM(require("./cliTools.js"), 1);
 var import_js_controller_common = require("@iobroker/js-controller-common");
 var import_node_child_process = require("node:child_process");
 class CLIDebug extends import_cliCommand.CLICommand {
+  /**
+   * @param options The command options including context and parameters
+   */
   constructor(options) {
     super(options);
   }
@@ -65,7 +68,7 @@ class CLIDebug extends import_cliCommand.CLICommand {
   /**
    * Executes a command
    *
-   * @param args
+   * @param args The command arguments (the first is the adapter name)
    */
   async execute(args) {
     const { callback, ...params } = this.options;

package/build/cjs/lib/cli/cliDebug.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/cli/cliDebug.ts"],
-  "sourcesContent": ["import * as CLI from './messages.js';\nimport { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport * as CLITools from './cliTools.js';\nimport { tools, EXIT_CODES } from '@iobroker/js-controller-common';\nimport { fork } from 'node:child_process';\n\n/** Command ioBroker debug ... */\nexport class CLIDebug extends CLICommand {\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n\n    /**\n     * Checks if the adapter instance is running\n     *\n     * @param adapter adapter name\n     * @param instance instance id\n     */\n    private _isInstanceRunning(adapter: string, instance: string): Promise<boolean> {\n        const { dbConnect } = this.options;\n        return new Promise(resolve => {\n            dbConnect(async ({ states }) => {\n                try {\n                    const state = await states.getStateAsync(`system.adapter.${adapter}.${instance}.alive`);\n                    if (state?.val) {\n                        resolve(true);\n                        return;\n                    }\n                } catch {\n                    // ignore\n                }\n                resolve(false);\n            });\n        });\n    }\n\n    /**\n     * Executes a command\n     *\n     * @param args\n     */\n    async execute(args: any[]): Promise<void> {\n        const { callback, ...params } = this.options;\n        const adapter = args[0];\n        if (!adapter) {\n            CLI.error.requiredArgumentMissing('adaptername', 'debug <adaptername>');\n            return void callback(34);\n        }\n\n        const { name, instance } = CLITools.splitAdapterOrInstanceIdentifierWithVersion(adapter)!;\n\n        if (await this._isInstanceRunning(name, instance || '0')) {\n            CLI.error.instanceAlreadyRunning(`${name}.${instance || '0'}`);\n            return void callback(EXIT_CODES.ADAPTER_ALREADY_RUNNING);\n        }\n\n        const adapterDir = tools.getAdapterDir(adapter);\n        if (!adapterDir) {\n            CLI.error.adapterDirNotFound(adapter);\n            return void callback(34);\n        }\n\n        let mainFile;\n        try {\n            mainFile = await tools.resolveAdapterMainFile(adapter);\n        } catch {\n            CLI.error.mainFileNotFound(adapter);\n            return callback(1);\n        }\n\n        // Start the adapter with force and console logs\n        const adapterArgs = [instance || '0', '--debug'];\n        // Tell node to attach a debugger\n        const nodeArgs = [\n            ...tools.getDefaultNodeArgs(mainFile),\n            // --inspect[-brk][=[ip]:[port]]\n            `--inspect${params.wait ? '-brk' : ''}${!!params.ip || !!params.port ? '=' : ''}${params.ip || ''}${\n                !!params.ip && !!params.port ? ':' : ''\n            }${params.port || ''}`,\n        ];\n        // And wait until the sub process has finished\n        const cp = fork(mainFile, adapterArgs, {\n            cwd: adapterDir,\n            execArgv: nodeArgs,\n        });\n        cp.on('exit', code => callback(code || 0));\n    }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAAA,UAAqB;AACrB,wBAAmD;AACnD,eAA0B;AAC1B,kCAAkC;AAClC,gCAAqB;AAGf,MAAO,iBAAiB,6BAAU;EACpC,YAAY,SAA0B;AAClC,UAAM,OAAO;EACjB;;;;;;;EAQQ,mBAAmB,SAAiB,UAAgB;AACxD,UAAM,EAAE,UAAS,IAAK,KAAK;AAC3B,WAAO,IAAI,QAAQ,aAAU;AACzB,gBAAU,OAAO,EAAE,OAAM,MAAM;AAC3B,YAAI;AACA,gBAAM,QAAQ,MAAM,OAAO,cAAc,kBAAkB,OAAO,IAAI,QAAQ,QAAQ;AACtF,cAAI,OAAO,KAAK;AACZ,oBAAQ,IAAI;AACZ;UACJ;QACJ,QAAQ;QAER;AACA,gBAAQ,KAAK;MACjB,CAAC;IACL,CAAC;EACL;;;;;;EAOA,MAAM,QAAQ,MAAW;AACrB,UAAM,EAAE,UAAU,GAAG,OAAM,IAAK,KAAK;AACrC,UAAM,UAAU,KAAK,CAAC;AACtB,QAAI,CAAC,SAAS;AACV,UAAI,MAAM,wBAAwB,eAAe,qBAAqB;AACtE,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,UAAM,EAAE,MAAM,SAAQ,IAAK,SAAS,4CAA4C,OAAO;AAEvF,QAAI,MAAM,KAAK,mBAAmB,MAAM,YAAY,GAAG,GAAG;AACtD,UAAI,MAAM,uBAAuB,GAAG,IAAI,IAAI,YAAY,GAAG,EAAE;AAC7D,aAAO,KAAK,SAAS,uCAAW,uBAAuB;IAC3D;AAEA,UAAM,aAAa,kCAAM,cAAc,OAAO;AAC9C,QAAI,CAAC,YAAY;AACb,UAAI,MAAM,mBAAmB,OAAO;AACpC,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,QAAI;AACJ,QAAI;AACA,iBAAW,MAAM,kCAAM,uBAAuB,OAAO;IACzD,QAAQ;AACJ,UAAI,MAAM,iBAAiB,OAAO;AAClC,aAAO,SAAS,CAAC;IACrB;AAGA,UAAM,cAAc,CAAC,YAAY,KAAK,SAAS;AAE/C,UAAM,WAAW;MACb,GAAG,kCAAM,mBAAmB,QAAQ;;MAEpC,YAAY,OAAO,OAAO,SAAS,EAAE,GAAG,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,GAC7F,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,OAAO,MAAM,EACzC,GAAG,OAAO,QAAQ,EAAE;;AAGxB,UAAM,SAAK,gCAAK,UAAU,aAAa;MACnC,KAAK;MACL,UAAU;KACb;AACD,OAAG,GAAG,QAAQ,UAAQ,SAAS,QAAQ,CAAC,CAAC;EAC7C;;",
+  "sourcesContent": ["import * as CLI from './messages.js';\nimport { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport * as CLITools from './cliTools.js';\nimport { tools, EXIT_CODES } from '@iobroker/js-controller-common';\nimport { fork } from 'node:child_process';\n\n/** Command ioBroker debug ... */\nexport class CLIDebug extends CLICommand {\n    /**\n     * @param options The command options including context and parameters\n     */\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n\n    /**\n     * Checks if the adapter instance is running\n     *\n     * @param adapter adapter name\n     * @param instance instance id\n     */\n    private _isInstanceRunning(adapter: string, instance: string): Promise<boolean> {\n        const { dbConnect } = this.options;\n        return new Promise(resolve => {\n            dbConnect(async ({ states }) => {\n                try {\n                    const state = await states.getStateAsync(`system.adapter.${adapter}.${instance}.alive`);\n                    if (state?.val) {\n                        resolve(true);\n                        return;\n                    }\n                } catch {\n                    // ignore\n                }\n                resolve(false);\n            });\n        });\n    }\n\n    /**\n     * Executes a command\n     *\n     * @param args The command arguments (the first is the adapter name)\n     */\n    async execute(args: any[]): Promise<void> {\n        const { callback, ...params } = this.options;\n        const adapter = args[0];\n        if (!adapter) {\n            CLI.error.requiredArgumentMissing('adaptername', 'debug <adaptername>');\n            return void callback(34);\n        }\n\n        const { name, instance } = CLITools.splitAdapterOrInstanceIdentifierWithVersion(adapter)!;\n\n        if (await this._isInstanceRunning(name, instance || '0')) {\n            CLI.error.instanceAlreadyRunning(`${name}.${instance || '0'}`);\n            return void callback(EXIT_CODES.ADAPTER_ALREADY_RUNNING);\n        }\n\n        const adapterDir = tools.getAdapterDir(adapter);\n        if (!adapterDir) {\n            CLI.error.adapterDirNotFound(adapter);\n            return void callback(34);\n        }\n\n        let mainFile;\n        try {\n            mainFile = await tools.resolveAdapterMainFile(adapter);\n        } catch {\n            CLI.error.mainFileNotFound(adapter);\n            return callback(1);\n        }\n\n        // Start the adapter with force and console logs\n        const adapterArgs = [instance || '0', '--debug'];\n        // Tell node to attach a debugger\n        const nodeArgs = [\n            ...tools.getDefaultNodeArgs(mainFile),\n            // --inspect[-brk][=[ip]:[port]]\n            `--inspect${params.wait ? '-brk' : ''}${!!params.ip || !!params.port ? '=' : ''}${params.ip || ''}${\n                !!params.ip && !!params.port ? ':' : ''\n            }${params.port || ''}`,\n        ];\n        // And wait until the sub process has finished\n        const cp = fork(mainFile, adapterArgs, {\n            cwd: adapterDir,\n            execArgv: nodeArgs,\n        });\n        cp.on('exit', code => callback(code || 0));\n    }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAAA,UAAqB;AACrB,wBAAmD;AACnD,eAA0B;AAC1B,kCAAkC;AAClC,gCAAqB;AAGf,MAAO,iBAAiB,6BAAU;;;;EAIpC,YAAY,SAA0B;AAClC,UAAM,OAAO;EACjB;;;;;;;EAQQ,mBAAmB,SAAiB,UAAgB;AACxD,UAAM,EAAE,UAAS,IAAK,KAAK;AAC3B,WAAO,IAAI,QAAQ,aAAU;AACzB,gBAAU,OAAO,EAAE,OAAM,MAAM;AAC3B,YAAI;AACA,gBAAM,QAAQ,MAAM,OAAO,cAAc,kBAAkB,OAAO,IAAI,QAAQ,QAAQ;AACtF,cAAI,OAAO,KAAK;AACZ,oBAAQ,IAAI;AACZ;UACJ;QACJ,QAAQ;QAER;AACA,gBAAQ,KAAK;MACjB,CAAC;IACL,CAAC;EACL;;;;;;EAOA,MAAM,QAAQ,MAAW;AACrB,UAAM,EAAE,UAAU,GAAG,OAAM,IAAK,KAAK;AACrC,UAAM,UAAU,KAAK,CAAC;AACtB,QAAI,CAAC,SAAS;AACV,UAAI,MAAM,wBAAwB,eAAe,qBAAqB;AACtE,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,UAAM,EAAE,MAAM,SAAQ,IAAK,SAAS,4CAA4C,OAAO;AAEvF,QAAI,MAAM,KAAK,mBAAmB,MAAM,YAAY,GAAG,GAAG;AACtD,UAAI,MAAM,uBAAuB,GAAG,IAAI,IAAI,YAAY,GAAG,EAAE;AAC7D,aAAO,KAAK,SAAS,uCAAW,uBAAuB;IAC3D;AAEA,UAAM,aAAa,kCAAM,cAAc,OAAO;AAC9C,QAAI,CAAC,YAAY;AACb,UAAI,MAAM,mBAAmB,OAAO;AACpC,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,QAAI;AACJ,QAAI;AACA,iBAAW,MAAM,kCAAM,uBAAuB,OAAO;IACzD,QAAQ;AACJ,UAAI,MAAM,iBAAiB,OAAO;AAClC,aAAO,SAAS,CAAC;IACrB;AAGA,UAAM,cAAc,CAAC,YAAY,KAAK,SAAS;AAE/C,UAAM,WAAW;MACb,GAAG,kCAAM,mBAAmB,QAAQ;;MAEpC,YAAY,OAAO,OAAO,SAAS,EAAE,GAAG,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,OAAO,MAAM,EAAE,GAAG,OAAO,MAAM,EAAE,GAC7F,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,OAAO,MAAM,EACzC,GAAG,OAAO,QAAQ,EAAE;;AAGxB,UAAM,SAAK,gCAAK,UAAU,aAAa;MACnC,KAAK;MACL,UAAU;KACb;AACD,OAAG,GAAG,QAAQ,UAAQ,SAAS,QAAQ,CAAC,CAAC;EAC7C;;",
   "names": []
 }

package/build/cjs/lib/cli/cliHost.d.ts

@@ -1,35 +1,38 @@
 import { CLICommand, type CLICommandOptions } from './cliCommand.js';
 /** Command iobroker host ... */
 export declare class CLIHost extends CLICommand {
+    /**
+     * @param options The command options including context and parameters
+     */
     constructor(options: CLICommandOptions);
     /**
      * Executes a command
      *
-     * @param args
+     * @param args The command arguments (the first is the sub-command)
      */
     execute(args: any[]): void;
     /**
      * When in single-host mode, changes the hostname of the host and all instances to the current one
      *
-     * @param _args
+     * @param _args The command arguments (unused)
      */
     self(_args: any[]): void;
     /**
      * Changes the current host's hostname to the given one
      *
-     * @param args
+     * @param args The command arguments (the second is the new hostname)
      */
     set(args: any[]): void;
     /**
      * Removes the host with the given name
      *
-     * @param args
+     * @param args The command arguments (the second is the hostname to remove)
      */
     remove(args: any[]): void;
     /**
      * Renames the host with the given name to the current one (opposite of `set()`)
      *
-     * @param args
+     * @param args The command arguments (the second is the old hostname)
      */
     rename(args: any[]): void;
     /**

package/build/cjs/lib/cli/cliHost.js

@@ -38,13 +38,16 @@ var import_js_controller_common = require("@iobroker/js-controller-common");
 var import_node_os = __toESM(require("node:os"), 1);
 var import_fs_extra = __toESM(require("fs-extra"), 1);
 class CLIHost extends import_cliCommand.CLICommand {
+  /**
+   * @param options The command options including context and parameters
+   */
   constructor(options) {
     super(options);
   }
   /**
    * Executes a command
    *
-   * @param args
+   * @param args The command arguments (the first is the sub-command)
    */
   execute(args) {
     const command = args[0];
@@ -63,7 +66,7 @@ class CLIHost extends import_cliCommand.CLICommand {
   /**
    * When in single-host mode, changes the hostname of the host and all instances to the current one
    *
-   * @param _args
+   * @param _args The command arguments (unused)
    */
   self(_args) {
     this.renameHost(void 0, import_node_os.default.hostname());
@@ -71,7 +74,7 @@ class CLIHost extends import_cliCommand.CLICommand {
   /**
    * Changes the current host's hostname to the given one
    *
-   * @param args
+   * @param args The command arguments (the second is the new hostname)
    */
   set(args) {
     const { callback } = this.options;
@@ -85,7 +88,7 @@ class CLIHost extends import_cliCommand.CLICommand {
   /**
    * Removes the host with the given name
    *
-   * @param args
+   * @param args The command arguments (the second is the hostname to remove)
    */
   remove(args) {
     const { callback, dbConnect } = this.options;
@@ -143,7 +146,7 @@ class CLIHost extends import_cliCommand.CLICommand {
   /**
    * Renames the host with the given name to the current one (opposite of `set()`)
    *
-   * @param args
+   * @param args The command arguments (the second is the old hostname)
    */
   rename(args) {
     const { callback } = this.options;

package/build/cjs/lib/cli/cliHost.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/cli/cliHost.ts"],
-  "sourcesContent": ["import * as CLI from './messages.js';\nimport { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport { enumHosts, enumObjects, getObjectFrom, enumInstances } from './cliTools.js';\nimport { tools, EXIT_CODES } from '@iobroker/js-controller-common';\nimport type { Client as ObjectsClient } from '@iobroker/db-objects-redis';\nimport os from 'node:os';\nimport fs from 'fs-extra';\n\n/** Command iobroker host ... */\nexport class CLIHost extends CLICommand {\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n\n    /**\n     * Executes a command\n     *\n     * @param args\n     */\n    execute(args: any[]): void {\n        const command = args[0];\n\n        switch (command) {\n            case 'this':\n            case 'self':\n                return this.self(args);\n            case 'set':\n                return this.set(args);\n            case 'remove':\n                return this.remove(args);\n            default:\n                return this.rename(args);\n        }\n    }\n\n    /**\n     * When in single-host mode, changes the hostname of the host and all instances to the current one\n     *\n     * @param _args\n     */\n    self(_args: any[]): void {\n        this.renameHost(undefined, os.hostname());\n    }\n\n    /**\n     * Changes the current host's hostname to the given one\n     *\n     * @param args\n     */\n    set(args: any[]): void {\n        const { callback } = this.options;\n\n        const newHostname: string = args[1];\n        if (!newHostname) {\n            CLI.error.requiredArgumentMissing('newHostname', 'host set newHostname');\n            return void callback(34);\n        }\n\n        this.renameHost(tools.getHostName(), newHostname);\n    }\n\n    /**\n     * Removes the host with the given name\n     *\n     * @param args\n     */\n    remove(args: any[]): void {\n        const { callback, dbConnect } = this.options;\n\n        const hostname: string = args[1];\n        if (!hostname) {\n            CLI.error.requiredArgumentMissing('hostname', 'host remove hostname');\n            return void callback(34);\n        }\n\n        const newHostname = tools.getHostName();\n\n        if (hostname === newHostname) {\n            // avoid object deletion when target host is same host\n            CLI.error.dontRemoveCurrentHost(hostname);\n            return void callback(35);\n        }\n\n        dbConnect(async params => {\n            const { objects, isOffline } = params;\n\n            try {\n                if (!isOffline) {\n                    CLI.error.cannotChangeRunningSystem();\n                    return void callback(EXIT_CODES.CONTROLLER_RUNNING);\n                }\n\n                // Find the requested host object\n                const hosts = await enumHosts(objects);\n                const hostToDelete = hosts.find(host => host?.common.hostname === hostname);\n                if (!hostToDelete) {\n                    CLI.error.hostDoesNotExist(hostname);\n                    return void callback(30);\n                }\n\n                // Delete it\n                try {\n                    await objects.delObjectAsync(hostToDelete._id);\n                } catch (err) {\n                    CLI.error.cannotDeleteObject(hostToDelete._id, err.message);\n                    return void callback(30);\n                }\n\n                // Also delete its states\n                const hostStates = await enumObjects(objects, 'state', `system.host.${hostname}.`);\n                for (const state of hostStates) {\n                    // Therefore delete the old one because we will recreate it under a new name\n                    try {\n                        await objects.delObjectAsync(state._id);\n                        CLI.success.stateDeleted(state._id);\n                    } catch (err) {\n                        CLI.error.cannotDeleteObject(state._id, err.message);\n                    }\n                }\n\n                // Move all instances from the deleted host to the current one\n                const instances = await enumInstances(objects);\n                const instancesToRename = instances.filter(i => i?.common.host === hostname);\n                for (const instance of instancesToRename) {\n                    await changeInstanceHost(objects, instance, newHostname);\n                }\n\n                // Notify the user that we are done\n                CLI.success.hostDeleted(hostname);\n                return void callback(EXIT_CODES.NO_ERROR);\n            } catch (err) {\n                CLI.error.unknown(err.message);\n                return void callback(1);\n            }\n        });\n    }\n\n    /**\n     * Renames the host with the given name to the current one (opposite of `set()`)\n     *\n     * @param args\n     */\n    rename(args: any[]): void {\n        const { callback } = this.options;\n\n        const oldHostname: string = args[0];\n\n        if (!oldHostname) {\n            CLI.error.requiredArgumentMissing('oldHostname', 'host oldHostname');\n            return void callback(34);\n        }\n\n        this.renameHost(oldHostname, os.hostname());\n    }\n\n    /**\n     * Renames the host with the hostname `oldHostname` to the hostname `newHostname`\n     *\n     * @param oldHostname The hostname to rename from or `undefined` to rename all hosts (single-host mode only!)\n     * @param newHostname The hostname to rename to\n     */\n    renameHost(oldHostname: string | undefined, newHostname: string): void {\n        const { callback, dbConnect, showHelp } = this.options;\n        dbConnect(async params => {\n            const { isOffline, objects } = params;\n\n            try {\n                if (!isOffline) {\n                    CLI.error.cannotChangeRunningSystem();\n                    return void callback(EXIT_CODES.CONTROLLER_RUNNING);\n                }\n\n                const hosts = await enumHosts(objects);\n                if (hosts.length > 1 && oldHostname === undefined) {\n                    // iobroker host this/self in multihost is not allowed\n                    CLI.error.noHostThisInMultihost();\n                    showHelp();\n                    return void callback(30);\n                }\n\n                // Does another host with the target name exist?\n                const hostExists = !!hosts.find(obj => obj?.common.hostname === newHostname);\n                if (hostExists) {\n                    // This prevents migration of instances if host already exists, but we need it to prevent\n                    // multiple hosts with same name. Thus we only allow if no instances are on the host\n                    // Note: this is only a heuristic, if problems occur we need a `force` flag\n                    const instances = await enumInstances(objects);\n                    const hasExistingInstances = !!instances.find(instance => instance?.common.host === newHostname);\n\n                    if (hasExistingInstances) {\n                        CLI.error.hostAlreadyExists(newHostname);\n                        return void callback(EXIT_CODES.INSTANCE_ALREADY_EXISTS);\n                    }\n                }\n\n                // Remember the new hostname in the system settings\n                const configFileName = tools.getConfigFileName();\n                const configData = fs.readJSONSync(configFileName);\n                if (configData.system && configData.system.hostname !== newHostname) {\n                    configData.system.hostname = newHostname;\n                    fs.writeFileSync(configFileName, JSON.stringify(configData, null, 2), 'utf8');\n                }\n\n                // Rename the host(s)\n                for (const host of hosts) {\n                    // Remember the current hostname of this object because we need it later\n                    const prevHostname = host.common.hostname;\n\n                    // Rename only the hostname we're supposed to rename!\n                    if (oldHostname && prevHostname !== oldHostname) {\n                        continue;\n                    }\n\n                    // Rename the host object\n                    // Therefore delete the old one because we will recreate it under a new name\n                    try {\n                        await objects.delObjectAsync(host._id);\n                    } catch (err) {\n                        CLI.error.cannotDeleteObject(host._id, err.message);\n                        continue;\n                    }\n\n                    // Now update the object\n                    Object.assign(host, {\n                        _id: `system.host.${newHostname}`,\n                        from: getObjectFrom(),\n                        ts: Date.now(),\n                    });\n                    Object.assign(host.common, {\n                        name: host._id,\n                        hostname: newHostname,\n                        address: [],\n                        cmd: '',\n                        native: { process: {}, os: {}, hardware: {} },\n                    });\n                    // And save it\n                    try {\n                        await objects.setObjectAsync(host._id, host);\n                    } catch (err) {\n                        CLI.error.cannotChangeObject(host._id, err.message);\n                        continue;\n                    }\n\n                    // Rename its states\n                    const hostStateObjects = await enumObjects(objects, 'state', `system.host.${prevHostname}.`);\n                    const hostFolders = await enumObjects(objects, 'folder', `system.host.${prevHostname}.`);\n                    for (const object of [...hostStateObjects, ...hostFolders]) {\n                        // Therefore delete the old one because we will recreate it under a new name\n                        try {\n                            await objects.delObjectAsync(object._id);\n                        } catch (err) {\n                            CLI.error.cannotDeleteObject(object._id, err.message);\n                            continue;\n                        }\n\n                        // Now update the object\n                        Object.assign(object, {\n                            _id: object._id.replace(`system.host.${prevHostname}`, `system.host.${newHostname}`),\n                            from: getObjectFrom(),\n                            ts: Date.now(),\n                        });\n\n                        // And save it\n                        try {\n                            await objects.setObjectAsync(object._id, object);\n                        } catch (err) {\n                            CLI.error.cannotChangeObject(object._id, err.message);\n                        }\n                    }\n\n                    CLI.success.hostRenamed(prevHostname, newHostname);\n                }\n\n                // Also rename all instances\n                const instances = await enumInstances(objects);\n                const instancesToRename =\n                    oldHostname === undefined ? instances : instances.filter(i => i.common.host === oldHostname);\n                if (instancesToRename.length > 0) {\n                    for (const instance of instancesToRename) {\n                        // Update each instance object\n                        await changeInstanceHost(objects, instance, newHostname);\n                    }\n                } else {\n                    CLI.warn.noInstancesFoundOnHost(oldHostname);\n                }\n                return void callback(EXIT_CODES.NO_ERROR);\n            } catch (err) {\n                CLI.error.unknown(err.message);\n                return void callback(1);\n            }\n        });\n    }\n}\n\n/**\n * Changes the host an instance is running on\n *\n * @param objects The objects DB to use\n * @param instance The instance object\n * @param newHostname The new hostname the instance should be running on\n */\nasync function changeInstanceHost(\n    objects: ObjectsClient,\n    instance: ioBroker.InstanceObject,\n    newHostname: string,\n): Promise<void> {\n    const oldInstanceHost = instance.common.host;\n    instance.from = getObjectFrom();\n    instance.ts = Date.now();\n    instance.common.host = newHostname;\n    // and save it\n    try {\n        await objects.setObjectAsync(instance._id, instance);\n        CLI.success.instanceHostChanged(instance._id, oldInstanceHost, newHostname);\n    } catch (e) {\n        CLI.error.cannotChangeObject(instance._id, e.message);\n        // resolve anyways, we don't want to cause errors\n    }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAAA,UAAqB;AACrB,wBAAmD;AACnD,sBAAqE;AACrE,kCAAkC;AAElC,qBAAe;AACf,sBAAe;AAGT,MAAO,gBAAgB,6BAAU;EACnC,YAAY,SAA0B;AAClC,UAAM,OAAO;EACjB;;;;;;EAOA,QAAQ,MAAW;AACf,UAAM,UAAU,KAAK,CAAC;AAEtB,YAAQ,SAAS;MACb,KAAK;MACL,KAAK;AACD,eAAO,KAAK,KAAK,IAAI;MACzB,KAAK;AACD,eAAO,KAAK,IAAI,IAAI;MACxB,KAAK;AACD,eAAO,KAAK,OAAO,IAAI;MAC3B;AACI,eAAO,KAAK,OAAO,IAAI;IAC/B;EACJ;;;;;;EAOA,KAAK,OAAY;AACb,SAAK,WAAW,QAAW,eAAAA,QAAG,SAAQ,CAAE;EAC5C;;;;;;EAOA,IAAI,MAAW;AACX,UAAM,EAAE,SAAQ,IAAK,KAAK;AAE1B,UAAM,cAAsB,KAAK,CAAC;AAClC,QAAI,CAAC,aAAa;AACd,UAAI,MAAM,wBAAwB,eAAe,sBAAsB;AACvE,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,SAAK,WAAW,kCAAM,YAAW,GAAI,WAAW;EACpD;;;;;;EAOA,OAAO,MAAW;AACd,UAAM,EAAE,UAAU,UAAS,IAAK,KAAK;AAErC,UAAM,WAAmB,KAAK,CAAC;AAC/B,QAAI,CAAC,UAAU;AACX,UAAI,MAAM,wBAAwB,YAAY,sBAAsB;AACpE,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,UAAM,cAAc,kCAAM,YAAW;AAErC,QAAI,aAAa,aAAa;AAE1B,UAAI,MAAM,sBAAsB,QAAQ;AACxC,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,cAAU,OAAM,WAAS;AACrB,YAAM,EAAE,SAAS,UAAS,IAAK;AAE/B,UAAI;AACA,YAAI,CAAC,WAAW;AACZ,cAAI,MAAM,0BAAyB;AACnC,iBAAO,KAAK,SAAS,uCAAW,kBAAkB;QACtD;AAGA,cAAM,QAAQ,UAAM,2BAAU,OAAO;AACrC,cAAM,eAAe,MAAM,KAAK,UAAQ,MAAM,OAAO,aAAa,QAAQ;AAC1E,YAAI,CAAC,cAAc;AACf,cAAI,MAAM,iBAAiB,QAAQ;AACnC,iBAAO,KAAK,SAAS,EAAE;QAC3B;AAGA,YAAI;AACA,gBAAM,QAAQ,eAAe,aAAa,GAAG;QACjD,SAAS,KAAK;AACV,cAAI,MAAM,mBAAmB,aAAa,KAAK,IAAI,OAAO;AAC1D,iBAAO,KAAK,SAAS,EAAE;QAC3B;AAGA,cAAM,aAAa,UAAM,6BAAY,SAAS,SAAS,eAAe,QAAQ,GAAG;AACjF,mBAAW,SAAS,YAAY;AAE5B,cAAI;AACA,kBAAM,QAAQ,eAAe,MAAM,GAAG;AACtC,gBAAI,QAAQ,aAAa,MAAM,GAAG;UACtC,SAAS,KAAK;AACV,gBAAI,MAAM,mBAAmB,MAAM,KAAK,IAAI,OAAO;UACvD;QACJ;AAGA,cAAM,YAAY,UAAM,+BAAc,OAAO;AAC7C,cAAM,oBAAoB,UAAU,OAAO,OAAK,GAAG,OAAO,SAAS,QAAQ;AAC3E,mBAAW,YAAY,mBAAmB;AACtC,gBAAM,mBAAmB,SAAS,UAAU,WAAW;QAC3D;AAGA,YAAI,QAAQ,YAAY,QAAQ;AAChC,eAAO,KAAK,SAAS,uCAAW,QAAQ;MAC5C,SAAS,KAAK;AACV,YAAI,MAAM,QAAQ,IAAI,OAAO;AAC7B,eAAO,KAAK,SAAS,CAAC;MAC1B;IACJ,CAAC;EACL;;;;;;EAOA,OAAO,MAAW;AACd,UAAM,EAAE,SAAQ,IAAK,KAAK;AAE1B,UAAM,cAAsB,KAAK,CAAC;AAElC,QAAI,CAAC,aAAa;AACd,UAAI,MAAM,wBAAwB,eAAe,kBAAkB;AACnE,aAAO,KAAK,SAAS,EAAE;IAC3B;AAEA,SAAK,WAAW,aAAa,eAAAA,QAAG,SAAQ,CAAE;EAC9C;;;;;;;EAQA,WAAW,aAAiC,aAAmB;AAC3D,UAAM,EAAE,UAAU,WAAW,SAAQ,IAAK,KAAK;AAC/C,cAAU,OAAM,WAAS;AACrB,YAAM,EAAE,WAAW,QAAO,IAAK;AAE/B,UAAI;AACA,YAAI,CAAC,WAAW;AACZ,cAAI,MAAM,0BAAyB;AACnC,iBAAO,KAAK,SAAS,uCAAW,kBAAkB;QACtD;AAEA,cAAM,QAAQ,UAAM,2BAAU,OAAO;AACrC,YAAI,MAAM,SAAS,KAAK,gBAAgB,QAAW;AAE/C,cAAI,MAAM,sBAAqB;AAC/B,mBAAQ;AACR,iBAAO,KAAK,SAAS,EAAE;QAC3B;AAGA,cAAM,aAAa,CAAC,CAAC,MAAM,KAAK,SAAO,KAAK,OAAO,aAAa,WAAW;AAC3E,YAAI,YAAY;AAIZ,gBAAMC,aAAY,UAAM,+BAAc,OAAO;AAC7C,gBAAM,uBAAuB,CAAC,CAACA,WAAU,KAAK,cAAY,UAAU,OAAO,SAAS,WAAW;AAE/F,cAAI,sBAAsB;AACtB,gBAAI,MAAM,kBAAkB,WAAW;AACvC,mBAAO,KAAK,SAAS,uCAAW,uBAAuB;UAC3D;QACJ;AAGA,cAAM,iBAAiB,kCAAM,kBAAiB;AAC9C,cAAM,aAAa,gBAAAC,QAAG,aAAa,cAAc;AACjD,YAAI,WAAW,UAAU,WAAW,OAAO,aAAa,aAAa;AACjE,qBAAW,OAAO,WAAW;AAC7B,0BAAAA,QAAG,cAAc,gBAAgB,KAAK,UAAU,YAAY,MAAM,CAAC,GAAG,MAAM;QAChF;AAGA,mBAAW,QAAQ,OAAO;AAEtB,gBAAM,eAAe,KAAK,OAAO;AAGjC,cAAI,eAAe,iBAAiB,aAAa;AAC7C;UACJ;AAIA,cAAI;AACA,kBAAM,QAAQ,eAAe,KAAK,GAAG;UACzC,SAAS,KAAK;AACV,gBAAI,MAAM,mBAAmB,KAAK,KAAK,IAAI,OAAO;AAClD;UACJ;AAGA,iBAAO,OAAO,MAAM;YAChB,KAAK,eAAe,WAAW;YAC/B,UAAM,+BAAa;YACnB,IAAI,KAAK,IAAG;WACf;AACD,iBAAO,OAAO,KAAK,QAAQ;YACvB,MAAM,KAAK;YACX,UAAU;YACV,SAAS,CAAA;YACT,KAAK;YACL,QAAQ,EAAE,SAAS,CAAA,GAAI,IAAI,CAAA,GAAI,UAAU,CAAA,EAAE;WAC9C;AAED,cAAI;AACA,kBAAM,QAAQ,eAAe,KAAK,KAAK,IAAI;UAC/C,SAAS,KAAK;AACV,gBAAI,MAAM,mBAAmB,KAAK,KAAK,IAAI,OAAO;AAClD;UACJ;AAGA,gBAAM,mBAAmB,UAAM,6BAAY,SAAS,SAAS,eAAe,YAAY,GAAG;AAC3F,gBAAM,cAAc,UAAM,6BAAY,SAAS,UAAU,eAAe,YAAY,GAAG;AACvF,qBAAW,UAAU,CAAC,GAAG,kBAAkB,GAAG,WAAW,GAAG;AAExD,gBAAI;AACA,oBAAM,QAAQ,eAAe,OAAO,GAAG;YAC3C,SAAS,KAAK;AACV,kBAAI,MAAM,mBAAmB,OAAO,KAAK,IAAI,OAAO;AACpD;YACJ;AAGA,mBAAO,OAAO,QAAQ;cAClB,KAAK,OAAO,IAAI,QAAQ,eAAe,YAAY,IAAI,eAAe,WAAW,EAAE;cACnF,UAAM,+BAAa;cACnB,IAAI,KAAK,IAAG;aACf;AAGD,gBAAI;AACA,oBAAM,QAAQ,eAAe,OAAO,KAAK,MAAM;YACnD,SAAS,KAAK;AACV,kBAAI,MAAM,mBAAmB,OAAO,KAAK,IAAI,OAAO;YACxD;UACJ;AAEA,cAAI,QAAQ,YAAY,cAAc,WAAW;QACrD;AAGA,cAAM,YAAY,UAAM,+BAAc,OAAO;AAC7C,cAAM,oBACF,gBAAgB,SAAY,YAAY,UAAU,OAAO,OAAK,EAAE,OAAO,SAAS,WAAW;AAC/F,YAAI,kBAAkB,SAAS,GAAG;AAC9B,qBAAW,YAAY,mBAAmB;AAEtC,kBAAM,mBAAmB,SAAS,UAAU,WAAW;UAC3D;QACJ,OAAO;AACH,cAAI,KAAK,uBAAuB,WAAW;QAC/C;AACA,eAAO,KAAK,SAAS,uCAAW,QAAQ;MAC5C,SAAS,KAAK;AACV,YAAI,MAAM,QAAQ,IAAI,OAAO;AAC7B,eAAO,KAAK,SAAS,CAAC;MAC1B;IACJ,CAAC;EACL;;AAUJ,eAAe,mBACX,SACA,UACA,aAAmB;AAEnB,QAAM,kBAAkB,SAAS,OAAO;AACxC,WAAS,WAAO,+BAAa;AAC7B,WAAS,KAAK,KAAK,IAAG;AACtB,WAAS,OAAO,OAAO;AAEvB,MAAI;AACA,UAAM,QAAQ,eAAe,SAAS,KAAK,QAAQ;AACnD,QAAI,QAAQ,oBAAoB,SAAS,KAAK,iBAAiB,WAAW;EAC9E,SAAS,GAAG;AACR,QAAI,MAAM,mBAAmB,SAAS,KAAK,EAAE,OAAO;EAExD;AACJ;",
+  "sourcesContent": ["import * as CLI from './messages.js';\nimport { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport { enumHosts, enumObjects, getObjectFrom, enumInstances } from './cliTools.js';\nimport { tools, EXIT_CODES } from '@iobroker/js-controller-common';\nimport type { Client as ObjectsClient } from '@iobroker/db-objects-redis';\nimport os from 'node:os';\nimport fs from 'fs-extra';\n\n/** Command iobroker host ... */\nexport class CLIHost extends CLICommand {\n    /**\n     * @param options The command options including context and parameters\n     */\n    constructor(options: CLICommandOptions) {\n        super(options);\n    }\n\n    /**\n     * Executes a command\n     *\n     * @param args The command arguments (the first is the sub-command)\n     */\n    execute(args: any[]): void {\n        const command = args[0];\n\n        switch (command) {\n            case 'this':\n            case 'self':\n                return this.self(args);\n            case 'set':\n                return this.set(args);\n            case 'remove':\n                return this.remove(args);\n            default:\n                return this.rename(args);\n        }\n    }\n\n    /**\n     * When in single-host mode, changes the hostname of the host and all instances to the current one\n     *\n     * @param _args The command arguments (unused)\n     */\n    self(_args: any[]): void {\n        this.renameHost(undefined, os.hostname());\n    }\n\n    /**\n     * Changes the current host's hostname to the given one\n     *\n     * @param args The command arguments (the second is the new hostname)\n     */\n    set(args: any[]): void {\n        const { callback } = this.options;\n\n        const newHostname: string = args[1];\n        if (!newHostname) {\n            CLI.error.requiredArgumentMissing('newHostname', 'host set newHostname');\n            return void callback(34);\n        }\n\n        this.renameHost(tools.getHostName(), newHostname);\n    }\n\n    /**\n     * Removes the host with the given name\n     *\n     * @param args The command arguments (the second is the hostname to remove)\n     */\n    remove(args: any[]): void {\n        const { callback, dbConnect } = this.options;\n\n        const hostname: string = args[1];\n        if (!hostname) {\n            CLI.error.requiredArgumentMissing('hostname', 'host remove hostname');\n            return void callback(34);\n        }\n\n        const newHostname = tools.getHostName();\n\n        if (hostname === newHostname) {\n            // avoid object deletion when target host is same host\n            CLI.error.dontRemoveCurrentHost(hostname);\n            return void callback(35);\n        }\n\n        dbConnect(async params => {\n            const { objects, isOffline } = params;\n\n            try {\n                if (!isOffline) {\n                    CLI.error.cannotChangeRunningSystem();\n                    return void callback(EXIT_CODES.CONTROLLER_RUNNING);\n                }\n\n                // Find the requested host object\n                const hosts = await enumHosts(objects);\n                const hostToDelete = hosts.find(host => host?.common.hostname === hostname);\n                if (!hostToDelete) {\n                    CLI.error.hostDoesNotExist(hostname);\n                    return void callback(30);\n                }\n\n                // Delete it\n                try {\n                    await objects.delObjectAsync(hostToDelete._id);\n                } catch (err) {\n                    CLI.error.cannotDeleteObject(hostToDelete._id, err.message);\n                    return void callback(30);\n                }\n\n                // Also delete its states\n                const hostStates = await enumObjects(objects, 'state', `system.host.${hostname}.`);\n                for (const state of hostStates) {\n                    // Therefore delete the old one because we will recreate it under a new name\n                    try {\n                        await objects.delObjectAsync(state._id);\n                        CLI.success.stateDeleted(state._id);\n                    } catch (err) {\n                        CLI.error.cannotDeleteObject(state._id, err.message);\n                    }\n                }\n\n                // Move all instances from the deleted host to the current one\n                const instances = await enumInstances(objects);\n                const instancesToRename = instances.filter(i => i?.common.host === hostname);\n                for (const instance of instancesToRename) {\n                    await changeInstanceHost(objects, instance, newHostname);\n                }\n\n                // Notify the user that we are done\n                CLI.success.hostDeleted(hostname);\n                return void callback(EXIT_CODES.NO_ERROR);\n            } catch (err) {\n                CLI.error.unknown(err.message);\n                return void callback(1);\n            }\n        });\n    }\n\n    /**\n     * Renames the host with the given name to the current one (opposite of `set()`)\n     *\n     * @param args The command arguments (the second is the old hostname)\n     */\n    rename(args: any[]): void {\n        const { callback } = this.options;\n\n        const oldHostname: string = args[0];\n\n        if (!oldHostname) {\n            CLI.error.requiredArgumentMissing('oldHostname', 'host oldHostname');\n            return void callback(34);\n        }\n\n        this.renameHost(oldHostname, os.hostname());\n    }\n\n    /**\n     * Renames the host with the hostname `oldHostname` to the hostname `newHostname`\n     *\n     * @param oldHostname The hostname to rename from or `undefined` to rename all hosts (single-host mode only!)\n     * @param newHostname The hostname to rename to\n     */\n    renameHost(oldHostname: string | undefined, newHostname: string): void {\n        const { callback, dbConnect, showHelp } = this.options;\n        dbConnect(async params => {\n            const { isOffline, objects } = params;\n\n            try {\n                if (!isOffline) {\n                    CLI.error.cannotChangeRunningSystem();\n                    return void callback(EXIT_CODES.CONTROLLER_RUNNING);\n                }\n\n                const hosts = await enumHosts(objects);\n                if (hosts.length > 1 && oldHostname === undefined) {\n                    // iobroker host this/self in multihost is not allowed\n                    CLI.error.noHostThisInMultihost();\n                    showHelp();\n                    return void callback(30);\n                }\n\n                // Does another host with the target name exist?\n                const hostExists = !!hosts.find(obj => obj?.common.hostname === newHostname);\n                if (hostExists) {\n                    // This prevents migration of instances if host already exists, but we need it to prevent\n                    // multiple hosts with same name. Thus we only allow if no instances are on the host\n                    // Note: this is only a heuristic, if problems occur we need a `force` flag\n                    const instances = await enumInstances(objects);\n                    const hasExistingInstances = !!instances.find(instance => instance?.common.host === newHostname);\n\n                    if (hasExistingInstances) {\n                        CLI.error.hostAlreadyExists(newHostname);\n                        return void callback(EXIT_CODES.INSTANCE_ALREADY_EXISTS);\n                    }\n                }\n\n                // Remember the new hostname in the system settings\n                const configFileName = tools.getConfigFileName();\n                const configData = fs.readJSONSync(configFileName);\n                if (configData.system && configData.system.hostname !== newHostname) {\n                    configData.system.hostname = newHostname;\n                    fs.writeFileSync(configFileName, JSON.stringify(configData, null, 2), 'utf8');\n                }\n\n                // Rename the host(s)\n                for (const host of hosts) {\n                    // Remember the current hostname of this object because we need it later\n                    const prevHostname = host.common.hostname;\n\n                    // Rename only the hostname we're supposed to rename!\n                    if (oldHostname && prevHostname !== oldHostname) {\n                        continue;\n                    }\n\n                    // Rename the host object\n                    // Therefore delete the old one because we will recreate it under a new name\n                    try {\n                        await objects.delObjectAsync(host._id);\n                    } catch (err) {\n                        CLI.error.cannotDeleteObject(host._id, err.message);\n                        continue;\n                    }\n\n                    // Now update the object\n                    Object.assign(host, {\n                        _id: `system.host.${newHostname}`,\n                        from: getObjectFrom(),\n                        ts: Date.now(),\n                    });\n                    Object.assign(host.common, {\n                        name: host._id,\n                        hostname: newHostname,\n                        address: [],\n                        cmd: '',\n                        native: { process: {}, os: {}, hardware: {} },\n                    });\n                    // And save it\n                    try {\n                        await objects.setObjectAsync(host._id, host);\n                    } catch (err) {\n                        CLI.error.cannotChangeObject(host._id, err.message);\n                        continue;\n                    }\n\n                    // Rename its states\n                    const hostStateObjects = await enumObjects(objects, 'state', `system.host.${prevHostname}.`);\n                    const hostFolders = await enumObjects(objects, 'folder', `system.host.${prevHostname}.`);\n                    for (const object of [...hostStateObjects, ...hostFolders]) {\n                        // Therefore delete the old one because we will recreate it under a new name\n                        try {\n                            await objects.delObjectAsync(object._id);\n                        } catch (err) {\n                            CLI.error.cannotDeleteObject(object._id, err.message);\n                            continue;\n                        }\n\n                        // Now update the object\n                        Object.assign(object, {\n                            _id: object._id.replace(`system.host.${prevHostname}`, `system.host.${newHostname}`),\n                            from: getObjectFrom(),\n                            ts: Date.now(),\n                        });\n\n                        // And save it\n                        try {\n                            await objects.setObjectAsync(object._id, object);\n                        } catch (err) {\n                            CLI.error.cannotChangeObject(object._id, err.message);\n                        }\n                    }\n\n                    CLI.success.hostRenamed(prevHostname, newHostname);\n                }\n\n                // Also rename all instances\n                const instances = await enumInstances(objects);\n                const instancesToRename =\n                    oldHostname === undefined ? instances : instances.filter(i => i.common.host === oldHostname);\n                if (instancesToRename.length > 0) {\n                    for (const instance of instancesToRename) {\n                        // Update each instance object\n                        await changeInstanceHost(objects, instance, newHostname);\n                    }\n                } else {\n                    CLI.warn.noInstancesFoundOnHost(oldHostname);\n                }\n                return void callback(EXIT_CODES.NO_ERROR);\n            } catch (err) {\n                CLI.error.unknown(err.message);\n                return void callback(1);\n            }\n        });\n    }\n}\n\n/**\n * Changes the host an instance is running on\n *\n * @param objects The objects DB to use\n * @param instance The instance object\n * @param newHostname The new hostname the instance should be running on\n */\nasync function changeInstanceHost(\n    objects: ObjectsClient,\n    instance: ioBroker.InstanceObject,\n    newHostname: string,\n): Promise<void> {\n    const oldInstanceHost = instance.common.host;\n    instance.from = getObjectFrom();\n    instance.ts = Date.now();\n    instance.common.host = newHostname;\n    // and save it\n    try {\n        await objects.setObjectAsync(instance._id, instance);\n        CLI.success.instanceHostChanged(instance._id, oldInstanceHost, newHostname);\n    } catch (e) {\n        CLI.error.cannotChangeObject(instance._id, e.message);\n        // resolve anyways, we don't want to cause errors\n    }\n}\n"],
+  "mappings": "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",
   "names": ["os", "instances", "fs"]
 }

package/build/cjs/lib/cli/cliLogs.d.ts

@@ -9,11 +9,14 @@ interface CLILogsOptions {
 export declare class CLILogs extends CLICommand {
     private readonly fileSizes;
     private isReady;
+    /**
+     * @param options The command options including context and parameters
+     */
     constructor(options: CLICommandOptions);
     /**
      * Executes a command
      *
-     * @param args
+     * @param args The command arguments (the first is the sub-command)
      * @param params additional parsed CLI parameters
      */
     execute(args: any[], params: Record<string, any>): void;

package/build/cjs/lib/cli/cliLogs.js

@@ -44,13 +44,16 @@ const { getConfigFileName } = import_js_controller_common.tools;
 class CLILogs extends import_cliCommand.CLICommand {
   fileSizes = /* @__PURE__ */ new Map();
   isReady = false;
+  /**
+   * @param options The command options including context and parameters
+   */
   constructor(options) {
     super(options);
   }
   /**
    * Executes a command
    *
-   * @param args
+   * @param args The command arguments (the first is the sub-command)
    * @param params additional parsed CLI parameters
    */
   execute(args, params) {