hcloud-sdk 17.0.0 → 19.0.0

package/lib/interfaces/shorts/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShortType = void 0;
+var ShortType;
+(function (ShortType) {
+    ShortType["GENERIC"] = "GENERIC";
+    ShortType["COSMO"] = "COSMO";
+})(ShortType || (exports.ShortType = ShortType = {}));

package/lib/service/agent/bundle/dev/index.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from "axios";
-import Base, { Options } from "../../../../Base";
+import Base, { MaybeRaw, Options } from "../../../../Base";
 import { ToggleDevBundle } from "../../../../interfaces/agent/bundle/dev";
 export declare class DevBundle extends Base {
     constructor(options: Options, axios: AxiosInstance);
@@ -7,14 +7,24 @@ export declare class DevBundle extends Base {
      * Retrieves the current dev bundle state.
      * @returns The current dev bundle state
      */
-    getDevBundleState(): Promise<ToggleDevBundle>;
+    getDevBundleState<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, ToggleDevBundle>>;
     /**
      * Update the dev bundle state.
      * @returns 204 - No content
      */
-    updateDevBundleState(allowDev: boolean): Promise<void>;
-    getCurrentVersion(): Promise<string>;
-    setCurrentVersion(version: string): Promise<void>;
-    restart(): Promise<void>;
+    updateDevBundleState<R extends boolean = false>(allowDev: boolean, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    getCurrentVersion<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, string>>;
+    setCurrentVersion<R extends boolean = false>(version: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    restart<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/agent/bundle/dev/index.js

@@ -8,9 +8,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DevBundle = void 0;
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 class DevBundle extends Base_1.default {
     constructor(options, axios) {
         super(options, axios);
@@ -19,38 +22,40 @@ class DevBundle extends Base_1.default {
      * Retrieves the current dev bundle state.
      * @returns The current dev bundle state
      */
-    getDevBundleState() {
+    getDevBundleState(raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.get(this.getEndpoint(`/v1/bundle/dev`));
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
      * Update the dev bundle state.
      * @returns 204 - No content
      */
-    updateDevBundleState(allowDev) {
+    updateDevBundleState(allowDev, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.post(this.getEndpoint(`/v1/bundle/dev`), {
                 allowDev,
             });
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
         });
     }
-    getCurrentVersion() {
+    getCurrentVersion(raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.get(this.getEndpoint("/v1/bundle/version"));
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
-    setCurrentVersion(version) {
+    setCurrentVersion(version, raw) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.axios.put(this.getEndpoint("/v1/bundle/version"), { version }, { headers: { "Content-Type": "application/x-www-form-urlencoded" } });
+            const resp = yield this.axios.put(this.getEndpoint("/v1/bundle/version"), { version }, { headers: { "Content-Type": "application/x-www-form-urlencoded" } });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
         });
     }
-    restart() {
+    restart(raw) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.axios.post(this.getEndpoint("/v1/bundle/restart"));
+            const resp = yield this.axios.post(this.getEndpoint("/v1/bundle/restart"));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
         });
     }
     getEndpoint(endpoint) {

package/lib/service/agent/bundle/index.d.ts

@@ -1,11 +1,17 @@
 import { AxiosInstance } from "axios";
-import Base, { Options } from "../../../Base";
+import Base, { MaybeRaw, Options } from "../../../Base";
 import { AgentVersions, Version } from "../../../interfaces/agent";
 export declare class AgentBundle extends Base {
     private sourceServer;
     constructor(options: Options, axios: AxiosInstance);
-    getVersions(): Promise<AgentVersions>;
-    getLatestVersion(): Promise<Version>;
-    getVersion(version: string): Promise<Version | void>;
+    getVersions<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, AgentVersions>>;
+    getLatestVersion<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Version>>;
+    getVersion<R extends boolean = false>(version: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Version | void>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/agent/bundle/index.js

@@ -8,9 +8,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentBundle = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 const axios_1 = require("../../../interfaces/axios");
 class AgentBundle extends Base_1.default {
     constructor(options, axios) {
@@ -18,26 +21,26 @@ class AgentBundle extends Base_1.default {
         super(options, axios);
         this.sourceServer = ((_a = options.agent) === null || _a === void 0 ? void 0 : _a.server) || "https://agent.s3.helmut.cloud";
     }
-    getVersions() {
+    getVersions(raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.get(this.getEndpoint("/bundles/index.json"), { headers: axios_1.disableCacheHeaders });
             const registry = resp.data;
             for (const v in registry.versions) {
                 setDev(registry.versions[v]);
             }
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
-    getLatestVersion() {
+    getLatestVersion(raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.getVersions();
-            return setDev(resp.versions[resp.latest]);
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? Object.assign(Object.assign({}, resp), { data: setDev(resp.versions[resp.latest]) }) : setDev(resp.versions[resp.latest]));
         });
     }
-    getVersion(version) {
+    getVersion(version, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.getVersions();
-            return setDev(resp.versions[version]);
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? Object.assign(Object.assign({}, resp), { data: setDev(resp.versions[version]) }) : setDev(resp.versions[version]));
         });
     }
     getEndpoint(endpoint) {

package/lib/service/agent/context/index.d.ts

@@ -1,40 +1,54 @@
-import Base from "../../../Base";
+import Base, { MaybeRaw } from "../../../Base";
 import { Context } from "../../../interfaces/agent/context";
 export declare class AgentContext extends Base {
     /**
      * Retrieves all contexts.
      * @returns The requested contexts
      */
-    getContexts(): Promise<Context[]>;
+    getContexts<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Context[]>>;
     /**
      * Add a new context.
      * @returns The newly created context
      */
-    addContext(server: string, email: string, token: string, enabled: boolean): Promise<Context>;
+    addContext<R extends boolean = false>(server: string, email: string, token: string, enabled: boolean, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Context>>;
     /**
      * Add a new context by using a service accounts PAT token.
      * @returns The newly created context
      */
-    addServiceAccountContext(server: string, token: string, enabled: boolean): Promise<Context>;
+    addServiceAccountContext<R extends boolean = false>(server: string, token: string, enabled: boolean, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Context>>;
     /**
      * Update an existing context.
      * @returns The updated context
      */
-    updateContext(uuid: string, server: string, email: string, token: string, enabled: boolean): Promise<Context>;
+    updateContext<R extends boolean = false>(uuid: string, server: string, email: string, token: string, enabled: boolean, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Context>>;
     /**
      * Get an existing context.
      * @returns The requested context
      */
-    getContext(uuid: string): Promise<Context>;
+    getContext<R extends boolean = false>(uuid: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Context>>;
     /**
      * Delete a context.
      * @returns void
      */
-    deleteContext(uuid: string): Promise<void>;
+    deleteContext<R extends boolean = false>(uuid: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Context>>;
     /**
      * Patch the enabled property of a Context.
      * @returns Updated Context
      */
-    patchContextEnabled(uuid: string, enabled: boolean): Promise<Context>;
+    patchContextEnabled<R extends boolean = false>(uuid: string, enabled: boolean, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Context>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/agent/context/index.js

@@ -8,25 +8,28 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentContext = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 class AgentContext extends Base_1.default {
     /**
      * Retrieves all contexts.
      * @returns The requested contexts
      */
-    getContexts() {
+    getContexts(raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.get(this.getEndpoint(`/v1/context`));
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
      * Add a new context.
      * @returns The newly created context
      */
-    addContext(server, email, token, enabled) {
+    addContext(server, email, token, enabled, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.post(this.getEndpoint(`/v1/context`), {
                 server,
@@ -34,28 +37,28 @@ class AgentContext extends Base_1.default {
                 token,
                 enabled,
             });
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
      * Add a new context by using a service accounts PAT token.
      * @returns The newly created context
      */
-    addServiceAccountContext(server, token, enabled) {
+    addServiceAccountContext(server, token, enabled, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.post(this.getEndpoint(`/v1/context`), {
                 server,
                 token: token.toLowerCase().startsWith("bearer") ? token : `Bearer ${token}`,
                 enabled,
             });
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
      * Update an existing context.
      * @returns The updated context
      */
-    updateContext(uuid, server, email, token, enabled) {
+    updateContext(uuid, server, email, token, enabled, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.patch(this.getEndpoint(`/v1/context/${uuid}`), {
                 server,
@@ -63,38 +66,39 @@ class AgentContext extends Base_1.default {
                 token,
                 enabled,
             });
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
      * Get an existing context.
      * @returns The requested context
      */
-    getContext(uuid) {
+    getContext(uuid, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.get(this.getEndpoint(`/v1/context/${uuid}`));
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
      * Delete a context.
      * @returns void
      */
-    deleteContext(uuid) {
+    deleteContext(uuid, raw) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.axios.delete(this.getEndpoint(`/v1/context/${uuid}`));
+            const resp = yield this.axios.delete(this.getEndpoint(`/v1/context/${uuid}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
      * Patch the enabled property of a Context.
      * @returns Updated Context
      */
-    patchContextEnabled(uuid, enabled) {
+    patchContextEnabled(uuid, enabled, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const res = yield this.axios.patch(this.getEndpoint(`/v1/context/${uuid}/enabled`), {
                 enabled,
             });
-            return res.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? res : res.data);
         });
     }
     getEndpoint(endpoint) {

package/lib/service/agent/index.d.ts

@@ -3,6 +3,8 @@ import { AgentBundle } from "./bundle";
 import { DevBundle } from "./bundle/dev";
 import { AgentContext } from "./context";
 import { AgentInstaller } from "./installer";
+import { AgentLogging } from "./logging";
+import { AgentModule } from "./module";
 export default class Agent extends Base {
     get context(): AgentContext;
     private _context?;
@@ -12,5 +14,9 @@ export default class Agent extends Base {
     private _devBundle?;
     get installer(): AgentInstaller;
     private _installer?;
+    get logging(): AgentLogging;
+    private _logging?;
+    get module(): AgentModule;
+    private _module?;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/agent/index.js

@@ -1,10 +1,15 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const Base_1 = require("../../Base");
+const Base_1 = __importDefault(require("../../Base"));
 const bundle_1 = require("./bundle");
 const dev_1 = require("./bundle/dev");
 const context_1 = require("./context");
 const installer_1 = require("./installer");
+const logging_1 = require("./logging");
+const module_1 = require("./module");
 class Agent extends Base_1.default {
     get context() {
         if (this._context === undefined) {
@@ -30,6 +35,18 @@ class Agent extends Base_1.default {
         }
         return this._installer;
     }
+    get logging() {
+        if (this._logging === undefined) {
+            this._logging = new logging_1.AgentLogging(this.options, this.axios);
+        }
+        return this._logging;
+    }
+    get module() {
+        if (this._module === undefined) {
+            this._module = new module_1.AgentModule(this.options, this.axios);
+        }
+        return this._module;
+    }
     getEndpoint(endpoint) {
         return `${this.options.server}/api/agent${endpoint}`;
     }

package/lib/service/agent/installer/index.js

@@ -8,9 +8,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentInstaller = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 const axios_1 = require("../../../interfaces/axios");
 class AgentInstaller extends Base_1.default {
     constructor(options, axios) {

package/lib/service/agent/logging/index.d.ts

@@ -0,0 +1,69 @@
+import Base, { MaybeRaw } from "../../../Base";
+import { AddCloudWatchDto, AddLogCollectorDto, CloudWatchDto, LogCollectorDto } from "../../../interfaces/agent/logging";
+export declare class AgentLogging extends Base {
+    /**
+     * Retrieves a list of all currently registered and connected external logging destinations.
+     * @returns List of active external log collector configurations
+     */
+    getLogCollectors<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, LogCollectorDto[]>>;
+    /**
+     * Registers a new external destination and initializes a persistent Winston HTTP transport for log forwarding.
+     * @param collector - The configuration for the new log collector
+     * @returns The newly created log collector details
+     */
+    addLogCollector<R extends boolean = false>(collector: AddLogCollectorDto, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, LogCollectorDto>>;
+    /**
+     * Retrieves configuration and status information for a specific external log collector by its name.
+     * @param name - Unique identifier of the external log collector
+     * @returns The requested log collector details
+     */
+    getLogCollector<R extends boolean = false>(name: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, LogCollectorDto>>;
+    /**
+     * Removes an external log destination and immediately terminates the associated Winston transport.
+     * @param name - Unique identifier of the external log collector to be deleted
+     * @returns void (or raw response)
+     */
+    deleteLogCollector<R extends boolean = false>(name: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    /**
+     * Updates the activation status of a specific log collector,
+     * this toggles log forwarding to the destination without removing its configuration.
+     * @param name - Unique identifier of the external log collector
+     * @param enabled - Flag to enable or disable the collector
+     * @returns The updated log collector details
+     */
+    patchLogCollectorEnabled<R extends boolean = false>(name: string, enabled: boolean, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, LogCollectorDto>>;
+    /**
+     * Registers and initializes a new Amazon CloudWatch transport for log forwarding
+     * @param options - AWS credentials and CloudWatch group/stream configuration
+     * @returns The registered CloudWatch collector details
+     */
+    addCloudWatch<R extends boolean = false>(options: AddCloudWatchDto, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, CloudWatchDto>>;
+    /**
+     * Removes the Amazon CloudWatch logging destination and terminates its Winston transport
+     * @returns void (or raw response)
+     */
+    deleteCloudWatch<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    /**
+     * Establishes a persistent Server-Sent Events (SSE) connection to stream logs in real-time.
+     * Note: This method returns the raw Axios response because SSE requires stream handling.
+     * @param level - Optional filter by severity level
+     * @param entity - Optional filter by originating component
+     * @returns Raw response with the event stream
+     */
+    streamLogs(level?: string, entity?: string): Promise<any>;
+    protected getEndpoint(endpoint: string): string;
+}

package/lib/service/agent/logging/index.js

@@ -0,0 +1,117 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentLogging = void 0;
+const Base_1 = __importDefault(require("../../../Base"));
+class AgentLogging extends Base_1.default {
+    /**
+     * Retrieves a list of all currently registered and connected external logging destinations.
+     * @returns List of active external log collector configurations
+     */
+    getLogCollectors(raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.get(this.getEndpoint(`/v1/log/collectors`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Registers a new external destination and initializes a persistent Winston HTTP transport for log forwarding.
+     * @param collector - The configuration for the new log collector
+     * @returns The newly created log collector details
+     */
+    addLogCollector(collector, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.post(this.getEndpoint(`/v1/log/collectors`), collector);
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Retrieves configuration and status information for a specific external log collector by its name.
+     * @param name - Unique identifier of the external log collector
+     * @returns The requested log collector details
+     */
+    getLogCollector(name, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.get(this.getEndpoint(`/v1/log/collectors/${name}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Removes an external log destination and immediately terminates the associated Winston transport.
+     * @param name - Unique identifier of the external log collector to be deleted
+     * @returns void (or raw response)
+     */
+    deleteLogCollector(name, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.delete(this.getEndpoint(`/v1/log/collectors/${name}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Updates the activation status of a specific log collector,
+     * this toggles log forwarding to the destination without removing its configuration.
+     * @param name - Unique identifier of the external log collector
+     * @param enabled - Flag to enable or disable the collector
+     * @returns The updated log collector details
+     */
+    patchLogCollectorEnabled(name, enabled, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.patch(this.getEndpoint(`/v1/log/collectors/${name}/enabled`), { enabled });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Registers and initializes a new Amazon CloudWatch transport for log forwarding
+     * @param options - AWS credentials and CloudWatch group/stream configuration
+     * @returns The registered CloudWatch collector details
+     */
+    addCloudWatch(options, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.post(this.getEndpoint(`/v1/log/cloudwatch`), options);
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Removes the Amazon CloudWatch logging destination and terminates its Winston transport
+     * @returns void (or raw response)
+     */
+    deleteCloudWatch(raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.delete(this.getEndpoint(`/v1/log/cloudwatch`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Establishes a persistent Server-Sent Events (SSE) connection to stream logs in real-time.
+     * Note: This method returns the raw Axios response because SSE requires stream handling.
+     * @param level - Optional filter by severity level
+     * @param entity - Optional filter by originating component
+     * @returns Raw response with the event stream
+     */
+    streamLogs(level, entity) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.axios.get(this.getEndpoint(`/v1/logs`), {
+                params: { level, entity },
+                responseType: "stream",
+                headers: {
+                    Accept: "text/event-stream",
+                },
+            });
+        });
+    }
+    getEndpoint(endpoint) {
+        return `${this.options.server}/api/agent${endpoint}`;
+    }
+}
+exports.AgentLogging = AgentLogging;

package/lib/service/agent/module/index.d.ts

@@ -0,0 +1,36 @@
+import Base, { MaybeRaw } from "../../../Base";
+import { ModuleDto } from "../../../interfaces/agent/module";
+export declare class AgentModule extends Base {
+    /**
+     * Retrieves a list of all loaded modules available in the agent.
+     * @returns A list of modules metadata
+     */
+    listModules<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, ModuleDto[]>>;
+    /**
+     * Creates a new module template based on the received metadata.
+     * @param module - Metadata for the new module template
+     * @returns Newly created module data
+     */
+    addModule<R extends boolean = false>(module: ModuleDto, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, ModuleDto>>;
+    /**
+     * Retrieves detailed information about a specific module by its name.
+     * @param modName - Unique name identifier of the module
+     * @returns Requested module details
+     */
+    getModule<R extends boolean = false>(modName: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, ModuleDto>>;
+    /**
+     * Removes the module from the agent by its name.
+     * @param modName - Unique name identifier of the module to be deleted
+     * @returns void (or raw response)
+     */
+    deleteModule<R extends boolean = false>(modName: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    protected getEndpoint(endpoint: string): string;
+}