@openfilz-sdk/typescript-ee 1.14.5 → 1.14.7

package/dist/api/comments-api.js

@@ -100,6 +100,74 @@ const CommentsApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+         * @summary Give mentioned users comment access
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        grantMentionAccess: (mentionAccessRequest_1, ...args_1) => __awaiter(this, [mentionAccessRequest_1, ...args_1], void 0, function* (mentionAccessRequest, options = {}) {
+            // verify required parameter 'mentionAccessRequest' is not null or undefined
+            (0, common_1.assertParamExists)('grantMentionAccess', 'mentionAccessRequest', mentionAccessRequest);
+            const localVarPath = `/api/v1/documents/comments/mention-access/grant`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(mentionAccessRequest, localVarRequestOptions, configuration);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+         * @summary Preview comment access for mentioned users
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        previewMentionAccess: (mentionAccessRequest_1, ...args_1) => __awaiter(this, [mentionAccessRequest_1, ...args_1], void 0, function* (mentionAccessRequest, options = {}) {
+            // verify required parameter 'mentionAccessRequest' is not null or undefined
+            (0, common_1.assertParamExists)('previewMentionAccess', 'mentionAccessRequest', mentionAccessRequest);
+            const localVarPath = `/api/v1/documents/comments/mention-access`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, common_1.DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            yield (0, common_1.setBearerAuthToObject)(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = (0, common_1.serializeDataIfNeeded)(mentionAccessRequest, localVarRequestOptions, configuration);
+            return {
+                url: (0, common_1.toPathString)(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          * Update an existing comment. Only the comment creator can update their comment.
          * @summary Update a comment
@@ -179,6 +247,38 @@ const CommentsApiFp = function (configuration) {
                 return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+         * @summary Give mentioned users comment access
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        grantMentionAccess(mentionAccessRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.grantMentionAccess(mentionAccessRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['CommentsApi.grantMentionAccess']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+         * @summary Preview comment access for mentioned users
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        previewMentionAccess(mentionAccessRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.previewMentionAccess(mentionAccessRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = base_1.operationServerMap['CommentsApi.previewMentionAccess']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          * Update an existing comment. Only the comment creator can update their comment.
          * @summary Update a comment
@@ -225,6 +325,26 @@ const CommentsApiFactory = function (configuration, basePath, axios) {
         deleteComment(id, options) {
             return localVarFp.deleteComment(id, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+         * @summary Give mentioned users comment access
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        grantMentionAccess(mentionAccessRequest, options) {
+            return localVarFp.grantMentionAccess(mentionAccessRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+         * @summary Preview comment access for mentioned users
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        previewMentionAccess(mentionAccessRequest, options) {
+            return localVarFp.previewMentionAccess(mentionAccessRequest, options).then((request) => request(axios, basePath));
+        },
         /**
          * Update an existing comment. Only the comment creator can update their comment.
          * @summary Update a comment
@@ -263,6 +383,26 @@ class CommentsApi extends base_1.BaseAPI {
     deleteComment(id, options) {
         return (0, exports.CommentsApiFp)(this.configuration).deleteComment(id, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+     * @summary Give mentioned users comment access
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    grantMentionAccess(mentionAccessRequest, options) {
+        return (0, exports.CommentsApiFp)(this.configuration).grantMentionAccess(mentionAccessRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+     * @summary Preview comment access for mentioned users
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    previewMentionAccess(mentionAccessRequest, options) {
+        return (0, exports.CommentsApiFp)(this.configuration).previewMentionAccess(mentionAccessRequest, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Update an existing comment. Only the comment creator can update their comment.
      * @summary Update a comment

package/dist/api/notifications-api.d.ts

@@ -18,8 +18,8 @@ import type { NotificationDTO } from '../models';
  */
 export declare const NotificationsApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -59,8 +59,8 @@ export declare const NotificationsApiAxiosParamCreator: (configuration?: Configu
  */
 export declare const NotificationsApiFp: (configuration?: Configuration) => {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -100,8 +100,8 @@ export declare const NotificationsApiFp: (configuration?: Configuration) => {
  */
 export declare const NotificationsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -141,8 +141,8 @@ export declare const NotificationsApiFactory: (configuration?: Configuration, ba
  */
 export declare class NotificationsApi extends BaseAPI {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */

package/dist/api/notifications-api.js

@@ -35,8 +35,8 @@ const base_1 = require("../base");
 const NotificationsApiAxiosParamCreator = function (configuration) {
     return {
         /**
-         * Retrieve all notifications for the authenticated user
-         * @summary Get all notifications
+         * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+         * @summary Get notifications
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -191,8 +191,8 @@ const NotificationsApiFp = function (configuration) {
     const localVarAxiosParamCreator = (0, exports.NotificationsApiAxiosParamCreator)(configuration);
     return {
         /**
-         * Retrieve all notifications for the authenticated user
-         * @summary Get all notifications
+         * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+         * @summary Get notifications
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -276,8 +276,8 @@ const NotificationsApiFactory = function (configuration, basePath, axios) {
     const localVarFp = (0, exports.NotificationsApiFp)(configuration);
     return {
         /**
-         * Retrieve all notifications for the authenticated user
-         * @summary Get all notifications
+         * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+         * @summary Get notifications
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
@@ -329,8 +329,8 @@ exports.NotificationsApiFactory = NotificationsApiFactory;
  */
 class NotificationsApi extends base_1.BaseAPI {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */

package/dist/esm/api/collaboration-controller-api.d.ts

@@ -82,7 +82,7 @@ export declare const CollaborationControllerApiAxiosParamCreator: (configuration
      */
     deleteSharedDocuments: (deleteShareRequest: DeleteShareRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Deletes a team. Requires ADMIN_USERS role.
+     * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
      * @summary Delete a team
      * @param {string} teamId
      * @param {*} [options] Override http request option.
@@ -210,7 +210,7 @@ export declare const CollaborationControllerApiFp: (configuration?: Configuratio
      */
     deleteSharedDocuments(deleteShareRequest: DeleteShareRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShareResultResponse>>;
     /**
-     * Deletes a team. Requires ADMIN_USERS role.
+     * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
      * @summary Delete a team
      * @param {string} teamId
      * @param {*} [options] Override http request option.
@@ -338,7 +338,7 @@ export declare const CollaborationControllerApiFactory: (configuration?: Configu
      */
     deleteSharedDocuments(deleteShareRequest: DeleteShareRequest, options?: RawAxiosRequestConfig): AxiosPromise<ShareResultResponse>;
     /**
-     * Deletes a team. Requires ADMIN_USERS role.
+     * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
      * @summary Delete a team
      * @param {string} teamId
      * @param {*} [options] Override http request option.
@@ -466,7 +466,7 @@ export declare class CollaborationControllerApi extends BaseAPI {
      */
     deleteSharedDocuments(deleteShareRequest: DeleteShareRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ShareResultResponse, any, {}, any>>;
     /**
-     * Deletes a team. Requires ADMIN_USERS role.
+     * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
      * @summary Delete a team
      * @param {string} teamId
      * @param {*} [options] Override http request option.

package/dist/esm/api/collaboration-controller-api.js

@@ -270,7 +270,7 @@ export const CollaborationControllerApiAxiosParamCreator = function (configurati
             };
         }),
         /**
-         * Deletes a team. Requires ADMIN_USERS role.
+         * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
          * @summary Delete a team
          * @param {string} teamId
          * @param {*} [options] Override http request option.
@@ -661,7 +661,7 @@ export const CollaborationControllerApiFp = function (configuration) {
             });
         },
         /**
-         * Deletes a team. Requires ADMIN_USERS role.
+         * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
          * @summary Delete a team
          * @param {string} teamId
          * @param {*} [options] Override http request option.
@@ -870,7 +870,7 @@ export const CollaborationControllerApiFactory = function (configuration, basePa
             return localVarFp.deleteSharedDocuments(deleteShareRequest, options).then((request) => request(axios, basePath));
         },
         /**
-         * Deletes a team. Requires ADMIN_USERS role.
+         * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
          * @summary Delete a team
          * @param {string} teamId
          * @param {*} [options] Override http request option.
@@ -1029,7 +1029,7 @@ export class CollaborationControllerApi extends BaseAPI {
         return CollaborationControllerApiFp(this.configuration).deleteSharedDocuments(deleteShareRequest, options).then((request) => request(this.axios, this.basePath));
     }
     /**
-     * Deletes a team. Requires ADMIN_USERS role.
+     * Deletes a team of any kind; its members are told by a notification. Requires ADMIN_USERS role.
      * @summary Delete a team
      * @param {string} teamId
      * @param {*} [options] Override http request option.

package/dist/esm/api/comments-api.d.ts

@@ -14,6 +14,9 @@ import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
 import { type RequestArgs, BaseAPI } from '../base';
 import type { CommentDTO } from '../models';
 import type { CreateCommentRequest } from '../models';
+import type { MentionAccessPreview } from '../models';
+import type { MentionAccessRequest } from '../models';
+import type { ShareResultResponse } from '../models';
 import type { UpdateCommentRequest } from '../models';
 /**
  * CommentsApi - axios parameter creator
@@ -35,6 +38,22 @@ export declare const CommentsApiAxiosParamCreator: (configuration?: Configuratio
      * @throws {RequiredError}
      */
     deleteComment: (id: string, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+     * @summary Give mentioned users comment access
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    grantMentionAccess: (mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+     * @summary Preview comment access for mentioned users
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    previewMentionAccess: (mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * Update an existing comment. Only the comment creator can update their comment.
      * @summary Update a comment
@@ -65,6 +84,22 @@ export declare const CommentsApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     deleteComment(id: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
+    /**
+     * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+     * @summary Give mentioned users comment access
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    grantMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShareResultResponse>>;
+    /**
+     * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+     * @summary Preview comment access for mentioned users
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    previewMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<MentionAccessPreview>>;
     /**
      * Update an existing comment. Only the comment creator can update their comment.
      * @summary Update a comment
@@ -95,6 +130,22 @@ export declare const CommentsApiFactory: (configuration?: Configuration, basePat
      * @throws {RequiredError}
      */
     deleteComment(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void>;
+    /**
+     * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+     * @summary Give mentioned users comment access
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    grantMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): AxiosPromise<ShareResultResponse>;
+    /**
+     * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+     * @summary Preview comment access for mentioned users
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    previewMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): AxiosPromise<MentionAccessPreview>;
     /**
      * Update an existing comment. Only the comment creator can update their comment.
      * @summary Update a comment
@@ -125,6 +176,22 @@ export declare class CommentsApi extends BaseAPI {
      * @throws {RequiredError}
      */
     deleteComment(id: string, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}, any>>;
+    /**
+     * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+     * @summary Give mentioned users comment access
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    grantMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<ShareResultResponse, any, {}, any>>;
+    /**
+     * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+     * @summary Preview comment access for mentioned users
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    previewMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): Promise<import("axios").AxiosResponse<MentionAccessPreview, any, {}, any>>;
     /**
      * Update an existing comment. Only the comment creator can update their comment.
      * @summary Update a comment

package/dist/esm/api/comments-api.js

@@ -97,6 +97,74 @@ export const CommentsApiAxiosParamCreator = function (configuration) {
                 options: localVarRequestOptions,
             };
         }),
+        /**
+         * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+         * @summary Give mentioned users comment access
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        grantMentionAccess: (mentionAccessRequest_1, ...args_1) => __awaiter(this, [mentionAccessRequest_1, ...args_1], void 0, function* (mentionAccessRequest, options = {}) {
+            // verify required parameter 'mentionAccessRequest' is not null or undefined
+            assertParamExists('grantMentionAccess', 'mentionAccessRequest', mentionAccessRequest);
+            const localVarPath = `/api/v1/documents/comments/mention-access/grant`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(mentionAccessRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
+        /**
+         * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+         * @summary Preview comment access for mentioned users
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        previewMentionAccess: (mentionAccessRequest_1, ...args_1) => __awaiter(this, [mentionAccessRequest_1, ...args_1], void 0, function* (mentionAccessRequest, options = {}) {
+            // verify required parameter 'mentionAccessRequest' is not null or undefined
+            assertParamExists('previewMentionAccess', 'mentionAccessRequest', mentionAccessRequest);
+            const localVarPath = `/api/v1/documents/comments/mention-access`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+            const localVarRequestOptions = Object.assign(Object.assign({ method: 'POST' }, baseOptions), options);
+            const localVarHeaderParameter = {};
+            const localVarQueryParameter = {};
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            yield setBearerAuthToObject(localVarHeaderParameter, configuration);
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = Object.assign(Object.assign(Object.assign({}, localVarHeaderParameter), headersFromBaseOptions), options.headers);
+            localVarRequestOptions.data = serializeDataIfNeeded(mentionAccessRequest, localVarRequestOptions, configuration);
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        }),
         /**
          * Update an existing comment. Only the comment creator can update their comment.
          * @summary Update a comment
@@ -175,6 +243,38 @@ export const CommentsApiFp = function (configuration) {
                 return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
             });
         },
+        /**
+         * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+         * @summary Give mentioned users comment access
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        grantMentionAccess(mentionAccessRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.grantMentionAccess(mentionAccessRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['CommentsApi.grantMentionAccess']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
+        /**
+         * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+         * @summary Preview comment access for mentioned users
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        previewMentionAccess(mentionAccessRequest, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const localVarAxiosArgs = yield localVarAxiosParamCreator.previewMentionAccess(mentionAccessRequest, options);
+                const localVarOperationServerIndex = (_a = configuration === null || configuration === void 0 ? void 0 : configuration.serverIndex) !== null && _a !== void 0 ? _a : 0;
+                const localVarOperationServerBasePath = (_c = (_b = operationServerMap['CommentsApi.previewMentionAccess']) === null || _b === void 0 ? void 0 : _b[localVarOperationServerIndex]) === null || _c === void 0 ? void 0 : _c.url;
+                return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+            });
+        },
         /**
          * Update an existing comment. Only the comment creator can update their comment.
          * @summary Update a comment
@@ -220,6 +320,26 @@ export const CommentsApiFactory = function (configuration, basePath, axios) {
         deleteComment(id, options) {
             return localVarFp.deleteComment(id, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+         * @summary Give mentioned users comment access
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        grantMentionAccess(mentionAccessRequest, options) {
+            return localVarFp.grantMentionAccess(mentionAccessRequest, options).then((request) => request(axios, basePath));
+        },
+        /**
+         * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+         * @summary Preview comment access for mentioned users
+         * @param {MentionAccessRequest} mentionAccessRequest
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        previewMentionAccess(mentionAccessRequest, options) {
+            return localVarFp.previewMentionAccess(mentionAccessRequest, options).then((request) => request(axios, basePath));
+        },
         /**
          * Update an existing comment. Only the comment creator can update their comment.
          * @summary Update a comment
@@ -257,6 +377,26 @@ export class CommentsApi extends BaseAPI {
     deleteComment(id, options) {
         return CommentsApiFp(this.configuration).deleteComment(id, options).then((request) => request(this.axios, this.basePath));
     }
+    /**
+     * Does what the preview lists: silent COMMENTER shares on the documents the caller manages, share requests to the owner on the others. Call it before saving the comment so the mentioned users are notified.
+     * @summary Give mentioned users comment access
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    grantMentionAccess(mentionAccessRequest, options) {
+        return CommentsApiFp(this.configuration).grantMentionAccess(mentionAccessRequest, options).then((request) => request(this.axios, this.basePath));
+    }
+    /**
+     * Lists the mentioned users who cannot comment on the documents yet and what giving them access takes: a COMMENTER share (or READER → COMMENTER) on a document the caller manages, a share request to the owner on the others. Changes nothing.
+     * @summary Preview comment access for mentioned users
+     * @param {MentionAccessRequest} mentionAccessRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    previewMentionAccess(mentionAccessRequest, options) {
+        return CommentsApiFp(this.configuration).previewMentionAccess(mentionAccessRequest, options).then((request) => request(this.axios, this.basePath));
+    }
     /**
      * Update an existing comment. Only the comment creator can update their comment.
      * @summary Update a comment

package/dist/esm/api/notifications-api.d.ts

@@ -18,8 +18,8 @@ import type { NotificationDTO } from '../models';
  */
 export declare const NotificationsApiAxiosParamCreator: (configuration?: Configuration) => {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -59,8 +59,8 @@ export declare const NotificationsApiAxiosParamCreator: (configuration?: Configu
  */
 export declare const NotificationsApiFp: (configuration?: Configuration) => {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -100,8 +100,8 @@ export declare const NotificationsApiFp: (configuration?: Configuration) => {
  */
 export declare const NotificationsApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
@@ -141,8 +141,8 @@ export declare const NotificationsApiFactory: (configuration?: Configuration, ba
  */
 export declare class NotificationsApi extends BaseAPI {
     /**
-     * Retrieve all notifications for the authenticated user
-     * @summary Get all notifications
+     * The most recent notifications of the authenticated user, newest first (100 by default, 500 at most)
+     * @summary Get notifications
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */