@yuuvis/client-core 2.13.0 → 2.15.0

package/fesm2022/yuuvis-client-core.mjs

@@ -2368,7 +2368,6 @@ class EventService {
     }
     #listenToWindowEvents() {
         window.addEventListener('message', (event) => {
-            console.log(event);
             this.#ngZone.run(() => this.#isValidExternalMessage(event) && this.trigger(event.data.type, event.data.data));
         });
     }
@@ -3606,35 +3605,81 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.20", ngImpo
                 }]
         }], ctorParameters: () => [] });
 
-const transformResponse = () => map((res) => (res && res.body ? res.body.objects.map((val) => val) : null));
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+const transformResponse = () => map((res) => (res.body ? res.body.objects.map((val) => val) : null));
 /**
  * Service for providing upload of different object types into a client.
  */
 class UploadService {
     constructor() {
+        // #region Dependencies
         this.#backend = inject(BackendService);
         this.#http = inject(HttpClient);
         this.#logger = inject(Logger);
+        //#endregion
+        //#region Properties
         this.#status = { err: 0, items: [] };
         this.#statusSource = new ReplaySubject();
-        this.status$ = this.#statusSource.pipe(scan((acc, newVal) => ({ ...acc, ...newVal }), this.#status));
         this.#uploadStatus = new BehaviorSubject(null);
+        this.status$ = this.#statusSource.pipe(scan((acc, newVal) => ({ ...acc, ...newVal }), this.#status));
         this.uploadStatus$ = this.#uploadStatus.asObservable();
     }
+    // #region Dependencies
     #backend;
     #http;
     #logger;
+    //#endregion
+    //#region Properties
     #status;
     #statusSource;
     #uploadStatus;
+    //#endregion
+    //#region Public Methods
     /**
      * Upload a file.
      * @param url The URL to upload the file to
      * @param file The file to be uploaded
      * @param label A label that will show up in the upload overlay dialog while uploading
+     *
+     * @deprecated use uploadFile instead. `label`, `silent` as well as `scope` can be provided through `options`.
      */
     upload(url, file, label, silent) {
-        return this.#executeUpload(url, file, label || file.name, silent);
+        return this.#executeUpload(url, file, { label: label || file.name, silent: silent });
+    }
+    /**
+     * Uploads a single file to the specified URL using the structured `FileUploadOptions` object.
+     *
+     * This is the preferred alternative to the legacy `upload()` method. It accepts a typed
+     * options object instead of individual parameters, which makes it easier to pass optional
+     * settings such as `silent` mode and `scope` without relying on positional arguments.
+     *
+     * **Behavior:**
+     * - If `options.silent` is `false` (default), the upload appears in the upload overlay dialog
+     *   and progress is tracked via `status$`
+     * - If `options.silent` is `true`, the upload runs quietly in the background with no UI feedback
+     * - `options.label` is shown in the overlay dialog during upload; falls back to `file.name` if omitted
+     * - `options.scope` tags the upload with a named scope, enabling an `UploadProgressComponent`
+     *   configured with the same scope to display only the uploads relevant to its section of the UI
+     *
+     * @param url - The backend URL to POST the file to
+     * @param file - The `File` object to be uploaded
+     * @param options - Upload configuration: label, silent mode, and optional scope
+     * @returns An `Observable` that emits the server response on completion
+     *
+     * @example
+     * ```typescript
+     * // Standard upload with progress indicator
+     * this.uploadService.uploadFile(url, file, { label: 'Uploading contract.pdf' }).subscribe();
+     *
+     * // Silent upload (no UI, runs in background)
+     * this.uploadService.uploadFile(url, file, { label: 'document.pdf', silent: true }).subscribe();
+     *
+     * // Scoped upload — only the UploadProgressComponent with scope 'profile-editor' will show this
+     * this.uploadService.uploadFile(url, file, { label: 'photo.jpg', scope: 'profile-editor' }).subscribe();
+     * ```
+     */
+    uploadFile(url, file, options) {
+        return this.#executeUpload(url, file, options);
     }
     /**
      * Upload files using multipart upload.
@@ -3642,18 +3687,110 @@ class UploadService {
      * @param files The files to be uploaded
      * @param data Data to be send along with the files
      * @param label A label that will show up in the upload overlay dialog while uploading
+     *
+     * @deprecated Use multipartUpload(url, files, options, data) instead. Provide scope through options.
      */
     uploadMultipart(url, files, data, label, silent) {
-        return this.#executeMultipartUpload(url, files, label || 'Upload', data, silent);
+        return this.#executeMultipartUpload(url, files, { label, silent }, data);
+    }
+    /**
+     * Uploads multiple files to the specified URL using a multipart/form-data request.
+     *
+     * This is the preferred method for multi-file uploads. It accepts a typed `FileUploadOptions`
+     * object for configuration, making it easier to pass `scope` and other options compared
+     * to the legacy `uploadMultipart()` overload.
+     *
+     * **Behavior:**
+     * - All files are bundled into a single `FormData` payload under the `files` field
+     * - Optional `data` is appended as a JSON blob under the `data` field
+     * - If `options.silent` is `false` (default), upload progress is shown in the overlay dialog
+     * - If `options.silent` is `true`, the upload runs in the background with no UI feedback
+     * - `options.scope` tags the upload with a named scope, enabling an `UploadProgressComponent`
+     *   configured with the same scope to display only the uploads relevant to its section of the UI
+     *
+     * @param url - The backend URL to POST the multipart request to
+     * @param files - Array of `File` objects to upload
+     * @param options - Upload configuration: label (required), silent mode, and optional scope
+     * @param data - Optional metadata object to send alongside the files (serialized as JSON)
+     * @returns An `Observable` that emits the server response on completion
+     *
+     * @example
+     * ```typescript
+     * // Upload files with a visible progress indicator
+     * this.uploadService.multipartUpload(url, files, { label: 'Uploading 3 files' }).subscribe();
+     *
+     * // Upload files with additional metadata
+     * this.uploadService
+     *   .multipartUpload(url, files, { label: 'Batch upload' }, { folderId: 'abc123' })
+     *   .subscribe();
+     *
+     * // Scoped upload — only the UploadProgressComponent with scope 'mail-editor' will show this
+     * this.uploadService
+     *   .multipartUpload(url, files, { label: 'attachments', scope: 'mail-editor' })
+     *   .subscribe();
+     * ```
+     */
+    multipartUpload(url, files, options, data) {
+        return this.#executeMultipartUpload(url, files, options, data);
     }
+    /**
+     * Creates a document on the server by sending structured metadata without a file attachment.
+     *
+     * Unlike `uploadFile()` and `multipartUpload()`, this method does not attach any file content.
+     * It is intended for creating document objects from metadata alone — for example, creating
+     * a folder, a placeholder record, or a document entry where the content stream will be
+     * provided separately.
+     *
+     * **Behavior:**
+     * - Sends the `data` object as a JSON blob inside a `FormData` payload
+     * - Progress is NOT tracked — this method does not appear in `status$`
+     * - Errors are re-thrown so the caller can handle them via the returned `Observable`
+     *
+     * @param url - The backend URL to POST the document creation request to
+     * @param data - Metadata object describing the document to be created
+     * @returns An `Observable` that emits the created object(s) on success
+     *
+     * @example
+     * ```typescript
+     * const metadata = {
+     *   objectTypeId: 'yuv:document',
+     *   properties: { 'yuv:title': 'My Document' }
+     * };
+     *
+     * this.uploadService.createDocument(url, metadata).subscribe((result) => {
+     *   console.log('Created:', result);
+     * });
+     * ```
+     */
     createDocument(url, data) {
         const formData = this.#createFormData({ data });
         const request = this.#createHttpRequest(url, { formData }, false);
-        return this.#http.request(request).pipe(filter((obj) => obj && obj.body), transformResponse(), catchError((err) => throwError(() => err)));
+        return this.#http.request(request).pipe(filter((obj) => obj?.body), transformResponse(), catchError((err) => throwError(() => err)));
     }
     /**
-     * Cancels an upload request and removes it from the list of files being uploaded.
-     * @param id ID of the UploadItem to be canceled
+     * Cancels one or all active upload requests and removes them from the tracked upload list.
+     *
+     * This method unsubscribes from the underlying HTTP request, effectively aborting the upload,
+     * and removes the corresponding item(s) from the internal status list. The updated status
+     * is then emitted via `status$` so that any subscribed UI components (e.g. the upload overlay)
+     * can reflect the change immediately.
+     *
+     * **Behavior:**
+     * - If `id` is provided, only the matching upload item is cancelled
+     * - If `id` is omitted, **all** active uploads are cancelled at once
+     * - If the provided `id` does not match any active item, the call is a no-op
+     * - After cancellation, the error count on `status$` is recalculated
+     *
+     * @param id - Optional ID of the upload item to cancel. Omit to cancel all active uploads.
+     *
+     * @example
+     * ```typescript
+     * // Cancel a specific upload by ID
+     * this.uploadService.cancelItem(uploadId);
+     *
+     * // Cancel all ongoing uploads (e.g. on component destroy or user confirmation)
+     * this.uploadService.cancelItem();
+     * ```
      */
     cancelItem(id) {
         if (id) {
@@ -3670,6 +3807,8 @@ class UploadService {
         this.#status.err = this.#status.items.filter((i) => i.err).length;
         this.#statusSource.next(this.#status);
     }
+    //#endregion
+    //#region Utilities
     /**
      * Prepares Formdata for multipart upload.
      * @param from contains form and or file
@@ -3677,6 +3816,7 @@ class UploadService {
     #createFormData({ file, data }) {
         const formData = new FormData();
         (file || []).forEach((f) => formData.append('files', f, f.name));
+        // eslint-disable-next-line @typescript-eslint/no-unused-expressions
         data ? formData.append('data', new Blob([JSON.stringify(data)], { type: 'application/json' })) : null;
         return formData;
     }
@@ -3689,8 +3829,8 @@ class UploadService {
      */
     #createHttpRequest(url, content, reportProgress, method = 'POST') {
         const { formData, file } = content;
-        // add request param to bypass the serviceworker
-        url += `${url.indexOf('?') === -1 ? '?' : '&'}ngsw-bypass=1`;
+        // add request param to bypass the service-worker
+        url += `${!url.includes('?') ? '?' : '&'}ngsw-bypass=1`;
         let headers = this.#backend.getAuthHeaders();
         if (file) {
             headers = headers.set('Content-Disposition', `attachment; filename*=utf-8''${encodeURIComponent(file.name)}`);
@@ -3703,25 +3843,29 @@ class UploadService {
      * @param file The file to be uploaded
      * @param label A label that will show up in the upload overlay dialog while uploading
      */
-    #executeUpload(url, file, label, silent = false) {
+    #executeUpload(url, file, options) {
+        const silent = options.silent === true;
+        const label = options.label || file.name;
         const request = this.#createHttpRequest(url, { file }, !silent);
         return silent
             ? this.#http.request(request).pipe(filter((res) => res instanceof HttpResponse))
-            : this.#startUploadWithFile(request, label).pipe(transformResponse());
+            : this.#startUploadWithFile(request, label, options.scope).pipe(transformResponse());
     }
     /**
      * Prepare multipart upload.
      * @param url The URL to upload the file to
-     * @param file Array of files to be uploaded
+     * @param files Array of files to be uploaded
      * @param label A label that will show up in the upload overlay dialog while uploading
      * @param data Data to be send along with the files
      */
-    #executeMultipartUpload(url, file, label, data, silent = false) {
-        const formData = this.#createFormData({ file, data });
+    #executeMultipartUpload(url, files, options, data) {
+        const label = options.label ?? 'Upload';
+        const silent = options.silent === true;
+        const formData = this.#createFormData({ file: files, data });
         const request = this.#createHttpRequest(url, { formData }, !silent);
         return silent
             ? this.#http.request(request).pipe(filter((res) => res instanceof HttpResponse))
-            : this.#startUploadWithFile(request, label).pipe(transformResponse());
+            : this.#startUploadWithFile(request, label, options.scope).pipe(transformResponse());
     }
     #generateResult(result) {
         const objects = result.body?.objects;
@@ -3753,14 +3897,15 @@ class UploadService {
     }
     #createProgressStatus(event, progress, id) {
         if (event.type === HttpEventType.UploadProgress) {
-            const percentDone = Math.round((100 * event.loaded) / event.total);
+            const fullPercentage = 100;
+            const percentDone = Math.round((fullPercentage * event.loaded) / event.total);
             progress.next(percentDone);
         }
         else if (event instanceof HttpResponse) {
             progress.complete();
             // add upload response
             // this.status.items = this.status.items.filter(s => s.id !== id);
-            const idx = this.#status.items.findIndex((s) => s.id === id);
+            const idx = this.#status.items.findIndex((item) => item.id === id);
             if (idx !== -1) {
                 this.#status.items[idx].result = this.#generateResult(event);
                 this.#statusSource.next(this.#status);
@@ -3768,7 +3913,7 @@ class UploadService {
         }
     }
     #createUploadError(err, progress, id) {
-        const statusItem = this.#status.items.find((s) => s.id === id);
+        const statusItem = this.#status.items.find((item) => item.id === id);
         statusItem.err = {
             code: err.status,
             message: err.error ? err.error.errorMessage : err.message
@@ -3784,8 +3929,8 @@ class UploadService {
      * @param request Request to be executed
      * @param label A label that will show up in the upload overlay dialog while uploading
      */
-    #startUploadWithFile(request, label) {
-        return new Observable((o) => {
+    #startUploadWithFile(request, label, scope) {
+        return new Observable((uploadObserver) => {
             const id = Utils.uuid();
             const progress = new Subject();
             let result;
@@ -3799,14 +3944,14 @@ class UploadService {
                 .subscribe({
                 next: (res) => (res.status ? (result = res) : null),
                 error: (err) => {
-                    o.error(err);
+                    uploadObserver.error(err);
                     this.#uploadStatus.next(true);
-                    o.complete();
+                    uploadObserver.complete();
                 },
                 complete: () => {
-                    o.next(result);
+                    uploadObserver.next(result);
                     this.#uploadStatus.next(true);
-                    o.complete();
+                    uploadObserver.complete();
                 }
             });
             this.#status.items.push({
@@ -3814,6 +3959,7 @@ class UploadService {
                 filename: label,
                 progress: progress.asObservable(),
                 subscription,
+                scope: scope,
                 err: undefined
             });
             this.#statusSource.next(this.#status);
@@ -3837,26 +3983,6 @@ class DmsService {
     #backend = inject(BackendService);
     #eventService = inject(EventService);
     #uploadService = inject(UploadService);
-    // general trigger operator to handle all dms events
-    triggerEvent(event, id, silent = false) {
-        return (stream) => stream.pipe(
-        // update does not return permissions, so we need to re-load the whole dms object
-        // TODO: Remove once permissions are provided
-        switchMap((res) => (!id ? of(res) : this.getDmsObject(id))), 
-        // TODO: enable once permissions are provided
-        // map((res) => this.searchResultToDmsObject(this.searchService.toSearchResult(res).items[0])),
-        tap((res) => !silent && this.#eventService.trigger(event, res)));
-    }
-    // general trigger operator to handle all dms events
-    #triggerEvents(event, ids, silent = false) {
-        return (stream) => stream.pipe(
-        // update does not return permissions, so we need to re-load the whole dms object
-        // TODO: Remove once permissions are provided
-        switchMap((res) => (!ids ? of(res) : this.getDmsObjects(ids))), 
-        // TODO: enable once permissions are provided
-        // map((_res: any[]) => _res.map((res, i) => res?._error ? { ...res, id: ids?[i] } : this.searchResultToDmsObject(this.searchService.toSearchResult(res).items[0]))),
-        map((_res) => _res.map((res, i) => (res?._error && ids ? { ...res, id: ids[i] } : res))), tap((res) => !silent && res.forEach((o) => o && this.#eventService.trigger(event, o))));
-    }
     /**
      * Create new dms object(s). Providing an array of files here instead of one will create
      * a new dms object for every file. In this case indexdata will shared across all files.
@@ -3868,12 +3994,15 @@ class DmsService {
      * @returns Array of IDs of the objects that have been created
      */
     createDmsObject(objectTypeId, indexdata, files, label, silent = false, options = { waitForSearchConsistency: true }) {
-        const url = `${this.#backend.getApiBase(ApiBase.apiWeb)}/dms/objects${options.waitForSearchConsistency ? '?waitForSearchConsistency=true' : ''}`;
+        const url = `${this.#backend.getApiBase(ApiBase.apiWeb)}/dms/objects` +
+            `${options.waitForSearchConsistency ? '?waitForSearchConsistency=true' : ''}`;
         const data = indexdata;
         data[BaseObjectTypeField.OBJECT_TYPE_ID] = objectTypeId;
-        const upload = files.length ? this.#uploadService.uploadMultipart(url, files, data, label, silent) : this.#uploadService.createDocument(url, data);
+        const upload = files.length
+            ? this.#uploadService.multipartUpload(url, files, { label: label ?? '', silent, scope: options.scope }, data)
+            : this.#uploadService.createDocument(url, data);
         return upload
-            .pipe(map((res) => res.map((r) => r.properties[BaseObjectTypeField.OBJECT_ID].value)), 
+            .pipe(map((res) => res.map((response) => response.properties[BaseObjectTypeField.OBJECT_ID].value)), 
         // TODO: Replace by proper solution
         // Right now there is a gap between when the object was
         // created and when it is indexed. So delaying here will
@@ -3898,17 +4027,66 @@ class DmsService {
      * @param version version of the object to be restored
      */
     restoreDmsObject(id, version, silent = false) {
+        // eslint-disable-next-line max-len
         const url = `/dms/objects/${id}/versions/${version}/actions/restore?waitForSearchConsistency=true&restoreParentId=false`;
-        return this.#backend.post(url, {}, ApiBase.apiWeb).pipe(this.triggerEvent(YuvEventType.DMS_OBJECT_UPDATED, id, silent));
+        return this.#backend
+            .post(url, {}, ApiBase.apiWeb)
+            .pipe(this.triggerEvent(YuvEventType.DMS_OBJECT_UPDATED, id, silent));
     }
     /**
      * Upload (add/replace) content to a dms object.
      * @param objectId ID of the dms object to upload the file to
      * @param file The file to be uploaded
      * @param label A label that will show up in the upload overlay dialog while uploading
+     *
+     * @deprecated use uploadFileContent instead. Provide label and silent through `options`
      */
     uploadContent(objectId, file, label, silent) {
-        return this.#uploadService.upload(this.getContentPath(objectId), file, label, silent).pipe(this.triggerEvent(YuvEventType.DMS_OBJECT_UPDATED, objectId));
+        return this.#uploadService
+            .upload(this.getContentPath(objectId), file, label, silent)
+            .pipe(this.triggerEvent(YuvEventType.DMS_OBJECT_UPDATED, objectId));
+    }
+    /**
+     * Uploads a file as the content of an existing DMS object, replacing or setting its content stream.
+     *
+     * This is the preferred alternative to the legacy `uploadContent()` method. It accepts a typed
+     * `FileUploadOptions` object instead of individual parameters, which enables full control over
+     * the upload label, silent mode, and scope-based progress visibility.
+     *
+     * After a successful upload, a `DMS_OBJECT_UPDATED` event is triggered automatically so that
+     * any subscribed parts of the application can react to the change (e.g. refreshing a preview).
+     *
+     * **Behavior:**
+     * - Targets the content endpoint of the given DMS object: `/dms/objects/{objectId}/contents/file`
+     * - `options.label` is shown in the upload progress indicator; falls back to `file.name` if omitted
+     * - If `options.silent` is `true`, the upload runs in the background with no UI feedback
+     *   and no `DMS_OBJECT_UPDATED` event is emitted
+     * - `options.scope` tags the upload so that only the `UploadProgressComponent` instance
+     *   configured with the same scope will display progress for this upload
+     *
+     * @param objectId - ID of the DMS object whose content should be uploaded or replaced
+     * @param file - The `File` object to upload as the new content stream
+     * @param options - Upload configuration: label, silent mode, and optional scope
+     * @returns An `Observable` that emits the updated DMS object on completion
+     *
+     * @example
+     * ```typescript
+     * // Replace content with a visible progress indicator
+     * this.dmsService.uploadFileContent(objectId, file, { label: 'Uploading contract.pdf' }).subscribe();
+     *
+     * // Silent replacement (no UI feedback, no event emitted)
+     * this.dmsService.uploadFileContent(objectId, file, { label: 'report.pdf', silent: true }).subscribe();
+     *
+     * // Scoped upload — only UploadProgressComponent with scope 'detail-panel' will show this
+     * this.dmsService
+     *   .uploadFileContent(objectId, file, { label: 'photo.jpg', scope: 'detail-panel' })
+     *   .subscribe();
+     * ```
+     */
+    uploadFileContent(objectId, file, options) {
+        return this.#uploadService
+            .uploadFile(this.getContentPath(objectId), file, { ...options, label: options.label ?? file.name })
+            .pipe(this.triggerEvent(YuvEventType.DMS_OBJECT_UPDATED, objectId));
     }
     /**
      * Path of dms object content file.
@@ -3916,7 +4094,8 @@ class DmsService {
      * @param version version number of the dms object
      */
     getContentPath(objectId, version) {
-        return `${this.#backend.getApiBase(ApiBase.apiWeb)}/dms/objects/${objectId}/contents/file${version ? '?version=' + version : ''}`;
+        return (`${this.#backend.getApiBase(ApiBase.apiWeb)}/dms/objects/` +
+            `${objectId}/contents/file${version ? '?version=' + version : ''}`);
     }
     /**
      * Original API Path of dms object content file.
@@ -3925,7 +4104,8 @@ class DmsService {
      * @param rendition should return rendition path of the dms object
      */
     getFullContentPath(objectId, version, rendition = false) {
-        return `${this.#backend.getApiBase(ApiBase.core, true)}/dms/objects/${objectId}${version ? '/versions/' + version : ''}/contents/${rendition ? 'renditions/pdf' : 'file'}`;
+        return (`${this.#backend.getApiBase(ApiBase.core, true)}/dms/objects/` +
+            `${objectId}${version ? '/versions/' + version : ''}/contents/${rendition ? 'renditions/pdf' : 'file'}`);
     }
     getSlideURI(objectId, mimeType) {
         const supportedMimeTypes = ['*/*'];
@@ -3934,7 +4114,9 @@ class DmsService {
             // check if mime type supports slides
             supportedMimeTypes.forEach((p) => (supported = supported || Utils.patternToRegExp(p).test(mimeType)));
         }
-        return !mimeType || supported ? `${this.#backend.getApiBase(ApiBase.core, true)}/dms/objects/${objectId}/contents/renditions/slide` : undefined;
+        return !mimeType || supported
+            ? `${this.#backend.getApiBase(ApiBase.core, true)}/dms/objects/${objectId}/contents/renditions/slide`
+            : undefined;
     }
     /**
      * Downloads the content of dms objects.
@@ -3992,7 +4174,9 @@ class DmsService {
      * @param tag The tag to be deleted
      */
     deleteDmsObjectTag(id, tag, silent = false) {
-        return this.#backend.delete(`/dms/objects/${id}/tags/${tag}`, ApiBase.core).pipe(this.triggerEvent(YuvEventType.DMS_OBJECT_UPDATED, id, silent));
+        return this.#backend
+            .delete(`/dms/objects/${id}/tags/${tag}`, ApiBase.core)
+            .pipe(this.triggerEvent(YuvEventType.DMS_OBJECT_UPDATED, id, silent));
     }
     /**
      * Update indexdata of a dms object.
@@ -4093,7 +4277,9 @@ class DmsService {
      */
     getDmsObjects(ids, silent = false) {
         return this.batchGet(ids)
-            .pipe(map((_res) => _res.map((res, i) => (res?._error ? { ...res, id: ids[i] } : this.#searchResultToDmsObject(this.#searchService.toSearchResult(res).items[0])))))
+            .pipe(map((_res) => _res.map((res, i) => res?._error
+            ? { ...res, id: ids[i] }
+            : this.#searchResultToDmsObject(this.#searchService.toSearchResult(res).items[0]))))
             .pipe(this.#triggerEvents(YuvEventType.DMS_OBJECT_LOADED, undefined, silent));
     }
     /**
@@ -4158,9 +4344,6 @@ class DmsService {
             content: res.contentStreams?.[0]
         });
     }
-    #searchResultToDmsObject(resItem) {
-        return new DmsObject(resItem);
-    }
     /**
      * Transforms a plain data object to a DmsObject.
      * @param data The plain data object
@@ -4224,7 +4407,9 @@ class DmsService {
                     if (o.properties[key].resolvedValues) {
                         value.forEach((v) => {
                             Object.keys(v).forEach((k) => {
-                                const resValue = Array.isArray(v[k]) ? v[k].map((i) => o.properties[key].resolvedValues[i]) : o.properties[key].resolvedValues[v[k]];
+                                const resValue = Array.isArray(v[k])
+                                    ? v[k].map((i) => o.properties[key].resolvedValues[i])
+                                    : o.properties[key].resolvedValues[v[k]];
                                 if (resValue) {
                                     v[`${k}_title`] = resValue;
                                 }
@@ -4241,10 +4426,10 @@ class DmsService {
             // Objects that don't have files attached won't have this section
             let content;
             if (o.contentStreams && o.contentStreams.length > 0) {
-                // we assume that each result object only has ONE file attached, altough
+                // we assume that each result object only has ONE file attached, although
                 // this is an array and there may be more
                 const contentStream = o.contentStreams[0];
-                // also add contentstream related fields to the result fields
+                // also add content-stream related fields to the result fields
                 fields.set(ContentStreamField.LENGTH, contentStream.length);
                 fields.set(ContentStreamField.MIME_TYPE, contentStream.mimeType);
                 fields.set(ContentStreamField.FILENAME, contentStream.fileName);
@@ -4264,8 +4449,10 @@ class DmsService {
                     size: contentStream.length
                 };
             }
-            const objectTypeId = o.properties[BaseObjectTypeField.OBJECT_TYPE_ID] ? o.properties[BaseObjectTypeField.OBJECT_TYPE_ID].value : null;
-            if (objectTypes.indexOf(objectTypeId) === -1) {
+            const objectTypeId = o.properties[BaseObjectTypeField.OBJECT_TYPE_ID]
+                ? o.properties[BaseObjectTypeField.OBJECT_TYPE_ID].value
+                : null;
+            if (!objectTypes.includes(objectTypeId)) {
                 objectTypes.push(objectTypeId);
             }
             resultListItems.push({
@@ -4283,6 +4470,30 @@ class DmsService {
         };
         return result;
     }
+    // general trigger operator to handle all dms events
+    triggerEvent(event, id, silent = false) {
+        return (stream) => stream.pipe(
+        // update does not return permissions, so we need to re-load the whole dms object
+        // TODO: Remove once permissions are provided
+        switchMap((res) => (!id ? of(res) : this.getDmsObject(id))), 
+        // TODO: enable once permissions are provided
+        // map((res) => this.searchResultToDmsObject(this.searchService.toSearchResult(res).items[0])),
+        tap((res) => !silent && this.#eventService.trigger(event, res)));
+    }
+    // general trigger operator to handle all dms events
+    #triggerEvents(event, ids, silent = false) {
+        return (stream) => stream.pipe(
+        // update does not return permissions, so we need to re-load the whole dms object
+        // TODO: Remove once permissions are provided
+        switchMap((res) => (!ids ? of(res) : this.getDmsObjects(ids))), 
+        // TODO: enable once permissions are provided
+        // map((_res: any[]) => _res.map((res, i) => res?._error ?
+        // { ...res, id: ids?[i] } : this.searchResultToDmsObject(this.searchService.toSearchResult(res).items[0]))),
+        map((_res) => _res.map((res, i) => (res?._error && ids ? { ...res, id: ids[i] } : res))), tap((res) => !silent && res.forEach((o) => o && this.#eventService.trigger(event, o))));
+    }
+    #searchResultToDmsObject(resItem) {
+        return new DmsObject(resItem);
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: DmsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.20", ngImport: i0, type: DmsService, providedIn: 'root' }); }
 }
@@ -5747,7 +5958,9 @@ let EoxTranslateJsonLoader = class EoxTranslateJsonLoader {
         return forkJoin(t).pipe(map((res) => res.reduce((acc, x) => Object.assign(acc, x), {})));
     }
     loadTranslationFile(path, lang) {
-        return this.http.get(`${Utils.getBaseHref()}${path}${lang}.json`).pipe(catchError(() => {
+        const version = document.body.dataset['bt'] ?? document.body.dataset['version'];
+        const cacheBuster = version ? `?v=${version}` : '';
+        return this.http.get(`${Utils.getBaseHref()}${path}${lang}.json${cacheBuster}`).pipe(catchError(() => {
             // ISO codes with more than 2 characters are sub-languages like de-CH.
             // If there is no translation file for that sub-language we'll try to load
             // the file for the base language (in this case de).