@iobroker/testing 2.5.2 → 2.5.5

package/CHANGELOG.md

@@ -4,6 +4,15 @@
 	PLACEHOLDER for next version:
 	## __WORK IN PROGRESS__
 -->
+## 2.5.5 (2022-03-04)
+* Allow immediate exit with code `0` for schedule adapters
+* Check that `npm` is not listed as a local dependency in `package.json`
+* Updated dependencies
+
+## 2.5.4 (2022-02-02)
+* Modifying ioBroker databases now uses the same methods that JS-Controller uses internally. This ensures that the testing is compatible with the `jsonl` database format.
+* Testing adapters with adapter dependencies that try to access the databases during installation now works.
+
 ## 2.5.2 (2021-09-18)
 * Fix: `adminUI.config` is now respected for the config UI check and JSON config is allowed too
 * Updated dependencies
@@ -44,4 +53,4 @@
 ## v2.0.2
 * **Unit tests:** added mocks for `getAbsoluteDefaultDataDir` and `getAbsoluteInstanceDataDir`
 
-Sorry, there isn't more yet.
+Sorry, there isn't more yet.

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 AlCalzone <d.griesel@gmx.net>
+Copyright (c) 2022 AlCalzone <d.griesel@gmx.net>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/build/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/build/lib/adapterTools.d.ts

@@ -9,16 +9,7 @@ export declare function loadNpmPackage(adapterDir: string): Record<string, any>;
  * @param adapterDir The directory the adapter resides in
  */
 export declare function loadIoPackage(adapterDir: string): Record<string, any>;
-/**
- * Checks if an adapter claims that it supports compact mode
- * @param ioPackage The contents of io-package.json in object format
- */
-export declare function adapterShouldSupportCompactMode(ioPackage: Record<string, any>): boolean;
-/**
- * Checks if an adapter claims that it supports compact mode
- * @param adapterDir The directory the adapter resides in
- */
-export declare function adapterShouldSupportCompactMode(adapterDir: string): boolean;
+export declare function getAdapterExecutionMode(adapterDir: string): ioBroker.AdapterCommon["mode"];
 /**
  * Locates an adapter's main file
  * @param adapterDir The directory the adapter resides in

package/build/lib/adapterTools.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -22,7 +26,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAdapterDependencies = exports.getAdapterFullName = exports.getAdapterName = exports.getAppName = exports.loadInstanceObjects = exports.loadAdapterCommon = exports.loadAdapterConfig = exports.locateAdapterMainFile = exports.adapterShouldSupportCompactMode = exports.loadIoPackage = exports.loadNpmPackage = void 0;
+exports.getAdapterDependencies = exports.getAdapterFullName = exports.getAdapterName = exports.getAppName = exports.loadInstanceObjects = exports.loadAdapterCommon = exports.loadAdapterConfig = exports.locateAdapterMainFile = exports.getAdapterExecutionMode = exports.loadIoPackage = exports.loadNpmPackage = void 0;
 // Add debug logging for tests
 const typeguards_1 = require("alcalzone-shared/typeguards");
 const debug_1 = __importDefault(require("debug"));
@@ -45,12 +49,11 @@ function loadIoPackage(adapterDir) {
     return require(path.join(adapterDir, "io-package.json"));
 }
 exports.loadIoPackage = loadIoPackage;
-function adapterShouldSupportCompactMode(dirOrIoPack) {
-    if (typeof dirOrIoPack === "string")
-        dirOrIoPack = loadIoPackage(dirOrIoPack);
-    return dirOrIoPack.common.compact === true;
+function getAdapterExecutionMode(adapterDir) {
+    const ioPackage = loadIoPackage(adapterDir);
+    return ioPackage.common.mode;
 }
-exports.adapterShouldSupportCompactMode = adapterShouldSupportCompactMode;
+exports.getAdapterExecutionMode = getAdapterExecutionMode;
 /**
  * Locates an adapter's main file
  * @param adapterDir The directory the adapter resides in

package/build/tests/index.js

@@ -8,6 +8,7 @@ const createMocks_1 = require("./unit/harness/createMocks");
 const mockDatabase_1 = require("./unit/mocks/mockDatabase");
 var harness_1 = require("./integration/lib/harness");
 Object.defineProperty(exports, "IntegrationTestHarness", { enumerable: true, get: function () { return harness_1.TestHarness; } });
+var mockAdapter_1 = require("./unit/mocks/mockAdapter");
 var mockDatabase_2 = require("./unit/mocks/mockDatabase");
 Object.defineProperty(exports, "MockDatabase", { enumerable: true, get: function () { return mockDatabase_2.MockDatabase; } });
 /** Predefined test sets */

