@openfilz-sdk/typescript 1.3.19 → 1.3.21

package/.openapi-generator/FILES

@@ -40,10 +40,12 @@ docs/AiSettingsResponse.md
 docs/AncestorInfo.md
 docs/ApplySignatureRequest.md
 docs/AuditControllerApi.md
+docs/AuditIntegrityStatusResponse.md
 docs/AuditLog.md
 docs/AuditLogDetails.md
 docs/AuditLogDetailsOneOf.md
 docs/AuditVerificationResult.md
+docs/AutoFileInboxRequest.md
 docs/AutoFileJobView.md
 docs/AutoFileJobsRequest.md
 docs/AutoFileRequest.md
@@ -70,6 +72,7 @@ docs/DocumentControllerApi.md
 docs/DocumentInfo.md
 docs/DocumentInsightView.md
 docs/DocumentInsightsApi.md
+docs/DocumentIntegrityRecord.md
 docs/DocumentPosition.md
 docs/DocumentSuggestionControllerApi.md
 docs/DocumentVersionControllerApi.md
@@ -80,6 +83,7 @@ docs/ESignTemplatesApi.md
 docs/ElementInfo.md
 docs/EmbeddingBackfillRequest.md
 docs/EmbeddingBackfillStatus.md
+docs/Facet.md
 docs/FavoritesApi.md
 docs/FileControllerApi.md
 docs/FileTypeStats.md
@@ -91,6 +95,7 @@ docs/FolderResponse.md
 docs/InsightBackfillRequest.md
 docs/InsightBackfillStatus.md
 docs/InsightCategoryUpdate.md
+docs/InsightFacets.md
 docs/InstantiateTemplateRequest.md
 docs/Item.md
 docs/ItemResult.md
@@ -189,10 +194,12 @@ models/ai-preferences-view.ts
 models/ai-settings-response.ts
 models/ancestor-info.ts
 models/apply-signature-request.ts
+models/audit-integrity-status-response.ts
 models/audit-log-details-one-of.ts
 models/audit-log-details.ts
 models/audit-log.ts
 models/audit-verification-result.ts
+models/auto-file-inbox-request.ts
 models/auto-file-job-view.ts
 models/auto-file-jobs-request.ts
 models/auto-file-request.ts
@@ -216,11 +223,13 @@ models/delete-metadata-request.ts
 models/delete-request.ts
 models/document-info.ts
 models/document-insight-view.ts
+models/document-integrity-record.ts
 models/document-position.ts
 models/document-version-info.ts
 models/element-info.ts
 models/embedding-backfill-request.ts
 models/embedding-backfill-status.ts
+models/facet.ts
 models/file-type-stats.ts
 models/filing-outcome.ts
 models/filter-input.ts
@@ -230,6 +239,7 @@ models/index.ts
 models/insight-backfill-request.ts
 models/insight-backfill-status.ts
 models/insight-category-update.ts
+models/insight-facets.ts
 models/instantiate-template-request.ts
 models/item-result.ts
 models/item.ts

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

@@ -1 +1 @@
-8672580c6c5002cb918a847b9f10e8dd17d4fb82174d95aee6d855cadfbb0aa8
+5028c2728c97b24a1e3d89f156885b27c70c2536b5c7aca4323fbfa321eb42c4

package/README.md

@@ -1,4 +1,4 @@
-## @openfilz-sdk/typescript@1.3.19
+## @openfilz-sdk/typescript@1.3.21
 
 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@1.3.19 --save
