@hahnpro/hpc-api 2026.9.11 → 2026.9.12

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @hahnpro/hpc-api
 
+# 2026.9.12
+
+- Added permission verification support for object references, including reference-check endpoints for resources, AI threads, and user messages
+- Added the `PermissionLevel` enum
+- Added pagination and sorting parameters to object-reference queries
+
 # 2026.9.11
 
 - Added `api.knowledge` client, shared types and mock support for pages, revisions, discovery and lifecycle operations #5262

package/package.json

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

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

@@ -66,7 +66,7 @@ export { NatsConsumers, natsFlowsPrefix, natsHpcPrefix, NatsStreams } from './na
 export { NotificationRuleStatus } from './notification-rule.interface';
 export { OrganizationMembersInviteOrAdd } from './organization.interface';
 export { OwnerType } from './owner.interface';
-export { ObjectReferenceType } from './reference.interface';
+export { ObjectReferenceType, PermissionLevel } from './reference.interface';
 export { arePopulated, CommandType, EventType, isPopulated, PermissionType, ResourceApiPath, resourceApiPathToTypeMap, ResourceType, } from './resource.interface';
 export { ACTIVE_TASK_STATUSES, AssigneeType, buildTaskStatusFilter, INACTIVE_TASK_STATUSES, Priority, TaskStatus } from './task.interface';
 export { RETENTION_VALUES } from './timeseries.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.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.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; } });
@@ -85,6 +85,7 @@ var owner_interface_1 = require("./owner.interface");
 Object.defineProperty(exports, "OwnerType", { enumerable: true, get: function () { return owner_interface_1.OwnerType; } });
 var reference_interface_1 = require("./reference.interface");
 Object.defineProperty(exports, "ObjectReferenceType", { enumerable: true, get: function () { return reference_interface_1.ObjectReferenceType; } });
+Object.defineProperty(exports, "PermissionLevel", { enumerable: true, get: function () { return reference_interface_1.PermissionLevel; } });
 var resource_interface_1 = require("./resource.interface");
 Object.defineProperty(exports, "arePopulated", { enumerable: true, get: function () { return resource_interface_1.arePopulated; } });
 Object.defineProperty(exports, "CommandType", { enumerable: true, get: function () { return resource_interface_1.CommandType; } });

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

