@hahnpro/hpc-api 2026.10.3 → 2026.10.5

package/CHANGELOG.md

@@ -1,10 +1,19 @@
 # @hahnpro/hpc-api
 
+# 2026.10.4
+
+- Added `ToolName.ADD_ATTACHMENT_TO_ASSET` for attaching existing Content objects to Assets through AI #5158
+- Removed `AssetService.addAttachment`; upload content and create an `ASSET_ATTACHMENT` object reference instead
+- Deprecated `Asset.attachments` in favor of `AssetService.getAttachments`
+- Updated the attachment examples to use the object-reference workflow
+- Added asset type search support through `AssetTypesService.search`
+
 # 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
+- Expanded object-reference service request options from `TokenOption` to `Config`
 
 # 2026.9.11
 

package/README.md

@@ -60,7 +60,7 @@ defaults to `https://testing.hahnpro.com`), `AUTH_BASE_URL` (defaults to `API_BA
 `AUTH_REALM` (defaults to `hpc`), `API_USER` and `AUTH_SECRET` environment variables;
 
 ```typescript
-import { API } from '@hahnpro/flow-sdk';
+import { API, ObjectReferenceType, ResourceType } from '@hahnpro/flow-sdk';
 // or by using dotenv
 import * as dotenv from 'dotenv';
 
@@ -304,14 +304,16 @@ res = requests.get(API_BASE_URL + API_CM_PATH + '/' + contentId + '/download', h
 blob = res.content
 ```
 
+> **Deprecated:** `Asset.attachments` and the legacy asset attachment endpoints are retained for compatibility. Use `ASSET_ATTACHMENT` object references instead.
+
 Download Content attached to an Asset:
 
 ```python
 ASSET_WITH_CONTENT = '1234'
-res = requests.get(API_BASE_URL + API_AM_PATH +'/' + ASSET_WITH_CONTENT, headers=headers)
-attachments = res.json()['attachments']
+res = requests.get(API_BASE_URL + API_AM_PATH + '/' + ASSET_WITH_CONTENT + '/attachments', headers=headers)
+attachments = res.json()['docs']
 
-res = requests.get(API_BASE_URL + API_CM_PATH + '/' + attachments[0] + '/download', headers=headers)
+res = requests.get(API_BASE_URL + API_CM_PATH + '/' + attachments[0]['id'] + '/download', headers=headers)
 blob = res.content
 ```
 
@@ -337,13 +339,13 @@ res = requests.post(API_BASE_URL + API_CM_PATH, files=files, data=payload, heade
 Attach Content to Asset:
 
 ```python
-files = {'file': open('somefile.txt', 'rb')}
-payload={
-    'readPermissions': 'test',
-    'readWritePermissions': 'test'
+content = requests.post(API_BASE_URL + API_CM_PATH, data=payload, files=files, headers=headers).json()
+reference = {
+    'srcId': '1234', 'tgtId': content['id'],
+    'srcType': 'asset', 'tgtType': 'content',
+    'relSrc': 'api-client', 'relType': 'asset_attachment'
 }
-
-res = requests.post(API_BASE_URL + API_AM_PATH + '/1234/attachment', data=payload, files=files, headers=headers)
+res = requests.post(API_BASE_URL + '/api/references', json=reference, headers=headers)
 ```
 
 </details>
@@ -365,11 +367,13 @@ const content = await api.contents.getOne('1234');
 const file = await api.contents.download(content.id);
 ```
 
+> **Deprecated:** `Asset.attachments` and the legacy asset attachment endpoints are retained for compatibility. Use `ASSET_ATTACHMENT` object references instead.
+
 Download Content attached to an Asset:
 
 ```typescript
-const asset = await api.contents.getOne('1234');
-const file = await api.contents.download(asset.attachments[0]);
+const attachments = await api.assets.getAttachments('1234');
+const file = await api.contents.download(attachments.docs[0].id);
 ```
 
 Upload new Content:
@@ -388,14 +392,16 @@ await api.contents.upload(form);
 Attach Content to Asset:
 
 ```typescript
-import FormData from 'form-data';
-
-const form = new FormData();
-form.append('file', fs.createReadStream('/foo/bar.jpg'));
-form.append('readPermission', 'test');
-form.append('readWritePermission', 'test');
-
-await api.assets.addAttachment('1234', form);
+const asset = await api.assets.getOne('1234');
+const content = await api.contents.upload(form);
+await api.objectReferences.create({
+  srcId: asset.id,
+  tgtId: content.id,
+  srcType: ResourceType.ASSET,
+  tgtType: ResourceType.CONTENT,
+  relSrc: 'example',
+  relType: ObjectReferenceType.ASSET_ATTACHMENT,
+});
 ```
 
 </details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hahnpro/hpc-api",
-  "version": "2026.10.3",
+  "version": "2026.10.5",
   "description": "Module for easy access to the HahnPRO Cloud API",
   "license": "MIT",
   "author": {
@@ -15,10 +15,10 @@
   "dependencies": {
     "@microsoft/fetch-event-source": "2.0.1",
     "axios": "1.20.0",
-    "eventsource": "5.1.2",
+    "eventsource": "5.1.3",
     "jose": "6.2.12",
     "jwt-decode": "4.0.0",
-    "p-queue": "9.3.3",
+    "p-queue": "10.0.0",
     "rxjs": "7.8.2",
     "ts-mixer": "6.0.4",
     "tslib": "2.8.1"

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

@@ -93,6 +93,7 @@ export declare enum ToolName {
     FIND_TASK_BY_NAME = "findTaskByName",
     GET_TASK_LOGBOOK_ENTRIES = "getTaskLogbookEntries",
     CREATE_EVENT = "createEvent",
+    ADD_ATTACHMENT_TO_ASSET = "addAttachmentToAsset",
     GET_ASSET_DATA = "getAssetData",
     ASSET_SELECTION = "assetSelection",
     SEARCH_FOR_ASSETS_BY_ID_NAME_TYPE = "searchForAssetsByIdNameType",

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

@@ -104,6 +104,7 @@ var ToolName;
     ToolName["FIND_TASK_BY_NAME"] = "findTaskByName";
     ToolName["GET_TASK_LOGBOOK_ENTRIES"] = "getTaskLogbookEntries";
     ToolName["CREATE_EVENT"] = "createEvent";
+    ToolName["ADD_ATTACHMENT_TO_ASSET"] = "addAttachmentToAsset";
     ToolName["GET_ASSET_DATA"] = "getAssetData";
     ToolName["ASSET_SELECTION"] = "assetSelection";
     ToolName["SEARCH_FOR_ASSETS_BY_ID_NAME_TYPE"] = "searchForAssetsByIdNameType";

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

@@ -51,6 +51,7 @@ export interface Asset {
     relations?: any[];
     data?: any;
     image?: string;
+    /** Legacy compatibility and revision data only. Use ASSET_ATTACHMENT object references and assets.getAttachments(). */
     attachments?: string[];
     notificationEndpoints?: string[];
     aliases?: string[];

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

@@ -0,0 +1,5 @@
+import { LocalizedText } from './localized-text.interface';
+export interface Permission {
+    translations: LocalizedText | string;
+    value: string;
+}

package/src/lib/interfaces/authz/permission.interface.js

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

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

@@ -6,7 +6,7 @@ export type { Audit } from './audit.interface';
 export type { Author } from './author.interface';
 export type { AzureBillingEvent, AzureBillingResult, Billing, BillingEvent, BillingResource, BillingSubscription, BillingValues, OnceBilledResources, RegularlyBilledResources, } from './billing.interface';
 export type { Content, ContentAnalysis, ContentChange, ContentSearchResult, IndexingStatusData, ReindexStatusSsePayload, } from './content.interface';
-export type { CompanyCandidate, ContactCandidate, CrmDealReminderDeliveryResult, CrmContactMergeOverrides, CrmDuplicateEntityType, CrmDuplicateGroup, CrmDuplicateGroupStatus, CrmDuplicateMember, CrmDuplicateReasonCode, CrmEmailMerge, CrmGetContactDuplicatesResponse, CrmGetDuplicatesQuery, CrmGetDuplicatesResponse, CrmImportContactDuplicateDetails, CrmImportContactDuplicateMemberDetails, CrmImportDuplicateDecision, CrmImportDuplicateEntityType, CrmImportDuplicateGroup, CrmImportDuplicateMember, CrmImportDuplicateReasonCode, CrmImportJsonRequest, CrmImportParser, CrmImportResponse, CrmMergeContactDuplicatesRequest, CrmMergeContactDuplicatesResponse, ImportResult, ImportResultStats, MatchResult, MeetingReport, ReportActivity, ReportParticipant, ReportSummary, SendDealReminderPayload, TouchpointCandidate, } from './crm.interface';
+export type { CompanyCandidate, ContactCandidate, CrmContactMergeOverrides, CrmDealReminderDeliveryResult, CrmDuplicateEntityType, CrmDuplicateGroup, CrmDuplicateGroupStatus, CrmDuplicateMember, CrmDuplicateReasonCode, CrmEmailMerge, CrmGetContactDuplicatesResponse, CrmGetDuplicatesQuery, CrmGetDuplicatesResponse, CrmImportContactDuplicateDetails, CrmImportContactDuplicateMemberDetails, CrmImportDuplicateDecision, CrmImportDuplicateEntityType, CrmImportDuplicateGroup, CrmImportDuplicateMember, CrmImportDuplicateReasonCode, CrmImportJsonRequest, CrmImportParser, CrmImportResponse, CrmMergeContactDuplicatesRequest, CrmMergeContactDuplicatesResponse, ImportResult, ImportResultStats, MatchResult, MeetingReport, ReportActivity, ReportParticipant, ReportSummary, SendDealReminderPayload, TouchpointCandidate, } from './crm.interface';
 export type { DataInterface, Filter, Paginated, RequestParameter } from './data.interface';
 export type { DataspaceAllowedResourceType, DataspaceWorkflowResult, DataspaceWorkflowStatus, ShareInDataspaceDto, } from './dataspace.interface';
 export type { EdgeDeviceRequestResponse, EdgeDeviceResult, WebIOData } from './edge-device.interface';
@@ -45,7 +45,7 @@ export type { MostRecentTimeSeriesValueUpdate, Retention, SearchTimeSeriesResult
 export type { CreateTimeSeriesValueFeedDto, TimeSeriesValueFeed, TimeSeriesValueFeedManagementApi, TimeSeriesValueFeedUrls, UpdateTimeSeriesValueFeedDto, } from './time-series-value-feed.interface';
 export { MAX_TIME_SERIES_PER_VALUE_FEED } from './time-series-value-feed.interface';
 export type { Translation, TranslationData } from './translation.interface';
-export type { Consent, Permission, TableSetting, TableSettingProfile, UserSettings } from './user-settings.interface';
+export type { Consent, TableSetting, TableSettingProfile, UserSettings, Permission } from './user-settings.interface';
 export type { KVSecretVersion, VaultSecret } from './vault.interface';
 export { AgentId, AiAssistantId, AssistantMessageStatus, ATTACHMENT_CAPABLE_AGENT_IDS, AttachmentHandlingMode, AvailableLanguages, ErrorMessageType, FinishReason, HandOffTool, OneShotTaskId, ReferenceType, ReturnToReferrerTool, Role, ToolMessageStatus, ToolName, ToolType, } from './ai.interface';
 export { AlertLevel, AlertStatus, AlertType, DEFAULT_DEADMAN_CONDITION, DEFAULT_RELATIVE_CONDITION, DEFAULT_THRESHOLD_CONDITION, } from './alert.interface';

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

@@ -13,6 +13,8 @@ export declare const NatsConsumers: {
         readonly ContentDeindexer: "content-deindexer";
         readonly ContentAnalysis: {
             readonly AssetsReferencesResolver: "content-analysis-assets-references-resolver";
+            readonly AssetAttachmentReferenceCreated: "content-analysis-asset-attachment-reference-created";
+            readonly AssetAttachmentReferenceDeleted: "content-analysis-asset-attachment-reference-deleted";
             readonly ContentTrashed: "content-trashed";
             readonly ContentRestored: "content-restored";
         };

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

@@ -16,6 +16,8 @@ exports.NatsConsumers = {
         ContentDeindexer: 'content-deindexer',
         ContentAnalysis: {
             AssetsReferencesResolver: 'content-analysis-assets-references-resolver',
+            AssetAttachmentReferenceCreated: 'content-analysis-asset-attachment-reference-created',
+            AssetAttachmentReferenceDeleted: 'content-analysis-asset-attachment-reference-deleted',
             ContentTrashed: 'content-trashed',
             ContentRestored: 'content-restored',
         },

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

@@ -28,8 +28,13 @@ export declare class AssetMockService extends BaseService implements AssetServic
     deleteOne(assetId: string, deleteQuery?: DeleteQuery): Promise<Asset>;
     getMany(params?: RequestParameter): Promise<Paginated<Asset>>;
     updateOne(assetId: string, dto: Asset): Promise<Asset>;
-    addAttachment(id: string, form: CrossPlatformFormData): Promise<Asset>;
-    getAttachments(assetId: string): Promise<Paginated<Attachment>>;
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
+    getAttachments(assetId: string, params?: RequestParameter): Promise<Paginated<Attachment>>;
+    /** Legacy attachment endpoint. Use ASSET_ATTACHMENT object-reference APIs instead. */
+    bulkRemoveAttachments(assetId: string, attachmentIds: string[]): Promise<Asset>;
+    /** Legacy flow-module compatibility. Use content upload plus an ASSET_ATTACHMENT object reference instead. */
+    addAttachment(assetId: string, form: CrossPlatformFormData, _options?: TokenOption): Promise<Asset>;
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
     getAssetsByAttachment(contentId: string, params?: RequestParameter): Promise<Paginated<Asset>>;
     getChildren(assetId: string, params?: RequestParameter): Promise<Paginated<Asset>>;
     getEventLevelOverride(ids: string[], causes: string[]): Promise<EventLevelOverride>;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AssetMockService = void 0;
 const ts_mixer_1 = require("ts-mixer");
+const interfaces_1 = require("../interfaces");
 const data_mock_service_1 = require("./data.mock.service");
 const share_mock_service_1 = require("./share.mock.service");
 const trash_mock_service_1 = require("./trash.mock.service");
@@ -63,19 +64,89 @@ class AssetMockService extends BaseService {
         const asset = await this.addOne(dto);
         return Promise.resolve(asset);
     }
-    async addAttachment(id, form) {
-        const asset = this.data.find((v) => v.id === id);
-        const content = await this.api.contents.upload(form);
-        asset.attachments.push(content.id);
-        return Promise.resolve(asset);
-    }
-    async getAttachments(assetId) {
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
+    async getAttachments(assetId, params = {}) {
+        const asset = this.data.find((v) => v.id === assetId);
+        const legacyAttachmentIds = (asset?.attachments ?? []).map((attachmentId) => attachmentId.toString());
+        const references = await this.api.objectReferences.find({
+            objId: assetId,
+            types: [interfaces_1.ObjectReferenceType.ASSET_ATTACHMENT],
+            objIsSrc: true,
+        });
+        const attachmentIds = new Set([...legacyAttachmentIds, ...references.docs.map((reference) => reference.tgt)]);
         const contents = await this.api.contents.getMany();
-        const docs = contents.docs.filter((c) => c.assets?.includes?.(assetId));
-        return { docs, total: docs.length, limit: 0 };
+        const docs = contents.docs.filter((content) => content.id && attachmentIds.has(content.id));
+        const limit = params.limit ?? Number.MAX_SAFE_INTEGER;
+        const page = params.page ?? 1;
+        const start = (page - 1) * limit;
+        return {
+            docs: limit > 0 ? docs.slice(start, start + limit) : [],
+            total: docs.length,
+            limit,
+            page,
+            pages: limit > 0 ? Math.ceil(docs.length / limit) : 0,
+        };
+    }
+    /** Legacy attachment endpoint. Use ASSET_ATTACHMENT object-reference APIs instead. */
+    async bulkRemoveAttachments(assetId, attachmentIds) {
+        const asset = this.data.find((v) => v.id === assetId);
+        if (!asset) {
+            throw new Error(`Asset ${assetId} not found`);
+        }
+        const attachmentIdsToRemove = new Set(attachmentIds);
+        asset.attachments = (asset.attachments ?? []).filter((attachmentId) => !attachmentIdsToRemove.has(attachmentId));
+        const references = await this.api.objectReferences.find({
+            objId: assetId,
+            types: [interfaces_1.ObjectReferenceType.ASSET_ATTACHMENT],
+            objIsSrc: true,
+        });
+        await Promise.all(references.docs
+            .filter((reference) => attachmentIdsToRemove.has(reference.tgt))
+            .map((reference) => this.api.objectReferences.deleteById(reference.id.toString())));
+        return asset;
+    }
+    /** Legacy flow-module compatibility. Use content upload plus an ASSET_ATTACHMENT object reference instead. */
+    async addAttachment(assetId, form, _options = {}) {
+        const asset = this.data.find((v) => v.id === assetId);
+        if (!asset) {
+            throw new Error(`Asset ${assetId} not found`);
+        }
+        const content = await this.api.contents.upload(form);
+        if (!content.id) {
+            throw new Error('Uploaded content has no id');
+        }
+        await this.api.objectReferences.create({
+            srcId: assetId,
+            tgtId: content.id,
+            srcType: interfaces_1.ResourceType.ASSET,
+            tgtType: interfaces_1.ResourceType.CONTENT,
+            relSrc: 'mock-api',
+            relType: interfaces_1.ObjectReferenceType.ASSET_ATTACHMENT,
+        });
+        return {
+            ...asset,
+            attachments: [...(asset.attachments ?? []), content.id],
+        };
     }
-    getAssetsByAttachment(contentId, params = {}) {
-        return this.getManyFiltered({ attachments: contentId }, params);
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
+    async getAssetsByAttachment(contentId, params = {}) {
+        const references = await this.api.objectReferences.find({
+            objId: contentId,
+            types: [interfaces_1.ObjectReferenceType.ASSET_ATTACHMENT],
+            objIsTgt: true,
+        });
+        const assetIds = references.docs.map((reference) => reference.src);
+        const docs = this.data.filter((asset) => asset.attachments?.includes(contentId) || assetIds.includes(asset.id));
+        const limit = params.limit ?? Number.MAX_SAFE_INTEGER;
+        const page = params.page ?? 1;
+        const start = (page - 1) * limit;
+        return {
+            docs: limit > 0 ? docs.slice(start, start + limit) : [],
+            total: docs.length,
+            limit,
+            page,
+            pages: limit > 0 ? Math.ceil(docs.length / limit) : 0,
+        };
     }
     getChildren(assetId, params = {}) {
         return this.getManyFiltered({ parent: assetId }, params);

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

@@ -1,4 +1,4 @@
-import { AssetType, AssetTypeRevision, DeleteAssetTypeQuery, Paginated, RequestParameter, Template, TokenOption } from '../interfaces';
+import { AssetType, AssetTypeRevision, AssetTypeSearchResult, DeleteAssetTypeQuery, Paginated, RequestParameter, Template, TokenOption } from '../interfaces';
 import { AssetTypesService } from '../services';
 import { DataMockService } from './data.mock.service';
 import { ShareMockService } from './share.mock.service';
@@ -18,6 +18,7 @@ export declare class AssetTypesMockService extends BaseService implements AssetT
     deleteOne(id: string, deleteQuery?: DeleteAssetTypeQuery): Promise<any>;
     updateOne(id: string, dto: AssetType): Promise<AssetType>;
     getAssetCount(id: string): Promise<number>;
+    search(query: string, _params?: RequestParameter, _options?: TokenOption): Promise<AssetTypeSearchResult[]>;
     getRevisions(id: string): Promise<Paginated<AssetTypeRevision>>;
     rollback(id: string, revisionId: string): Promise<AssetType>;
     deleteRevision(assetId: string, revisionId: string): Promise<any>;

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

@@ -52,6 +52,18 @@ class AssetTypesMockService extends BaseService {
     getAssetCount(id) {
         return Promise.resolve(0);
     }
+    search(query, _params = {}, _options = {}) {
+        const normalizedQuery = query.toLowerCase();
+        return Promise.resolve(this.data
+            .filter((assetType) => !assetType.deletedAt && assetType.name.toLowerCase().includes(normalizedQuery))
+            .map((assetType) => ({
+            id: assetType.id,
+            name: assetType.name,
+            isSystemAssetType: assetType.isSystemAssetType ?? false,
+            isGlobalAssetType: false,
+            owner: assetType.owner,
+        })));
+    }
     getRevisions(id) {
         const revisions = this.revisions.filter((revision) => revision.originalId === id);
         const page = {

package/src/lib/queue.d.ts

@@ -8,7 +8,7 @@ export declare class Queue extends PQueueBase {
     private total;
     private readonly throwOnTimeout;
     constructor({ throwOnTimeout, ...options }: QueueOptions);
-    add<TaskResultType>(function_: QueueTask<TaskResultType>, options?: Partial<QueueAddOptions>): Promise<TaskResultType>;
+    add<TaskResultType>(function_: QueueTask<TaskResultType>, options?: Partial<QueueAddOptions>): Promise<Awaited<TaskResultType>>;
     getStats(): {
         peak: number;
         pending: number;

package/src/lib/queue.js

@@ -10,10 +10,10 @@ class Queue extends PQueueBase {
         this.peak = 0;
         this.total = 0;
         this.throwOnTimeout = throwOnTimeout;
-        this.on('add', () => {
+        this.addEventListener('add', () => {
             this.peak = Math.max(this.peak, this.size);
         });
-        this.on('active', () => {
+        this.addEventListener('active', () => {
             this.total++;
         });
     }

package/src/lib/services/api-workflow.helpers.d.ts

@@ -0,0 +1,13 @@
+import { Config, Content } from '../interfaces';
+import { CrossPlatformFormData } from '../utils';
+import { ContentService } from './content.service';
+import { ObjectReferenceService } from './object-reference.service';
+export interface AssetAttachmentApi {
+    contents: Pick<ContentService, 'upload' | 'deleteOne'>;
+    objectReferences: Pick<ObjectReferenceService, 'create'>;
+}
+/**
+ * Uploads content and attaches it to an asset as an ASSET_ATTACHMENT reference.
+ * If the reference cannot be created, the uploaded content is removed again.
+ */
+export declare function uploadAssetAttachment(api: AssetAttachmentApi, assetId: string, form: CrossPlatformFormData, relSrc: string, options?: Config): Promise<Content>;

package/src/lib/services/api-workflow.helpers.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadAssetAttachment = uploadAssetAttachment;
+const interfaces_1 = require("../interfaces");
+/**
+ * Uploads content and attaches it to an asset as an ASSET_ATTACHMENT reference.
+ * If the reference cannot be created, the uploaded content is removed again.
+ */
+async function uploadAssetAttachment(api, assetId, form, relSrc, options = {}) {
+    const content = await api.contents.upload(form, options);
+    if (!content.id) {
+        throw new Error('Uploaded content has no id');
+    }
+    const reference = {
+        srcId: assetId,
+        tgtId: content.id,
+        srcType: interfaces_1.ResourceType.ASSET,
+        tgtType: interfaces_1.ResourceType.CONTENT,
+        relSrc,
+        relType: interfaces_1.ObjectReferenceType.ASSET_ATTACHMENT,
+    };
+    try {
+        await api.objectReferences.create(reference, options);
+    }
+    catch (error) {
+        await api.contents.deleteOne(content.id, {}, options).catch(() => undefined);
+        throw error;
+    }
+    return content;
+}

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

@@ -16,11 +16,19 @@ export declare class AssetService extends BaseService {
     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>;
+    /**
+     * Legacy flow-module compatibility. The asset service stores the relation as an
+     * ASSET_ATTACHMENT object reference behind this endpoint.
+     */
     addAttachment: (id: string, form: CrossPlatformFormData, options?: TokenOption) => Promise<Asset>;
     addElementToProperty(id: string, dto: AddToProperty): Promise<Asset>;
     removeElementFromProperty(id: string, dto: RemoveFromProperty): Promise<Asset>;
     getChildren(assetId: string, params?: RequestParameter, options?: TokenOption): Promise<Paginated<Asset>>;
-    getAttachments(assetId: string, params?: RequestParameter, options?: TokenOption): Promise<Paginated<Attachment>>;
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
+    getAttachments(assetId: string, params?: RequestParameter, options?: Config): Promise<Paginated<Attachment>>;
+    /** Legacy attachment endpoint. Use ASSET_ATTACHMENT object-reference APIs instead. */
+    bulkRemoveAttachments(assetId: string, attachmentIds: string[], options?: TokenOption): Promise<Asset>;
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
     getAssetsByAttachment(contentId: string, params?: RequestParameter, options?: TokenOption): Promise<Paginated<Asset>>;
     getEventLevelOverride(ids: string[], causes: string[], options?: TokenOption): Promise<EventLevelOverride>;
     updateEventCausesAsset(id: string, dto: EventCause, options?: TokenOption): Promise<Asset>;

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

@@ -11,6 +11,10 @@ class BaseService extends (0, ts_mixer_1.Mixin)((data_service_1.DataService), sh
 class AssetService extends BaseService {
     constructor(httpClient) {
         super(httpClient, '/assets');
+        /**
+         * Legacy flow-module compatibility. The asset service stores the relation as an
+         * ASSET_ATTACHMENT object reference behind this endpoint.
+         */
         this.addAttachment = (id, form, options = {}) => {
             return this.httpClient.post(`${this.basePath}/${id}/attachment`, form, {
                 headers: (0, utils_1.getFormDataHeaders)(form),
@@ -42,11 +46,17 @@ class AssetService extends BaseService {
     getChildren(assetId, params = {}, options = {}) {
         return this.getManyFiltered({ parent: assetId }, params, options);
     }
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
     getAttachments(assetId, params = {}, options = {}) {
         return this.httpClient.get(`${this.basePath}/${assetId}/attachments`, { params, ...options });
     }
+    /** Legacy attachment endpoint. Use ASSET_ATTACHMENT object-reference APIs instead. */
+    bulkRemoveAttachments(assetId, attachmentIds, options = {}) {
+        return this.httpClient.post(`${this.basePath}/${assetId}/attachments/remove`, { ids: attachmentIds }, options);
+    }
+    /** Legacy attachment endpoint. Query ASSET_ATTACHMENT object references instead. */
     getAssetsByAttachment(contentId, params = {}, options = {}) {
-        return this.getManyFiltered({ attachments: contentId }, params, options);
+        return this.httpClient.get(`${this.basePath}/attachments/${contentId}`, { params, ...options });
     }
     getEventLevelOverride(ids, causes, options = {}) {
         return this.httpClient.post(`${this.basePath}/event-causes`, { ids, causes }, options);

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

@@ -1,4 +1,4 @@
-import { AssetType, DeleteAssetTypeQuery, Paginated, Template, TokenOption } from '../interfaces';
+import { AssetType, AssetTypeSearchResult, DeleteAssetTypeQuery, Paginated, RequestParameter, Template, TokenOption } from '../interfaces';
 import { DataService } from './data.service';
 import { HttpClientService } from './http-client.service';
 import { ShareService } from './share.service';
@@ -14,6 +14,7 @@ export declare class AssetTypesService extends BaseService {
     constructor(httpClient: HttpClientService);
     deleteOne(id: string, deleteQuery?: DeleteAssetTypeQuery, options?: TokenOption): Promise<AssetType>;
     getAssetCount(id: string, options?: TokenOption): Promise<number>;
+    search(query: string, params?: RequestParameter, options?: TokenOption): Promise<AssetTypeSearchResult[]>;
     getRevisions(id: string, options?: TokenOption): Promise<Paginated<AssetType>>;
     rollback(id: string, revisionId: string, options?: TokenOption): Promise<AssetType>;
     deleteRevision(id: string, revisionId: string, options?: TokenOption): Promise<any>;

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

@@ -17,6 +17,9 @@ class AssetTypesService extends BaseService {
     getAssetCount(id, options = {}) {
         return this.httpClient.get(`${this.basePath}/${id}/countAssets`, options);
     }
+    search(query, params = {}, options = {}) {
+        return this.httpClient.get(`${this.basePath}/search`, { params: { ...params, query }, ...options });
+    }
     getRevisions(id, options = {}) {
         return this.httpClient.get(`${this.basePath}/${id}/revisions`, options);
     }

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

@@ -1,9 +1,9 @@
 import { APIBase } from '../../api-base';
-import type { CreateOrgGroup, OrgGroup, SqlPagination, SqlPaginationResult, TokenOption, UpdateOrgGroup } from '../../interfaces';
+import type { CreateOrgGroup, OrgGroup, SqlPagination, SqlPaginationResult, SqlSort, TokenOption, UpdateOrgGroup } from '../../interfaces';
 import { HttpClientService } from '../http-client.service';
 export declare class OrgGroupService extends APIBase {
     constructor(httpClient: HttpClientService);
-    getOrgGroupsOfUsersActiveOrg(sqlPagination?: SqlPagination, options?: TokenOption): Promise<SqlPaginationResult<OrgGroup>>;
+    getOrgGroupsOfUsersActiveOrg(sqlPagination?: SqlPagination & SqlSort, options?: TokenOption): Promise<SqlPaginationResult<OrgGroup>>;
     getOrgGroupById(orgGroupId: string, options?: TokenOption): Promise<OrgGroup>;
     createOrgGroup(createOrgGroup: CreateOrgGroup, options?: TokenOption): Promise<OrgGroup>;
     updateOrgGroup(orgGroupId: string, updateOrgGroup: UpdateOrgGroup, options?: TokenOption): Promise<OrgGroup>;

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

@@ -23,5 +23,5 @@ export declare class DataService<T> extends APIBase implements DataInterface<T>
     updateOne(id: string, dto: any, options?: TokenOption & {
         [key: string]: any;
     }): Promise<T>;
-    deleteOne(id: string, deleteQuery?: DeleteQuery, options?: TokenOption): Promise<any>;
+    deleteOne(id: string, deleteQuery?: DeleteQuery, options?: Config): Promise<any>;
 }

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

@@ -3,6 +3,8 @@ export { TrashService } from './trash.service';
 export { AiService } from './ai.service';
 export { AlertService } from './alert.service';
 export { AssetService } from './asset.service';
+export { uploadAssetAttachment } from './api-workflow.helpers';
+export type { AssetAttachmentApi } from './api-workflow.helpers';
 export { AssetTypesService } from './assettypes.service';
 export { AuthzService } from './authz';
 export { ContentService } from './content.service';

package/src/lib/services/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VaultService = exports.UserService = exports.TimeseriesValueFeedManagementService = exports.TimeSeriesService = exports.TaskService = exports.ShareService = exports.SearchService = exports.ProxyService = exports.OrganizationsService = exports.OrganizationsResourcesService = exports.OrganizationsAdministrationService = exports.ObjectReferenceService = exports.NotificationService = exports.NotificationRuleService = exports.LogbookService = exports.LabelService = exports.HttpClientService = exports.FlowService = exports.FlowModuleService = exports.FlowFunctionService = exports.FlowDeploymentService = exports.FlangeSkillControlService = exports.EventService = exports.EndpointService = exports.DataspaceService = exports.CrmService = exports.ContentService = exports.AuthzService = exports.AssetTypesService = exports.AssetService = exports.AlertService = exports.AiService = exports.TrashService = exports.DataService = void 0;
+exports.VaultService = exports.UserService = exports.TimeseriesValueFeedManagementService = exports.TimeSeriesService = exports.TaskService = exports.ShareService = exports.SearchService = exports.ProxyService = exports.OrganizationsService = exports.OrganizationsResourcesService = exports.OrganizationsAdministrationService = exports.ObjectReferenceService = exports.NotificationService = exports.NotificationRuleService = exports.LogbookService = exports.LabelService = exports.HttpClientService = exports.FlowService = exports.FlowModuleService = exports.FlowFunctionService = exports.FlowDeploymentService = exports.FlangeSkillControlService = exports.EventService = exports.EndpointService = exports.DataspaceService = exports.CrmService = exports.ContentService = exports.AuthzService = exports.AssetTypesService = exports.uploadAssetAttachment = exports.AssetService = exports.AlertService = exports.AiService = exports.TrashService = exports.DataService = void 0;
 const tslib_1 = require("tslib");
 var data_service_1 = require("./data.service");
 Object.defineProperty(exports, "DataService", { enumerable: true, get: function () { return data_service_1.DataService; } });
@@ -12,6 +12,8 @@ var alert_service_1 = require("./alert.service");
 Object.defineProperty(exports, "AlertService", { enumerable: true, get: function () { return alert_service_1.AlertService; } });
 var asset_service_1 = require("./asset.service");
 Object.defineProperty(exports, "AssetService", { enumerable: true, get: function () { return asset_service_1.AssetService; } });
+var api_workflow_helpers_1 = require("./api-workflow.helpers");
+Object.defineProperty(exports, "uploadAssetAttachment", { enumerable: true, get: function () { return api_workflow_helpers_1.uploadAssetAttachment; } });
 var assettypes_service_1 = require("./assettypes.service");
 Object.defineProperty(exports, "AssetTypesService", { enumerable: true, get: function () { return assettypes_service_1.AssetTypesService; } });
 var authz_1 = require("./authz");