@iobroker/js-controller-cli 8.0.0-alpha.1-20260921-e5941ca8a → 8.0.0-alpha.12-20261105-0aa407437

package/build/cjs/index.d.ts

@@ -3,7 +3,9 @@ export { dbConnectAsync } from './lib/setup/dbConnection.js';
 export { Vendor } from './lib/setup/setupVendor.js';
 export { Upload } from './lib/setup/setupUpload.js';
 export { Upgrade } from './lib/setup/setupUpgrade.js';
+export { Install } from './lib/setup/setupInstall.js';
 export { BackupRestore } from './lib/setup/setupBackup.js';
 export { PacketManager, type UpgradePacket } from './lib/setup/setupPacketManager.js';
+export { checkAdapterCompatibility, type AdapterCompatibilityInput, type AdapterCompatibilityProblem, } from './lib/setup/adapterCompatibility.js';
 export type * from './lib/_Types.js';
 //# sourceMappingURL=index.d.ts.map

package/build/cjs/index.js

@@ -19,10 +19,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   BackupRestore: () => import_setupBackup.BackupRestore,
+  Install: () => import_setupInstall.Install,
   PacketManager: () => import_setupPacketManager.PacketManager,
   Upgrade: () => import_setupUpgrade.Upgrade,
   Upload: () => import_setupUpload.Upload,
   Vendor: () => import_setupVendor.Vendor,
+  checkAdapterCompatibility: () => import_adapterCompatibility.checkAdapterCompatibility,
   dbConnectAsync: () => import_dbConnection.dbConnectAsync,
   execute: () => import_setup.execute
 });
@@ -32,15 +34,19 @@ var import_dbConnection = require("./lib/setup/dbConnection.js");
 var import_setupVendor = require("./lib/setup/setupVendor.js");
 var import_setupUpload = require("./lib/setup/setupUpload.js");
 var import_setupUpgrade = require("./lib/setup/setupUpgrade.js");
+var import_setupInstall = require("./lib/setup/setupInstall.js");
 var import_setupBackup = require("./lib/setup/setupBackup.js");
 var import_setupPacketManager = require("./lib/setup/setupPacketManager.js");
+var import_adapterCompatibility = require("./lib/setup/adapterCompatibility.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BackupRestore,
+  Install,
   PacketManager,
   Upgrade,
   Upload,
   Vendor,
+  checkAdapterCompatibility,
   dbConnectAsync,
   execute
 });