+npm install @openfilz-sdk/typescript@1.3.21 --save
 ```
 
 _unPublished (not recommended):_
@@ -66,6 +66,7 @@ Class | Method | HTTP request | Description
 *AISettingsApi* | [**listModels**](docs/AISettingsApi.md#listmodels) | **POST** /api/v1/settings/ai/models | List the provider\'s chat models
 *AISettingsApi* | [**saveSettings**](docs/AISettingsApi.md#savesettings) | **PUT** /api/v1/settings/ai | Save my AI settings
 *AISettingsApi* | [**testConnection**](docs/AISettingsApi.md#testconnection) | **POST** /api/v1/settings/ai/test | Test AI provider connection
+*AuditControllerApi* | [**auditIntegrityStatus**](docs/AuditControllerApi.md#auditintegritystatus) | **GET** /api/v1/audit/verify/status | Last scheduled audit chain verification
 *AuditControllerApi* | [**getAuditTrail**](docs/AuditControllerApi.md#getaudittrail) | **GET** /api/v1/audit/{id} | Get audit trail for a resource
 *AuditControllerApi* | [**searchAuditTrail**](docs/AuditControllerApi.md#searchaudittrail) | **POST** /api/v1/audit/search | Search for audit trails
 *AuditControllerApi* | [**verifyChain**](docs/AuditControllerApi.md#verifychain) | **GET** /api/v1/audit/verify | Verify audit chain integrity
@@ -77,6 +78,7 @@ Class | Method | HTTP request | Description
 *DocumentControllerApi* | [**downloadMultipleDocumentsAsZip**](docs/DocumentControllerApi.md#downloadmultipledocumentsaszip) | **POST** /api/v1/documents/download-multiple | Download multiple documents as ZIP
 *DocumentControllerApi* | [**getDocumentAncestors**](docs/DocumentControllerApi.md#getdocumentancestors) | **GET** /api/v1/documents/{documentId}/ancestors | Get document ancestors
 *DocumentControllerApi* | [**getDocumentInfo**](docs/DocumentControllerApi.md#getdocumentinfo) | **GET** /api/v1/documents/{documentId}/info | Get information of a document
+*DocumentControllerApi* | [**getDocumentIntegrity**](docs/DocumentControllerApi.md#getdocumentintegrity) | **GET** /api/v1/documents/{documentId}/integrity | Get a document\'s integrity ledger
 *DocumentControllerApi* | [**getDocumentMetadata**](docs/DocumentControllerApi.md#getdocumentmetadata) | **POST** /api/v1/documents/{documentId}/search/metadata | Search metadata of a document
 *DocumentControllerApi* | [**getDocumentPosition**](docs/DocumentControllerApi.md#getdocumentposition) | **GET** /api/v1/documents/{documentId}/position | Get document position in folder
 *DocumentControllerApi* | [**replaceDocumentContent**](docs/DocumentControllerApi.md#replacedocumentcontent) | **PUT** /api/v1/documents/{documentId}/replace-content | Replace document content
@@ -87,6 +89,7 @@ Class | Method | HTTP request | Description
 *DocumentControllerApi* | [**uploadDocument1**](docs/DocumentControllerApi.md#uploaddocument1) | **POST** /api/v1/documents/upload | Upload a single document
 *DocumentInsightsApi* | [**backfill**](docs/DocumentInsightsApi.md#backfill) | **POST** /api/v1/ai/insights/backfill | Enrich existing documents
 *DocumentInsightsApi* | [**backfillStatus**](docs/DocumentInsightsApi.md#backfillstatus) | **GET** /api/v1/ai/insights/backfill/{jobId} | Progress of a backfill job
+*DocumentInsightsApi* | [**facets**](docs/DocumentInsightsApi.md#facets) | **GET** /api/v1/ai/insights/facets | The category and language facets of the library
 *DocumentInsightsApi* | [**getInsights**](docs/DocumentInsightsApi.md#getinsights) | **GET** /api/v1/documents/{documentId}/insights | Get the insights of a document
 *DocumentInsightsApi* | [**setCategory**](docs/DocumentInsightsApi.md#setcategory) | **PATCH** /api/v1/documents/{documentId}/insights | Correct the kind of a document
 *DocumentSuggestionControllerApi* | [**getSuggestions**](docs/DocumentSuggestionControllerApi.md#getsuggestions) | **GET** /api/v1/suggestions | 
@@ -142,6 +145,7 @@ Class | Method | HTTP request | Description
 *SettingsApi* | [**getSettings1**](docs/SettingsApi.md#getsettings1) | **GET** /api/v1/settings | Get user\'s settings
 *SettingsApi* | [**save**](docs/SettingsApi.md#save) | **PUT** /api/v1/settings/ai/preferences | Save the caller\'s smart-filing preferences
 *SmartFilingApi* | [**file**](docs/SmartFilingApi.md#file) | **POST** /api/v1/ai/auto-file | File existing documents on demand
+*SmartFilingApi* | [**fileInbox**](docs/SmartFilingApi.md#fileinbox) | **POST** /api/v1/ai/auto-file/inbox | File everything lying loose in the caller\'s Inbox
 *SmartFilingApi* | [**job**](docs/SmartFilingApi.md#job) | **GET** /api/v1/ai/auto-file/{jobId} | Progress and outcome of a filing job
 *SmartFilingApi* | [**jobs**](docs/SmartFilingApi.md#jobs) | **POST** /api/v1/ai/auto-file/jobs | Progress and outcome of several filing jobs
 *SmartFilingApi* | [**lastFiling**](docs/SmartFilingApi.md#lastfiling) | **GET** /api/v1/ai/auto-file/document/{documentId} | The latest filing record of a document (the \"Filed by OpenFilz\" chip)
@@ -184,10 +188,12 @@ Class | Method | HTTP request | Description
  - [AiSettingsResponse](docs/AiSettingsResponse.md)
  - [AncestorInfo](docs/AncestorInfo.md)
  - [ApplySignatureRequest](docs/ApplySignatureRequest.md)
+ - [AuditIntegrityStatusResponse](docs/AuditIntegrityStatusResponse.md)
  - [AuditLog](docs/AuditLog.md)
  - [AuditLogDetails](docs/AuditLogDetails.md)
  - [AuditLogDetailsOneOf](docs/AuditLogDetailsOneOf.md)
  - [AuditVerificationResult](docs/AuditVerificationResult.md)
+ - [AutoFileInboxRequest](docs/AutoFileInboxRequest.md)
  - [AutoFileJobView](docs/AutoFileJobView.md)
  - [AutoFileJobsRequest](docs/AutoFileJobsRequest.md)
  - [AutoFileRequest](docs/AutoFileRequest.md)
@@ -211,11 +217,13 @@ Class | Method | HTTP request | Description
  - [DeleteRequest](docs/DeleteRequest.md)
  - [DocumentInfo](docs/DocumentInfo.md)
  - [DocumentInsightView](docs/DocumentInsightView.md)
+ - [DocumentIntegrityRecord](docs/DocumentIntegrityRecord.md)
  - [DocumentPosition](docs/DocumentPosition.md)
  - [DocumentVersionInfo](docs/DocumentVersionInfo.md)
  - [ElementInfo](docs/ElementInfo.md)
  - [EmbeddingBackfillRequest](docs/EmbeddingBackfillRequest.md)
  - [EmbeddingBackfillStatus](docs/EmbeddingBackfillStatus.md)
+ - [Facet](docs/Facet.md)
  - [FileTypeStats](docs/FileTypeStats.md)
  - [FilingOutcome](docs/FilingOutcome.md)
  - [FilterInput](docs/FilterInput.md)
@@ -224,6 +232,7 @@ Class | Method | HTTP request | Description
  - [InsightBackfillRequest](docs/InsightBackfillRequest.md)
  - [InsightBackfillStatus](docs/InsightBackfillStatus.md)
  - [InsightCategoryUpdate](docs/InsightCategoryUpdate.md)
+ - [InsightFacets](docs/InsightFacets.md)
  - [InstantiateTemplateRequest](docs/InstantiateTemplateRequest.md)
  - [Item](docs/Item.md)
  - [ItemResult](docs/ItemResult.md)

package/api/audit-controller-api.ts

@@ -22,6 +22,8 @@ import { DUMMY_BASE_URL, assertParamExists, setApiKeyToObject, setBasicAuthToObj
 // @ts-ignore
 import { BASE_PATH, COLLECTION_FORMATS, type RequestArgs, BaseAPI, RequiredError, operationServerMap } from '../base';
 // @ts-ignore
+import type { AuditIntegrityStatusResponse } from '../models';
+// @ts-ignore
 import type { AuditLog } from '../models';
 // @ts-ignore
 import type { AuditVerificationResult } from '../models';
@@ -32,6 +34,40 @@ import type { SearchByAuditLogRequest } from '../models';
  */
 export const AuditControllerApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
+        /**
+         * Returns the cached verdict of the last scheduled verification on this instance, without re-walking the chain. Poll this for monitoring; call /verify for an authoritative, on-demand answer. `verified=false` means the chain has not been checked yet on this instance — it does not mean the chain is valid.
+         * @summary Last scheduled audit chain verification
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        auditIntegrityStatus: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/api/v1/audit/verify/status`;
+            // 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: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = '*/*';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * Retrieves the audit trail for a given resource.
          * @summary Get audit trail for a resource
