hcloud-sdk 22.48.0 → 22.49.0

package/changelog.md

@@ -1,5 +1,11 @@
-## [22.48.0](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/compare/v22.47.0...v22.48.0) (2026-10-05)
+## [22.49.0](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/compare/v22.48.0...v22.49.0) (2026-10-07)
 
 ### Features
 
-* reflect changes made in high5 ([af4a2a1](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/af4a2a1a89937f24f72b5e163d099b1fc0c6a1de))
+* add a capacityInGB quota for default storage as well ([3b4ae0c](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/3b4ae0cf85bb1a85e5ba8d070c805ff216196169))
+* add capacityInGB which reflects license quota as max usable capacity ([75a1dea](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/75a1dea437d657eacd967abaad9ae3e5688bd468))
+* reflect new introduced byos license endpoint and interfaces ([efcb701](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/efcb701645e1e0f06800ba8e7c13c117d547c444))
+
+### Bug Fixes
+
+* default license quota determination and application ([e228077](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/e2280774fec9b1a4969743b8c70ded3e307625fd))

package/lib/interfaces/global/Storage.d.ts

@@ -17,7 +17,13 @@ export type Storage = {
     spaces: (ReducedSpace & {
         storageUsed: number;
     })[];
+    /** Total bytes used across all spaces assigned to this storage. For the default storage only the spaces of the requesting organization. */
     storageUsed: number;
+    /**
+     * Licensed maximum capacity in GB (1 GB = 1024³ bytes). For the default storage the default storage quota of the organization.
+     * For own storages the storages quota of the organization, shared across all of its own storages (0 if own storages are not allowed).
+     */
+    capacityInGB: number;
     valid: boolean;
     errorMessage?: string;
 };
@@ -32,6 +38,21 @@ export type StorageConfiguration = {
     isDefault: boolean;
     valid: boolean;
 };
+export type StorageCapacity = {
+    storageId: string;
+    /** Organization the capacity was determined for. For own storages the owner, for the default storage the requested organization. */
+    organizationId: string;
+    /** Whether the storage is the default storage */
+    isDefault: boolean;
+    /** Whether the license of the organization allows own storages */
+    byos: boolean;
+    /** Licensed capacity in bytes. For own storages across all own storages of the organization, for the default storage the default storage quota of the organization. */
+    capacityBytes?: number;
+    /** Current usage in bytes. For own storages across all own storages of the organization, for the default storage by the spaces of the organization. */
+    usedBytes?: number;
+    /** Whether an upload of the requested size would exceed the licensed capacity */
+    exceeded: boolean;
+};
 export type StorageDto = Omit<Storage, "accessKeyId" | "secretAccessKey">;
 export type StorageCreateDto = Pick<Storage, "name" | "endpoint" | "bucket" | "region"> & {
     accessKeyId: string;

package/lib/interfaces/idp/organization/license/index.d.ts

@@ -24,6 +24,17 @@ type LicenseQuotaBase = {
             domains: {
                 quota: number;
             };
+            /** Bring your own storage quota. Absent on older licenses, in which case own storages are not allowed. */
+            storages?: {
+                byos: boolean;
+                quota: number;
+                capacityInGB: number;
+            };
+            /** Default (hcloud provided) storage quota. Absent on older licenses, in which case a capacity of 1 GB applies. */
+            defaultStorage?: {
+                /** Maximum usage of the default storage in GB (1 GB = 1024³ bytes). */
+                capacityInGB: number;
+            };
             logPeriodInDays: number;
         };
     };

package/lib/service/idp/organization/storage/index.d.ts

@@ -1,6 +1,6 @@
 import Base, { MaybeRaw } from "../../../../Base";
 import { PaginatedResponse, SearchFilter, Sorting } from "../../../../interfaces/global";
-import { StorageDto as Storage, StorageConfiguration, StorageCreateDto, StoragePatchDto } from "../../../../interfaces/global/Storage";
+import { StorageDto as Storage, StorageCapacity, StorageConfiguration, StorageCreateDto, StoragePatchDto } from "../../../../interfaces/global/Storage";
 export declare class IdpOrganizationStorages extends Base {
     /**
      * Creates a new Storage in the specified Organization.
@@ -82,5 +82,20 @@ export declare class IdpOrganizationStorages extends Base {
     getStorageConfig<R extends boolean = false>(pat: string, storageId?: string, decrypt?: boolean, raw?: {
         raw: R;
     }): Promise<MaybeRaw<R, StorageConfiguration>>;
+    /**
+     * Checks whether the specified Storage can take an upload of the given size according to the license of an Organization.
+     * Own Storages are limited by the storages quota of the owning Organization, the default Storage by the default storage quota
+     * of the given Organization (counting only its Spaces). Requires a Personal Access Token (PAT) with appropriate permissions.
+     *
+     * @param pat Personal Access Token
+     * @param storageId (optional) ID of storage. If not provided or "default", the default storage is checked.
+     * @param uploadSize (optional) Size of the upload that is about to start in bytes. If omitted, it is checked whether the capacity is already reached.
+     * @param orgName (optional) Name of the Organization the upload belongs to. Required for the default storage, must be the owner for own storages.
+     * @param raw (optional) If true, returns the raw Axios response instead of the data
+     * @returns The Storage capacity
+     */
+    getStorageCapacity<R extends boolean = false>(pat: string, storageId?: string, uploadSize?: number, orgName?: string, raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, StorageCapacity>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/idp/organization/storage/index.js

@@ -129,6 +129,30 @@ class IdpOrganizationStorages extends Base_1.default {
             return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
         });
     }
+    /**
+     * Checks whether the specified Storage can take an upload of the given size according to the license of an Organization.
+     * Own Storages are limited by the storages quota of the owning Organization, the default Storage by the default storage quota
+     * of the given Organization (counting only its Spaces). Requires a Personal Access Token (PAT) with appropriate permissions.
+     *
+     * @param pat Personal Access Token
+     * @param storageId (optional) ID of storage. If not provided or "default", the default storage is checked.
+     * @param uploadSize (optional) Size of the upload that is about to start in bytes. If omitted, it is checked whether the capacity is already reached.
+     * @param orgName (optional) Name of the Organization the upload belongs to. Required for the default storage, must be the owner for own storages.
+     * @param raw (optional) If true, returns the raw Axios response instead of the data
+     * @returns The Storage capacity
+     */
+    getStorageCapacity(pat_1) {
+        return __awaiter(this, arguments, void 0, function* (pat, storageId = "default", uploadSize, orgName, raw) {
+            const resp = yield this.axios.get(`${this.options.server}/api/account/v1/storage/${storageId}/capacity`, {
+                params: Object.assign(Object.assign({}, (uploadSize !== undefined ? { uploadSize } : {})), (orgName !== undefined ? { orgName } : {})),
+                headers: {
+                    Authorization: `Bearer ${pat}`,
+                    "x-hcloud-login-enforce": "true",
+                },
+            });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
     getEndpoint(endpoint) {
         return `${this.options.server}/api/account/v1/org${endpoint}`;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hcloud-sdk",
-  "version": "22.48.0",
+  "version": "22.49.0",
   "description": "hcloud platform sdk",
   "main": "index.js",
   "types": "index.d.ts",