package/build/cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/index.ts"],
-  "sourcesContent": ["/// <reference types=\"@iobroker/types-dev\" />\nexport { execute } from '@/lib/setup.js';\nexport { dbConnectAsync } from '@/lib/setup/dbConnection.js';\nexport { Vendor } from '@/lib/setup/setupVendor.js';\nexport { Upload } from '@/lib/setup/setupUpload.js';\nexport { Upgrade } from '@/lib/setup/setupUpgrade.js';\nexport { BackupRestore } from '@/lib/setup/setupBackup.js';\nexport { PacketManager, type UpgradePacket } from '@/lib/setup/setupPacketManager.js';\nexport type * from '@/lib/_Types.js';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;AACA,mBAAwB;AACxB,0BAA+B;AAC/B,yBAAuB;AACvB,yBAAuB;AACvB,0BAAwB;AACxB,yBAA8B;AAC9B,gCAAkD;",
+  "sourcesContent": ["/// <reference types=\"@iobroker/types-dev\" />\nexport { execute } from '@/lib/setup.js';\nexport { dbConnectAsync } from '@/lib/setup/dbConnection.js';\nexport { Vendor } from '@/lib/setup/setupVendor.js';\nexport { Upload } from '@/lib/setup/setupUpload.js';\nexport { Upgrade } from '@/lib/setup/setupUpgrade.js';\nexport { Install } from '@/lib/setup/setupInstall.js';\nexport { BackupRestore } from '@/lib/setup/setupBackup.js';\nexport { PacketManager, type UpgradePacket } from '@/lib/setup/setupPacketManager.js';\nexport {\n    checkAdapterCompatibility,\n    type AdapterCompatibilityInput,\n    type AdapterCompatibilityProblem,\n} from '@/lib/setup/adapterCompatibility.js';\nexport type * from '@/lib/_Types.js';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;AACA,mBAAwB;AACxB,0BAA+B;AAC/B,yBAAuB;AACvB,yBAAuB;AACvB,0BAAwB;AACxB,0BAAwB;AACxB,yBAA8B;AAC9B,gCAAkD;AAClD,kCAIO;",
   "names": []
 }

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

@@ -4,6 +4,8 @@ interface CLILogsOptions {
     complete?: boolean;
     /** An optional RegExp to filter by */
     regex?: RegExp;
+    /** The lowest level to still show, if the output is restricted to a severity */
+    minLevel?: ioBroker.LogLevel;
 }
 /** Command ioBroker state ... */
 export declare class CLILogs extends CLICommand {
@@ -46,6 +48,24 @@ export declare class CLILogs extends CLICommand {
      * @param options some options
      */
     streamChange(path: string, start: number, options: CLILogsOptions): void;
+    /**
+     * Create the check of log lines against the active filters, for one read of a file
+     *
+     * A log entry can span several lines, e.g. a stack trace, and only its first line carries the
+     * level. Those follow-up lines inherit the decision made for the entry they belong to, so
+     * filtering by level does not cut a stack trace in half. Which lines start an entry is decided
+     * by the shared parser, the same one the host commands `getLogs` and `searchLogs` use: it takes
+     * a level only where the time stamp of an entry is, so a level quoted inside a message does not
+     * count as one.
+     *
+     * The decision belongs to one read and starts as "not shown". A read can begin with follow-up
+     * lines - the last lines of a file, or a stream from an offset - whose entry it does not know,
+     * and showing them would ignore the level. Files that are streamed at the same time do not
+     * share it either.
+     *
+     * @param options the active filters
+     */
+    private createFilter;
 }
 export {};
 //# sourceMappingURL=cliLogs.d.ts.map

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

@@ -67,6 +67,14 @@ class CLILogs extends import_cliCommand.CLICommand {
     const options = {
       complete: this.options.all
     };
+    if (params.level !== void 0) {
+      const level = String(params.level).toLowerCase();
+      if (!import_js_controller_common.tools.isLogLevel(level)) {
+        console.error(`Unknown log level "${params.level}". Use one of: ${import_js_controller_common.LOG_LEVELS.join(", ")}`);
+        return void this.options.callback(import_js_controller_common.EXIT_CODES.INVALID_ARGUMENTS);
+      }
+      options.minLevel = level;
+    }
     const config = import_fs_extra.default.readJSONSync(require2.resolve(getConfigFileName()));
     const logger = (0, import_js_controller_common.logger)(config.log);
     let fileName = logger.getFileName();
@@ -81,8 +89,9 @@ class CLILogs extends import_cliCommand.CLICommand {
         regex = new RegExp(`: ${adapterName}\\.`);
         options.regex = regex;
       }
+      const matches = this.createFilter(options);
       lines.forEach((line) => {
-        if (regex && !regex.test(line)) {
+        if (!matches(line)) {
           return;
         }
         console.log(line);
@@ -150,12 +159,44 @@ class CLILogs extends import_cliCommand.CLICommand {
       start,
       autoClose: true
     });
-    if (options.regex) {
-      input.pipe(import_event_stream.default.split()).pipe(import_event_stream.default.filterSync((line) => options.regex.test(line))).pipe(import_event_stream.default.mapSync((line) => line + import_node_os.default.EOL)).pipe(process.stdout);
+    if (options.regex || options.minLevel) {
+      input.pipe(import_event_stream.default.split()).pipe(import_event_stream.default.filterSync(this.createFilter(options))).pipe(import_event_stream.default.mapSync((line) => line + import_node_os.default.EOL)).pipe(process.stdout);
     } else {
       import_js_controller_common.tools.pipeLinewise(input, process.stdout);
     }
   }
+  /**
+   * Create the check of log lines against the active filters, for one read of a file
+   *
+   * A log entry can span several lines, e.g. a stack trace, and only its first line carries the
+   * level. Those follow-up lines inherit the decision made for the entry they belong to, so
+   * filtering by level does not cut a stack trace in half. Which lines start an entry is decided
+   * by the shared parser, the same one the host commands `getLogs` and `searchLogs` use: it takes
+   * a level only where the time stamp of an entry is, so a level quoted inside a message does not
+   * count as one.
+   *
+   * The decision belongs to one read and starts as "not shown". A read can begin with follow-up
+   * lines - the last lines of a file, or a stream from an offset - whose entry it does not know,
+   * and showing them would ignore the level. Files that are streamed at the same time do not
+   * share it either.
+   *
+   * @param options the active filters
+   */
+  createFilter(options) {
+    let showEntry = false;
+    return (line) => {
+      if (options.minLevel) {
+        const header = (0, import_js_controller_common.parseLogEntryHeader)(line);
+        if (header) {
+          showEntry = (0, import_js_controller_common.isLogLevelAtLeast)(header.level, options.minLevel);
+        }
+        if (!showEntry) {
+          return false;
+        }
+      }
+      return !options.regex || options.regex.test(line);
+    };
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/cli/cliLogs.ts", "../../../../../../node_modules/@alcalzone/esm2cjs/shims/import.meta.url/shim.js"],
-  "sourcesContent": ["import { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport { tools, logger as toolsLogger } from '@iobroker/js-controller-common';\nimport chokidar from 'chokidar';\nimport fs from 'fs-extra';\nimport os from 'node:os';\nimport es from 'event-stream';\nimport { createRequire } from 'node:module';\n// eslint-disable-next-line unicorn/prefer-module\nconst require = createRequire(import.meta.url || `file://${__filename}`);\n\nconst { getConfigFileName } = tools;\n\ninterface CLILogsOptions {\n    /** Whether to show today's full log */\n    complete?: boolean;\n    /** An optional RegExp to filter by */\n    regex?: RegExp;\n}\n\n/** Command ioBroker state ... */\nexport class CLILogs extends CLICommand {\n    private readonly fileSizes = new Map<string, number>();\n    private isReady = false;\n\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     * @param params additional parsed CLI parameters\n     */\n    execute(args: string[], params: Record<string, any>): void {\n        const adapterName = args[0];\n        const watch = params.watch || params.w;\n        const count = params.lines || 1_000;\n\n        const options: CLILogsOptions = {\n            complete: this.options.all,\n        };\n\n        const config = fs.readJSONSync(require.resolve(getConfigFileName()));\n        const logger = toolsLogger(config.log);\n        // @ts-expect-error todo adjust logger type\n        let fileName = logger.getFileName();\n        if (fileName) {\n            let lines = fs.readFileSync(fileName).toString('utf-8').split('\\n');\n            lines = lines.filter(line => line);\n            if (lines.length > count) {\n                lines.splice(0, lines.length - count);\n            }\n            let regex: RegExp;\n            if (adapterName) {\n                //2019-03-02 13:26:54.698  - debug: iot.0 [ALEXA] Created ALEXA device: Bad.Hauptlicht.Aktor.STATE [\"turnOn\",\"turnOff\"]\n                regex = new RegExp(`: ${adapterName}\\\\.`);\n                options.regex = regex;\n            }\n            lines.forEach(line => {\n                if (regex && !regex.test(line)) {\n                    return;\n                }\n                console.log(line);\n            });\n\n            if (watch) {\n                fileName = fileName.replace(/\\\\/g, '/');\n                const parts = fileName.split('/');\n                parts.pop();\n                chokidar\n                    .watch(`${parts.join('/')}/iobroker*`, {\n                        awaitWriteFinish: { stabilityThreshold: 500 },\n                        followSymlinks: false,\n                    })\n                    .on('all', this.watchHandler.bind(this, options))\n                    .on('ready', () => (this.isReady = true));\n            }\n        } else {\n            console.log('No log file found');\n        }\n    }\n\n    /**\n     * Called by chokidar when watched files change\n     *\n     * @param options some options\n     * @param event The type of change\n     * @param path Which path has changed\n     * @param stats Information about the file\n     * @param stats.size The current size of the file in bytes\n     */\n    watchHandler(\n        options: CLILogsOptions,\n        event: string,\n        path: string,\n        stats?: {\n            size: number;\n        },\n    ): void {\n        if (!stats) {\n            return;\n        }\n        if (event === 'add' || !this.fileSizes.has(path)) {\n            this.fileSizes.set(path, stats.size);\n            if (stats.size > 0 && (this.isReady || (options.complete && this.isTodaysLogfile(path)))) {\n                this.streamChange(path, 0, options);\n            }\n        } else if (event === 'change') {\n            const oldFileSize = this.fileSizes.get(path)!;\n            this.fileSizes.set(path, stats.size);\n            if (this.isReady && stats.size > oldFileSize) {\n                this.streamChange(path, oldFileSize, options);\n            }\n        } else if (event === 'unlink') {\n            this.fileSizes.delete(path);\n        }\n    }\n\n    /**\n     * If the log file belongs to today\n     *\n     * @param path The log file path\n     */\n    isTodaysLogfile(path: string): boolean {\n        const YYYYMMDDDate = new Date().toJSON().slice(0, 10);\n        return path.includes(YYYYMMDDDate);\n    }\n\n    /**\n     * Streams a portion of a file to the console\n     *\n     * @param path The file to stream\n     * @param start The offset in bytes where to start\n     * @param options some options\n     */\n    streamChange(path: string, start: number, options: CLILogsOptions): void {\n        const input = fs.createReadStream(path, {\n            encoding: 'utf8',\n            start,\n            autoClose: true,\n        });\n        if (options.regex) {\n            // Read the input line by line and only include the lines matching the filter\n            input\n                .pipe(es.split())\n                .pipe(es.filterSync(line => options.regex!.test(line)))\n                .pipe(es.mapSync((line: string) => line + os.EOL))\n                .pipe(process.stdout);\n        } else {\n            // just pipe the input through\n            tools.pipeLinewise(input, process.stdout);\n        }\n    }\n}\n", "export const __import_meta_url =\n  typeof document === 'undefined' ? new (require('url'.replace('', '')).URL)('file:' + __filename).href :\n    (document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href)\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { CLICommand, type CLICommandOptions } from './cliCommand.js';\nimport {\n    tools,\n    logger as toolsLogger,\n    EXIT_CODES,\n    LOG_LEVELS,\n    isLogLevelAtLeast,\n    parseLogEntryHeader,\n} from '@iobroker/js-controller-common';\nimport chokidar from 'chokidar';\nimport fs from 'fs-extra';\nimport os from 'node:os';\nimport es from 'event-stream';\nimport { createRequire } from 'node:module';\n// eslint-disable-next-line unicorn/prefer-module\nconst require = createRequire(import.meta.url || `file://${__filename}`);\n\nconst { getConfigFileName } = tools;\n\ninterface CLILogsOptions {\n    /** Whether to show today's full log */\n    complete?: boolean;\n    /** An optional RegExp to filter by */\n    regex?: RegExp;\n    /** The lowest level to still show, if the output is restricted to a severity */\n    minLevel?: ioBroker.LogLevel;\n}\n\n/** Command ioBroker state ... */\nexport class CLILogs extends CLICommand {\n    private readonly fileSizes = new Map<string, number>();\n    private isReady = false;\n\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     * @param params additional parsed CLI parameters\n     */\n    execute(args: string[], params: Record<string, any>): void {\n        const adapterName = args[0];\n        const watch = params.watch || params.w;\n        const count = params.lines || 1_000;\n\n        const options: CLILogsOptions = {\n            complete: this.options.all,\n        };\n\n        // Optional, so calls without a level keep showing everything as before\n        if (params.level !== undefined) {\n            const level = String(params.level).toLowerCase();\n\n            if (!tools.isLogLevel(level)) {\n                console.error(`Unknown log level \"${params.level}\". Use one of: ${LOG_LEVELS.join(', ')}`);\n                return void this.options.callback(EXIT_CODES.INVALID_ARGUMENTS);\n            }\n\n            options.minLevel = level;\n        }\n\n        const config = fs.readJSONSync(require.resolve(getConfigFileName()));\n        const logger = toolsLogger(config.log);\n        // @ts-expect-error todo adjust logger type\n        let fileName = logger.getFileName();\n        if (fileName) {\n            let lines = fs.readFileSync(fileName).toString('utf-8').split('\\n');\n            lines = lines.filter(line => line);\n            if (lines.length > count) {\n                lines.splice(0, lines.length - count);\n            }\n            let regex: RegExp;\n            if (adapterName) {\n                //2019-03-02 13:26:54.698  - debug: iot.0 [ALEXA] Created ALEXA device: Bad.Hauptlicht.Aktor.STATE [\"turnOn\",\"turnOff\"]\n                regex = new RegExp(`: ${adapterName}\\\\.`);\n                options.regex = regex;\n            }\n            const matches = this.createFilter(options);\n            lines.forEach(line => {\n                if (!matches(line)) {\n                    return;\n                }\n                console.log(line);\n            });\n\n            if (watch) {\n                fileName = fileName.replace(/\\\\/g, '/');\n                const parts = fileName.split('/');\n                parts.pop();\n                chokidar\n                    .watch(`${parts.join('/')}/iobroker*`, {\n                        awaitWriteFinish: { stabilityThreshold: 500 },\n                        followSymlinks: false,\n                    })\n                    .on('all', this.watchHandler.bind(this, options))\n                    .on('ready', () => (this.isReady = true));\n            }\n        } else {\n            console.log('No log file found');\n        }\n    }\n\n    /**\n     * Called by chokidar when watched files change\n     *\n     * @param options some options\n     * @param event The type of change\n     * @param path Which path has changed\n     * @param stats Information about the file\n     * @param stats.size The current size of the file in bytes\n     */\n    watchHandler(\n        options: CLILogsOptions,\n        event: string,\n        path: string,\n        stats?: {\n            size: number;\n        },\n    ): void {\n        if (!stats) {\n            return;\n        }\n        if (event === 'add' || !this.fileSizes.has(path)) {\n            this.fileSizes.set(path, stats.size);\n            if (stats.size > 0 && (this.isReady || (options.complete && this.isTodaysLogfile(path)))) {\n                this.streamChange(path, 0, options);\n            }\n        } else if (event === 'change') {\n            const oldFileSize = this.fileSizes.get(path)!;\n            this.fileSizes.set(path, stats.size);\n            if (this.isReady && stats.size > oldFileSize) {\n                this.streamChange(path, oldFileSize, options);\n            }\n        } else if (event === 'unlink') {\n            this.fileSizes.delete(path);\n        }\n    }\n\n    /**\n     * If the log file belongs to today\n     *\n     * @param path The log file path\n     */\n    isTodaysLogfile(path: string): boolean {\n        const YYYYMMDDDate = new Date().toJSON().slice(0, 10);\n        return path.includes(YYYYMMDDDate);\n    }\n\n    /**\n     * Streams a portion of a file to the console\n     *\n     * @param path The file to stream\n     * @param start The offset in bytes where to start\n     * @param options some options\n     */\n    streamChange(path: string, start: number, options: CLILogsOptions): void {\n        const input = fs.createReadStream(path, {\n            encoding: 'utf8',\n            start,\n            autoClose: true,\n        });\n        if (options.regex || options.minLevel) {\n            // Read the input line by line and only include the lines matching the filter\n            input\n                .pipe(es.split())\n                .pipe(es.filterSync(this.createFilter(options)))\n                .pipe(es.mapSync((line: string) => line + os.EOL))\n                .pipe(process.stdout);\n        } else {\n            // just pipe the input through\n            tools.pipeLinewise(input, process.stdout);\n        }\n    }\n\n    /**\n     * Create the check of log lines against the active filters, for one read of a file\n     *\n     * A log entry can span several lines, e.g. a stack trace, and only its first line carries the\n     * level. Those follow-up lines inherit the decision made for the entry they belong to, so\n     * filtering by level does not cut a stack trace in half. Which lines start an entry is decided\n     * by the shared parser, the same one the host commands `getLogs` and `searchLogs` use: it takes\n     * a level only where the time stamp of an entry is, so a level quoted inside a message does not\n     * count as one.\n     *\n     * The decision belongs to one read and starts as \"not shown\". A read can begin with follow-up\n     * lines - the last lines of a file, or a stream from an offset - whose entry it does not know,\n     * and showing them would ignore the level. Files that are streamed at the same time do not\n     * share it either.\n     *\n     * @param options the active filters\n     */\n    private createFilter(options: CLILogsOptions): (line: string) => boolean {\n        let showEntry = false;\n\n        return line => {\n            if (options.minLevel) {\n                const header = parseLogEntryHeader(line);\n\n                if (header) {\n                    showEntry = isLogLevelAtLeast(header.level, options.minLevel);\n                }\n\n                if (!showEntry) {\n                    return false;\n                }\n            }\n\n            return !options.regex || options.regex.test(line);\n        };\n    }\n}\n", "export const __import_meta_url =\n  typeof document === 'undefined' ? new (require('url'.replace('', '')).URL)('file:' + __filename).href :\n    (document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href)\n"],
+  "mappings": "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",
   "names": ["require", "fs", "toolsLogger", "chokidar", "es", "os"]
 }

package/build/cjs/lib/setup/adapterCompatibility.d.ts

@@ -0,0 +1,39 @@
+import { EXIT_CODES } from '@iobroker/js-controller-common-db';
+/** What is known about an adapter that is about to be installed */
+export interface AdapterCompatibilityInput {
+    /** Content of its `io-package.json` */
+    ioPackage: {
+        common?: Partial<Pick<ioBroker.AdapterCommon, 'os' | 'nogit'>>;
+    } | null | undefined;
+    /** Content of its `package.json`, if known */
+    packageJson?: {
+        engines?: {
+            node?: string;
+        };
+    } | null;
+    /** Whether it is installed directly from GitHub (`iobroker url <github-url>`) */
+    fromGitHub?: boolean;
+    /** Operating system to check against, default `process.platform` */
+    platform?: string;
+    /** Node.js version to check against, default `process.version` */
+    nodeVersion?: string;
+}
+/** Why an adapter cannot be installed */
+export interface AdapterCompatibilityProblem {
+    /** Exit code of the CLI */
+    exitCode: EXIT_CODES;
+    /** Message for the user */
+    message: string;
+}
+/**
+ * Check whether an adapter can be installed on this system: from GitHub only without `common.nogit`, only on a
+ * supported operating system (`common.os`) and only with a supported Node.js version (`engines.node`).
+ *
+ * The same checks run before a GitHub installation (with the files from GitHub) and before an adapter is set up
+ * (with the installed files).
+ *
+ * @param input the adapter files and the system to check against
+ * @returns the first problem found, or `null` if the adapter can be installed
+ */
+export declare function checkAdapterCompatibility(input: AdapterCompatibilityInput): AdapterCompatibilityProblem | null;
+//# sourceMappingURL=adapterCompatibility.d.ts.map

package/build/cjs/lib/setup/adapterCompatibility.js

@@ -0,0 +1,74 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var adapterCompatibility_exports = {};
+__export(adapterCompatibility_exports, {
+  checkAdapterCompatibility: () => checkAdapterCompatibility
+});
+module.exports = __toCommonJS(adapterCompatibility_exports);
+var import_semver = __toESM(require("semver"), 1);
+var import_js_controller_common_db = require("@iobroker/js-controller-common-db");
+function checkAdapterCompatibility(input) {
+  const common = input.ioPackage?.common;
+  const platform = input.platform ?? process.platform;
+  const nodeVersion = (input.nodeVersion ?? process.version).replace(/^v/, "");
+  if (input.fromGitHub && common?.nogit === true) {
+    return {
+      exitCode: import_js_controller_common_db.EXIT_CODES.CANNOT_INSTALL_NPM_PACKET,
+      message: 'Adapter cannot be installed from GitHub ("nogit" is set in io-package.json). Install it from the repository or from npm instead'
+    };
+  }
+  const os = common?.os;
+  if (typeof os === "string" && os !== platform) {
+    return {
+      exitCode: import_js_controller_common_db.EXIT_CODES.INVALID_OS,
+      message: `Adapter does not support current os. Required ${os}. Actual platform: ${platform}`
+    };
+  }
+  if (Array.isArray(os) && !os.includes(platform)) {
+    return {
+      exitCode: import_js_controller_common_db.EXIT_CODES.INVALID_OS,
+      message: `Adapter does not support current os. Required one of ${os.join(", ")}. Actual platform: ${platform}`
+    };
+  }
+  const engine = input.packageJson?.engines?.node;
+  if (engine && !import_semver.default.satisfies(nodeVersion, engine)) {
+    return {
+      exitCode: import_js_controller_common_db.EXIT_CODES.INVALID_NODE_VERSION,
+      message: `Adapter does not support current nodejs version. Required ${engine}. Actual version: v${nodeVersion}`
+    };
+  }
+  return null;
+}
+__name(checkAdapterCompatibility, "checkAdapterCompatibility");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  checkAdapterCompatibility
+});
+//# sourceMappingURL=adapterCompatibility.js.map

package/build/cjs/lib/setup/adapterCompatibility.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/lib/setup/adapterCompatibility.ts"],
+  "sourcesContent": ["import semver from 'semver';\nimport { EXIT_CODES } from '@iobroker/js-controller-common-db';\n\n/** What is known about an adapter that is about to be installed */\nexport interface AdapterCompatibilityInput {\n    /** Content of its `io-package.json` */\n    ioPackage: { common?: Partial<Pick<ioBroker.AdapterCommon, 'os' | 'nogit'>> } | null | undefined;\n    /** Content of its `package.json`, if known */\n    packageJson?: { engines?: { node?: string } } | null;\n    /** Whether it is installed directly from GitHub (`iobroker url <github-url>`) */\n    fromGitHub?: boolean;\n    /** Operating system to check against, default `process.platform` */\n    platform?: string;\n    /** Node.js version to check against, default `process.version` */\n    nodeVersion?: string;\n}\n\n/** Why an adapter cannot be installed */\nexport interface AdapterCompatibilityProblem {\n    /** Exit code of the CLI */\n    exitCode: EXIT_CODES;\n    /** Message for the user */\n    message: string;\n}\n\n/**\n * Check whether an adapter can be installed on this system: from GitHub only without `common.nogit`, only on a\n * supported operating system (`common.os`) and only with a supported Node.js version (`engines.node`).\n *\n * The same checks run before a GitHub installation (with the files from GitHub) and before an adapter is set up\n * (with the installed files).\n *\n * @param input the adapter files and the system to check against\n * @returns the first problem found, or `null` if the adapter can be installed\n */\nexport function checkAdapterCompatibility(input: AdapterCompatibilityInput): AdapterCompatibilityProblem | null {\n    const common = input.ioPackage?.common;\n    const platform = input.platform ?? process.platform;\n    const nodeVersion = (input.nodeVersion ?? process.version).replace(/^v/, '');\n\n    if (input.fromGitHub && common?.nogit === true) {\n        return {\n            exitCode: EXIT_CODES.CANNOT_INSTALL_NPM_PACKET,\n            message:\n                'Adapter cannot be installed from GitHub (\"nogit\" is set in io-package.json). Install it from the repository or from npm instead',\n        };\n    }\n\n    const os = common?.os;\n    if (typeof os === 'string' && os !== platform) {\n        return {\n            exitCode: EXIT_CODES.INVALID_OS,\n            message: `Adapter does not support current os. Required ${os}. Actual platform: ${platform}`,\n        };\n    }\n    if (Array.isArray(os) && !(os as string[]).includes(platform)) {\n        return {\n            exitCode: EXIT_CODES.INVALID_OS,\n            message: `Adapter does not support current os. Required one of ${os.join(', ')}. Actual platform: ${platform}`,\n        };\n    }\n\n    const engine = input.packageJson?.engines?.node;\n    if (engine && !semver.satisfies(nodeVersion, engine)) {\n        return {\n            exitCode: EXIT_CODES.INVALID_NODE_VERSION,\n            message: `Adapter does not support current nodejs version. Required ${engine}. Actual version: v${nodeVersion}`,\n        };\n    }\n\n    return null;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;AAAA,oBAAmB;AACnB,qCAA2B;AAkCrB,SAAU,0BAA0B,OAAgC;AACtE,QAAM,SAAS,MAAM,WAAW;AAChC,QAAM,WAAW,MAAM,YAAY,QAAQ;AAC3C,QAAM,eAAe,MAAM,eAAe,QAAQ,SAAS,QAAQ,MAAM,EAAE;AAE3E,MAAI,MAAM,cAAc,QAAQ,UAAU,MAAM;AAC5C,WAAO;MACH,UAAU,0CAAW;MACrB,SACI;;EAEZ;AAEA,QAAM,KAAK,QAAQ;AACnB,MAAI,OAAO,OAAO,YAAY,OAAO,UAAU;AAC3C,WAAO;MACH,UAAU,0CAAW;MACrB,SAAS,iDAAiD,EAAE,sBAAsB,QAAQ;;EAElG;AACA,MAAI,MAAM,QAAQ,EAAE,KAAK,CAAE,GAAgB,SAAS,QAAQ,GAAG;AAC3D,WAAO;MACH,UAAU,0CAAW;MACrB,SAAS,wDAAwD,GAAG,KAAK,IAAI,CAAC,sBAAsB,QAAQ;;EAEpH;AAEA,QAAM,SAAS,MAAM,aAAa,SAAS;AAC3C,MAAI,UAAU,CAAC,cAAAA,QAAO,UAAU,aAAa,MAAM,GAAG;AAClD,WAAO;MACH,UAAU,0CAAW;MACrB,SAAS,6DAA6D,MAAM,sBAAsB,WAAW;;EAErH;AAEA,SAAO;AACX;AApCgB;",
+  "names": ["semver"]
+}

package/build/cjs/lib/setup/setupInstall.d.ts

@@ -204,6 +204,21 @@ export declare class Install {
      * @param adapter adapter name
      */
     deleteAdapter(adapter: string): Promise<EXIT_CODES>;
+    /**
+     * Remove the virtual environment a Python adapter leaves behind in the data directory
+     *
+     * Host-local state like `node_modules` - rebuildable, but easily a few hundred megabytes - so it goes when
+     * the adapter goes. Deliberately not part of the npm uninstall: that one starts by resolving the adapter's
+     * `io-package.json`, so for a half-removed installation, where the package directory is already gone, it
+     * throws before ever getting here - and that is precisely the case which leaves the environment behind with
+     * nothing pointing at it.
+     *
+     * Removed without looking at `common.platform` for the same reason: the directory only exists for Python
+     * adapters, and the `io-package.json` that would say so may no longer be there.
+     *
+     * @param adapter adapter name, e.g. "pyexample"
+     */
+    private _removePythonEnvironment;
     /**
      * Deletes given instance of an adapter
      *
@@ -211,6 +226,21 @@ export declare class Install {
      * @param instance e.g. 1, if undefined deletes all instances
      */
     deleteInstance(adapter: string, instance?: number): Promise<void | EXIT_CODES.CANNOT_DELETE_DEPENDENCY>;
+    /**
+     * Free all exclusive resources (serial ports, TCP/UDP ports, ...) the given instance(s) had registered.
+     *
+     * This is needed because an instance can be deleted via the CLI while a js-controller is not running: it
+     * cannot notice that the instance object disappeared, so its `system.host.<host>.usedResources.<type>`
+     * states would keep listing the resources of an instance that no longer exists.
+     *
+     * Hosts that are running are deliberately skipped. Such a host cleans its own registry up when it sees the
+     * instance object being deleted, and it holds the registry in memory: it rewrites the state from that copy
+     * on its next change, which would silently undo a write made here.
+     *
+     * @param adapter adapter name, e.g. "mqtt"
+     * @param instance instance number; if undefined, all instances of the adapter are freed
+     */
+    private _freeUsedResources;
     /**
      * Remove all node modules that has been installed by this instance
      *
@@ -224,6 +254,29 @@ export declare class Install {
      * @param ids - id of the adapter/instance to check for
      */
     private _removeCustomFromObjects;
+    /**
+     * Read a JSON file of a GitHub repository at the given commit
+     *
+     * @param user GitHub user or organization
+     * @param repo repository name
+     * @param commit commit hash, branch or tag
+     * @param fileName file in the root of the repository
+     * @returns the parsed file, or `null` if it cannot be read
+     */
+    private _readGitHubJson;
+    /**
+     * Check an adapter on GitHub before it is installed from there: `common.nogit`, the operating system and the
+     * Node.js version, from its `io-package.json` and `package.json` at the commit to be installed
+     *
+     * Without these checks the adapter would be installed first and fail later, e.g. because files that only the
+     * npm package contains are missing.
+     *
+     * @param user GitHub user or organization
+     * @param repo repository name
+     * @param commit commit hash, branch or tag; without it the default branch, which npm installs then as well
+     * @returns the problem that prevents the installation, or `null`
+     */
+    private _checkGitHubAdapter;
     /**
      * Installs an adapter from given url
      *