@knowledge-stack/ksapi 1.8.0 → 1.9.0

package/.openapi-generator/FILES

@@ -26,12 +26,14 @@ src/models/CreateFolderRequest.ts
 src/models/CreatePasswordUserRequest.ts
 src/models/CreateSectionRequest.ts
 src/models/CreateTenantRequest.ts
+src/models/DocumentContentPathPart.ts
 src/models/DocumentOrigin.ts
 src/models/DocumentResponse.ts
 src/models/DocumentType.ts
 src/models/DocumentVersionResponse.ts
 src/models/EmailSentResponse.ts
 src/models/EmailVerificationRequest.ts
+src/models/FolderDocumentResponse.ts
 src/models/FolderResponse.ts
 src/models/HTTPValidationError.ts
 src/models/HealthCheckResponse.ts
@@ -40,8 +42,10 @@ src/models/InviteResponse.ts
 src/models/InviteStatus.ts
 src/models/InviteUserRequest.ts
 src/models/OAuth2Config.ts
+src/models/PaginatedResponseDocumentContentPathPart.ts
 src/models/PaginatedResponseDocumentResponse.ts
 src/models/PaginatedResponseDocumentVersionResponse.ts
+src/models/PaginatedResponseFolderDocumentResponse.ts
 src/models/PaginatedResponseFolderResponse.ts
 src/models/PaginatedResponseInviteResponse.ts
 src/models/PaginatedResponsePathPartResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-## @knowledge-stack/ksapi@1.8.0