@@ -1,3 +1,9 @@
+import { ResourceType } from './resource.interface';
+export declare enum PermissionLevel {
+    READ = "read",
+    WRITE = "write",
+    NONE = "none"
+}
 export declare enum ObjectReferenceType {
     /**
      * Used for testing purposes to simulate references between objects.
@@ -30,9 +36,9 @@ export interface ObjectReference {
     id: number;
     src: string;
     tgt: string;
-    srcType: string;
-    tgtType: string;
-    relType: string;
+    srcType: ResourceType;
+    tgtType: ResourceType;
+    relType: ObjectReferenceType;
     createdAt: number;
     updatedAt: number;
     createdBy: string;
@@ -48,21 +54,10 @@ export interface ObjectReference {
 export interface CreateReferenceDto {
     srcId: string;
     tgtId: string;
-    srcType: string;
-    tgtType: string;
+    srcType: ResourceType;
+    tgtType: ResourceType;
     relSrc: string;
     relType: ObjectReferenceType;
-    displayData: {
-        src?: Record<string, unknown>;
-        tgt?: Record<string, unknown>;
-        [key: string]: unknown;
-    };
-    tgtDeleted?: boolean;
-    orgId?: string;
-    srcReadPermissions?: string[];
-    srcReadWritePermissions?: string[];
-    tgtReadPermissions?: string[];
-    tgtReadWritePermissions?: string[];
 }
 export interface ReferencesQuery {
     objId: string;

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

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectReferenceType = void 0;
+exports.ObjectReferenceType = exports.PermissionLevel = void 0;
+var PermissionLevel;
+(function (PermissionLevel) {
+    PermissionLevel["READ"] = "read";
+    PermissionLevel["WRITE"] = "write";
+    PermissionLevel["NONE"] = "none";
+})(PermissionLevel || (exports.PermissionLevel = PermissionLevel = {}));
 var ObjectReferenceType;
 (function (ObjectReferenceType) {
     /**

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

@@ -36,11 +36,14 @@ export declare enum ResourceApiPath {
     FLOWMODULE = "flow/modules",
     KNOWLEDGE = "knowledge",
     LABEL = "labels",
+    LOGBOOKENTRY = "tasks/logbook",
     NOTIFICATIONENDPOINT = "notification/endpoints",
     NOTIFICATIONRULE = "notification/rules",
     SECRET = "vault/secrets",
     TIMESERIES = "tsm",
-    TASK = "tasks"
+    TASK = "tasks",
+    THREAD = "ai/threads",
+    USERMESSAGE = "ai/messages"
 }
 export declare const resourceApiPathToTypeMap: Record<ResourceApiPath, ResourceType>;
 export declare enum EventType {

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

@@ -40,11 +40,14 @@ var ResourceApiPath;
     ResourceApiPath["FLOWMODULE"] = "flow/modules";
     ResourceApiPath["KNOWLEDGE"] = "knowledge";
     ResourceApiPath["LABEL"] = "labels";
+    ResourceApiPath["LOGBOOKENTRY"] = "tasks/logbook";
     ResourceApiPath["NOTIFICATIONENDPOINT"] = "notification/endpoints";
     ResourceApiPath["NOTIFICATIONRULE"] = "notification/rules";
     ResourceApiPath["SECRET"] = "vault/secrets";
     ResourceApiPath["TIMESERIES"] = "tsm";
     ResourceApiPath["TASK"] = "tasks";
+    ResourceApiPath["THREAD"] = "ai/threads";
+    ResourceApiPath["USERMESSAGE"] = "ai/messages";
 })(ResourceApiPath || (exports.ResourceApiPath = ResourceApiPath = {}));
 exports.resourceApiPathToTypeMap = {
     [ResourceApiPath.ALERT]: ResourceType.ALERT,
@@ -58,11 +61,14 @@ exports.resourceApiPathToTypeMap = {
     [ResourceApiPath.FLOWMODULE]: ResourceType.FLOWMODULE,
     [ResourceApiPath.KNOWLEDGE]: ResourceType.KNOWLEDGE,
     [ResourceApiPath.LABEL]: ResourceType.LABEL,
+    [ResourceApiPath.LOGBOOKENTRY]: ResourceType.LOGBOOKENTRY,
     [ResourceApiPath.NOTIFICATIONENDPOINT]: ResourceType.NOTIFICATIONENDPOINT,
     [ResourceApiPath.NOTIFICATIONRULE]: ResourceType.NOTIFICATIONRULE,
     [ResourceApiPath.SECRET]: ResourceType.SECRET,
     [ResourceApiPath.TIMESERIES]: ResourceType.TIMESERIES,
     [ResourceApiPath.TASK]: ResourceType.TASK,
+    [ResourceApiPath.THREAD]: ResourceType.THREAD,
+    [ResourceApiPath.USERMESSAGE]: ResourceType.USERMESSAGE,
 };
 var EventType;
 (function (EventType) {

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

@@ -1,4 +1,4 @@
-import { AiAssistant, AiSkill, AiSkillSummary, AudioTranscription, Config, Message, OneShotTaskId, OneShotTaskResult, Paginated, Thread, ThreadPopulated, TokenOption } from '../interfaces';
+import { AiAssistant, AiSkill, AiSkillSummary, AudioTranscription, Config, Message, OneShotTaskId, OneShotTaskResult, Paginated, PermissionLevel, Thread, ThreadPopulated, TokenOption } from '../interfaces';
 import { AiService } from '../services';
 import type { CrossPlatformFormData } from '../utils';
 import { APIBaseMock } from './api-base.mock';
@@ -18,6 +18,8 @@ export declare class AiMockService extends APIBaseMock<never> implements AiServi
     replaceSkill(_id: string, _form: CrossPlatformFormData, _options?: Config): Promise<AiSkill>;
     getThreadMessages(threadId: string): Promise<Paginated<Message>>;
     getThread(threadId: string): Promise<ThreadPopulated>;
+    getThreadReferenceCheck(threadId: string, _permissionLevel?: PermissionLevel, _options?: Config): Promise<ThreadPopulated>;
+    getUserMessageReferenceCheck(messageId: string, _permissionLevel?: PermissionLevel, _options?: Config): Promise<Message>;
     getLatestThread(): Promise<ThreadPopulated>;
     listThreads(): Promise<ThreadPopulated[]>;
     listAssistantThreads(assistantId: string): Promise<ThreadPopulated[]>;

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiMockService = void 0;
+const interfaces_1 = require("../interfaces");
 const api_base_mock_1 = require("./api-base.mock");
 class AiMockService extends api_base_mock_1.APIBaseMock {
     constructor() {
@@ -48,6 +49,12 @@ class AiMockService extends api_base_mock_1.APIBaseMock {
     getThread(threadId) {
         throw new Error('Method not implemented.');
     }
+    getThreadReferenceCheck(threadId, _permissionLevel = interfaces_1.PermissionLevel.READ, _options = {}) {
+        throw new Error('Method not implemented.');
+    }
+    getUserMessageReferenceCheck(messageId, _permissionLevel = interfaces_1.PermissionLevel.READ, _options = {}) {
+        throw new Error('Method not implemented.');
+    }
     getLatestThread() {
         throw new Error('Method not implemented.');
     }

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

@@ -1,4 +1,4 @@
-import { AddToProperty, Asset, AssetRevision, Attachment, DeleteQuery, EventCause, EventLevelOverride, Filter, Paginated, RemoveFromProperty, RequestParameter, SearchResultItem, TokenOption, Translation } from '../interfaces';
+import { AddToProperty, Asset, AssetRevision, Attachment, Config, DeleteQuery, EventCause, EventLevelOverride, Filter, Paginated, PermissionLevel, RemoveFromProperty, RequestParameter, SearchResultItem, TokenOption, Translation } from '../interfaces';
 import { AssetService } from '../services';
 import { CrossPlatformFormData } from '../utils';
 import type { MockAPI } from './api.mock';
@@ -19,6 +19,7 @@ export declare class AssetMockService extends BaseService implements AssetServic
     constructor(api: MockAPI, assets: Asset[], revisions: AssetRevision[], translations?: Array<Translation & {
         id: string;
     }>);
+    getReferenceCheck(id: string, _permissionLevel: PermissionLevel, _options?: Config): Promise<Asset>;
     addElementToProperty(id: string, dto: AddToProperty): Promise<Asset>;
     removeElementFromProperty(id: string, dto: RemoveFromProperty): Promise<Asset>;
     private getAssets;

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

@@ -14,6 +14,9 @@ class AssetMockService extends BaseService {
         this.revisions = revisions;
         this.translations = translations;
     }
+    getReferenceCheck(id, _permissionLevel, _options = {}) {
+        return this.getOne(id);
+    }
     addElementToProperty(id, dto) {
         throw new Error('Method not implemented.');
     }

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

@@ -1,4 +1,4 @@
-import { Content, DeleteQuery, Paginated, RequestParameter, ReturnType } from '../interfaces';
+import { Config, Content, DeleteQuery, Paginated, PermissionLevel, RequestParameter, ReturnType } from '../interfaces';
 import { ContentService } from '../services';
 import { CrossPlatformFormData } from '../utils';
 import { DataMockService } from './data.mock.service';
@@ -14,6 +14,7 @@ declare class BaseService extends BaseService_base {
 export declare class ContentMockService extends BaseService implements ContentService {
     private contentData;
     constructor(contents: Content[], contentData: any[]);
+    getReferenceCheck(id: string, _permissionLevel: PermissionLevel, _options?: Config): Promise<Content>;
     download(id: string, raw?: boolean, options?: any): Promise<Blob | ArrayBuffer>;
     download(id: string, returnType: ReturnType.TEXT, options?: any): Promise<string>;
     download(id: string, returnType: ReturnType.JSON, options?: any): Promise<Record<string, unknown>>;

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

@@ -16,6 +16,9 @@ class ContentMockService extends BaseService {
             this.contentData.set(contents[i].id, contentData[i]);
         }
     }
+    getReferenceCheck(id, _permissionLevel, _options = {}) {
+        return this.getOne(id);
+    }
     download(id, second, options = {}) {
         let returnType;
         if (typeof second === 'boolean' || second == null) {

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

@@ -1,4 +1,4 @@
-import { Event, EventCountByAsset } from '../interfaces';
+import { Config, Event, EventCountByAsset, PermissionLevel } from '../interfaces';
 import { EventService } from '../services';
 import { DataMockService } from './data.mock.service';
 import { ShareMockService } from './share.mock.service';
@@ -9,6 +9,7 @@ declare class BaseService extends BaseService_base {
 }
 export declare class EventMockService extends BaseService implements EventService {
     constructor(events: Event[]);
+    getReferenceCheck(id: string, _permissionLevel: PermissionLevel, _options?: Config): Promise<Event>;
     getEventCountByAsset(assetId: string): Promise<EventCountByAsset>;
     getLastEventByAssetAndGroup(assetId: string, group: string): Promise<Event>;
     getLastEventByAssetAndGroups(assetId: string, groups: string[]): Promise<Record<string, string>>;

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

@@ -12,6 +12,9 @@ class EventMockService extends BaseService {
         super();
         this.data = events;
     }
+    getReferenceCheck(id, _permissionLevel, _options = {}) {
+        return this.getOne(id);
+    }
     getEventCountByAsset(assetId) {
         const events = this.data.filter((event) => event.assetRef === assetId);
         const critical = events.filter((event) => event.level === interfaces_1.EventLevel.Critical).length;

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

@@ -1,8 +1,9 @@
-import { LogbookEntry, LogbookEntryDto, Paginated, TokenOption } from '../interfaces';
+import { Config, LogbookEntry, LogbookEntryDto, Paginated, PermissionLevel, TokenOption } from '../interfaces';
 import { LogbookService } from '../services';
 import { APIBaseMock } from './api-base.mock';
 export declare class LogbookMockService extends APIBaseMock<LogbookEntry> implements LogbookService {
     constructor(logbookEntries?: LogbookEntry[]);
+    getReferenceCheck(id: string, _permissionLevel: PermissionLevel, _options?: Config): Promise<LogbookEntry>;
     getEntries(taskId: string, limit?: number, offset?: number, _options?: TokenOption): Promise<Paginated<LogbookEntry>>;
     getEntriesByIds(ids: string[], _options?: TokenOption): Promise<LogbookEntry[]>;
     addEntry(taskId: string, dto: LogbookEntryDto, _options?: TokenOption): Promise<LogbookEntry>;

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

@@ -7,6 +7,9 @@ class LogbookMockService extends api_base_mock_1.APIBaseMock {
     constructor(logbookEntries = []) {
         super(logbookEntries);
     }
+    getReferenceCheck(id, _permissionLevel, _options = {}) {
+        return Promise.resolve(this.data.find((entry) => entry.id === id));
+    }
     async getEntries(taskId, limit = 50, offset = 0, _options = {}) {
         const taskEntries = this.data.filter((e) => e.taskId === taskId);
         const docs = taskEntries.slice(offset, offset + limit);

package/src/lib/mock/object-reference.mock.service.d.ts

@@ -1,13 +1,12 @@
-import { CreateReferenceDto, ObjectReference, ObjectReferenceType, Paginated, ReferencesQuery, TokenOption } from '../interfaces';
+import { Config, CreateReferenceDto, ObjectReference, ObjectReferenceType, Paginated, ReferencesQuery } from '../interfaces';
 import { ObjectReferenceService } from '../services/object-reference.service';
 import { APIBaseMock } from './api-base.mock';
 export declare class ObjectReferenceMockService extends APIBaseMock<ObjectReference> implements ObjectReferenceService {
     constructor(initialData: ObjectReference[]);
-    find(query: ReferencesQuery, _options?: TokenOption): Promise<Paginated<ObjectReference>>;
-    findAll(objId: string, _options?: TokenOption): Promise<ObjectReference[]>;
-    create(dto: CreateReferenceDto, _options?: TokenOption): Promise<ObjectReference>;
-    update(referenceId: number, updateData: Partial<Omit<ObjectReference, 'id' | 'createdAt'>>, _options?: TokenOption): Promise<ObjectReference>;
-    deleteById(refId: string, _options?: TokenOption): Promise<void>;
-    deleteByReference(src: string, tgt: string, relType: ObjectReferenceType, _options?: TokenOption): Promise<void>;
-    checkConnection(srcId: string, tgtId: string, type?: ObjectReferenceType, _options?: TokenOption): Promise<boolean>;
+    find(query: ReferencesQuery, _options?: Config): Promise<Paginated<ObjectReference>>;
+    findAll(objId: string, _options?: Config): Promise<ObjectReference[]>;
+    create(dto: CreateReferenceDto, _options?: Config): Promise<ObjectReference>;
+    deleteById(refId: string, _options?: Config): Promise<void>;
+    deleteByReference(src: string, tgt: string, relType: ObjectReferenceType, _options?: Config): Promise<void>;
+    checkConnection(srcId: string, tgtId: string, type?: ObjectReferenceType, _options?: Config): Promise<boolean>;
 }

package/src/lib/mock/object-reference.mock.service.js

@@ -25,10 +25,16 @@ class ObjectReferenceMockService extends api_base_mock_1.APIBaseMock {
             // Note: connectedObjType filter logic could be added here if needed
             return true;
         });
+        const limit = query.limit ?? docs.length;
+        const page = query.page ?? 1;
+        const start = (page - 1) * limit;
+        const paginatedDocs = docs.slice(start, start + limit);
         return {
-            docs,
+            docs: paginatedDocs,
             total: docs.length,
-            limit: docs.length,
+            limit,
+            page,
+            pages: limit > 0 ? Math.ceil(docs.length / limit) : 0,
         };
     }
     async findAll(objId, _options = {}) {
@@ -43,8 +49,8 @@ class ObjectReferenceMockService extends api_base_mock_1.APIBaseMock {
             tgtType: dto.tgtType,
             relType: dto.relType,
             relSrc: dto.relSrc,
-            displayData: dto.displayData,
-            tgtDeleted: dto.tgtDeleted ?? false,
+            displayData: {},
+            tgtDeleted: false,
             createdAt: Date.now(),
             updatedAt: Date.now(),
             createdBy: 'mock-user',
@@ -52,18 +58,6 @@ class ObjectReferenceMockService extends api_base_mock_1.APIBaseMock {
         this.data.push(newRef);
         return newRef;
     }
-    async update(referenceId, updateData, _options = {}) {
-        const index = this.data.findIndex((ref) => ref.id === referenceId);
-        if (index === -1) {
-            throw new Error(`Reference with id ${referenceId} not found`);
-        }
-        this.data[index] = {
-            ...this.data[index],
-            ...updateData,
-            updatedAt: Date.now(),
-        };
-        return this.data[index];
-    }
     async deleteById(refId, _options = {}) {
         const id = parseInt(refId, 10);
         this.data = this.data.filter((ref) => ref.id !== id);

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

@@ -1,4 +1,4 @@
-import { DeleteQuery, Paginated, RequestParameter, Task } from '../interfaces';
+import { Config, DeleteQuery, Paginated, PermissionLevel, RequestParameter, Task } from '../interfaces';
 import { TaskService } from '../services';
 import type { CreateAbsenceRequest } from '../services/task.service';
 import { DataMockService } from './data.mock.service';
@@ -13,6 +13,7 @@ declare class BaseService extends BaseService_base {
 }
 export declare class TaskMockService extends BaseService implements TaskService {
     constructor(tasks: Task[]);
+    getReferenceCheck(id: string, _permissionLevel: PermissionLevel, _options?: Config): Promise<Task>;
     createTaskAttachedToAsset(dto: any): Promise<Task>;
     createAbsence(dto: CreateAbsenceRequest): Promise<Task>;
     deleteOne(taskId: string, deleteQuery?: DeleteQuery): Promise<Task>;

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

@@ -11,6 +11,9 @@ class TaskMockService extends BaseService {
     constructor(tasks) {
         super(tasks);
     }
+    getReferenceCheck(id, _permissionLevel, _options = {}) {
+        return this.getOne(id);
+    }
     async createTaskAttachedToAsset(dto) {
         this.data.push(dto);
         return Promise.resolve(dto);

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

@@ -1,5 +1,5 @@
 import { APIBase } from '../api-base';
-import { AiAssistant, AiAssistantId, AiSkill, AiSkillSummary, AudioTranscription, Config, Message, OneShotTaskId, OneShotTaskResult, Paginated, Thread, ThreadPopulated, TokenOption } from '../interfaces';
+import { AiAssistant, AiAssistantId, AiSkill, AiSkillSummary, AudioTranscription, Config, Message, OneShotTaskId, OneShotTaskResult, Paginated, PermissionLevel, Thread, ThreadPopulated, TokenOption } from '../interfaces';
 import { CrossPlatformFormData } from '../utils';
 import { HttpClientService } from './http-client.service';
 export declare class AiService extends APIBase {
@@ -19,6 +19,8 @@ export declare class AiService extends APIBase {
     replaceSkill(id: string, form: CrossPlatformFormData, options?: Config): Promise<AiSkill>;
     getThreadMessages(threadId: string): Promise<Paginated<Message>>;
     getThread(threadId: string): Promise<ThreadPopulated>;
+    getThreadReferenceCheck(threadId: string, permissionLevel?: PermissionLevel, options?: Config): Promise<ThreadPopulated>;
+    getUserMessageReferenceCheck(messageId: string, permissionLevel?: PermissionLevel, options?: Config): Promise<Message>;
     getLatestThread(): Promise<ThreadPopulated>;
     listThreads(assistantIds?: AiAssistantId[], params?: {}, options?: TokenOption): Promise<ThreadPopulated[]>;
     provideFeedback(traceId: string, value: number, comment?: string): Promise<void>;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiService = void 0;
 const api_base_1 = require("../api-base");
+const interfaces_1 = require("../interfaces");
 const utils_1 = require("../utils");
 const AUDIO_TRANSCRIPTION_TIMEOUT_MS = 5 * 60000;
 class AiService extends api_base_1.APIBase {
@@ -62,6 +63,18 @@ class AiService extends api_base_1.APIBase {
     getThread(threadId) {
         return this.httpClient.get(`${this.basePath}/threads/${threadId}`);
     }
+    getThreadReferenceCheck(threadId, permissionLevel = interfaces_1.PermissionLevel.NONE, options = {}) {
+        return this.httpClient.get(`${this.basePath}/threads/${threadId}/reference-check`, {
+            ...options,
+            params: { permissionLevel, ...options.params },
+        });
+    }
+    getUserMessageReferenceCheck(messageId, permissionLevel = interfaces_1.PermissionLevel.NONE, options = {}) {
+        return this.httpClient.get(`${this.basePath}/messages/${messageId}/reference-check`, {
+            ...options,
+            params: { permissionLevel, ...options.params },
+        });
+    }
     getLatestThread() {
         return this.httpClient.get(`${this.basePath}/threads/latest`);
     }

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

@@ -1,4 +1,4 @@
-import { AddToProperty, Asset, AssetRevision, Attachment, DeleteAssetQuery, EventCause, EventLevelOverride, Filter, Paginated, RemoveFromProperty, RequestParameter, SearchResultItem, TokenOption, Translation } from '../interfaces';
+import { AddToProperty, Asset, AssetRevision, Attachment, Config, DeleteAssetQuery, EventCause, EventLevelOverride, Filter, Paginated, PermissionLevel, RemoveFromProperty, RequestParameter, SearchResultItem, TokenOption, Translation } from '../interfaces';
 import { CrossPlatformFormData } from '../utils';
 import { DataService } from './data.service';
 import { HttpClientService } from './http-client.service';
@@ -13,6 +13,7 @@ declare class BaseService extends BaseService_base {
 }
 export declare class AssetService extends BaseService {
     constructor(httpClient: HttpClientService);
+    getReferenceCheck(id: string, permissionLevel: PermissionLevel, options?: Config): Promise<Asset>;
     count(filter: Filter, options?: TokenOption): Promise<number>;
     deleteOne(id: string, deleteQuery?: DeleteAssetQuery, options?: TokenOption): Promise<any>;
     addAttachment: (id: string, form: CrossPlatformFormData, options?: TokenOption) => Promise<Asset>;

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

@@ -20,6 +20,12 @@ class AssetService extends BaseService {
             });
         };
     }
+    getReferenceCheck(id, permissionLevel, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${id}/reference-check`, {
+            ...options,
+            params: { ...options.params, permissionLevel },
+        });
+    }
     count(filter, options = {}) {
         const params = { filter: (0, utils_1.getFilterString)(filter) };
         return this.httpClient.get(`${this.basePath}/count`, { params, ...options });

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

@@ -1,4 +1,4 @@
-import { Config, Content, ReturnType, TokenOption } from '../interfaces';
+import { Config, Content, PermissionLevel, ReturnType, TokenOption } from '../interfaces';
 import { CrossPlatformFormData } from '../utils';
 import { DataService } from './data.service';
 import { HttpClientService } from './http-client.service';
@@ -13,6 +13,7 @@ declare class BaseService extends BaseService_base {
 }
 export declare class ContentService extends BaseService {
     constructor(httpClient: HttpClientService);
+    getReferenceCheck(id: string, permissionLevel: PermissionLevel, options?: Config): Promise<Content>;
     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

@@ -22,6 +22,12 @@ class ContentService extends BaseService {
             });
         };
     }
+    getReferenceCheck(id, permissionLevel, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${id}/reference-check`, {
+            ...options,
+            params: { ...options.params, permissionLevel },
+        });
+    }
     async download(id, second, options = {}) {
         let returnType;
         if (typeof second === 'boolean' || second == null) {

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

@@ -1,4 +1,4 @@
-import { Event, EventCountByAsset, TokenOption } from '../interfaces';
+import { Config, Event, EventCountByAsset, PermissionLevel, TokenOption } from '../interfaces';
 import { DataService } from './data.service';
 import { HttpClientService } from './http-client.service';
 import { ShareService } from './share.service';
@@ -9,6 +9,7 @@ declare class BaseService extends BaseService_base {
 }
 export declare class EventService extends BaseService {
     constructor(httpClient: HttpClientService);
+    getReferenceCheck(id: string, permissionLevel: PermissionLevel, options?: Config): Promise<Event>;
     getEventCountByAsset(assetId: string, options?: TokenOption): Promise<EventCountByAsset>;
     getLastEventByAssetAndGroup(assetId: string, group: string, options?: TokenOption): Promise<Event>;
     getLastEventByAssetAndGroups(assetId: string, groups: string[], options?: TokenOption): Promise<Record<string, string>>;

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

@@ -10,6 +10,12 @@ class EventService extends BaseService {
     constructor(httpClient) {
         super(httpClient, '/events');
     }
+    getReferenceCheck(id, permissionLevel, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${id}/reference-check`, {
+            ...options,
+            params: { ...options.params, permissionLevel },
+        });
+    }
     getEventCountByAsset(assetId, options = {}) {
         return this.httpClient.get(`${this.basePath}/countByAsset/${assetId}`, options);
     }

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

@@ -1,8 +1,9 @@
 import { APIBase } from '../api-base';
-import { LogbookEntry, LogbookEntryDto, Paginated, TokenOption } from '../interfaces';
+import { Config, LogbookEntry, LogbookEntryDto, Paginated, PermissionLevel, TokenOption } from '../interfaces';
 import { HttpClientService } from './http-client.service';
 export declare class LogbookService extends APIBase {
     constructor(httpClient: HttpClientService);
+    getReferenceCheck(entryId: string, permissionLevel: PermissionLevel, options?: Config): Promise<LogbookEntry>;
     getEntries(taskId: string, limit?: number, offset?: number, options?: TokenOption): Promise<Paginated<LogbookEntry>>;
     getEntriesByIds(ids: string[], options?: TokenOption): Promise<LogbookEntry[]>;
     addEntry(taskId: string, entry: LogbookEntryDto, options?: TokenOption): Promise<LogbookEntry>;

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

@@ -6,6 +6,12 @@ class LogbookService extends api_base_1.APIBase {
     constructor(httpClient) {
         super(httpClient, '/tasks/logbook');
     }
+    getReferenceCheck(entryId, permissionLevel, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${entryId}/reference-check`, {
+            ...options,
+            params: { ...options.params, permissionLevel },
+        });
+    }
     getEntries(taskId, limit = 50, offset = 0, options = {}) {
         return this.httpClient.get(this.basePath, {
             ...options,

package/src/lib/services/object-reference.service.d.ts

@@ -1,13 +1,12 @@
 import { APIBase } from '../api-base';
-import { CreateReferenceDto, ObjectReference, ObjectReferenceType, Paginated, ReferencesQuery, TokenOption } from '../interfaces';
+import { Config, CreateReferenceDto, ObjectReference, ObjectReferenceType, Paginated, ReferencesQuery } from '../interfaces';
 import { HttpClientService } from './http-client.service';
 export declare class ObjectReferenceService extends APIBase {
     constructor(httpClient: HttpClientService);
-    find(query: ReferencesQuery, options?: TokenOption): Promise<Paginated<ObjectReference>>;
-    findAll(objId: string, options?: TokenOption): Promise<ObjectReference[]>;
-    create(dto: CreateReferenceDto, options?: TokenOption): Promise<ObjectReference>;
-    update(referenceId: number, updateData: Partial<Omit<ObjectReference, 'id' | 'createdAt'>>, options?: TokenOption): Promise<ObjectReference>;
-    deleteById(refId: string, options?: TokenOption): Promise<void>;
-    deleteByReference(src: string, tgt: string, relType: ObjectReferenceType, options?: TokenOption): Promise<void>;
-    checkConnection(srcId: string, tgtId: string, type?: ObjectReferenceType, options?: TokenOption): Promise<boolean>;
+    find(query: ReferencesQuery, options?: Config): Promise<Paginated<ObjectReference>>;
+    findAll(objId: string, options?: Config): Promise<ObjectReference[]>;
+    create(dto: CreateReferenceDto, options?: Config): Promise<ObjectReference>;
+    deleteById(refId: string, options?: Config): Promise<void>;
+    deleteByReference(src: string, tgt: string, relType: ObjectReferenceType, options?: Config): Promise<void>;
+    checkConnection(srcId: string, tgtId: string, type?: ObjectReferenceType, options?: Config): Promise<boolean>;
 }

package/src/lib/services/object-reference.service.js

@@ -21,6 +21,15 @@ class ObjectReferenceService extends api_base_1.APIBase {
         if (query.objIsSrc === true) {
             params.append('objIsSrc', query.objIsSrc.toString());
         }
+        if (query.limit !== undefined) {
+            params.append('limit', query.limit.toString());
+        }
+        if (query.page !== undefined) {
+            params.append('page', query.page.toString());
+        }
+        if (query.sort) {
+            params.append('sort', query.sort);
+        }
         return await this.httpClient.get(`${this.basePath}?${params.toString()}`, options);
     }
     async findAll(objId, options = {}) {
@@ -29,9 +38,6 @@ class ObjectReferenceService extends api_base_1.APIBase {
     async create(dto, options = {}) {
         return await this.httpClient.post(this.basePath, dto, options);
     }
-    async update(referenceId, updateData, options = {}) {
-        return await this.httpClient.put(`${this.basePath}/${referenceId}`, updateData, options);
-    }
     async deleteById(refId, options = {}) {
         await this.httpClient.delete(`${this.basePath}/${refId}`, options);
     }

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

@@ -1,4 +1,4 @@
-import { Paginated, Task, TokenOption } from '../interfaces';
+import { Config, Paginated, PermissionLevel, Task, TokenOption } from '../interfaces';
 import { DataService } from './data.service';
 import { HttpClientService } from './http-client.service';
 import { ShareService } from './share.service';
@@ -20,6 +20,7 @@ export interface CreateAbsenceRequest {
 }
 export declare class TaskService extends BaseService {
     constructor(httpClient: HttpClientService);
+    getReferenceCheck(id: string, permissionLevel: PermissionLevel, options?: Config): Promise<Task>;
     createTaskAttachedToAsset(dto: any, options?: TokenOption): Promise<Task>;
     findByName(name: string, options?: TokenOption): Promise<Paginated<Task>>;
     findByAsset(assetId: string, options?: TokenOption): Promise<Paginated<Task>>;

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

@@ -11,6 +11,12 @@ class TaskService extends BaseService {
     constructor(httpClient) {
         super(httpClient, '/tasks');
     }
+    getReferenceCheck(id, permissionLevel, options = {}) {
+        return this.httpClient.get(`${this.basePath}/${id}/reference-check`, {
+            ...options,
+            params: { ...options.params, permissionLevel },
+        });
+    }
     // we may not need this method (already have the addOne method from ShareService)
     createTaskAttachedToAsset(dto, options = {}) {
         return this.httpClient.post(this.basePath, dto, options);