@openfilz-sdk/typescript-ee 1.14.6 → 1.14.7

package/.openapi-generator/FILES

@@ -211,6 +211,9 @@ docs/McpAgentTokenInfo.md
 docs/McpAgentTokenResponse.md
 docs/McpDiscoveryControllerApi.md
 docs/McpTokenAdminControllerApi.md
+docs/MentionAccessItem.md
+docs/MentionAccessPreview.md
+docs/MentionAccessRequest.md
 docs/MergeRequest.md
 docs/MergeSource.md
 docs/MetadataKeyControllerApi.md
@@ -498,6 +501,9 @@ models/list-ai-models-request.ts
 models/mcp-agent-token-config.ts
 models/mcp-agent-token-info.ts
 models/mcp-agent-token-response.ts
+models/mention-access-item.ts
+models/mention-access-preview.ts
+models/mention-access-request.ts
 models/merge-request.ts
 models/merge-source.ts
 models/metadata-key-suggestion.ts

package/.openapi-generator/openfilz-api-generate-typescript-sdk.sha256

@@ -1 +1 @@
-f934993d994e1399aefd36e15e29a9546e6005d5afa7c057ce2d970dbababce0
+e314baf547051c02a7a055fd51c85629232ae4a88aae0c8f071625539563c9f7

package/README.md

@@ -1,4 +1,4 @@
-## @openfilz-sdk/typescript-ee@1.14.6
+## @openfilz-sdk/typescript-ee@1.14.7
 
 This generator creates TypeScript/JavaScript client that utilizes [axios](https://github.com/axios/axios). The generated Node module can be used in the following environments:
 
@@ -36,7 +36,7 @@ navigate to the folder of your consuming project and run one of the following co
 _published:_
 
 ```
-npm install @openfilz-sdk/typescript-ee@1.14.6 --save
+npm install @openfilz-sdk/typescript-ee@1.14.7 --save
 ```
 
 _unPublished (not recommended):_
@@ -126,6 +126,8 @@ Class | Method | HTTP request | Description
 *CollaborationControllerApi* | [**updateUser**](docs/CollaborationControllerApi.md#updateuser) | **PUT** /api/v1/users/{userId} | Update a user
 *CommentsApi* | [**createComment**](docs/CommentsApi.md#createcomment) | **POST** /api/v1/documents/comments | Create a comment
 *CommentsApi* | [**deleteComment**](docs/CommentsApi.md#deletecomment) | **DELETE** /api/v1/documents/comments/{id} | Delete a comment
+*CommentsApi* | [**grantMentionAccess**](docs/CommentsApi.md#grantmentionaccess) | **POST** /api/v1/documents/comments/mention-access/grant | Give mentioned users comment access
+*CommentsApi* | [**previewMentionAccess**](docs/CommentsApi.md#previewmentionaccess) | **POST** /api/v1/documents/comments/mention-access | Preview comment access for mentioned users
 *CommentsApi* | [**updateComment**](docs/CommentsApi.md#updatecomment) | **PUT** /api/v1/documents/comments/{id} | Update a comment
 *DashboardApi* | [**getDashboardStatistics**](docs/DashboardApi.md#getdashboardstatistics) | **GET** /api/v1/dashboard/statistics | Get dashboard statistics
 *DelegatedBrowseGrantsAdminApi* | [**browseFolders**](docs/DelegatedBrowseGrantsAdminApi.md#browsefolders) | **GET** /api/v1/admin/delegated/folders | Browse folders on behalf of the grantor
@@ -479,6 +481,9 @@ Class | Method | HTTP request | Description
  - [McpAgentTokenConfig](docs/McpAgentTokenConfig.md)
  - [McpAgentTokenInfo](docs/McpAgentTokenInfo.md)
  - [McpAgentTokenResponse](docs/McpAgentTokenResponse.md)
+ - [MentionAccessItem](docs/MentionAccessItem.md)
+ - [MentionAccessPreview](docs/MentionAccessPreview.md)
+ - [MentionAccessRequest](docs/MentionAccessRequest.md)
  - [MergeRequest](docs/MergeRequest.md)
  - [MergeSource](docs/MergeSource.md)
  - [MetadataKeySuggestion](docs/MetadataKeySuggestion.md)

package/api/comments-api.ts

@@ -26,6 +26,12 @@ import type { CommentDTO } from '../models';
 // @ts-ignore
 import type { CreateCommentRequest } from '../models';
 // @ts-ignore
+import type { MentionAccessPreview } from '../models';
+// @ts-ignore
+import type { MentionAccessRequest } from '../models';
+// @ts-ignore
+import type { ShareResultResponse } from '../models';
+// @ts-ignore
 import type { UpdateCommentRequest } from '../models';
 /**
  * CommentsApi - axios parameter creator
@@ -108,6 +114,84 @@ export const CommentsApiAxiosParamCreator = function (configuration?: Configurat
                 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: async (mentionAccessRequest: MentionAccessRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // 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 = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...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: async (mentionAccessRequest: MentionAccessRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // 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 = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...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
@@ -186,6 +270,32 @@ export const CommentsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['CommentsApi.deleteComment']?.[localVarOperationServerIndex]?.url;
             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}
+         */
+        async grantMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ShareResultResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.grantMentionAccess(mentionAccessRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['CommentsApi.grantMentionAccess']?.[localVarOperationServerIndex]?.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}
+         */
+        async previewMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<MentionAccessPreview>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.previewMentionAccess(mentionAccessRequest, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['CommentsApi.previewMentionAccess']?.[localVarOperationServerIndex]?.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
@@ -229,6 +339,26 @@ export const CommentsApiFactory = function (configuration?: Configuration, baseP
         deleteComment(id: string, options?: RawAxiosRequestConfig): AxiosPromise<void> {
             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: MentionAccessRequest, options?: RawAxiosRequestConfig): AxiosPromise<ShareResultResponse> {
+            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: MentionAccessRequest, options?: RawAxiosRequestConfig): AxiosPromise<MentionAccessPreview> {
+            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
@@ -269,6 +399,28 @@ export class CommentsApi extends BaseAPI {
         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}
+     */
+    public grantMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig) {
+        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}
+     */
+    public previewMentionAccess(mentionAccessRequest: MentionAccessRequest, options?: RawAxiosRequestConfig) {
+        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/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/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/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