+## @knowledge-stack/ksapi@1.9.0
 
 This generator creates TypeScript/JavaScript client that utilizes [Fetch API](https://fetch.spec.whatwg.org/). 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 @knowledge-stack/ksapi@1.8.0 --save
+npm install @knowledge-stack/ksapi@1.9.0 --save
 ```
 
 _unPublished (not recommended):_

package/dist/apis/DocumentVersionsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { DocumentVersionResponse, PaginatedResponseDocumentVersionResponse } from '../models/index';
+import type { DocumentVersionResponse, PaginatedResponseDocumentContentPathPart, PaginatedResponseDocumentVersionResponse } from '../models/index';
 export interface CreateDocumentVersionRequest {
     documentId: string;
     ksUat?: string;
@@ -23,6 +23,13 @@ export interface GetDocumentVersionRequest {
     versionId: string;
     ksUat?: string;
 }
+export interface GetDocumentVersionContentsRequest {
+    versionId: string;
+    sectionId?: string;
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
 export interface ListDocumentVersionsRequest {
     documentId: string;
     limit?: number;
@@ -81,6 +88,24 @@ export interface DocumentVersionsApiInterface {
      * Get Document Version Handler
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * @summary Get Document Version Contents Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * @summary List Document Versions Handler
@@ -133,6 +158,16 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      * Get Document Version Handler
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * List Document Versions Handler

package/dist/apis/DocumentVersionsApi.js

@@ -124,6 +124,47 @@ class DocumentVersionsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContentsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['versionId'] == null) {
+                throw new runtime.RequiredError('versionId', 'Required parameter "versionId" was null or undefined when calling getDocumentVersionContents().');
+            }
+            const queryParameters = {};
+            if (requestParameters['sectionId'] != null) {
+                queryParameters['section_id'] = requestParameters['sectionId'];
+            }
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/document_versions/{version_id}/contents`;
+            urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseDocumentContentPathPartFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContents(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getDocumentVersionContentsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * List Document Versions Handler

package/dist/apis/FoldersApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateFolderRequest, FolderResponse, PaginatedResponseFolderResponse, PathOrder, UpdateFolderRequest } from '../models/index';
+import type { CreateFolderRequest, FolderResponse, PaginatedResponseFolderDocumentResponse, PaginatedResponseFolderResponse, PathOrder, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
     ksUat?: string;
@@ -23,6 +23,14 @@ export interface GetFolderRequest {
     folderId: string;
     ksUat?: string;
 }
+export interface ListFolderContentsRequest {
+    folderId: string;
+    maxDepth?: number;
+    sortOrder?: PathOrder;
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
 export interface ListFoldersRequest {
     parentId?: string;
     sortOrder?: PathOrder;
@@ -87,6 +95,25 @@ export interface FoldersApiInterface {
      * Get Folder Handler
      */
     getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * @summary List Folder Contents Handler
+     * @param {string} folderId
+     * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
+     * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse>;
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * @summary List Folders Handler
@@ -156,6 +183,16 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      * Get Folder Handler
      */
     getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse>;
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * List Folders Handler

package/dist/apis/FoldersApi.js

@@ -125,6 +125,50 @@ class FoldersApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContentsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['folderId'] == null) {
+                throw new runtime.RequiredError('folderId', 'Required parameter "folderId" was null or undefined when calling listFolderContents().');
+            }
+            const queryParameters = {};
+            if (requestParameters['maxDepth'] != null) {
+                queryParameters['max_depth'] = requestParameters['maxDepth'];
+            }
+            if (requestParameters['sortOrder'] != null) {
+                queryParameters['sort_order'] = requestParameters['sortOrder'];
+            }
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/folders/{folder_id}/contents`;
+            urlPath = urlPath.replace(`{${"folder_id"}}`, encodeURIComponent(String(requestParameters['folderId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseFolderDocumentResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContents(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listFolderContentsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * List Folders Handler

package/dist/apis/PathPartsApi.d.ts

@@ -17,7 +17,6 @@ export interface GetPathPartRequest {
 }
 export interface ListPathPartsRequest {
     parentId?: string;
-    includeDocuments?: boolean;
     maxDepth?: number;
     sortOrder?: PathOrder;
     limit?: number;
@@ -47,10 +46,9 @@ export interface PathPartsApiInterface {
      */
     getPathPart(requestParameters: GetPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * @summary List Path Parts Handler
      * @param {string} [parentId] Parent PathPart ID (defaults to root)
-     * @param {boolean} [includeDocuments] Include documents in results (default: False, folders only)
      * @param {number} [maxDepth] Maximum depth to traverse (1 &#x3D; direct children, default: 1)
      * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
      * @param {number} [limit] Number of items per page
@@ -62,7 +60,7 @@ export interface PathPartsApiInterface {
      */
     listPathPartsRaw(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponsePathPartResponse>>;
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     listPathParts(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;
@@ -82,12 +80,12 @@ export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsAp
      */
     getPathPart(requestParameters: GetPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     listPathPartsRaw(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponsePathPartResponse>>;
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     listPathParts(requestParameters?: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;

package/dist/apis/PathPartsApi.js

@@ -62,7 +62,7 @@ class PathPartsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     listPathPartsRaw(requestParameters, initOverrides) {
@@ -71,9 +71,6 @@ class PathPartsApi extends runtime.BaseAPI {
             if (requestParameters['parentId'] != null) {
                 queryParameters['parent_id'] = requestParameters['parentId'];
             }
-            if (requestParameters['includeDocuments'] != null) {
-                queryParameters['include_documents'] = requestParameters['includeDocuments'];
-            }
             if (requestParameters['maxDepth'] != null) {
                 queryParameters['max_depth'] = requestParameters['maxDepth'];
             }
@@ -98,7 +95,7 @@ class PathPartsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List path parts under a parent with flexible filtering and traversal.  This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided.  - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types.   Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
+     * List path parts (folders) under a parent with traversal.  This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts.  - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.  For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
      * List Path Parts Handler
      */
     listPathParts() {

package/dist/esm/apis/DocumentVersionsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { DocumentVersionResponse, PaginatedResponseDocumentVersionResponse } from '../models/index';
+import type { DocumentVersionResponse, PaginatedResponseDocumentContentPathPart, PaginatedResponseDocumentVersionResponse } from '../models/index';
 export interface CreateDocumentVersionRequest {
     documentId: string;
     ksUat?: string;
@@ -23,6 +23,13 @@ export interface GetDocumentVersionRequest {
     versionId: string;
     ksUat?: string;
 }
+export interface GetDocumentVersionContentsRequest {
+    versionId: string;
+    sectionId?: string;
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
 export interface ListDocumentVersionsRequest {
     documentId: string;
     limit?: number;
@@ -81,6 +88,24 @@ export interface DocumentVersionsApiInterface {
      * Get Document Version Handler
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * @summary Get Document Version Contents Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * @summary List Document Versions Handler
@@ -133,6 +158,16 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      * Get Document Version Handler
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * List Document Versions Handler

package/dist/esm/apis/DocumentVersionsApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { DocumentVersionResponseFromJSON, PaginatedResponseDocumentVersionResponseFromJSON, } from '../models/index';
+import { DocumentVersionResponseFromJSON, PaginatedResponseDocumentContentPathPartFromJSON, PaginatedResponseDocumentVersionResponseFromJSON, } from '../models/index';
 /**
  *
  */
@@ -121,6 +121,47 @@ export class DocumentVersionsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContentsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['versionId'] == null) {
+                throw new runtime.RequiredError('versionId', 'Required parameter "versionId" was null or undefined when calling getDocumentVersionContents().');
+            }
+            const queryParameters = {};
+            if (requestParameters['sectionId'] != null) {
+                queryParameters['section_id'] = requestParameters['sectionId'];
+            }
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/document_versions/{version_id}/contents`;
+            urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseDocumentContentPathPartFromJSON(jsonValue));
+        });
+    }
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Get Document Version Contents Handler
+     */
+    getDocumentVersionContents(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getDocumentVersionContentsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * List Document Versions Handler

package/dist/esm/apis/FoldersApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateFolderRequest, FolderResponse, PaginatedResponseFolderResponse, PathOrder, UpdateFolderRequest } from '../models/index';
+import type { CreateFolderRequest, FolderResponse, PaginatedResponseFolderDocumentResponse, PaginatedResponseFolderResponse, PathOrder, UpdateFolderRequest } from '../models/index';
 export interface CreateFolderOperationRequest {
     createFolderRequest: CreateFolderRequest;
     ksUat?: string;
@@ -23,6 +23,14 @@ export interface GetFolderRequest {
     folderId: string;
     ksUat?: string;
 }
+export interface ListFolderContentsRequest {
+    folderId: string;
+    maxDepth?: number;
+    sortOrder?: PathOrder;
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
 export interface ListFoldersRequest {
     parentId?: string;
     sortOrder?: PathOrder;
@@ -87,6 +95,25 @@ export interface FoldersApiInterface {
      * Get Folder Handler
      */
     getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * @summary List Folder Contents Handler
+     * @param {string} folderId
+     * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
+     * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof FoldersApiInterface
+     */
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse>;
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * @summary List Folders Handler
@@ -156,6 +183,16 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      * Get Folder Handler
      */
     getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse>;
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * List Folders Handler

package/dist/esm/apis/FoldersApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { CreateFolderRequestToJSON, FolderResponseFromJSON, PaginatedResponseFolderResponseFromJSON, UpdateFolderRequestToJSON, } from '../models/index';
+import { CreateFolderRequestToJSON, FolderResponseFromJSON, PaginatedResponseFolderDocumentResponseFromJSON, PaginatedResponseFolderResponseFromJSON, UpdateFolderRequestToJSON, } from '../models/index';
 /**
  *
  */
@@ -122,6 +122,50 @@ export class FoldersApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContentsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['folderId'] == null) {
+                throw new runtime.RequiredError('folderId', 'Required parameter "folderId" was null or undefined when calling listFolderContents().');
+            }
+            const queryParameters = {};
+            if (requestParameters['maxDepth'] != null) {
+                queryParameters['max_depth'] = requestParameters['maxDepth'];
+            }
+            if (requestParameters['sortOrder'] != null) {
+                queryParameters['sort_order'] = requestParameters['sortOrder'];
+            }
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/folders/{folder_id}/contents`;
+            urlPath = urlPath.replace(`{${"folder_id"}}`, encodeURIComponent(String(requestParameters['folderId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseFolderDocumentResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * List all contents (folders and documents) under a folder.  Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
+     * List Folder Contents Handler
+     */
+    listFolderContents(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listFolderContentsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * List child folders of a parent folder.  Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
      * List Folders Handler