hcloud-sdk 18.0.0 → 19.0.0

package/lib/service/high5/space/execution/log/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.High5SpaceExecutionLogs = void 0;
-const Base_1 = require("../../../../../Base");
+const Base_1 = __importDefault(require("../../../../../Base"));
 const paginatedResponseHelper_1 = require("../../../../../helper/paginatedResponseHelper");
 const searchFilter_1 = require("../../../../../helper/searchFilter");
 class High5SpaceExecutionLogs extends Base_1.default {

package/lib/service/high5/space/execution/status/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.High5SpaceExecutionStates = void 0;
-const Base_1 = require("../../../../../Base");
+const Base_1 = __importDefault(require("../../../../../Base"));
 class High5SpaceExecutionStates extends Base_1.default {
     constructor(options, axios) {
         super(options, axios);

package/lib/service/high5/space/index.d.ts

@@ -148,5 +148,15 @@ export declare class High5Space extends Base {
     enableDev<R extends boolean = false>(orgName: string, spaceName: string, enableDev: boolean, raw?: {
         raw: R;
     }): Promise<MaybeRaw<R, Space>>;
+    /**
+     * Updates the avatar of the specified High5 space
+     * @param orgName Name of the organization
+     * @param spaceName Name of the space
+     * @param file Image as Javascript File
+     * @returns Space details with updated avatar
+     */
+    updateAvatar<R extends boolean = false>(orgName: string, spaceName: string, file: File, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Space>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/high5/space/index.js

@@ -8,20 +8,23 @@ 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.High5Space = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 const paginatedResponseHelper_1 = require("../../../helper/paginatedResponseHelper");
 const searchFilter_1 = require("../../../helper/searchFilter");
 const database_1 = require("./database");
 const event_1 = require("./event");
 const execution_1 = require("./execution");
 const job_1 = require("./job");
-const node_1 = require("./node");
-const pool_1 = require("./pool");
-const secret_1 = require("./secret");
+const node_1 = __importDefault(require("./node"));
+const pool_1 = __importDefault(require("./pool"));
+const secret_1 = __importDefault(require("./secret"));
 const stat_1 = require("./stat");
-const wave_1 = require("./wave");
+const wave_1 = __importDefault(require("./wave"));
 const webhook_1 = require("./webhook");
 class High5Space extends Base_1.default {
     get event() {
@@ -243,6 +246,23 @@ class High5Space extends Base_1.default {
             return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
+    /**
+     * Updates the avatar of the specified High5 space
+     * @param orgName Name of the organization
+     * @param spaceName Name of the space
+     * @param file Image as Javascript File
+     * @returns Space details with updated avatar
+     */
+    updateAvatar(orgName, spaceName, file, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = new FormData();
+            data.append("avatar", file);
+            const resp = yield this.axios.patch(this.getEndpoint(`/v1/org/${orgName}/spaces/${spaceName}/avatar`), data, {
+                headers: { "Content-Type": "multipart/form-data" },
+            });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
     getEndpoint(endpoint) {
         return `${this.options.server}/api/high5${endpoint}`;
     }

package/lib/service/high5/space/job/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.High5Job = void 0;
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 const paginatedResponseHelper_1 = require("../../../../helper/paginatedResponseHelper");
 const searchFilter_1 = require("../../../../helper/searchFilter");
 const log_1 = require("../../internal/space/job/log");

package/lib/service/high5/space/job/log/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.High5JobLog = void 0;
-const Base_1 = require("../../../../../Base");
+const Base_1 = __importDefault(require("../../../../../Base"));
 const paginatedResponseHelper_1 = require("../../../../../helper/paginatedResponseHelper");
 const searchFilter_1 = require("../../../../../helper/searchFilter");
 class High5JobLog extends Base_1.default {

package/lib/service/high5/space/node/index.js

@@ -8,8 +8,11 @@ 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 });
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 class High5Node extends Base_1.default {
     /**
      * Retrieves all Nodes for the specified stream.

package/lib/service/high5/space/pool/index.d.ts

@@ -109,5 +109,16 @@ export default class High5Pool extends Base {
     }, raw?: {
         raw: R;
     }): Promise<MaybeRaw<R, PaginatedResponse<OrganizationMember>>>;
+    /**
+     * Updates the avatar of the specified pool
+     * @param orgName Name of the organization
+     * @param spaceName Name of the space
+     * @param name Name of the pool
+     * @param file Image as Javascript File
+     * @returns Pool details with updated avatar
+     */
+    updateAvatar<R extends boolean = false>(orgName: string, spaceName: string, name: string, file: File, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, Pool>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/high5/space/pool/index.js

@@ -8,8 +8,11 @@ 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 });
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 const paginatedResponseHelper_1 = require("../../../../helper/paginatedResponseHelper");
 const searchFilter_1 = require("../../../../helper/searchFilter");
 class High5Pool extends Base_1.default {
@@ -165,6 +168,24 @@ class High5Pool extends Base_1.default {
             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));
         });
     }
+    /**
+     * Updates the avatar of the specified pool
+     * @param orgName Name of the organization
+     * @param spaceName Name of the space
+     * @param name Name of the pool
+     * @param file Image as Javascript File
+     * @returns Pool details with updated avatar
+     */
+    updateAvatar(orgName, spaceName, name, file, raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const data = new FormData();
+            data.append("avatar", file);
+            const resp = yield this.axios.patch(this.getEndpoint(`/v1/org/${orgName}/spaces/${spaceName}/pools/${name}/avatar`), data, {
+                headers: { "Content-Type": "multipart/form-data" },
+            });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
     getEndpoint(endpoint) {
         return `${this.options.server}/api/high5${endpoint}`;
     }

package/lib/service/high5/space/secret/index.js

@@ -8,8 +8,11 @@ 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 });
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 const paginatedResponseHelper_1 = require("../../../../helper/paginatedResponseHelper");
 const searchFilter_1 = require("../../../../helper/searchFilter");
 class High5Secret extends Base_1.default {

package/lib/service/high5/space/stat/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.High5SpaceStat = void 0;
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 class High5SpaceStat extends Base_1.default {
     /**
      * Retrieves usage statistics for a specific space.

package/lib/service/high5/space/wave/index.js

@@ -8,8 +8,11 @@ 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 });
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 class High5Wave extends Base_1.default {
     /**
      * Patch wave engine version for a space

package/lib/service/high5/space/webhook/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.High5Webhook = void 0;
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 const paginatedResponseHelper_1 = require("../../../../helper/paginatedResponseHelper");
 const searchFilter_1 = require("../../../../helper/searchFilter");
 const log_1 = require("./log");

package/lib/service/high5/space/webhook/log/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.High5WebhookLog = void 0;
-const Base_1 = require("../../../../../Base");
+const Base_1 = __importDefault(require("../../../../../Base"));
 const paginatedResponseHelper_1 = require("../../../../../helper/paginatedResponseHelper");
 class High5WebhookLog extends Base_1.default {
     /**

package/lib/service/high5/stat/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.High5OrgStat = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 class High5OrgStat extends Base_1.default {
     /**
      * Retrieves usage statistics for a specific organization.

package/lib/service/high5/wave/index.js

@@ -1,7 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.High5Wave = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 const s3_1 = require("./s3");
 class High5Wave extends Base_1.default {
     constructor(options, axios) {

package/lib/service/high5/wave/s3/index.js

@@ -8,11 +8,14 @@ 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.S3 = void 0;
-const axios_1 = require("axios");
+const axios_1 = __importDefault(require("axios"));
 const package_json_1 = require("../../../../../package.json");
-const Base_1 = require("../../../../Base");
+const Base_1 = __importDefault(require("../../../../Base"));
 const axios_2 = require("../../../../interfaces/axios");
 const sdkVersion = "hcloud-sdk-js/v" + package_json_1.version;
 /**

package/lib/service/idp/guest/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.IdpGuest = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 class IdpGuest extends Base_1.default {
     /**
      * Creates a new guest user account.

package/lib/service/idp/index.js

@@ -8,8 +8,11 @@ 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 });
-const Base_1 = require("../../Base");
+const Base_1 = __importDefault(require("../../Base"));
 const guest_1 = require("./guest");
 const internal_1 = require("./internal");
 const oauth_1 = require("./oauth");

package/lib/service/idp/internal/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.IdpInternal = void 0;
-const Base_1 = require("../../../Base");
+const Base_1 = __importDefault(require("../../../Base"));
 class IdpInternal extends Base_1.default {
     /**
      * Creates an agent user for an organization.

package/lib/service/idp/oauth/device.d.ts

@@ -0,0 +1,131 @@
+import Base, { MaybeRaw } from "../../../Base";
+import { OAuthAppPublicInfo, Scope } from "../../../interfaces/idp";
+import { OAuthDeviceAuthorizationResponse, OAuthDeviceTokenResponse } from "../../../interfaces/idp/oauth/device";
+/**
+ * IdpOAuthDevice
+ *
+ * Client wrapper for OAuth 2.0 Device Authorization Grant (RFC 8628).
+ *
+ * This class provides methods to:
+ * - Initiate a device authorization request
+ * - Validate a user-provided code
+ * - Approve or reject a device authorization
+ * - Exchange a device code for an access token
+ *
+ * All methods support returning either the parsed response body or the raw Axios
+ * response via the `{ raw: true }` option.
+ *
+ * @extends Base
+ */
+export default class IdpOAuthDevice extends Base {
+    /**
+     * Initiates the OAuth Device Authorization flow.
+     *
+     * This endpoint returns a `device_code` and `user_code` which should be:
+     * - Displayed to the user on the device
+     * - Entered by the user on a separate verification page
+     *
+     * @typeParam R - Whether to return the raw Axios response
+     *
+     * @param clientId - OAuth client identifier
+     * @param scope - Optional OAuth scope string (space-delimited)
+     * @param raw - Optional flag to return the raw Axios response
+     *
+     * @returns Device authorization response or raw Axios response
+     */
+    authorize<R extends boolean = false>(clientId: string, scope?: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, OAuthDeviceAuthorizationResponse>>;
+    /**
+     * Validates a user-entered device code.
+     *
+     * This is typically called by the authorization UI after the user enters
+     * the `user_code`. It returns public information about the requesting
+     * application and the requested scopes.
+     *
+     * @typeParam R - Whether to return the raw Axios response
+     *
+     * @param clientId - OAuth client identifier
+     * @param userCode - User-facing verification code
+     * @param raw - Optional flag to return the raw Axios response
+     *
+     * @returns Application public info and requested scopes
+     */
+    validateUserCode<R extends boolean = false>(clientId: string, userCode: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, {
+        app: OAuthAppPublicInfo;
+        scopes: Scope[];
+    }>>;
+    /**
+     * Approves or rejects a device authorization request.
+     *
+     * ⚠️ This endpoint requires an `Authorization` header to be set
+     * on the HCloud instance (e.g., a logged-in user session or access token).
+     *
+     * @typeParam R - Whether to return the raw Axios response
+     *
+     * @param clientId - OAuth client identifier
+     * @param userCode - User-facing verification code
+     * @param status - Authorization decision (`APPROVED` or `REJECTED`)
+     * @param raw - Optional flag to return the raw Axios response
+     *
+     * @throws Error if the Authorization header is not set
+     *
+     * @returns Void response or raw Axios response
+     */
+    decide<R extends boolean = false>(clientId: string, userCode: string, status: "APPROVED" | "REJECTED", raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    /**
+     * Approves a device authorization request.
+     *
+     * Shorthand for {@link decide} with status `"APPROVED"`.
+     *
+     * @typeParam R - Whether to return the raw Axios response
+     *
+     * @param clientId - OAuth client identifier
+     * @param userCode - User-facing verification code
+     * @param raw - Optional flag to return the raw Axios response
+     *
+     * @returns Void response or raw Axios response
+     */
+    approve<R extends boolean = false>(clientId: string, userCode: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    /**
+     * Rejects a device authorization request.
+     *
+     * Shorthand for {@link decide} with status `"REJECTED"`.
+     *
+     * @typeParam R - Whether to return the raw Axios response
+     *
+     * @param clientId - OAuth client identifier
+     * @param userCode - User-facing verification code
+     * @param raw - Optional flag to return the raw Axios response
+     *
+     * @returns Void response or raw Axios response
+     */
+    reject<R extends boolean = false>(clientId: string, userCode: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, void>>;
+    /**
+     * Exchanges a device code for an access token.
+     *
+     * This endpoint may return HTTP 400 responses for non-fatal OAuth states
+     * such as `authorization_pending` or `slow_down`. These responses are
+     * returned normally and should be handled by the caller.
+     *
+     * @typeParam R - Whether to return the raw Axios response
+     *
+     * @param clientId - OAuth client identifier
+     * @param deviceCode - Device code obtained from {@link authorize}
+     * @param raw - Optional flag to return the raw Axios response
+     *
+     * @returns Device token response or raw Axios response
+     */
+    token<R extends boolean = false>(clientId: string, deviceCode: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, OAuthDeviceTokenResponse>>;
+    protected getEndpoint(endpoint: string): string;
+}