feat: add comprehensive tests and samples for host and user rights endpoints

- Added GraphQL sample queries and mutations for host and user rights endpoints in the 'docs' directory.

- Implemented unit tests for all remaining GraphQL endpoints, including hosts, devices, host groups, locations, and user permissions.

- Created dedicated integration tests for host and user rights workflows, utilizing the new sample files.

- Fixed a bug in 'HostImporter.getHostGroupHierarchyNames' to correctly process and sort nested host group hierarchies.

- Refined Zabbix API mocking in tests to improve reliability and support path-based routing.

- Verified all 38 tests across 11 suites pass successfully.

src/test/host_importer.test.ts

@@ -0,0 +1,84 @@
+
+import {HostImporter} from "../execution/host_importer.js";
+import {zabbixAPI, ZABBIX_EDGE_DEVICE_BASE_GROUP} from "../datasources/zabbix-api.js";
+import {ZabbixRequestWithPermissions} from "../datasources/zabbix-permissions.js";
+
+// Mocking ZabbixAPI
+jest.mock("../datasources/zabbix-api.js", () => ({
+    zabbixAPI: {
+        executeRequest: jest.fn(),
+        post: jest.fn(),
+        requestByPath: jest.fn()
+    },
+    ZABBIX_EDGE_DEVICE_BASE_GROUP: "Baustellen-Devices"
+}));
+
+// Mock ZabbixRequestWithPermissions to skip permission checks
+jest.mock("../datasources/zabbix-permissions.js", () => ({
+    ZabbixRequestWithPermissions: class {
+        constructor(public path: string) {}
+        async prepare() {
+            return undefined;
+        }
+        async executeRequestReturnError(api: any, args: any) {
+            // @ts-ignore
+            return api.post(this.path, { body: { method: this.path, params: args?.zabbix_params } });
+        }
+        async executeRequestThrowError(api: any, args: any) {
+            return this.executeRequestReturnError(api, args);
+        }
+    },
+    ZabbixPermissionsHelper: {
+        hasUserPermissions: jest.fn().mockResolvedValue(true)
+    }
+}));
+
+describe("HostImporter", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+
+    test("importHostGroups - create new hierarchy", async () => {
+        const hostGroups = [{ groupName: "Parent/Child" }];
+        
+        // Parent lookup (from importHostGroups loop)
+        (zabbixAPI.post as jest.Mock).mockResolvedValueOnce([]); // findHostGroupIdsByName (Parent)
+        // Parent creation
+        (zabbixAPI.post as jest.Mock).mockResolvedValueOnce({ groupids: ["101"] }); // hostgroup.create (Parent)
+
+        // Parent/Child lookup
+        (zabbixAPI.post as jest.Mock).mockResolvedValueOnce([]); // findHostGroupIdsByName (Parent/Child)
+        // Parent/Child creation
+        (zabbixAPI.post as jest.Mock).mockResolvedValueOnce({ groupids: ["102"] }); // hostgroup.create (Parent/Child)
+
+        const result = await HostImporter.importHostGroups(hostGroups, "token");
+
+        expect(result).toHaveLength(2);
+        expect(result!.find(r => r.groupName === "Parent")?.groupid).toBe(101);
+        expect(result!.find(r => r.groupName === "Parent/Child")?.groupid).toBe(102);
+    });
+
+    test("importHosts - basic host", async () => {
+        const hosts = [{
+            deviceKey: "Device1",
+            deviceType: "Type1",
+            groupNames: ["Group1"]
+        }];
+
+        // Mocking group lookup for Base group and Group1
+        // findHostGroupIdsByName for [Base, Group1]
+        (zabbixAPI.post as jest.Mock).mockResolvedValueOnce([{ groupid: "201", name: ZABBIX_EDGE_DEVICE_BASE_GROUP }]); // Base
+        (zabbixAPI.post as jest.Mock).mockResolvedValueOnce([{ groupid: "202", name: ZABBIX_EDGE_DEVICE_BASE_GROUP + "/Group1" }]); // Group1
+        
+        // Mocking template lookup for deviceType
+        (zabbixAPI.post as jest.Mock).mockResolvedValueOnce([{ templateid: "301" }]);
+
+        // Mocking host.create via requestByPath
+        (zabbixAPI.requestByPath as jest.Mock).mockResolvedValueOnce({ hostids: ["401"] });
+
+        const result = await HostImporter.importHosts(hosts, "token");
+
+        expect(result).toHaveLength(1);
+        expect(result![0].hostid).toBe("401");
+    });
+});