hcloud-sdk 19.3.0 → 20.4.0

package/changelog.md

@@ -1,5 +1,5 @@
-## [19.3.0](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/compare/v19.2.1...v19.3.0) (2026-05-12)
+## [20.4.0](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/compare/v20.3.0...v20.4.0) (2026-06-11)
 
 ### Features
 
-* new public version ([d33d2c1](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/d33d2c1f48e1e0aa3e1559d730dea1802e112fd9))
+* add panel service ([d92886d](https://github.com/moovit-sp-gmbh/hcloud-sdk-js/commit/d92886d338d3992fe08b815e6193ab56152afb3f))

package/lib/Base.d.ts

@@ -16,6 +16,9 @@ export interface Options {
     agent?: {
         server: string;
     };
+    panel?: {
+        server: string;
+    };
     logger?: HcloudLogger;
 }
 export default abstract class Base {

package/lib/Hcloud.d.ts

@@ -11,6 +11,7 @@ import IdpService from "./service/idp";
 import MailerService from "./service/mailer";
 import MothershipService from "./service/mothership";
 import NatsService from "./service/nats";
+import PanelService from "./service/panel";
 import ShortsService from "./service/shorts";
 export declare class HCloud {
     get Agent(): AgentService;
@@ -29,6 +30,8 @@ export declare class HCloud {
     private _Dali?;
     get Mailer(): MailerService;
     private _Mailer?;
+    get Panels(): PanelService;
+    private _Panels?;
     get Mothership(): MothershipService;
     private _Mothership?;
     get Shorts(): ShortsService;

package/lib/Hcloud.js

@@ -28,6 +28,7 @@ const idp_2 = __importDefault(require("./service/idp"));
 const mailer_1 = __importDefault(require("./service/mailer"));
 const mothership_1 = __importDefault(require("./service/mothership"));
 const nats_1 = __importDefault(require("./service/nats"));
+const panel_1 = __importDefault(require("./service/panel"));
 const shorts_1 = __importDefault(require("./service/shorts"));
 // tslint:disable-next-line
 class HCloud {
@@ -79,6 +80,12 @@ class HCloud {
         }
         return this._Mailer;
     }
+    get Panels() {
+        if (this._Panels === undefined) {
+            this._Panels = new panel_1.default(this.options, this.axios);
+        }
+        return this._Panels;
+    }
     get Mothership() {
         if (this._Mothership === undefined) {
             this._Mothership = new mothership_1.default(this.options, this.axios);

package/lib/interfaces/cosmo/asset/index.d.ts

@@ -16,6 +16,8 @@ export interface BaseAsset {
     space: ReducedSpace;
     permissions?: string[];
     breadcrumb?: (Asset | CosmoSpace)[];
+    purgeAt?: number;
+    deletedAt?: number;
 }
 export type Asset = BaseAsset & ({
     type: ItemType.MEDIA_ASSET;

package/lib/interfaces/cosmo/comment/index.d.ts

@@ -1,4 +1,5 @@
 import { ReducedTeam, ReducedUser } from "../../idp";
+type Primitive = string | number | boolean;
 export interface CreateComment {
     refId: string;
     text: string;
@@ -6,7 +7,7 @@ export interface CreateComment {
     annotation?: string;
     mentions?: string[];
     mentionsTeams?: string[];
-    visibility?: CommentVisibility;
+    metadata?: Record<string, Primitive | Primitive[]>;
 }
 export interface EditComment {
     text: string;
@@ -15,7 +16,7 @@ export interface EditComment {
     mentions?: string[];
     mentionsTeams?: string[];
     completed?: boolean;
-    visibility?: CommentVisibility;
+    metadata?: Record<string, Primitive | Primitive[]>;
 }
 export declare enum CommentType {
     COMMENT = "COMMENT",
@@ -31,10 +32,6 @@ export declare enum CommentSortDirection {
     ASC = "ASC",
     DESC = "DESC"
 }
-export declare enum CommentVisibility {
-    INTERNAL = "internal",
-    EXTERNAL = "external"
-}
 export interface Comment {
     _id: string;
     text: string;
@@ -50,7 +47,7 @@ export interface Comment {
     completed: boolean;
     completedBy?: ReducedUser;
     completedAt?: number;
-    visibility?: CommentVisibility;
+    metadata?: Record<string, Primitive | Primitive[]>;
 }
 export interface Reply extends Omit<Comment, "timestamp" | "replies"> {
     commentRef: string;
@@ -60,3 +57,4 @@ export interface Timestamp {
     out: number;
     color: string;
 }
+export {};

package/lib/interfaces/cosmo/comment/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommentVisibility = exports.CommentSortDirection = exports.CommentSortField = exports.CommentType = void 0;
+exports.CommentSortDirection = exports.CommentSortField = exports.CommentType = void 0;
 var CommentType;
 (function (CommentType) {
     CommentType["COMMENT"] = "COMMENT";
@@ -18,8 +18,3 @@ var CommentSortDirection;
     CommentSortDirection["ASC"] = "ASC";
     CommentSortDirection["DESC"] = "DESC";
 })(CommentSortDirection || (exports.CommentSortDirection = CommentSortDirection = {}));
-var CommentVisibility;
-(function (CommentVisibility) {
-    CommentVisibility["INTERNAL"] = "internal";
-    CommentVisibility["EXTERNAL"] = "external";
-})(CommentVisibility || (exports.CommentVisibility = CommentVisibility = {}));

package/lib/interfaces/cosmo/share/index.d.ts

@@ -13,6 +13,7 @@ export interface PublicLink {
  * Represents a share entity containing shared items and permissions.
  * @property _id - Unique identifier for the share.
  * @property name - Name of the share.
+ * @property active - Whether the share is currently active.
  * @property creator - The user who created the share.
  * @property createDate - Timestamp of when the share was created (in milliseconds since epoch).
  * @property items - Array of item IDs included in the share.
@@ -27,6 +28,7 @@ export interface PublicLink {
 export interface Share {
     _id: string;
     name: string;
+    active: boolean;
     creator: ReducedUser;
     createDate: number;
     items?: ({
@@ -91,7 +93,7 @@ export type ShareWithUsers = Share & {
  * @property public - (Optional) Whether the share is public.
  * @property visitsLimit - (Optional) New maximum number of allowed visits (only applicable for public shares).
  */
-export type SharePatch = Partial<Pick<ShareCreate, "name" | "users"> & {
+export type SharePatch = Partial<Pick<ShareCreate, "name" | "users" | "active"> & {
     items: string[];
     permissions?: string[];
     assetPermissionGroups?: ShareAssetPermissionGroup[];

package/lib/interfaces/idp/oauth/index.d.ts

@@ -31,3 +31,21 @@ export declare enum GrantType {
     AUTHORIZATION_CODE = "authorization_code",
     REFRESH_TOKEN = "refresh_token"
 }
+export interface OAuthMetadata {
+    issuer: string;
+    authorization_endpoint: string;
+    token_endpoint: string;
+    device_authorization_endpoint: string;
+    device_token_endpoint: string;
+    jwks_uri?: string;
+    userinfo_endpoint?: string;
+    http_logout_supported: boolean;
+    end_session_endpoint?: string;
+    scopes_supported: Scope[];
+    response_types_supported: string[];
+    grant_types_supported: string[];
+    token_endpoint_auth_methods_supported: string[];
+    token_endpoint_auth_signing_alg_values_supported: string[];
+    service_documentation: string[];
+    ui_locales_supported: string[];
+}

package/lib/interfaces/panel/index.d.ts

@@ -0,0 +1,13 @@
+export interface PanelVersions {
+    latestDev: string;
+    latest: string;
+    versions: Record<string, PanelVersion[]>;
+}
+export interface PanelVersion {
+    path: string;
+    published_date: number;
+    version: string;
+    arch: string;
+    os: string;
+    dev: boolean;
+}

package/lib/interfaces/panel/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -122,7 +122,7 @@ export declare class CosmoSpace extends Base {
      * Updates the trashbin auto-delete policy for the specified Cosmo space.
      * @param orgName Name of the organization
      * @param spaceName Name of the space
-     * @param policy Trash policy to apply. When `enabled` is `true`, `ttlDays` (1–365) must be provided. When `enabled` is `false`, `ttlDays` must be omitted.
+     * @param policy Trash policy to apply. If enabled, items in the trash will be automatically deleted after the specified TTL (in days).
      * @returns The updated Space
      */
     updateTrashbinPolicy<R extends boolean = false>(orgName: string, spaceName: string, policy: TrashPolicy, raw?: {

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

@@ -177,7 +177,7 @@ class CosmoSpace extends Base_1.default {
      * Updates the trashbin auto-delete policy for the specified Cosmo space.
      * @param orgName Name of the organization
      * @param spaceName Name of the space
-     * @param policy Trash policy to apply. When `enabled` is `true`, `ttlDays` (1–365) must be provided. When `enabled` is `false`, `ttlDays` must be omitted.
+     * @param policy Trash policy to apply. If enabled, items in the trash will be automatically deleted after the specified TTL (in days).
      * @returns The updated Space
      */
     updateTrashbinPolicy(orgName, spaceName, policy, raw) {

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

@@ -1,5 +1,5 @@
 import Base, { MaybeRaw } from "../../../Base";
-import { OAuthToken, OAuthTokenRequest } from "../../../interfaces/idp/oauth";
+import { OAuthMetadata, OAuthToken, OAuthTokenRequest } from "../../../interfaces/idp/oauth";
 import { OAuthAppPublicInfo } from "../../../interfaces/idp/organization/settings/oauthApp";
 import IdpOAuthDevice from "./device";
 export declare class IdpOAuth extends Base {
@@ -58,5 +58,13 @@ export declare class IdpOAuth extends Base {
     getOAuthAppInfo<R extends boolean = false>(clientId: string, raw?: {
         raw: R;
     }): Promise<MaybeRaw<R, OAuthAppPublicInfo>>;
+    /**
+     * Retrieves the OAuth 2.0 authorization server metadata
+     * This method enables dynamic discovery of endpoint locations and server capabilities as defined in RFC 8414
+     * @returns Authorization server metadata
+     */
+    getMetadata<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, OAuthMetadata>>;
     protected getEndpoint(endpoint: string): string;
 }

package/lib/service/idp/oauth/index.js

@@ -119,6 +119,17 @@ class IdpOAuth extends Base_1.default {
             return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? response : response.data);
         });
     }
+    /**
+     * Retrieves the OAuth 2.0 authorization server metadata
+     * This method enables dynamic discovery of endpoint locations and server capabilities as defined in RFC 8414
+     * @returns Authorization server metadata
+     */
+    getMetadata(raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.axios.get(this.getEndpoint("/v1/.well-known/oauth-authorization-server"));
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? response : response.data);
+        });
+    }
     getEndpoint(endpoint) {
         return `${this.options.server}/api/account${endpoint}`;
     }

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

@@ -0,0 +1,11 @@
+import { AxiosInstance } from "axios";
+import Base, { MaybeRaw, Options } from "../../Base";
+import { PanelVersions } from "../../interfaces/panel";
+export default class PanelService extends Base {
+    private sourceServer;
+    constructor(options: Options, axios: AxiosInstance);
+    getVersions<R extends boolean = false>(raw?: {
+        raw: R;
+    }): Promise<MaybeRaw<R, PanelVersions>>;
+    protected getEndpoint(endpoint: string): string;
+}

package/lib/service/panel/index.js

@@ -0,0 +1,33 @@
+"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 });
+const Base_1 = __importDefault(require("../../Base"));
+const axios_1 = require("../../interfaces/axios");
+class PanelService extends Base_1.default {
+    constructor(options, axios) {
+        var _a;
+        super(options, axios);
+        this.sourceServer = ((_a = options.panel) === null || _a === void 0 ? void 0 : _a.server) || "https://cosmo-panel.s3.helmut.cloud";
+    }
+    getVersions(raw) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const resp = yield this.axios.get(this.getEndpoint("/index.json"), { headers: axios_1.disableCacheHeaders });
+            return ((raw === null || raw === void 0 ? void 0 : raw.raw) ? resp : resp.data);
+        });
+    }
+    getEndpoint(endpoint) {
+        return this.sourceServer + endpoint;
+    }
+}
+exports.default = PanelService;

package/package.json

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