package/build/tests/integration/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -24,7 +28,6 @@ const async_1 = require("alcalzone-shared/async");
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const adapterTools_1 = require("../../lib/adapterTools");
-const executeCommand_1 = require("../../lib/executeCommand");
 const adapterSetup_1 = require("./lib/adapterSetup");
 const controllerSetup_1 = require("./lib/controllerSetup");
 const dbConnection_1 = require("./lib/dbConnection");
@@ -33,9 +36,10 @@ function testAdapter(adapterDir, options = {}) {
     const appName = (0, adapterTools_1.getAppName)(adapterDir);
     const adapterName = (0, adapterTools_1.getAdapterName)(adapterDir);
     const testDir = path.join(os.tmpdir(), `test-${appName}.${adapterName}`);
+    /** This db connection is only used for the lifetime of a test and then re-created */
+    let dbConnection;
     let harness;
-    const dbConnection = new dbConnection_1.DBConnection(appName, testDir);
-    const controllerSetup = new controllerSetup_1.ControllerSetup(adapterDir, testDir, dbConnection);
+    const controllerSetup = new controllerSetup_1.ControllerSetup(adapterDir, testDir);
     console.log();
     console.log(`Running tests in ${testDir}`);
     console.log();
@@ -49,46 +53,44 @@ function testAdapter(adapterDir, options = {}) {
             if (await controllerSetup.isJsControllerRunning()) {
                 throw new Error("JS-Controller is already running! Stop it for the first test run and try again!");
             }
-            const adapterSetup = new adapterSetup_1.AdapterSetup(adapterDir, testDir, dbConnection);
+            const adapterSetup = new adapterSetup_1.AdapterSetup(adapterDir, testDir);
+            // Installation happens in two steps:
+            // First we need to set up JS Controller, so the databases etc. can be created
             // First we need to copy all files and execute an npm install
             await controllerSetup.prepareTestDir();
-            await adapterSetup.copyAdapterFilesToTestDir();
-            // Remember if JS-Controller is installed already. If so, we need to call setup first later
-            const wasJsControllerInstalled = await controllerSetup.isJsControllerInstalled();
-            // Call npm install
-            await (0, executeCommand_1.executeCommand)("npm", ["i", "--production"], {
-                cwd: testDir,
-            });
-            // Prepare/clean the databases and config
-            if (wasJsControllerInstalled)
-                await controllerSetup.setupJsController();
-            await controllerSetup.setupSystemConfig();
-            await controllerSetup.disableAdminInstances();
-            await adapterSetup.deleteOldInstances();
+            // Only then we can install the adapter, because some (including VIS) try to access
+            // the databases if JS Controller is installed
+            await adapterSetup.installAdapterInTestDir();
+            const dbConnection = new dbConnection_1.DBConnection(appName, testDir);
+            await dbConnection.start();
+            controllerSetup.setupSystemConfig(dbConnection);
+            await controllerSetup.disableAdminInstances(dbConnection);
+            await adapterSetup.deleteOldInstances(dbConnection);
             await adapterSetup.addAdapterInstance();
+            await dbConnection.stop();
             // Create a copy of the databases that we can restore later
             ({ objects: objectsBackup, states: statesBackup } =
-                await dbConnection.readDB());
+                await dbConnection.backup());
         });
         beforeEach(async function () {
             this.timeout(30000);
+            dbConnection = new dbConnection_1.DBConnection(appName, testDir);
             // Clean up before every single test
             await Promise.all([
                 controllerSetup.clearDBDir(),
                 controllerSetup.clearLogDir(),
-                dbConnection.writeDB(objectsBackup, statesBackup),
+                dbConnection.restore(objectsBackup, statesBackup),
             ]);
             // Create a new test harness
-            harness = new harness_1.TestHarness(adapterDir, testDir);
+            await dbConnection.start();
+            harness = new harness_1.TestHarness(adapterDir, testDir, dbConnection);
             // Enable the adapter and set its loglevel to debug
-            await harness.changeAdapterConfig(appName, testDir, adapterName, {
+            await harness.changeAdapterConfig(adapterName, {
                 common: {
                     enabled: true,
                     loglevel: "debug",
                 },
             });
-            // Start the controller instance
-            await harness.startController();
             // And enable the sendTo emulation
             await harness.enableSendTo();
         });
@@ -100,7 +102,13 @@ function testAdapter(adapterDir, options = {}) {
             harness.removeAllListeners();
         });
         it("The adapter starts", function () {
+            var _a;
             this.timeout(60000);
+            const allowedExitCodes = new Set((_a = options.allowedExitCodes) !== null && _a !== void 0 ? _a : []);
+            // Schedule adapters are allowed to "immediately" exit with code 0
+            if (harness.getAdapterExecutionMode() === "schedule") {
+                allowedExitCodes.add(0);
+            }
             return new Promise((resolve, reject) => {
                 // Register a handler to check the alive state and exit codes
                 harness
@@ -116,8 +124,7 @@ function testAdapter(adapterDir, options = {}) {
                     }
                 })
                     .on("failed", (code) => {
-                    if (options.allowedExitCodes == undefined ||
-                        options.allowedExitCodes.indexOf(code) === -1) {
+                    if (!allowedExitCodes.has(code)) {
                         reject(new Error(`The adapter startup was interrupted unexpectedly with ${typeof code === "number"
                             ? "code"
                             : "signal"} ${code}`));

package/build/tests/integration/lib/adapterSetup.d.ts

@@ -2,8 +2,7 @@ import type { DBConnection } from "./dbConnection";
 export declare class AdapterSetup {
     private adapterDir;
     private testDir;
-    private dbConnection;
-    constructor(adapterDir: string, testDir: string, dbConnection: DBConnection);
+    constructor(adapterDir: string, testDir: string);
     private testAdapterDir;
     private adapterName;
     private adapterFullName;
@@ -14,10 +13,10 @@ export declare class AdapterSetup {
      */
     isAdapterInstalled(): Promise<boolean>;
     /** Copies all adapter files (except a few) to the test directory */
-    copyAdapterFilesToTestDir(): Promise<void>;
+    installAdapterInTestDir(): Promise<void>;
     /**
      * Adds an instance for an already installed adapter in the test directory
      */
     addAdapterInstance(): Promise<void>;
-    deleteOldInstances(): Promise<void>;
+    deleteOldInstances(dbConnection: DBConnection): Promise<void>;
 }

package/build/tests/integration/lib/adapterSetup.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -23,6 +27,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AdapterSetup = void 0;
+/* eslint-disable @typescript-eslint/no-empty-function */
 // Add debug logging for tests
 const objects_1 = require("alcalzone-shared/objects");
 const debug_1 = __importDefault(require("debug"));
@@ -33,10 +38,9 @@ const executeCommand_1 = require("../../../lib/executeCommand");
 const tools_1 = require("./tools");
 const debug = (0, debug_1.default)("testing:integration:AdapterSetup");
 class AdapterSetup {
-    constructor(adapterDir, testDir, dbConnection) {
+    constructor(adapterDir, testDir) {
         this.adapterDir = adapterDir;
         this.testDir = testDir;
-        this.dbConnection = dbConnection;
         debug("Creating AdapterSetup...");
         this.adapterName = (0, adapterTools_1.getAdapterName)(this.adapterDir);
         this.adapterFullName = (0, adapterTools_1.getAdapterFullName)(this.adapterDir);
@@ -57,7 +61,7 @@ class AdapterSetup {
         return (0, fs_extra_1.pathExists)(this.testAdapterDir);
     }
     /** Copies all adapter files (except a few) to the test directory */
-    async copyAdapterFilesToTestDir() {
+    async installAdapterInTestDir() {
         debug("Copying adapter files to test directory...");
         // We install the adapter almost like it would be installed in the real world
         // Therefore pack it into a tarball and put it in the test dir for installation
@@ -87,6 +91,11 @@ class AdapterSetup {
         debug("Deleting old remains of this adapter");
         if (await (0, fs_extra_1.pathExists)(this.testAdapterDir))
             await (0, fs_extra_1.remove)(this.testAdapterDir);
+        debug("Installing adapter");
+        // Defer to npm to install the controller (if it wasn't already)
+        await (0, executeCommand_1.executeCommand)("npm", ["i", "--production"], {
+            cwd: this.testDir,
+        });
         debug("  => done!");
     }
     /**
@@ -109,9 +118,12 @@ class AdapterSetup {
             throw new Error(`Adding the adapter instance failed!`);
         debug("  => done!");
     }
-    async deleteOldInstances() {
+    async deleteOldInstances(dbConnection) {
         debug("Removing old adapter instances...");
-        const { objects, states } = await this.dbConnection.readDB();
+        const allKeys = new Set([
+            ...(await dbConnection.getObjectIDs()),
+            ...(await dbConnection.getStateIDs()),
+        ]);
         const instanceRegex = new RegExp(`^system\\.adapter\\.${this.adapterName}\\.\\d+`);
         const instanceObjsRegex = new RegExp(`^${this.adapterName}\\.\\d+\.`);
         const belongsToAdapter = (id) => {
@@ -120,19 +132,12 @@ class AdapterSetup {
                 id === this.adapterName ||
                 id === `${this.adapterName}.admin`);
         };
-        if (objects) {
-            for (const id of Object.keys(objects)) {
-                if (belongsToAdapter(id))
-                    delete objects[id];
-            }
+        const idsToDelete = [...allKeys].filter((id) => belongsToAdapter(id));
+        for (const id of idsToDelete) {
+            await dbConnection.delObject(id).catch(() => { });
+            await dbConnection.delState(id).catch(() => { });
         }
-        if (states) {
-            for (const id of Object.keys(states)) {
-                if (belongsToAdapter(id))
-                    delete states[id];
-            }
-        }
-        await this.dbConnection.writeDB(objects, states);
+        debug("  => done!");
     }
 }
 exports.AdapterSetup = AdapterSetup;

package/build/tests/integration/lib/controllerSetup.d.ts

@@ -2,8 +2,7 @@ import type { DBConnection } from "./dbConnection";
 export declare class ControllerSetup {
     private adapterDir;
     private testDir;
-    private dbConnection;
-    constructor(adapterDir: string, testDir: string, dbConnection: DBConnection);
+    constructor(adapterDir: string, testDir: string);
     private appName;
     private adapterName;
     private testAdapterDir;
@@ -22,8 +21,6 @@ export declare class ControllerSetup {
     isJsControllerRunning(): Promise<boolean>;
     /**
      * Sets up an existing JS-Controller instance for testing by executing "iobroker setup first"
-     * @param appName The branded name of "iobroker"
-     * @param testDir The directory the integration tests are executed in
      */
     setupJsController(): Promise<void>;
     /**
@@ -31,7 +28,7 @@ export declare class ControllerSetup {
      * @param appName The branded name of "iobroker"
      * @param testDir The directory the integration tests are executed in
      */
-    setupSystemConfig(): Promise<void>;
+    setupSystemConfig(dbConnection: DBConnection): void;
     /**
      * Clears the log dir for integration tests (and creates it if it doesn't exist)
      * @param appName The branded name of "iobroker"
@@ -48,5 +45,5 @@ export declare class ControllerSetup {
      * Disables all admin instances in the objects DB
      * @param objects The contents of objects.json
      */
-    disableAdminInstances(): Promise<void>;
+    disableAdminInstances(dbConnection: DBConnection): Promise<void>;
 }

package/build/tests/integration/lib/controllerSetup.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
@@ -23,7 +27,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ControllerSetup = void 0;
-/* eslint-disable @typescript-eslint/no-var-requires */
 // Add debug logging for tests
 const debug_1 = __importDefault(require("debug"));
 const fs_extra_1 = require("fs-extra");
@@ -34,10 +37,9 @@ const executeCommand_1 = require("../../../lib/executeCommand");
 const tools_1 = require("./tools");
 const debug = (0, debug_1.default)("testing:integration:ControllerSetup");
 class ControllerSetup {
-    constructor(adapterDir, testDir, dbConnection) {
+    constructor(adapterDir, testDir) {
         this.adapterDir = adapterDir;
         this.testDir = testDir;
-        this.dbConnection = dbConnection;
         debug("Creating ControllerSetup...");
         this.adapterName = (0, adapterTools_1.getAdapterName)(this.adapterDir);
         this.appName = (0, adapterTools_1.getAppName)(this.adapterDir);
@@ -83,6 +85,16 @@ class ControllerSetup {
         if (nodeMajorVersion >= 10) {
             await (0, fs_extra_1.writeFile)(path.join(this.testDir, ".npmrc"), "engine-strict=true", "utf8");
         }
+        // Remember if JS-Controller is installed already. If so, we need to call `setup first` afterwards
+        const wasJsControllerInstalled = await this.isJsControllerInstalled();
+        // Defer to npm to install the controller (if it wasn't already)
+        debug("(Re-)installing JS Controller...");
+        await (0, executeCommand_1.executeCommand)("npm", ["i", "--production"], {
+            cwd: this.testDir,
+        });
+        // Prepare/clean the databases and config
+        if (wasJsControllerInstalled)
+            await this.setupJsController();
         debug("  => done!");
     }
     /**
@@ -152,8 +164,6 @@ class ControllerSetup {
     // }
     /**
      * Sets up an existing JS-Controller instance for testing by executing "iobroker setup first"
-     * @param appName The branded name of "iobroker"
-     * @param testDir The directory the integration tests are executed in
      */
     async setupJsController() {
         debug("Initializing JS-Controller installation...");
@@ -175,13 +185,12 @@ class ControllerSetup {
      * @param appName The branded name of "iobroker"
      * @param testDir The directory the integration tests are executed in
      */
-    async setupSystemConfig() {
-        debug("Moving databases to different ports...");
-        const systemFilename = path.join(this.testDataDir, `${this.appName}.json`);
-        const systemConfig = require(systemFilename);
+    setupSystemConfig(dbConnection) {
+        debug(`Moving databases to different ports...`);
+        const systemConfig = dbConnection.getSystemConfig();
         systemConfig.objects.port = 19001;
         systemConfig.states.port = 19000;
-        await (0, fs_extra_1.writeFile)(systemFilename, JSON.stringify(systemConfig, null, 2));
+        dbConnection.setSystemConfig(systemConfig);
         debug("  => done!");
     }
     /**
@@ -206,18 +215,17 @@ class ControllerSetup {
      * Disables all admin instances in the objects DB
      * @param objects The contents of objects.json
      */
-    async disableAdminInstances() {
+    async disableAdminInstances(dbConnection) {
         debug("Disabling admin instances...");
-        const objects = await this.dbConnection.readObjectsDB();
-        if (objects) {
-            for (const id of Object.keys(objects)) {
-                if (/^system\.adapter\.admin\.\d.+$/.test(id)) {
-                    const obj = objects[id];
-                    if (obj && obj.common)
-                        obj.common.enabled = false;
-                }
+        const instanceObjects = await dbConnection.getObjectViewAsync("system", "instance", {
+            startkey: "system.adapter.admin.",
+            endkey: "system.adapter.admin.\u9999",
+        });
+        for (const { id, value: obj } of instanceObjects.rows) {
+            if (obj && obj.common) {
+                obj.common.enabled = false;
+                await dbConnection.setObject(id, obj);
             }
-            await this.dbConnection.writeObjectsDB(objects);
         }
         debug("  => done!");
     }

package/build/tests/integration/lib/dbConnection.d.ts

@@ -1,8 +1,14 @@
 /// <reference types="iobroker" />
+/// <reference types="node" />
+import EventEmitter from "events";
 export declare type ObjectsDB = Record<string, ioBroker.Object>;
 export declare type StatesDB = Record<string, ioBroker.State>;
-/** The DB connection capsules access to the objects.json and states.json on disk */
-export declare class DBConnection {
+export interface DBConnection {
+    on(event: "objectChange", handler: ioBroker.ObjectChangeHandler): this;
+    on(event: "stateChange", handler: ioBroker.StateChangeHandler): this;
+}
+/** The DB connection capsules access to the states and objects DB */
+export declare class DBConnection extends EventEmitter {
     private appName;
     private testDir;
     /**
@@ -11,25 +17,43 @@ export declare class DBConnection {
      */
     constructor(appName: string, testDir: string);
     private testDataDir;
-    private objectsPath;
-    private statesPath;
-    readObjectsDB(): Promise<Record<string, ioBroker.Object> | undefined>;
-    writeObjectsDB(objects: ObjectsDB | undefined): Promise<void>;
-    writeStatesDB(states: StatesDB | undefined): Promise<void>;
-    readStatesDB(): Promise<any>;
-    /**
-     * Creates a backup of the objects and states DB, so it can be restored after each test
-     * @param appName The branded name of "iobroker"
-     * @param testDir The directory the integration tests are executed in
-     */
-    readDB(): Promise<{
-        objects: Record<string, ioBroker.Object> | undefined;
-        states: any;
+    private testControllerDir;
+    private _objectsServer;
+    private _statesServer;
+    private _objectsClient;
+    /** The underlying objects client instance that can be used to access the objects DB */
+    get objectsClient(): any;
+    private _statesClient;
+    /** The underlying states client instance that can be used to access the states DB */
+    get statesClient(): any;
+    get objectsType(): "file" | "jsonl";
+    get objectsPath(): string;
+    get statesType(): "file" | "jsonl";
+    get statesPath(): string;
+    getSystemConfig(): any;
+    backup(): Promise<{
+        objects: Buffer;
+        states: Buffer;
     }>;
-    /**
-     * Restores a previous backup of the objects and states DB
-     * @param appName The branded name of "iobroker"
-     * @param testDir The directory the integration tests are executed in
-     */
-    writeDB(objects: any, states: any): Promise<void>;
+    restore(objects: Buffer, states: Buffer): Promise<void>;
+    setSystemConfig(systemConfig: any): void;
+    private _isRunning;
+    get isRunning(): boolean;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Creates the objects DB and sets up listeners for it */
+    private createObjectsDB;
+    /** Creates the states DB and sets up listeners for it */
+    private createStatesDB;
+    readonly getObject: ioBroker.Adapter["getForeignObjectAsync"];
+    readonly setObject: ioBroker.Adapter["setForeignObjectAsync"];
+    readonly delObject: ioBroker.Adapter["delForeignObjectAsync"];
+    readonly getState: ioBroker.Adapter["getForeignStateAsync"];
+    readonly setState: ioBroker.Adapter["setForeignStateAsync"];
+    readonly delState: ioBroker.Adapter["delForeignStateAsync"];
+    subscribeMessage(id: string): void;
+    pushMessage(instanceId: string, msg: any, callback: (err: Error | null, id: any) => void): void;
+    readonly getObjectViewAsync: ioBroker.Adapter["getObjectViewAsync"];
+    getStateIDs(pattern?: string): Promise<string[]>;
+    getObjectIDs(pattern?: string): Promise<string[]>;
 }