@@ -157,6 +193,18 @@ export const AuditControllerApiAxiosParamCreator = function (configuration?: Con
 export const AuditControllerApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = AuditControllerApiAxiosParamCreator(configuration)
     return {
+        /**
+         * Returns the cached verdict of the last scheduled verification on this instance, without re-walking the chain. Poll this for monitoring; call /verify for an authoritative, on-demand answer. `verified=false` means the chain has not been checked yet on this instance — it does not mean the chain is valid.
+         * @summary Last scheduled audit chain verification
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async auditIntegrityStatus(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AuditIntegrityStatusResponse>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.auditIntegrityStatus(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['AuditControllerApi.auditIntegrityStatus']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Retrieves the audit trail for a given resource.
          * @summary Get audit trail for a resource
@@ -205,6 +253,15 @@ export const AuditControllerApiFp = function(configuration?: Configuration) {
 export const AuditControllerApiFactory = function (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) {
     const localVarFp = AuditControllerApiFp(configuration)
     return {
+        /**
+         * Returns the cached verdict of the last scheduled verification on this instance, without re-walking the chain. Poll this for monitoring; call /verify for an authoritative, on-demand answer. `verified=false` means the chain has not been checked yet on this instance — it does not mean the chain is valid.
+         * @summary Last scheduled audit chain verification
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        auditIntegrityStatus(options?: RawAxiosRequestConfig): AxiosPromise<AuditIntegrityStatusResponse> {
+            return localVarFp.auditIntegrityStatus(options).then((request) => request(axios, basePath));
+        },
         /**
          * Retrieves the audit trail for a given resource.
          * @summary Get audit trail for a resource
@@ -242,6 +299,16 @@ export const AuditControllerApiFactory = function (configuration?: Configuration
  * AuditControllerApi - object-oriented interface
  */
 export class AuditControllerApi extends BaseAPI {
+    /**
+     * Returns the cached verdict of the last scheduled verification on this instance, without re-walking the chain. Poll this for monitoring; call /verify for an authoritative, on-demand answer. `verified=false` means the chain has not been checked yet on this instance — it does not mean the chain is valid.
+     * @summary Last scheduled audit chain verification
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public auditIntegrityStatus(options?: RawAxiosRequestConfig) {
+        return AuditControllerApiFp(this.configuration).auditIntegrityStatus(options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Retrieves the audit trail for a given resource.
      * @summary Get audit trail for a resource

package/api/document-controller-api.ts

@@ -30,6 +30,8 @@ import type { DeleteMetadataRequest } from '../models';
 // @ts-ignore
 import type { DocumentInfo } from '../models';
 // @ts-ignore
+import type { DocumentIntegrityRecord } from '../models';
+// @ts-ignore
 import type { DocumentPosition } from '../models';
 // @ts-ignore
 import type { ElementInfo } from '../models';
@@ -335,6 +337,44 @@ export const DocumentControllerApiAxiosParamCreator = function (configuration?:
                 options: localVarRequestOptions,
             };
         },
+        /**
+         * Append-only history of what this document\'s content hashed to, newest first. Unlike the sha256 in metadata, these entries cannot be modified or deleted — a database trigger refuses UPDATE and DELETE on the table. Empty for documents uploaded before the ledger existed, or when openfilz.calculate-checksum is off.
+         * @summary Get a document\'s integrity ledger
+         * @param {string} documentId 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getDocumentIntegrity: async (documentId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'documentId' is not null or undefined
+            assertParamExists('getDocumentIntegrity', 'documentId', documentId)
+            const localVarPath = `/api/v1/documents/{documentId}/integrity`
+                .replace('{documentId}', encodeURIComponent(String(documentId)));
+            // 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: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = '*/*';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * Retrieves metadata for a document. Can filter by keys.
          * @summary Search metadata of a document
@@ -826,6 +866,19 @@ export const DocumentControllerApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['DocumentControllerApi.getDocumentInfo']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * Append-only history of what this document\'s content hashed to, newest first. Unlike the sha256 in metadata, these entries cannot be modified or deleted — a database trigger refuses UPDATE and DELETE on the table. Empty for documents uploaded before the ledger existed, or when openfilz.calculate-checksum is off.
+         * @summary Get a document\'s integrity ledger
+         * @param {string} documentId 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async getDocumentIntegrity(documentId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<DocumentIntegrityRecord>>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.getDocumentIntegrity(documentId, options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['DocumentControllerApi.getDocumentIntegrity']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Retrieves metadata for a document. Can filter by keys.
          * @summary Search metadata of a document
@@ -1026,6 +1079,16 @@ export const DocumentControllerApiFactory = function (configuration?: Configurat
         getDocumentInfo(documentId: string, withMetadata?: boolean, options?: RawAxiosRequestConfig): AxiosPromise<DocumentInfo> {
             return localVarFp.getDocumentInfo(documentId, withMetadata, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Append-only history of what this document\'s content hashed to, newest first. Unlike the sha256 in metadata, these entries cannot be modified or deleted — a database trigger refuses UPDATE and DELETE on the table. Empty for documents uploaded before the ledger existed, or when openfilz.calculate-checksum is off.
+         * @summary Get a document\'s integrity ledger
+         * @param {string} documentId 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        getDocumentIntegrity(documentId: string, options?: RawAxiosRequestConfig): AxiosPromise<Array<DocumentIntegrityRecord>> {
+            return localVarFp.getDocumentIntegrity(documentId, options).then((request) => request(axios, basePath));
+        },
         /**
          * Retrieves metadata for a document. Can filter by keys.
          * @summary Search metadata of a document
@@ -1207,6 +1270,17 @@ export class DocumentControllerApi extends BaseAPI {
         return DocumentControllerApiFp(this.configuration).getDocumentInfo(documentId, withMetadata, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Append-only history of what this document\'s content hashed to, newest first. Unlike the sha256 in metadata, these entries cannot be modified or deleted — a database trigger refuses UPDATE and DELETE on the table. Empty for documents uploaded before the ledger existed, or when openfilz.calculate-checksum is off.
+     * @summary Get a document\'s integrity ledger
+     * @param {string} documentId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public getDocumentIntegrity(documentId: string, options?: RawAxiosRequestConfig) {
+        return DocumentControllerApiFp(this.configuration).getDocumentIntegrity(documentId, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Retrieves metadata for a document. Can filter by keys.
      * @summary Search metadata of a document

package/api/document-insights-api.ts

@@ -29,6 +29,8 @@ import type { InsightBackfillRequest } from '../models';
 import type { InsightBackfillStatus } from '../models';
 // @ts-ignore
 import type { InsightCategoryUpdate } from '../models';
+// @ts-ignore
+import type { InsightFacets } from '../models';
 /**
  * DocumentInsightsApi - axios parameter creator
  */
@@ -109,6 +111,40 @@ export const DocumentInsightsApiAxiosParamCreator = function (configuration?: Co
                 options: localVarRequestOptions,
             };
         },
+        /**
+         * How many active files carry each tier-2 category and each detected language, from the document insights (largest first). The keys are what searchDocuments accepts in its \'category\' / \'language\' filters. 404 when the AI features are off (openfilz.ai.active); READER.
+         * @summary The category and language facets of the library
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        facets: async (options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/api/v1/ai/insights/facets`;
+            // 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: 'GET', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            // authentication keycloak_auth required
+            // http bearer authentication required
+            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+
+            localVarHeaderParameter['Accept'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * Tier 1: the file\'s own metadata (title, author, dates, page count, language) captured at upload. Tier 2: the AI-derived category, summary, keywords and entities when openfilz.ai.insights.active is on. 404 when the document is not visible or has no insights yet.
          * @summary Get the insights of a document
@@ -148,7 +184,7 @@ export const DocumentInsightsApiAxiosParamCreator = function (configuration?: Co
             };
         },
         /**
-         * Sets the tier-2 category to one of the deployment\'s categories (openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
+         * Sets the tier-2 category to one of the deployment\'s kinds (the category taxonomy: openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
          * @summary Correct the kind of a document
          * @param {string} documentId 
          * @param {InsightCategoryUpdate} insightCategoryUpdate 
@@ -225,6 +261,18 @@ export const DocumentInsightsApiFp = function(configuration?: Configuration) {
             const localVarOperationServerBasePath = operationServerMap['DocumentInsightsApi.backfillStatus']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
+        /**
+         * How many active files carry each tier-2 category and each detected language, from the document insights (largest first). The keys are what searchDocuments accepts in its \'category\' / \'language\' filters. 404 when the AI features are off (openfilz.ai.active); READER.
+         * @summary The category and language facets of the library
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async facets(options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InsightFacets>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.facets(options);
+            const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
+            const localVarOperationServerBasePath = operationServerMap['DocumentInsightsApi.facets']?.[localVarOperationServerIndex]?.url;
+            return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
+        },
         /**
          * Tier 1: the file\'s own metadata (title, author, dates, page count, language) captured at upload. Tier 2: the AI-derived category, summary, keywords and entities when openfilz.ai.insights.active is on. 404 when the document is not visible or has no insights yet.
          * @summary Get the insights of a document
@@ -239,7 +287,7 @@ export const DocumentInsightsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * Sets the tier-2 category to one of the deployment\'s categories (openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
+         * Sets the tier-2 category to one of the deployment\'s kinds (the category taxonomy: openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
          * @summary Correct the kind of a document
          * @param {string} documentId 
          * @param {InsightCategoryUpdate} insightCategoryUpdate 
@@ -281,6 +329,15 @@ export const DocumentInsightsApiFactory = function (configuration?: Configuratio
         backfillStatus(jobId: string, options?: RawAxiosRequestConfig): AxiosPromise<InsightBackfillStatus> {
             return localVarFp.backfillStatus(jobId, options).then((request) => request(axios, basePath));
         },
+        /**
+         * How many active files carry each tier-2 category and each detected language, from the document insights (largest first). The keys are what searchDocuments accepts in its \'category\' / \'language\' filters. 404 when the AI features are off (openfilz.ai.active); READER.
+         * @summary The category and language facets of the library
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        facets(options?: RawAxiosRequestConfig): AxiosPromise<InsightFacets> {
+            return localVarFp.facets(options).then((request) => request(axios, basePath));
+        },
         /**
          * Tier 1: the file\'s own metadata (title, author, dates, page count, language) captured at upload. Tier 2: the AI-derived category, summary, keywords and entities when openfilz.ai.insights.active is on. 404 when the document is not visible or has no insights yet.
          * @summary Get the insights of a document
@@ -292,7 +349,7 @@ export const DocumentInsightsApiFactory = function (configuration?: Configuratio
             return localVarFp.getInsights(documentId, options).then((request) => request(axios, basePath));
         },
         /**
-         * Sets the tier-2 category to one of the deployment\'s categories (openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
+         * Sets the tier-2 category to one of the deployment\'s kinds (the category taxonomy: openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
          * @summary Correct the kind of a document
          * @param {string} documentId 
          * @param {InsightCategoryUpdate} insightCategoryUpdate 
@@ -331,6 +388,16 @@ export class DocumentInsightsApi extends BaseAPI {
         return DocumentInsightsApiFp(this.configuration).backfillStatus(jobId, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * How many active files carry each tier-2 category and each detected language, from the document insights (largest first). The keys are what searchDocuments accepts in its \'category\' / \'language\' filters. 404 when the AI features are off (openfilz.ai.active); READER.
+     * @summary The category and language facets of the library
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    public facets(options?: RawAxiosRequestConfig) {
+        return DocumentInsightsApiFp(this.configuration).facets(options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Tier 1: the file\'s own metadata (title, author, dates, page count, language) captured at upload. Tier 2: the AI-derived category, summary, keywords and entities when openfilz.ai.insights.active is on. 404 when the document is not visible or has no insights yet.
      * @summary Get the insights of a document
@@ -343,7 +410,7 @@ export class DocumentInsightsApi extends BaseAPI {
     }
 
     /**
-     * Sets the tier-2 category to one of the deployment\'s categories (openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
+     * Sets the tier-2 category to one of the deployment\'s kinds (the category taxonomy: openfilz.ai.insights.categories, or \'other\'), recorded as written by the user: it is never overwritten by a non-forced backfill, it teaches the learned classifier, and the by-kind reorganisation and smart filing use it like a model\'s label. 400 for a kind the deployment does not know; 403 without modify access.
      * @summary Correct the kind of a document
      * @param {string} documentId 
      * @param {InsightCategoryUpdate} insightCategoryUpdate 

package/api/settings-api.ts

@@ -101,13 +101,14 @@ export const SettingsApiAxiosParamCreator = function (configuration?: Configurat
             };
         },
         /**
-         * A null field leaves the current value unchanged.
+         * A null field leaves the current value unchanged. inbox=true creates the caller\'s Inbox folder at their root on demand (named from Accept-Language, else the deployment\'s default language); inbox=false forgets it without deleting the folder. 400 when the Inbox is not offered.
          * @summary Save the caller\'s smart-filing preferences
          * @param {SaveAiPreferencesRequest} saveAiPreferencesRequest 
+         * @param {string} [acceptLanguage] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        save: async (saveAiPreferencesRequest: SaveAiPreferencesRequest, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
+        save: async (saveAiPreferencesRequest: SaveAiPreferencesRequest, acceptLanguage?: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'saveAiPreferencesRequest' is not null or undefined
             assertParamExists('save', 'saveAiPreferencesRequest', saveAiPreferencesRequest)
             const localVarPath = `/api/v1/settings/ai/preferences`;
@@ -129,6 +130,9 @@ export const SettingsApiAxiosParamCreator = function (configuration?: Configurat
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json';
 
+            if (acceptLanguage != null) {
+                localVarHeaderParameter['Accept-Language'] = String(acceptLanguage);
+            }
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -173,14 +177,15 @@ export const SettingsApiFp = function(configuration?: Configuration) {
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
         },
         /**
-         * A null field leaves the current value unchanged.
+         * A null field leaves the current value unchanged. inbox=true creates the caller\'s Inbox folder at their root on demand (named from Accept-Language, else the deployment\'s default language); inbox=false forgets it without deleting the folder. 400 when the Inbox is not offered.
          * @summary Save the caller\'s smart-filing preferences
          * @param {SaveAiPreferencesRequest} saveAiPreferencesRequest 
+         * @param {string} [acceptLanguage] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async save(saveAiPreferencesRequest: SaveAiPreferencesRequest, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AiPreferencesView>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.save(saveAiPreferencesRequest, options);
+        async save(saveAiPreferencesRequest: SaveAiPreferencesRequest, acceptLanguage?: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AiPreferencesView>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.save(saveAiPreferencesRequest, acceptLanguage, options);
             const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
             const localVarOperationServerBasePath = operationServerMap['SettingsApi.save']?.[localVarOperationServerIndex]?.url;
             return (axios, basePath) => createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration)(axios, localVarOperationServerBasePath || basePath);
@@ -213,14 +218,15 @@ export const SettingsApiFactory = function (configuration?: Configuration, baseP
             return localVarFp.getSettings1(options).then((request) => request(axios, basePath));
         },
         /**
-         * A null field leaves the current value unchanged.
+         * A null field leaves the current value unchanged. inbox=true creates the caller\'s Inbox folder at their root on demand (named from Accept-Language, else the deployment\'s default language); inbox=false forgets it without deleting the folder. 400 when the Inbox is not offered.
          * @summary Save the caller\'s smart-filing preferences
          * @param {SaveAiPreferencesRequest} saveAiPreferencesRequest 
+         * @param {string} [acceptLanguage] 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        save(saveAiPreferencesRequest: SaveAiPreferencesRequest, options?: RawAxiosRequestConfig): AxiosPromise<AiPreferencesView> {
-            return localVarFp.save(saveAiPreferencesRequest, options).then((request) => request(axios, basePath));
+        save(saveAiPreferencesRequest: SaveAiPreferencesRequest, acceptLanguage?: string, options?: RawAxiosRequestConfig): AxiosPromise<AiPreferencesView> {
+            return localVarFp.save(saveAiPreferencesRequest, acceptLanguage, options).then((request) => request(axios, basePath));
         },
     };
 };
@@ -250,14 +256,15 @@ export class SettingsApi extends BaseAPI {
     }
 
     /**
-     * A null field leaves the current value unchanged.
+     * A null field leaves the current value unchanged. inbox=true creates the caller\'s Inbox folder at their root on demand (named from Accept-Language, else the deployment\'s default language); inbox=false forgets it without deleting the folder. 400 when the Inbox is not offered.
      * @summary Save the caller\'s smart-filing preferences
      * @param {SaveAiPreferencesRequest} saveAiPreferencesRequest 
+     * @param {string} [acceptLanguage] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
-    public save(saveAiPreferencesRequest: SaveAiPreferencesRequest, options?: RawAxiosRequestConfig) {
-        return SettingsApiFp(this.configuration).save(saveAiPreferencesRequest, options).then((request) => request(this.axios, this.basePath));
+    public save(saveAiPreferencesRequest: SaveAiPreferencesRequest, acceptLanguage?: string, options?: RawAxiosRequestConfig) {
+        return SettingsApiFp(this.configuration).save(saveAiPreferencesRequest, acceptLanguage, options).then((request) => request(this.axios, this.basePath));
     }
 }