@hahnpro/hpc-api 2026.10.2 → 2026.10.3

package/package.json

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

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

@@ -36,6 +36,8 @@ export type AssetTypeRevision = AssetType & {
 };
 export interface Asset {
     id?: string;
+    /** Case-sensitive media relay binding; only platform superusers may provision it. */
+    streamId?: string | null;
     externalKey?: string;
     name: string;
     type: string | AssetType;
@@ -62,7 +64,7 @@ export interface Asset {
     updatedAt?: string;
     deletedAt?: string;
 }
-export type AssetRevision = Asset & {
+export type AssetRevision = Omit<Asset, 'streamId'> & {
     originalId: string;
 };
 export type Attachment = Content;

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

@@ -37,6 +37,7 @@ export declare class ContentAnalysis {
         pageNumber: number;
         text?: string;
     }[];
+    raw?: unknown;
 }
 export interface ContentChange extends Change {
     subject: ChangeSubject;

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

@@ -62,7 +62,7 @@ export { FlowDeployment, NATS_FLOW_TRIGGER_STATUSES } from './flow-deployment.in
 export { Flow, FlowDiagram } from './flow.interface';
 export { LABEL_COLORS } from './label.interface';
 export { SubscriptionType } from './marketplace.interface';
-export { NatsConsumers, natsFlowsPrefix, natsHpcPrefix, NatsStreams } from './nats.interface';
+export { NatsConsumers, natsFlowsPrefix, natsHpcPrefix, NatsStreams, natsAuthPrefix } from './nats.interface';
 export { NotificationRuleStatus } from './notification-rule.interface';
 export { OrganizationMembersInviteOrAdd } from './organization.interface';
 export { OwnerType } from './owner.interface';

package/src/lib/interfaces/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FlowDiagram = exports.Flow = exports.NATS_FLOW_TRIGGER_STATUSES = exports.FlowDeployment = exports.UNKOWN_STATES = exports.STOPPED_STATES = exports.RUNNING_STATES = exports.PROCESSING_STATES = exports.FlowDeploymentStatus = exports.ERROR_STATES = exports.TimeSlotStatus = exports.APPLICATION_AREA = exports.eventLevels = exports.EventLevelOverrideWrapper = exports.EventLevel = exports.NotificationEndpointType = exports.NotificationEndpointStatus = exports.NotificationEndpointSpamProtection = exports.DataspaceWorkflowType = exports.DataspaceAllowedResourceTypes = exports.instanceOfTimePeriod = exports.ReturnType = exports.IndexingStatus = exports.ContentAnalysisStatus = exports.BillingResourceType = exports.ChangeAction = exports.DEFAULT_THRESHOLD_CONDITION = exports.DEFAULT_RELATIVE_CONDITION = exports.DEFAULT_DEADMAN_CONDITION = exports.AlertType = exports.AlertStatus = exports.AlertLevel = exports.ToolType = exports.ToolName = exports.ToolMessageStatus = exports.Role = exports.ReturnToReferrerTool = exports.ReferenceType = exports.OneShotTaskId = exports.HandOffTool = exports.FinishReason = exports.ErrorMessageType = exports.AvailableLanguages = exports.AttachmentHandlingMode = exports.ATTACHMENT_CAPABLE_AGENT_IDS = exports.AssistantMessageStatus = exports.AiAssistantId = exports.AgentId = exports.MAX_TIME_SERIES_PER_VALUE_FEED = exports.LogbookEntrySource = void 0;
-exports.WebSocketMessageType = exports.SecretType = exports.isUserMessage = exports.isTask = exports.isStorage = exports.isOwner = exports.isLogbookEntry = exports.isEvent = exports.isContentAnalysis = exports.isContent = exports.isAuthor = exports.isAssignee = exports.isAsset = exports.TranslationEditData = exports.RETENTION_VALUES = exports.TaskStatus = exports.Priority = exports.INACTIVE_TASK_STATUSES = exports.buildTaskStatusFilter = exports.AssigneeType = exports.ACTIVE_TASK_STATUSES = exports.ResourceType = exports.resourceApiPathToTypeMap = exports.ResourceApiPath = exports.PermissionType = exports.isPopulated = exports.EventType = exports.CommandType = exports.arePopulated = exports.PermissionLevel = exports.ObjectReferenceType = exports.OwnerType = exports.OrganizationMembersInviteOrAdd = exports.NotificationRuleStatus = exports.NatsStreams = exports.natsHpcPrefix = exports.natsFlowsPrefix = exports.NatsConsumers = exports.SubscriptionType = exports.LABEL_COLORS = void 0;
+exports.WebSocketMessageType = exports.SecretType = exports.isUserMessage = exports.isTask = exports.isStorage = exports.isOwner = exports.isLogbookEntry = exports.isEvent = exports.isContentAnalysis = exports.isContent = exports.isAuthor = exports.isAssignee = exports.isAsset = exports.TranslationEditData = exports.RETENTION_VALUES = exports.TaskStatus = exports.Priority = exports.INACTIVE_TASK_STATUSES = exports.buildTaskStatusFilter = exports.AssigneeType = exports.ACTIVE_TASK_STATUSES = exports.ResourceType = exports.resourceApiPathToTypeMap = exports.ResourceApiPath = exports.PermissionType = exports.isPopulated = exports.EventType = exports.CommandType = exports.arePopulated = exports.PermissionLevel = exports.ObjectReferenceType = exports.OwnerType = exports.OrganizationMembersInviteOrAdd = exports.NotificationRuleStatus = exports.natsAuthPrefix = exports.NatsStreams = exports.natsHpcPrefix = exports.natsFlowsPrefix = exports.NatsConsumers = exports.SubscriptionType = exports.LABEL_COLORS = void 0;
 const tslib_1 = require("tslib");
 var logbook_interface_1 = require("./logbook.interface");
 Object.defineProperty(exports, "LogbookEntrySource", { enumerable: true, get: function () { return logbook_interface_1.LogbookEntrySource; } });
@@ -77,6 +77,7 @@ Object.defineProperty(exports, "NatsConsumers", { enumerable: true, get: functio
 Object.defineProperty(exports, "natsFlowsPrefix", { enumerable: true, get: function () { return nats_interface_1.natsFlowsPrefix; } });
 Object.defineProperty(exports, "natsHpcPrefix", { enumerable: true, get: function () { return nats_interface_1.natsHpcPrefix; } });
 Object.defineProperty(exports, "NatsStreams", { enumerable: true, get: function () { return nats_interface_1.NatsStreams; } });
+Object.defineProperty(exports, "natsAuthPrefix", { enumerable: true, get: function () { return nats_interface_1.natsAuthPrefix; } });
 var notification_rule_interface_1 = require("./notification-rule.interface");
 Object.defineProperty(exports, "NotificationRuleStatus", { enumerable: true, get: function () { return notification_rule_interface_1.NotificationRuleStatus; } });
 var organization_interface_1 = require("./organization.interface");

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

@@ -98,11 +98,21 @@ export interface ConfirmKnowledge extends KnowledgeVersion {
 }
 export type KnowledgeRelation = 'OBSERVED_IN' | 'EVIDENCED_BY' | 'RELATED_TO' | 'APPLIES_TO';
 export type KnowledgeScopeResult = 'matches' | 'not-established' | 'not-evaluated';
+export type KnowledgeStatus = 'overdue' | 'confirmed' | 'unconfirmed';
+export declare const KNOWLEDGE_STATUS_FILTERS: readonly ["confirmed", "needs-review"];
+export type KnowledgeStatusFilter = (typeof KNOWLEDGE_STATUS_FILTERS)[number];
+export declare function knowledgeStatus(page: {
+    staleAfter?: string | Date | null;
+    revision: number;
+    confirmations: Pick<KnowledgeConfirmation, 'revision'>[];
+}, now?: number): KnowledgeStatus;
+export declare function matchesKnowledgeStatus(status: KnowledgeStatus, filter: KnowledgeStatusFilter): boolean;
 export interface KnowledgeQuery {
     group?: 'direct' | 'broader' | 'related';
     query?: string;
     contextType?: 'asset' | 'location' | 'organization';
     contextId?: string;
+    status?: KnowledgeStatusFilter;
     cursor?: string;
     limit?: number;
 }

package/src/lib/interfaces/knowledge.interface.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KNOWLEDGE_TARGET_TYPES = void 0;
+exports.KNOWLEDGE_STATUS_FILTERS = exports.KNOWLEDGE_TARGET_TYPES = void 0;
+exports.knowledgeStatus = knowledgeStatus;
+exports.matchesKnowledgeStatus = matchesKnowledgeStatus;
 const resource_interface_1 = require("./resource.interface");
 exports.KNOWLEDGE_TARGET_TYPES = [
     resource_interface_1.ResourceType.KNOWLEDGE,
@@ -10,3 +12,13 @@ exports.KNOWLEDGE_TARGET_TYPES = [
     resource_interface_1.ResourceType.EVENT,
     resource_interface_1.ResourceType.TASK,
 ];
+exports.KNOWLEDGE_STATUS_FILTERS = ['confirmed', 'needs-review'];
+function knowledgeStatus(page, now = Date.now()) {
+    if (page.staleAfter && new Date(page.staleAfter).getTime() <= now) {
+        return 'overdue';
+    }
+    return page.confirmations.some((item) => item.revision === page.revision) ? 'confirmed' : 'unconfirmed';
+}
+function matchesKnowledgeStatus(status, filter) {
+    return filter === 'confirmed' ? status === 'confirmed' : status !== 'confirmed';
+}

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

@@ -42,10 +42,6 @@ export declare const NatsConsumers: {
             readonly ReferenceTargetRestored: "reference-target-restored";
             readonly ReferenceCreateCommand: "reference-create-command";
         };
-        readonly OrgGroupService: {
-            readonly DeleteGroupOfDeletedOrgs: "delete-group-of-deleted-orgs";
-            readonly DeleteSubsOfDeletedOrgs: "delete-subs-of-deleted-orgs";
-        };
     };
     readonly flows: {
         readonly FlowTrigger: "flow-trigger";
@@ -60,9 +56,20 @@ export declare const NatsConsumers: {
     };
     readonly organizations: {
         readonly OrgGroupMembers: {
-            readonly DeleteMemberships: "delete-org-group-memberships";
+            readonly AddMembership: "add-org-group-membership";
+            readonly DeleteMembership: "delete-org-group-membership";
+        };
+        readonly OrgInitializationsService: {
+            readonly InitializeOrg: "initialize-org";
+        };
+        readonly OrgGroupsService: {
+            readonly DeleteGroupOfDeletedOrg: "delete-group-of-deleted-org";
+        };
+        readonly OrgSubscriptionsService: {
+            readonly DeleteSubsOfDeletedOrg: "delete-subs-of-deleted-org";
         };
     };
 };
 export declare const natsHpcPrefix = "com.hahnpro";
 export declare const natsFlowsPrefix = "fs";
+export declare const natsAuthPrefix = "auth";

package/src/lib/interfaces/nats.interface.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.natsFlowsPrefix = exports.natsHpcPrefix = exports.NatsConsumers = exports.NatsStreams = void 0;
+exports.natsAuthPrefix = exports.natsFlowsPrefix = exports.natsHpcPrefix = exports.NatsConsumers = exports.NatsStreams = void 0;
 exports.NatsStreams = {
     Resource: 'resource',
     Flows: 'flows',
@@ -45,10 +45,6 @@ exports.NatsConsumers = {
             ReferenceTargetRestored: 'reference-target-restored',
             ReferenceCreateCommand: 'reference-create-command',
         },
-        OrgGroupService: {
-            DeleteGroupOfDeletedOrgs: 'delete-group-of-deleted-orgs',
-            DeleteSubsOfDeletedOrgs: 'delete-subs-of-deleted-orgs',
-        },
     },
     [exports.NatsStreams.Flows]: {
         FlowTrigger: 'flow-trigger',
@@ -63,9 +59,20 @@ exports.NatsConsumers = {
     },
     [exports.NatsStreams.Organizations]: {
         OrgGroupMembers: {
-            DeleteMemberships: 'delete-org-group-memberships',
+            AddMembership: 'add-org-group-membership',
+            DeleteMembership: 'delete-org-group-membership',
+        },
+        OrgInitializationsService: {
+            InitializeOrg: 'initialize-org',
+        },
+        OrgGroupsService: {
+            DeleteGroupOfDeletedOrg: 'delete-group-of-deleted-org',
+        },
+        OrgSubscriptionsService: {
+            DeleteSubsOfDeletedOrg: 'delete-subs-of-deleted-org',
         },
     },
 };
 exports.natsHpcPrefix = 'com.hahnpro';
 exports.natsFlowsPrefix = 'fs';
+exports.natsAuthPrefix = 'auth';

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

@@ -1,4 +1,4 @@
-import { Config, Content, DeleteQuery, Paginated, PermissionLevel, RequestParameter, ReturnType } from '../interfaces';
+import { Config, Content, ContentAnalysis, DeleteQuery, Paginated, PermissionLevel, RequestParameter, ReturnType } from '../interfaces';
 import { ContentService } from '../services';
 import { CrossPlatformFormData } from '../utils';
 import { DataMockService } from './data.mock.service';
@@ -22,6 +22,8 @@ export declare class ContentMockService extends BaseService implements ContentSe
     download(id: string, returnType: ReturnType.BLOB, options?: any): Promise<Blob>;
     download(id: string, returnType: ReturnType.ARRAYBUFFER, options?: any): Promise<ArrayBuffer>;
     download(id: string, returnType: ReturnType.STREAM, options?: any): Promise<any>;
+    updateAnalysis(id: string, dto: Partial<ContentAnalysis>): Promise<ContentAnalysis>;
+    getAnalysis(id: string): Promise<ContentAnalysis>;
     deleteOne(contentId: string, deleteQuery?: DeleteQuery): Promise<Content>;
     getMany(params?: RequestParameter): Promise<Paginated<Content>>;
     upload(form: CrossPlatformFormData): Promise<Content>;

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

@@ -64,6 +64,12 @@ class ContentMockService extends BaseService {
                 return Promise.reject(new Error(`ReturnType ${returnType} not supported in mock`));
         }
     }
+    updateAnalysis(id, dto) {
+        return Promise.resolve({ id, contentId: id, status: interfaces_1.ContentAnalysisStatus.NOT_STARTED, ...dto });
+    }
+    getAnalysis(id) {
+        return Promise.resolve({ id, contentId: id, status: interfaces_1.ContentAnalysisStatus.NOT_STARTED });
+    }
     deleteOne(contentId, deleteQuery = {}) {
         const content = this.data.find((v) => v.id === contentId);
         if (!content?.deletedAt && !deleteQuery.force) {

package/src/lib/mock/flow-modules.mock.service.d.ts

@@ -7,28 +7,28 @@ import { ShareMockService } from './share.mock.service';
 type ExtendedFlowModule = Replace<FlowModule, 'artifacts', Array<Artifact & {
     path: string;
 }>>;
-declare const BaseService_base: import("ts-mixer/dist/types/types").Class<any[], DataMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "revision" | "author" | "functions"> & {
+declare const BaseService_base: import("ts-mixer/dist/types/types").Class<any[], DataMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "author" | "revision" | "functions"> & {
     artifacts: (Artifact & {
         path: string;
     })[];
-}>> & ShareMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "revision" | "author" | "functions"> & {
+}>> & ShareMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "author" | "revision" | "functions"> & {
     artifacts: (Artifact & {
         path: string;
     })[];
-}>>, (abstract new (data?: import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "revision" | "author" | "functions"> & {
+}>>, (abstract new (data?: import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "author" | "revision" | "functions"> & {
     artifacts: (Artifact & {
         path: string;
     })[];
-}>[]) => DataMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "revision" | "author" | "functions"> & {
+}>[]) => DataMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "author" | "revision" | "functions"> & {
     artifacts: (Artifact & {
         path: string;
     })[];
 }>>) & {
-    new (data?: import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "revision" | "author" | "functions"> & {
+    new (data?: import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "author" | "revision" | "functions"> & {
         artifacts: (Artifact & {
             path: string;
         })[];
-    }>[]): ShareMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "revision" | "author" | "functions"> & {
+    }>[]): ShareMockService<import("./api.mock").Identity<Pick<FlowModule, "id" | "name" | "description" | "owner" | "createdAt" | "createdBy" | "updatedAt" | "updatedBy" | "tags" | "readPermissions" | "readWritePermissions" | "deletedAt" | "author" | "revision" | "functions"> & {
         artifacts: (Artifact & {
             path: string;
         })[];

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

@@ -75,7 +75,8 @@ class KnowledgeMockService extends knowledge_service_1.KnowledgeService {
     }
     async getMany(query = {}) {
         const term = query.query?.toLowerCase();
-        return this.list(this.data.filter((page) => !term || `${page.title} ${page.body}`.toLowerCase().includes(term)), query);
+        return this.list(this.data.filter((page) => (!term || `${page.title} ${page.body}`.toLowerCase().includes(term)) &&
+            (!query.status || (0, interfaces_1.matchesKnowledgeStatus)((0, interfaces_1.knowledgeStatus)(page), query.status))), query);
     }
     async getHome(query = {}) {
         return { direct: await this.getMany(query), broader: { docs: [], status: 'complete' }, related: { docs: [], status: 'complete' } };

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

@@ -1,4 +1,4 @@
-import { Config, Content, PermissionLevel, ReturnType, TokenOption } from '../interfaces';
+import { Config, Content, ContentAnalysis, PermissionLevel, RequestParameter, ReturnType, TokenOption } from '../interfaces';
 import { CrossPlatformFormData } from '../utils';
 import { DataService } from './data.service';
 import { HttpClientService } from './http-client.service';
@@ -14,6 +14,8 @@ declare class BaseService extends BaseService_base {
 export declare class ContentService extends BaseService {
     constructor(httpClient: HttpClientService);
     getReferenceCheck(id: string, permissionLevel: PermissionLevel, options?: Config): Promise<Content>;
+    updateAnalysis: (id: string, dto: Partial<ContentAnalysis>, params?: Pick<RequestParameter, "select">, options?: Config) => Promise<ContentAnalysis>;
+    getAnalysis: (id: string, params?: Pick<RequestParameter, "select">, options?: Config) => Promise<ContentAnalysis>;
     upload: (form: CrossPlatformFormData, options?: Config) => Promise<Content>;
     download(id: string, raw?: boolean, options?: TokenOption): Promise<Blob | ArrayBuffer>;
     download(id: string, returnType: ReturnType.TEXT, options?: TokenOption): Promise<string>;

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

@@ -12,6 +12,8 @@ class BaseService extends (0, ts_mixer_1.Mixin)((data_service_1.DataService), sh
 class ContentService extends BaseService {
     constructor(httpClient) {
         super(httpClient, '/contents');
+        this.updateAnalysis = (id, dto, params = {}, options = {}) => this.httpClient.put(`${this.basePath}/${id}/analysis`, dto, { params, ...options });
+        this.getAnalysis = (id, params = {}, options = {}) => this.httpClient.get(`${this.basePath}/${id}/analysis`, { params, ...options });
         this.upload = (form, options = {}) => {
             const headers = { ...(0, utils_1.getFormDataHeaders)(form), ...options.headers };
             return this.httpClient.post(`${this.basePath}`, form, {

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

@@ -125,6 +125,7 @@ export declare class OrganizationsService extends APIBase {
      * Returns an array of organizations where the current user is a member.
      *
      * @returns {Promise<Organization[]>} - Organizations (array of organizations)
+     * @deprecated Use getUserOrganizations(userId) instead, where userId is the id of the current user.
      */
     getMyOrganizations(): Promise<Organization[]>;
     /**

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

@@ -170,6 +170,7 @@ class OrganizationsService extends api_base_1.APIBase {
      * Returns an array of organizations where the current user is a member.
      *
      * @returns {Promise<Organization[]>} - Organizations (array of organizations)
+     * @deprecated Use getUserOrganizations(userId) instead, where userId is the id of the current user.
      */
     getMyOrganizations() {
         return this.httpClient.get(`${this.basePath}/mine`);