hcloud-sdk 16.0.0 → 18.0.0

package/lib/service/mothership/index.js

@@ -17,10 +17,10 @@ class MothershipService extends Base_1.default {
      * Requests the endpoint version
      * @returns Version object
      */
-    version() {
+    version(raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.get(this.getEndpoint("/v1/version"));
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
@@ -31,14 +31,15 @@ class MothershipService extends Base_1.default {
      * @param info Information about the agent's uuid, hardware and nickname
      * @return an Agent object
      */
-    hello(uuid, uuidSignature, info) {
+    hello(uuid, uuidSignature, info, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.post(this.getEndpoint("/v1/hello"), info, {
                 headers: {
                     Authorization: `Bearer ${uuid}.${uuidSignature}`,
                 },
             });
-            return { agent: resp.data, token: resp.headers.authorization };
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw)
+                ? Object.assign(Object.assign({}, resp), { data: { agent: resp.data, token: resp.headers.authorization } }) : { agent: resp.data, token: resp.headers.authorization });
         });
     }
     /**
@@ -51,10 +52,10 @@ class MothershipService extends Base_1.default {
      * @param info Information about the agent's system resources.
      * @return an Agent object
      */
-    helloAgain(info) {
+    helloAgain(info, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             const resp = yield this.axios.patch(this.getEndpoint("/v1/hello/again"), info);
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
@@ -67,14 +68,13 @@ class MothershipService extends Base_1.default {
      * @param publicKey the public key of the agent that will be used for cryptography. The agent should remember its private key.
      * @return an object holding a secret encrypted with the public key. The agent must decrypt it using its private key in order to use the /hello endpoint.
      */
-    // eslint-disable-next-line complexity
-    register(uuid, info, publicKey) {
+    register(uuid, info, publicKey, raw) {
         return __awaiter(this, void 0, void 0, function* () {
             if (typeof publicKey !== "string") {
                 publicKey = publicKey.toString("hex");
             }
             const resp = yield this.axios.post(this.getEndpoint("/v1/register"), Object.assign({ uuid, publicKey }, info));
-            return resp.data;
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
     /**
@@ -88,9 +88,10 @@ class MothershipService extends Base_1.default {
      * @param memberToken JWT assigned to a member of the organization
      * @param email Email of the user owner of the JWT
      */
-    connect(orgName, memberToken, email) {
+    connect(orgName, memberToken, email, raw) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.axios.post(this.getEndpoint(`/v1/org/${orgName}/connect`), { memberToken, email });
+            const resp = yield this.axios.post(this.getEndpoint(`/v1/org/${orgName}/connect`), { memberToken, email });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
         });
     }
     /**
@@ -103,9 +104,10 @@ class MothershipService extends Base_1.default {
      * @param orgName Name of the organization
      * @param email Email of the user
      */
-    disconnect(orgName, email) {
+    disconnect(orgName, email, raw) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.axios.delete(this.getEndpoint(`/v1/org/${orgName}/connect/${email}`));
+            const resp = yield this.axios.delete(this.getEndpoint(`/v1/org/${orgName}/connect/${email}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
         });
     }
     /**
@@ -117,9 +119,10 @@ class MothershipService extends Base_1.default {
      *
      * @param email Email of the target
      */
-    disconnectTarget(email) {
+    disconnectTarget(email, raw) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.axios.delete(this.getEndpoint(`/v1/connect/${email}`));
+            const resp = yield this.axios.delete(this.getEndpoint(`/v1/connect/${email}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
         });
     }
     /**
@@ -128,8 +131,8 @@ class MothershipService extends Base_1.default {
      * @param orgName Name of the organization
      * @returns Object containing an array of retrieved agents and the total number of available found in the database (independent of limit and page)
      */
-    searchAvailableTargets(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ orgName, filters, sorting, limit = 25, page = 0, }) {
+    searchAvailableTargets(_a, raw_1) {
+        return __awaiter(this, arguments, void 0, function* ({ orgName, filters, sorting, limit = 25, page = 0 }, raw) {
             const filtersDTO = filters === null || filters === void 0 ? void 0 : filters.map((f) => {
                 return new searchFilter_1.SearchFilterDTO(f);
             });
@@ -139,7 +142,18 @@ class MothershipService extends Base_1.default {
             }, {
                 params: { limit, page },
             });
-            return (0, paginatedResponseHelper_1.createPaginatedResponse)(resp);
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? Object.assign(Object.assign({}, resp), { data: (0, paginatedResponseHelper_1.createPaginatedResponse)(resp) }) : (0, paginatedResponseHelper_1.createPaginatedResponse)(resp));
+        });
+    }
+    /**
+     * Retrieves usage statistics for a specific organization.
+     * @param orgName Name of the organization
+     * @returns Statistics information
+     */
+    getStats(orgName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.get(this.getEndpoint(`/v1/org/${orgName}/stats`));
+            return resp.data;
         });
     }
     getEndpoint(endpoint) {

package/lib/service/nats/index.js

@@ -22,9 +22,14 @@ class Nats extends Base_1.default {
             return this.natsConnection;
         };
     }
-    // eslint-disable-next-line complexity
     connect(params) {
         return __awaiter(this, void 0, void 0, function* () {
+            let previousSubs = [];
+            if (this.natsConnection && !this.natsConnection.isClosed()) {
+                previousSubs = [...this.subMap];
+                yield this.natsConnection.close();
+                this.subMap = [];
+            }
             if (params.forceWebsocket) {
                 this.connection = nats_ws_1.connect;
             }
@@ -47,55 +52,64 @@ class Nats extends Base_1.default {
                 user: params.email !== undefined ? params.email : params.username,
                 pass: params.jwt !== undefined ? params.jwt : params.password,
             });
+            for (const entry of previousSubs) {
+                yield this.sub(entry.subject, (err, data, msg) => {
+                    var _a, _b;
+                    (_b = (_a = entry.sub).callback) === null || _b === void 0 ? void 0 : _b.call(_a, err, msg ? msg : {});
+                });
+            }
             return this.natsConnection;
         });
     }
     sub(subject, callback, options) {
-        var _a;
-        let delay = 0;
-        if (!this.getConnection() || ((_a = this.getConnection()) === null || _a === void 0 ? void 0 : _a.isClosed())) {
-            delay = 3000;
-        }
-        // add delay just in case the connection has not been established yet
-        return new Promise((resolve, reject) => {
-            const newOptions = Object.assign(Object.assign({}, options), { callback: (err, msg) => {
-                    if (err !== null) {
-                        try {
-                            callback(err);
-                        }
-                        catch (ignored) {
-                            // ignore callback errors
-                        }
-                        return;
-                    }
-                    let parsedData;
-                    try {
-                        const data = new TextDecoder("utf-8").decode(msg.data);
-                        parsedData = JSON.parse(data);
-                    }
-                    catch (e) {
-                        callback(e);
-                        return;
-                    }
-                    try {
-                        callback(null, parsedData, msg);
-                    }
-                    catch (ignored) {
-                        // ignore callback errors
-                    }
-                } });
-            setTimeout(() => {
-                var _a, _b;
-                if (!this.getConnection() || !((_a = this.getConnection()) === null || _a === void 0 ? void 0 : _a.isClosed)) {
-                    reject(new Error("connection not established, can not subscribe"));
+        return __awaiter(this, void 0, void 0, function* () {
+            const delay = 500;
+            const trySubscribe = () => __awaiter(this, void 0, void 0, function* () {
+                const conn = this.getConnection();
+                // if connection not ready, retry after delay
+                if (!conn || conn.isClosed()) {
+                    yield new Promise(res => setTimeout(res, delay));
+                    return trySubscribe();
+                }
+                try {
+                    const newOptions = Object.assign(Object.assign({}, options), { callback: (err, msg) => {
+                            if (err) {
+                                try {
+                                    callback(err);
+                                }
+                                catch (_a) {
+                                    // ignore callback errors
+                                }
+                                return;
+                            }
+                            let parsedData;
+                            try {
+                                const data = new TextDecoder("utf-8").decode(msg.data);
+                                parsedData = JSON.parse(data);
+                            }
+                            catch (e) {
+                                callback(e);
+                                return;
+                            }
+                            try {
+                                callback(null, parsedData, msg);
+                            }
+                            catch (_b) {
+                                // ignore callback errors
+                            }
+                        } });
+                    const sub = conn.subscribe(subject, newOptions);
+                    this.subMap.push({ subject, sub });
+                    return sub;
                 }
-                const sub = (_b = this.getConnection()) === null || _b === void 0 ? void 0 : _b.subscribe(subject, newOptions);
-                if (sub) {
-                    this.subMap.push({ subject, sub: sub });
-                    return resolve(sub);
+                catch (err) {
+                    err;
+                    // if subscription fails, retry after delay
+                    yield new Promise(res => setTimeout(res, delay));
+                    return trySubscribe();
                 }
-                return reject(new Error("could not subscribe"));
-            }, delay);
+            });
+            return trySubscribe();
         });
     }
     unsub(subject) {

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

@@ -0,0 +1,18 @@
+import Base, { MaybeRaw } from "../../Base";
+import { Version } from "../../interfaces/global";
+import { ShortsInternal } from "./internal";
+export default class Shorts extends Base {
+    /**
+     * Handles everything around internal endpoints
+     */
+    get internal(): ShortsInternal;
+    private _internal?;
+    /**
+     * Requests the endpoint version
+     * @returns Version object
+     */
+    version<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Version>>;
+    protected getEndpoint(endpoint: string): string;
+}

package/lib/service/shorts/index.js

@@ -0,0 +1,38 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Base_1 = require("../../Base");
+const internal_1 = require("./internal");
+class Shorts extends Base_1.default {
+    /**
+     * Handles everything around internal endpoints
+     */
+    get internal() {
+        if (this._internal === undefined) {
+            this._internal = new internal_1.ShortsInternal(this.options, this.axios);
+        }
+        return this._internal;
+    }
+    /**
+     * Requests the endpoint version
+     * @returns Version object
+     */
+    version(raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.get(this.getEndpoint("/v1/version"));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    getEndpoint(endpoint) {
+        return `${this.options.server}/api/shorts${endpoint}`;
+    }
+}
+exports.default = Shorts;

package/lib/service/shorts/internal/index.d.ts

@@ -0,0 +1,72 @@
+import Base, { MaybeRaw } from "../../../Base";
+import { Short } from "../../../interfaces/shorts";
+export declare class ShortsInternal extends Base {
+    /**
+     * Generates a shortened alias for the provided long URL and sets a maximum number of allowed visits.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param organizationId ID of the organization
+     * @param spaceId ID of the space
+     * @param url Original long URL that needs to be shortened
+     * @param visitsLimit Maximum number of times the shortened link can be accessed
+     * @returns the created short url
+     */
+    createShort<R extends boolean = false>(organizationId: string, spaceId: string, url: string, visitsLimit: number, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Short>>;
+    /**
+     * Retrieves the full data associated with a shortened URL slug, including the original long URL, the current number of visits, and the maximum allowed visit limit.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param slug Unique identifier or alias representing the shortened version of a URL
+     * @returns detailed information about this short url slug
+     */
+    getShort<R extends boolean = false>(slug: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Short>>;
+    /**
+     * Updates the maximum allowed visit limit for a shortened URL identified by its slug.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param slug Unique identifier representing the shortened version of a URL
+     * @param visitsLimit New maximum number of allowed visits for this shortened URL
+     * @returns The updated Short object with the new visit limit
+     */
+    updateVisitsLimit<R extends boolean = false>(slug: string, visitsLimit: number, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Short>>;
+    /**
+     * Deletes the shortened URL associated with the given slug.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param slug Unique identifier representing the shortened version of a URL
+     */
+    deleteShort<R extends boolean = false>(slug: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    /**
+     * Deletes all shortened URLs associated with the given space ID.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param spaceId ID of the space whose shortened URLs should be deleted
+     */
+    deleteSpaceShorts<R extends boolean = false>(spaceId: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    /**
+     * Deletes all shortened URLs associated with the given organization ID.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param orgId ID of the organization whose shortened URLs should be deleted
+     */
+    deleteOrganizationShorts<R extends boolean = false>(orgId: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    protected getEndpoint(endpoint: string): string;
+}

package/lib/service/shorts/internal/index.js

@@ -0,0 +1,104 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShortsInternal = void 0;
+const Base_1 = require("../../../Base");
+class ShortsInternal extends Base_1.default {
+    /**
+     * Generates a shortened alias for the provided long URL and sets a maximum number of allowed visits.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param organizationId ID of the organization
+     * @param spaceId ID of the space
+     * @param url Original long URL that needs to be shortened
+     * @param visitsLimit Maximum number of times the shortened link can be accessed
+     * @returns the created short url
+     */
+    createShort(organizationId, spaceId, url, visitsLimit, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.axios.post(this.getEndpoint(`/internal/v1/short`), { url, visitsLimit, organizationId, spaceId });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? res : res.data);
+        });
+    }
+    /**
+     * Retrieves the full data associated with a shortened URL slug, including the original long URL, the current number of visits, and the maximum allowed visit limit.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param slug Unique identifier or alias representing the shortened version of a URL
+     * @returns detailed information about this short url slug
+     */
+    getShort(slug, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.axios.get(this.getEndpoint(`/internal/v1/short/${slug}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? res : res.data);
+        });
+    }
+    /**
+     * Updates the maximum allowed visit limit for a shortened URL identified by its slug.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param slug Unique identifier representing the shortened version of a URL
+     * @param visitsLimit New maximum number of allowed visits for this shortened URL
+     * @returns The updated Short object with the new visit limit
+     */
+    updateVisitsLimit(slug, visitsLimit, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.patch(this.getEndpoint(`/internal/v1/short/${slug}/limit`), { visitsLimit });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    /**
+     * Deletes the shortened URL associated with the given slug.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param slug Unique identifier representing the shortened version of a URL
+     */
+    deleteShort(slug, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.delete(this.getEndpoint(`/internal/v1/short/${slug}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
+        });
+    }
+    /**
+     * Deletes all shortened URLs associated with the given space ID.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param spaceId ID of the space whose shortened URLs should be deleted
+     */
+    deleteSpaceShorts(spaceId, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.delete(this.getEndpoint(`/internal/v1/short/space/${spaceId}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
+        });
+    }
+    /**
+     * Deletes all shortened URLs associated with the given organization ID.
+     *
+     * This is an internal endpoint and can only be used from backends within the hcloud deployment.
+     *
+     * @param orgId ID of the organization whose shortened URLs should be deleted
+     */
+    deleteOrganizationShorts(orgId, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.delete(this.getEndpoint(`/internal/v1/short/org/${orgId}`));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : undefined);
+        });
+    }
+    getEndpoint(endpoint) {
+        return `${this.options.server}/api/account${endpoint}`;
+    }
+}
+exports.ShortsInternal = ShortsInternal;

package/lib/utils/bouncer/features/Provider.js

@@ -64,7 +64,6 @@ class BouncerProvider {
         }
         this.processRefs();
     }
-    /* eslint-disable @typescript-eslint/no-non-null-assertion*/
     doesMatchRegion(feature, context) {
         if (feature.regions.length) {
             if (context === null || context === void 0 ? void 0 : context.region) {
@@ -75,7 +74,6 @@ class BouncerProvider {
         }
         return true;
     }
-    /* eslint-disable @typescript-eslint/no-non-null-assertion*/
     doesMatchUser(feature, context) {
         if (feature.users.length) {
             if (context === null || context === void 0 ? void 0 : context.email) {
@@ -85,7 +83,6 @@ class BouncerProvider {
         }
         return true;
     }
-    /* eslint-disable @typescript-eslint/no-non-null-assertion*/
     doesMatchOrganization(feature, context) {
         if (feature.organizations.length) {
             if (context === null || context === void 0 ? void 0 : context.organization) {

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "hcloud-sdk",
-  "version": "16.0.0",
+  "version": "18.0.0",
   "description": "hcloud platform sdk",
   "main": "index.js",
   "types": "index.d.ts",
   "scripts": {
-    "test": "mocha -r ts-node/register tests/**/*.test.ts",
-    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.test.ts\"",
-    "lint": "eslint --max-warnings=0 --fix src/ tests/ --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint --max-warnings=0 --fix src/",
     "doc:build": "vuepress build _docs/src",
     "doc:dev": "vuepress dev _docs/src",
     "doc:export": "vuepress export _docs/src",
@@ -28,32 +27,31 @@
   "author": "moovit-sp-gmbh",
   "homepage": "https://github.com/moovit-sp-gmbh/hcloud-sdk-js#readme",
   "devDependencies": {
-    "@commitlint/cli": "^18.6.1",
-    "@commitlint/config-conventional": "^18.6.3",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.2.9",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.27.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@trivago/prettier-plugin-sort-imports": "^4.3.0",
-    "@types/chai": "^4.3.17",
-    "@types/mocha": "^10.0.7",
-    "@types/node": "^20.14.8",
-    "@typescript-eslint/eslint-plugin": "^7.0.2",
-    "@typescript-eslint/parser": "^7.0.2",
-    "chai": "^4.5.0",
+    "@trivago/prettier-plugin-sort-imports": "^5.2.2",
+    "@types/node": "^22.15.19",
+    "@typescript-eslint/eslint-plugin": "^8.32.1",
+    "@typescript-eslint/parser": "^8.32.1",
     "conventional-changelog-conventionalcommits": "^8.0.0",
-    "dayjs": "^1.11.12",
-    "eslint": "^8.57.0",
-    "eslint-config-prettier": "^8.10.0",
-    "eslint-plugin-import": "^2.29.1",
-    "mocha": "^10.7.3",
-    "prettier": "^3.3.3",
-    "semantic-release": "^23.1.1",
+    "eslint": "^9.27.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-import": "^2.31.0",
+    "globals": "^16.1.0",
+    "prettier": "^3.5.3",
+    "semantic-release": "^24.2.4",
     "semantic-release-telegram": "^1.6.2",
     "ts-node": "^10.9.2",
-    "typescript": "^5.5.4"
+    "typescript": "^5.8.3"
   },
   "dependencies": {
-    "axios": "^1.7.3",
-    "nats": "^2.28.2",
-    "nats.ws": "^1.29.2"
+    "axios": "^1.9.0",
+    "nats": "^2.29.3",
+    "nats.ws": "^1.30.3"
   }
 }