@hahnpro/hpc-api 2026.9.12 → 2026.10.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hahnpro/hpc-api",
-  "version": "2026.9.12",
+  "version": "2026.10.1",
   "description": "Module for easy access to the HahnPRO Cloud API",
   "license": "MIT",
   "author": {

package/src/lib/interfaces/authz/capability-bundle-capability.interface.d.ts

@@ -1,5 +1,5 @@
 import type { Audited } from './audited.interface';
-import { CapabilityBundleId } from './capability-bundle.interface';
+import type { CapabilityBundleId } from './capability-bundle.interface';
 import type { CapabilityId } from './capability.interface';
 export interface CreateCapabilityBundleCapability {
     capabilityBundleId: CapabilityBundleId;

package/src/lib/interfaces/authz/feature-capability.interface.d.ts

@@ -1,6 +1,6 @@
 import type { Audited } from './audited.interface';
 import type { CapabilityId } from './capability.interface';
-import { FeatureId } from './feature.interface';
+import type { FeatureId } from './feature.interface';
 export interface CreateFeatureCapability {
     featureId: FeatureId;
     capabilityId: CapabilityId;

package/src/lib/interfaces/authz/feature.interface.d.ts

@@ -1,4 +1,5 @@
 import type { Audited } from './audited.interface';
+import type { CapabilityBundle } from './capability-bundle.interface';
 import type { LocalizedText, LocalizedTextPatch } from './localized-text.interface';
 export declare enum FeatureId {
     ALERTS = "alerts",
@@ -39,3 +40,6 @@ export interface Feature extends Audited<string>, Omit<CreateFeature, 'id' | 'de
     readonly id: FeatureId;
     description: LocalizedText | null;
 }
+export interface FeatureWithCapabilityBundles extends Feature {
+    capabilityBundles: CapabilityBundle[];
+}

package/src/lib/interfaces/authz/index.d.ts

@@ -4,14 +4,14 @@ export type { CreateCapabilityBundle, UpdateCapabilityBundle, CapabilityBundle }
 export type { CreateCapabilityBundleCapability, CapabilityBundleCapability } from './capability-bundle-capability.interface';
 export type { CreateCapability, UpdateCapability, Capability } from './capability.interface';
 export type { CreateOrgGroup, UpdateOrgGroup, OrgGroup } from './org-group.interface';
-export type { CreateFeature, UpdateFeature, Feature } from './feature.interface';
+export type { CreateFeature, UpdateFeature, Feature, FeatureWithCapabilityBundles } from './feature.interface';
 export type { CreateFeatureCapability, FeatureCapability } from './feature-capability.interface';
 export type { CreateOrgGroupCapability, OrgGroupCapability } from './org-group-capability.interface';
 export type { CreateOrgGroupCapabilityBundle, OrgGroupCapabilityBundle } from './org-group-capability-bundle.interface';
 export type { CreateOrgGroupMember, OrgGroupMember } from './org-group-member.interface';
 export type { CreateOrgSubscription, UpdateOrgSubscription, OrgSubscription } from './org-subscription.interface';
 export type { SqlPagination, SqlPaginationResult } from './sql-pagination.interface';
-export type { CreatePlan, UpdatePlan, Plan as AuthzPlan } from './plan.interface';
+export type { CreatePlan, UpdatePlan, Plan as AuthzPlan, PlanWithFeaturesAndCapabilityBundles } from './plan.interface';
 export type { CreatePlanFeature, PlanFeature } from './plan-feature.interface';
 export type { CreateServiceAccountCapability, ServiceAccountCapability } from './service-account-capability.interface';
 export type { CreateServiceAccountCapabilityBundle, ServiceAccountCapabilityBundle } from './service-account-capability-bundle.interface';

package/src/lib/interfaces/authz/org-group-capability-bundle.interface.d.ts

@@ -1,5 +1,5 @@
 import type { Audited } from './audited.interface';
-import { CapabilityBundleId } from './capability-bundle.interface';
+import type { CapabilityBundleId } from './capability-bundle.interface';
 export interface CreateOrgGroupCapabilityBundle {
     orgGroupId: string;
     capabilityBundleId: CapabilityBundleId;

package/src/lib/interfaces/authz/org-subscription.interface.d.ts

@@ -1,5 +1,5 @@
 import type { Audited } from './audited.interface';
-import { PlanId } from './plan.interface';
+import type { PlanId } from './plan.interface';
 export declare enum OrgSubscriptionStatus {
     ACTIVE = "active",
     CANCELLED = "cancelled"

package/src/lib/interfaces/authz/plan-feature.interface.d.ts

@@ -1,6 +1,6 @@
 import type { Audited } from './audited.interface';
-import { FeatureId } from './feature.interface';
-import { PlanId } from './plan.interface';
+import type { FeatureId } from './feature.interface';
+import type { PlanId } from './plan.interface';
 export interface CreatePlanFeature {
     planId: PlanId;
     featureId: FeatureId;

package/src/lib/interfaces/authz/plan.interface.d.ts

@@ -1,4 +1,5 @@
 import type { Audited } from './audited.interface';
+import type { FeatureWithCapabilityBundles } from './feature.interface';
 import type { LocalizedText, LocalizedTextPatch } from './localized-text.interface';
 export declare enum PlanId {
     DEFAULT = "default",
@@ -22,3 +23,6 @@ export interface Plan extends Audited<string>, Omit<CreatePlan, 'id' | 'descript
     readonly id: PlanId;
     description: LocalizedText | null;
 }
+export interface PlanWithFeaturesAndCapabilityBundles extends Plan {
+    features: FeatureWithCapabilityBundles[];
+}

package/src/lib/interfaces/authz/service-account-capability-bundle.interface.d.ts

@@ -1,5 +1,5 @@
 import type { Audited } from './audited.interface';
-import { CapabilityBundleId } from './capability-bundle.interface';
+import type { CapabilityBundleId } from './capability-bundle.interface';
 export interface CreateServiceAccountCapabilityBundle {
     serviceAccountId: string;
     capabilityBundleId: CapabilityBundleId;

package/src/lib/interfaces/knowledge.interface.d.ts

@@ -140,3 +140,13 @@ export interface KnowledgeRevision {
         state: KnowledgePage['state'];
     };
 }
+export interface KnowledgeRevisionSummary {
+    revision: number;
+    title: string;
+    updatedBy: Author;
+    updatedAt: string;
+}
+export interface KnowledgeRevisionList {
+    docs: KnowledgeRevisionSummary[];
+    nextCursor?: string;
+}

package/src/lib/mock/authz/authz.mock.service.d.ts

@@ -5,6 +5,7 @@ import { OrgGroupCapabilityService } from '../../services/authz/org-group-capabi
 import { OrgGroupMemberService } from '../../services/authz/org-group-member.service';
 import { OrgGroupService } from '../../services/authz/org-group.service';
 import { OrgSubscriptionService } from '../../services/authz/org-subscription.service';
+import { PlansService } from '../../services/authz/plans.service';
 import { APIBaseMock } from '../api-base.mock';
 export declare class AuthzMockService extends APIBaseMock<never> implements AuthzService {
     readonly authorization: AuthorizationService;
@@ -13,5 +14,6 @@ export declare class AuthzMockService extends APIBaseMock<never> implements Auth
     readonly orgGroupCapabilityBundles: OrgGroupCapabilityBundleService;
     readonly orgGroupMembers: OrgGroupMemberService;
     readonly orgSubscriptions: OrgSubscriptionService;
+    readonly plans: PlansService;
     constructor();
 }

package/src/lib/mock/authz/authz.mock.service.js

@@ -8,6 +8,7 @@ const org_group_capability_mock_service_1 = require("./org-group-capability.mock
 const org_group_member_mock_service_1 = require("./org-group-member.mock.service");
 const org_group_mock_service_1 = require("./org-group.mock.service");
 const org_subscription_mock_service_1 = require("./org-subscription.mock.service");
+const plans_mock_service_1 = require("./plans.mock.service");
 class AuthzMockService extends api_base_mock_1.APIBaseMock {
     constructor() {
         super(null);
@@ -17,6 +18,7 @@ class AuthzMockService extends api_base_mock_1.APIBaseMock {
         this.orgGroupCapabilityBundles = new org_group_capability_bundle_mock_service_1.OrgGroupCapabilityBundleMockService();
         this.orgGroupMembers = new org_group_member_mock_service_1.OrgGroupMemberMockService();
         this.orgSubscriptions = new org_subscription_mock_service_1.OrgSubscriptionMockService();
+        this.plans = new plans_mock_service_1.PlansMockService();
     }
 }
 exports.AuthzMockService = AuthzMockService;

package/src/lib/mock/authz/plans.mock.service.d.ts

@@ -0,0 +1,8 @@
+import { APIBaseMock } from '../../mock/api-base.mock';
+import { PlansService } from '../../services/authz/plans.service';
+export declare class PlansMockService extends APIBaseMock<never> implements PlansService {
+    constructor();
+    getPlans(..._args: Parameters<PlansService['getPlans']>): ReturnType<PlansService['getPlans']>;
+    getPlanById(..._args: Parameters<PlansService['getPlanById']>): ReturnType<PlansService['getPlanById']>;
+    getPlanDetailsById(..._args: Parameters<PlansService['getPlanDetailsById']>): ReturnType<PlansService['getPlanDetailsById']>;
+}

package/src/lib/mock/authz/plans.mock.service.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlansMockService = void 0;
+const api_base_mock_1 = require("../../mock/api-base.mock");
+class PlansMockService extends api_base_mock_1.APIBaseMock {
+    constructor() {
+        super(null);
+    }
+    getPlans(..._args) {
+        throw new Error('Method not implemented.');
+    }
+    getPlanById(..._args) {
+        throw new Error('Method not implemented.');
+    }
+    getPlanDetailsById(..._args) {
+        throw new Error('Method not implemented.');
+    }
+}
+exports.PlansMockService = PlansMockService;

package/src/lib/mock/knowledge.mock.service.d.ts

@@ -1,4 +1,4 @@
-import { type ConfirmKnowledge, type CreateKnowledge, type KnowledgeBacklinkQuery, type KnowledgeBatch, type KnowledgeHome, type KnowledgeList, type KnowledgePage, type KnowledgeQuery, type KnowledgeRevision, type KnowledgeVersion, type UpdateKnowledge } from '../interfaces';
+import { type ConfirmKnowledge, type CreateKnowledge, type KnowledgeBacklinkQuery, type KnowledgeBatch, type KnowledgeHome, type KnowledgeList, type KnowledgePage, type KnowledgeQuery, type KnowledgeRevision, type KnowledgeRevisionList, type KnowledgeVersion, type UpdateKnowledge } from '../interfaces';
 import { KnowledgeService } from '../services/knowledge.service';
 export declare class KnowledgeMockService extends KnowledgeService {
     data: KnowledgePage[];
@@ -15,6 +15,7 @@ export declare class KnowledgeMockService extends KnowledgeService {
     getHome(query?: KnowledgeQuery): Promise<KnowledgeHome>;
     getBacklinks(query: KnowledgeBacklinkQuery): Promise<KnowledgeList>;
     getRelated(id: string, query?: Pick<KnowledgeQuery, 'cursor' | 'limit'>): Promise<KnowledgeList>;
+    getRevisions(id: string, query?: Pick<KnowledgeQuery, 'cursor' | 'limit'>): Promise<KnowledgeRevisionList>;
     getRevision(id: string, revision: number): Promise<KnowledgeRevision>;
     readBatch(ids: string[]): Promise<KnowledgeBatch>;
     private check;

package/src/lib/mock/knowledge.mock.service.js

@@ -90,6 +90,20 @@ class KnowledgeMockService extends knowledge_service_1.KnowledgeService {
             (outgoing.includes(item.id) ||
                 item.links.some((link) => link.target.resourceType === interfaces_1.ResourceType.KNOWLEDGE && link.target.id === id))), query);
     }
+    async getRevisions(id, query = {}) {
+        const current = this.page(id);
+        const before = query.cursor ? Number(query.cursor) : current.revision + 1;
+        const limit = query.limit || 20;
+        const docs = [];
+        for (let revision = before - 1; revision >= 1 && docs.length < limit; revision--) {
+            const page = this.revisions.get(`${id}:${revision}`);
+            if (page) {
+                docs.push({ revision, title: page.title, updatedBy: structuredClone(page.updatedBy), updatedAt: page.updatedAt });
+            }
+        }
+        const last = docs[docs.length - 1]?.revision ?? 1;
+        return { docs, ...(last > 1 ? { nextCursor: String(last) } : {}) };
+    }
     async getRevision(id, revision) {
         const current = this.page(id);
         const page = this.revisions.get(`${id}:${revision}`);
@@ -131,6 +145,7 @@ class KnowledgeMockService extends knowledge_service_1.KnowledgeService {
         if (staleAfter !== undefined) {
             page.staleAfter = staleAfter || undefined;
         }
+        page.updatedAt = new Date().toISOString();
         if (this.content(page) !== before) {
             page.revision++;
             this.remember(page);

package/src/lib/services/authz/authorization.service.d.ts

@@ -1,6 +1,5 @@
 import { APIBase } from '../../api-base';
-import { CapabilityId, Permission, TokenOption } from '../../interfaces';
-import type { Capability, CapabilityBundle, SqlPagination } from '../../interfaces/authz';
+import type { Capability, CapabilityBundle, CapabilityId, Permission, SqlPagination, TokenOption } from '../../interfaces';
 import { HttpClientService } from '../http-client.service';
 export declare class AuthorizationService extends APIBase {
     constructor(httpClient: HttpClientService);

package/src/lib/services/authz/authz.service.d.ts

@@ -6,6 +6,7 @@ import { OrgGroupCapabilityService } from './org-group-capability.service';
 import { OrgGroupMemberService } from './org-group-member.service';
 import { OrgGroupService } from './org-group.service';
 import { OrgSubscriptionService } from './org-subscription.service';
+import { PlansService } from './plans.service';
 export declare class AuthzService extends APIBase {
     readonly authorization: AuthorizationService;
     readonly orgGroups: OrgGroupService;
@@ -13,5 +14,6 @@ export declare class AuthzService extends APIBase {
     readonly orgGroupCapabilityBundles: OrgGroupCapabilityBundleService;
     readonly orgGroupMembers: OrgGroupMemberService;
     readonly orgSubscriptions: OrgSubscriptionService;
+    readonly plans: PlansService;
     constructor(httpClient: HttpClientService);
 }

package/src/lib/services/authz/authz.service.js

@@ -8,6 +8,7 @@ const org_group_capability_service_1 = require("./org-group-capability.service")
 const org_group_member_service_1 = require("./org-group-member.service");
 const org_group_service_1 = require("./org-group.service");
 const org_subscription_service_1 = require("./org-subscription.service");
+const plans_service_1 = require("./plans.service");
 class AuthzService extends api_base_1.APIBase {
     constructor(httpClient) {
         super(httpClient, '/authz');
@@ -17,6 +18,7 @@ class AuthzService extends api_base_1.APIBase {
         this.orgGroupCapabilityBundles = new org_group_capability_bundle_service_1.OrgGroupCapabilityBundleService(httpClient);
         this.orgGroupMembers = new org_group_member_service_1.OrgGroupMemberService(httpClient);
         this.orgSubscriptions = new org_subscription_service_1.OrgSubscriptionService(httpClient);
+        this.plans = new plans_service_1.PlansService(httpClient);
     }
 }
 exports.AuthzService = AuthzService;

package/src/lib/services/authz/org-group-capability-bundle.service.d.ts

@@ -1,6 +1,5 @@
 import { APIBase } from '../../api-base';
-import type { TokenOption } from '../../interfaces';
-import type { CapabilityBundleId, CreateOrgGroupCapabilityBundle, OrgGroupCapabilityBundle, SqlPagination } from '../../interfaces/authz';
+import type { CapabilityBundleId, CreateOrgGroupCapabilityBundle, OrgGroupCapabilityBundle, SqlPagination, TokenOption } from '../../interfaces';
 import { HttpClientService } from '../http-client.service';
 export declare class OrgGroupCapabilityBundleService extends APIBase {
     constructor(httpClient: HttpClientService);

package/src/lib/services/authz/org-group-capability.service.d.ts

@@ -1,6 +1,5 @@
 import { APIBase } from '../../api-base';
-import type { TokenOption } from '../../interfaces';
-import type { CapabilityId, CreateOrgGroupCapability, OrgGroupCapability, SqlPagination } from '../../interfaces/authz';
+import type { CapabilityId, CreateOrgGroupCapability, OrgGroupCapability, SqlPagination, TokenOption } from '../../interfaces';
 import { HttpClientService } from '../http-client.service';
 export declare class OrgGroupCapabilityService extends APIBase {
     constructor(httpClient: HttpClientService);

package/src/lib/services/authz/org-group-member.service.d.ts

@@ -1,6 +1,5 @@
 import { APIBase } from '../../api-base';
-import type { TokenOption } from '../../interfaces';
-import type { CreateOrgGroupMember, SqlPagination, SqlPaginationResult } from '../../interfaces/authz';
+import type { CreateOrgGroupMember, SqlPagination, SqlPaginationResult, TokenOption } from '../../interfaces';
 import { HttpClientService } from '../http-client.service';
 export declare class OrgGroupMemberService extends APIBase {
     constructor(httpClient: HttpClientService);

package/src/lib/services/authz/org-group.service.d.ts

@@ -1,6 +1,5 @@
 import { APIBase } from '../../api-base';
-import type { TokenOption } from '../../interfaces';
-import type { CreateOrgGroup, OrgGroup, SqlPagination, SqlPaginationResult, UpdateOrgGroup } from '../../interfaces/authz';
+import type { CreateOrgGroup, OrgGroup, SqlPagination, SqlPaginationResult, TokenOption, UpdateOrgGroup } from '../../interfaces';
 import { HttpClientService } from '../http-client.service';
 export declare class OrgGroupService extends APIBase {
     constructor(httpClient: HttpClientService);

package/src/lib/services/authz/org-subscription.service.d.ts

@@ -1,9 +1,8 @@
 import { APIBase } from '../../api-base';
-import type { TokenOption } from '../../interfaces';
-import type { OrgSubscription, SqlPagination } from '../../interfaces/authz';
+import type { OrgSubscription, SqlPagination, SqlPaginationResult, TokenOption } from '../../interfaces';
 import { HttpClientService } from '../http-client.service';
 export declare class OrgSubscriptionService extends APIBase {
     constructor(httpClient: HttpClientService);
-    getOrgSubscriptionsByOrgId(sqlPagination?: SqlPagination, options?: TokenOption): Promise<OrgSubscription[]>;
+    getOrgSubscriptionsByOrgId(sqlPagination?: SqlPagination, options?: TokenOption): Promise<SqlPaginationResult<OrgSubscription>>;
     getOrgSubscriptionById(orgSubscriptionId: string, options?: TokenOption): Promise<OrgSubscription>;
 }

package/src/lib/services/authz/plans.service.d.ts

@@ -0,0 +1,9 @@
+import { APIBase } from '../../api-base';
+import type { AuthzPlan as Plan, PlanId, PlanWithFeaturesAndCapabilityBundles, SqlPagination, SqlPaginationResult, TokenOption } from '../../interfaces';
+import { HttpClientService } from '../http-client.service';
+export declare class PlansService extends APIBase {
+    constructor(httpClient: HttpClientService);
+    getPlans(sqlPagination?: SqlPagination, options?: TokenOption): Promise<SqlPaginationResult<Plan>>;
+    getPlanById(planId: PlanId, options?: TokenOption): Promise<Plan>;
+    getPlanDetailsById(planId: PlanId, options?: TokenOption): Promise<PlanWithFeaturesAndCapabilityBundles>;
+}

package/src/lib/services/authz/plans.service.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlansService = void 0;
+const api_base_1 = require("../../api-base");
+class PlansService extends api_base_1.APIBase {
+    constructor(httpClient) {
+        super(httpClient, '/authz/plans');
+    }
+    getPlans(sqlPagination = {}, options = {}) {
+        return this.httpClient.get(this.basePath, { ...options, params: sqlPagination });
+    }
+    getPlanById(planId, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${planId}`, options);
+    }
+    getPlanDetailsById(planId, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${planId}/details`, options);
+    }
+}
+exports.PlansService = PlansService;

package/src/lib/services/knowledge.service.d.ts

@@ -1,5 +1,5 @@
 import { APIBase } from '../api-base';
-import type { Config, ConfirmKnowledge, CreateKnowledge, KnowledgeBacklinkQuery, KnowledgeBatch, KnowledgeHome, KnowledgeList, KnowledgePage, KnowledgeQuery, KnowledgeRevision, KnowledgeVersion, UpdateKnowledge } from '../interfaces';
+import type { Config, ConfirmKnowledge, CreateKnowledge, KnowledgeBacklinkQuery, KnowledgeBatch, KnowledgeHome, KnowledgeList, KnowledgePage, KnowledgeQuery, KnowledgeRevision, KnowledgeRevisionList, KnowledgeVersion, UpdateKnowledge } from '../interfaces';
 import { HttpClientService } from './http-client.service';
 export declare class KnowledgeService extends APIBase {
     constructor(httpClient: HttpClientService);
@@ -9,6 +9,7 @@ export declare class KnowledgeService extends APIBase {
     getHome(query?: KnowledgeQuery, options?: Config): Promise<KnowledgeHome>;
     getBacklinks(query: KnowledgeBacklinkQuery, options?: Config): Promise<KnowledgeList>;
     getRelated(id: string, query?: Pick<KnowledgeQuery, 'cursor' | 'limit'>, options?: Config): Promise<KnowledgeList>;
+    getRevisions(id: string, query?: Pick<KnowledgeQuery, 'cursor' | 'limit'>, options?: Config): Promise<KnowledgeRevisionList>;
     getRevision(id: string, revision: number, options?: Config): Promise<KnowledgeRevision>;
     readBatch(ids: string[], options?: Config): Promise<KnowledgeBatch>;
     updateOne(id: string, dto: UpdateKnowledge, options?: Config): Promise<KnowledgePage>;

package/src/lib/services/knowledge.service.js

@@ -24,6 +24,9 @@ class KnowledgeService extends api_base_1.APIBase {
     getRelated(id, query = {}, options = {}) {
         return this.httpClient.get(`${this.basePath}/${encodeURIComponent(id)}/related`, { ...options, params: query });
     }
+    getRevisions(id, query = {}, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${encodeURIComponent(id)}/revisions`, { ...options, params: query });
+    }
     getRevision(id, revision, options = {}) {
         return this.httpClient.get(`${this.basePath}/${encodeURIComponent(id)}/revisions/${revision}`, options);
     }

package/src/lib/services/organizations.service.d.ts

@@ -95,9 +95,10 @@ export declare class OrganizationsService extends APIBase {
      *
      * @param {string} id - organization id
      * @param {string} kinds - array of requested data types ( selection of: ['members', 'invitations', 'roles', 'domains', 'userRoles'])
+     * @param {TokenOption} options - Optional token option
      * @returns{Promise<OrganizationData>} organizationData (only selected kinds are returned)
      */
-    getOrganizationData(id: string, kinds?: OrganizationDataKind[]): Promise<OrganizationData>;
+    getOrganizationData(id: string, kinds?: OrganizationDataKind[], options?: TokenOption): Promise<OrganizationData>;
     /**
      * Returns the member with the provided id
      *

package/src/lib/services/organizations.service.js

@@ -131,11 +131,12 @@ class OrganizationsService extends api_base_1.APIBase {
      *
      * @param {string} id - organization id
      * @param {string} kinds - array of requested data types ( selection of: ['members', 'invitations', 'roles', 'domains', 'userRoles'])
+     * @param {TokenOption} options - Optional token option
      * @returns{Promise<OrganizationData>} organizationData (only selected kinds are returned)
      */
-    getOrganizationData(id, kinds = []) {
+    getOrganizationData(id, kinds = [], options = {}) {
         const params = kinds.length > 0 ? { kinds: kinds.join(',') } : {};
-        return this.httpClient.get(`${this.basePath}/${id}/data`, { params });
+        return this.httpClient.get(`${this.basePath}/${id}/data`, { params, ...options });
     }
     /**
      * Returns the member with the provided id