@knowledge-stack/ksapi 1.15.0 → 1.17.0

package/dist/apis/WorkflowsApi.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import * as runtime from '../runtime';
+import type { PaginatedResponseWorkflowSummaryResponse, WorkflowAction, WorkflowActionResponse, WorkflowDetailResponse } from '../models/index';
+export interface GetWorkflowRequest {
+    workflowId: string;
+    ksUat?: string;
+}
+export interface ListWorkflowsRequest {
+    limit?: number;
+    offset?: number;
+    ksUat?: string;
+}
+export interface WorkflowActionRequest {
+    workflowId: string;
+    action: WorkflowAction;
+    ksUat?: string;
+}
+/**
+ * WorkflowsApi - interface
+ *
+ * @export
+ * @interface WorkflowsApiInterface
+ */
+export interface WorkflowsApiInterface {
+    /**
+     * Get single workflow detail with live Temporal status.
+     * @summary Get Workflow Handler
+     * @param {string} workflowId
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowsApiInterface
+     */
+    getWorkflowRaw(requestParameters: GetWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowDetailResponse>>;
+    /**
+     * Get single workflow detail with live Temporal status.
+     * Get Workflow Handler
+     */
+    getWorkflow(requestParameters: GetWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowDetailResponse>;
+    /**
+     * List all workflows for the current tenant (paginated, DB-backed).
+     * @summary List Workflows Handler
+     * @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 WorkflowsApiInterface
+     */
+    listWorkflowsRaw(requestParameters: ListWorkflowsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowSummaryResponse>>;
+    /**
+     * List all workflows for the current tenant (paginated, DB-backed).
+     * List Workflows Handler
+     */
+    listWorkflows(requestParameters: ListWorkflowsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowSummaryResponse>;
+    /**
+     * Cancel or rerun a workflow (OWNER/ADMIN only).
+     * @summary Workflow Action Handler
+     * @param {string} workflowId
+     * @param {WorkflowAction} action Action to perform
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowsApiInterface
+     */
+    workflowActionRaw(requestParameters: WorkflowActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowActionResponse>>;
+    /**
+     * Cancel or rerun a workflow (OWNER/ADMIN only).
+     * Workflow Action Handler
+     */
+    workflowAction(requestParameters: WorkflowActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowActionResponse>;
+}
+/**
+ *
+ */
+export declare class WorkflowsApi extends runtime.BaseAPI implements WorkflowsApiInterface {
+    /**
+     * Get single workflow detail with live Temporal status.
+     * Get Workflow Handler
+     */
+    getWorkflowRaw(requestParameters: GetWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowDetailResponse>>;
+    /**
+     * Get single workflow detail with live Temporal status.
+     * Get Workflow Handler
+     */
+    getWorkflow(requestParameters: GetWorkflowRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowDetailResponse>;
+    /**
+     * List all workflows for the current tenant (paginated, DB-backed).
+     * List Workflows Handler
+     */
+    listWorkflowsRaw(requestParameters: ListWorkflowsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseWorkflowSummaryResponse>>;
+    /**
+     * List all workflows for the current tenant (paginated, DB-backed).
+     * List Workflows Handler
+     */
+    listWorkflows(requestParameters?: ListWorkflowsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseWorkflowSummaryResponse>;
+    /**
+     * Cancel or rerun a workflow (OWNER/ADMIN only).
+     * Workflow Action Handler
+     */
+    workflowActionRaw(requestParameters: WorkflowActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowActionResponse>>;
+    /**
+     * Cancel or rerun a workflow (OWNER/ADMIN only).
+     * Workflow Action Handler
+     */
+    workflowAction(requestParameters: WorkflowActionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowActionResponse>;
+}

package/dist/apis/WorkflowsApi.js

@@ -0,0 +1,137 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowsApi = void 0;
+const runtime = require("../runtime");
+const index_1 = require("../models/index");
+/**
+ *
+ */
+class WorkflowsApi extends runtime.BaseAPI {
+    /**
+     * Get single workflow detail with live Temporal status.
+     * Get Workflow Handler
+     */
+    getWorkflowRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['workflowId'] == null) {
+                throw new runtime.RequiredError('workflowId', 'Required parameter "workflowId" was null or undefined when calling getWorkflow().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            let urlPath = `/v1/workflows/{workflow_id}`;
+            urlPath = urlPath.replace(`{${"workflow_id"}}`, encodeURIComponent(String(requestParameters['workflowId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WorkflowDetailResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Get single workflow detail with live Temporal status.
+     * Get Workflow Handler
+     */
+    getWorkflow(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getWorkflowRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * List all workflows for the current tenant (paginated, DB-backed).
+     * List Workflows Handler
+     */
+    listWorkflowsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/workflows`;
+            const response = yield this.request({
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseWorkflowSummaryResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * List all workflows for the current tenant (paginated, DB-backed).
+     * List Workflows Handler
+     */
+    listWorkflows() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.listWorkflowsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Cancel or rerun a workflow (OWNER/ADMIN only).
+     * Workflow Action Handler
+     */
+    workflowActionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['workflowId'] == null) {
+                throw new runtime.RequiredError('workflowId', 'Required parameter "workflowId" was null or undefined when calling workflowAction().');
+            }
+            if (requestParameters['action'] == null) {
+                throw new runtime.RequiredError('action', 'Required parameter "action" was null or undefined when calling workflowAction().');
+            }
+            const queryParameters = {};
+            if (requestParameters['action'] != null) {
+                queryParameters['action'] = requestParameters['action'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/workflows/{workflow_id}`;
+            urlPath = urlPath.replace(`{${"workflow_id"}}`, encodeURIComponent(String(requestParameters['workflowId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WorkflowActionResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Cancel or rerun a workflow (OWNER/ADMIN only).
+     * Workflow Action Handler
+     */
+    workflowAction(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.workflowActionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}
+exports.WorkflowsApi = WorkflowsApi;

package/dist/apis/index.d.ts

@@ -14,3 +14,4 @@ export * from './ThreadMessagesApi';
 export * from './ThreadsApi';
 export * from './UserPermissionsApi';
 export * from './UsersApi';
+export * from './WorkflowsApi';

package/dist/apis/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./ThreadMessagesApi"), exports);
 __exportStar(require("./ThreadsApi"), exports);
 __exportStar(require("./UserPermissionsApi"), exports);
 __exportStar(require("./UsersApi"), exports);
+__exportStar(require("./WorkflowsApi"), exports);

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, PaginatedResponseDocumentContentPathPart, PaginatedResponseDocumentVersionResponse } from '../models/index';
+import type { DocumentVersionMetadataUpdate, DocumentVersionResponse, PaginatedResponseDocumentContentPathPart, PaginatedResponseDocumentVersionResponse } from '../models/index';
 export interface CreateDocumentVersionRequest {
     documentId: string;
     ksUat?: string;
@@ -36,6 +36,11 @@ export interface ListDocumentVersionsRequest {
     offset?: number;
     ksUat?: string;
 }
+export interface UpdateDocumentVersionMetadataRequest {
+    versionId: string;
+    documentVersionMetadataUpdate: DocumentVersionMetadataUpdate;
+    ksUat?: string;
+}
 /**
  * DocumentVersionsApi - interface
  *
@@ -123,6 +128,22 @@ export interface DocumentVersionsApiInterface {
      * List Document Versions Handler
      */
     listDocumentVersions(requestParameters: ListDocumentVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentVersionResponse>;
+    /**
+     * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
+     * @summary Update Document Version Metadata Handler
+     * @param {string} versionId DocumentVersion ID
+     * @param {DocumentVersionMetadataUpdate} documentVersionMetadataUpdate
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    updateDocumentVersionMetadataRaw(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>>;
+    /**
+     * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
+     * Update Document Version Metadata Handler
+     */
+    updateDocumentVersionMetadata(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
 }
 /**
  *
@@ -178,4 +199,14 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      * List Document Versions Handler
      */
     listDocumentVersions(requestParameters: ListDocumentVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentVersionResponse>;
+    /**
+     * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
+     * Update Document Version Metadata Handler
+     */
+    updateDocumentVersionMetadataRaw(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>>;
+    /**
+     * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
+     * Update Document Version Metadata Handler
+     */
+    updateDocumentVersionMetadata(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
 }

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, PaginatedResponseDocumentContentPathPartFromJSON, PaginatedResponseDocumentVersionResponseFromJSON, } from '../models/index';
+import { DocumentVersionMetadataUpdateToJSON, DocumentVersionResponseFromJSON, PaginatedResponseDocumentContentPathPartFromJSON, PaginatedResponseDocumentVersionResponseFromJSON, } from '../models/index';
 /**
  *
  */
@@ -202,4 +202,41 @@ export class DocumentVersionsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
+     * Update Document Version Metadata Handler
+     */
+    updateDocumentVersionMetadataRaw(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 updateDocumentVersionMetadata().');
+            }
+            if (requestParameters['documentVersionMetadataUpdate'] == null) {
+                throw new runtime.RequiredError('documentVersionMetadataUpdate', 'Required parameter "documentVersionMetadataUpdate" was null or undefined when calling updateDocumentVersionMetadata().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            let urlPath = `/v1/document_versions/{version_id}/metadata`;
+            urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
+            const response = yield this.request({
+                path: urlPath,
+                method: 'PATCH',
+                headers: headerParameters,
+                query: queryParameters,
+                body: DocumentVersionMetadataUpdateToJSON(requestParameters['documentVersionMetadataUpdate']),
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => DocumentVersionResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
+     * Update Document Version Metadata Handler
+     */
+    updateDocumentVersionMetadata(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.updateDocumentVersionMetadataRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
 }

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateDocumentRequest, DocumentResponse, PaginatedResponseDocumentResponse, PathOrder, UpdateDocumentRequest } from '../models/index';
+import type { CreateDocumentRequest, DocumentResponse, IngestDocumentResponse, PaginatedResponseDocumentResponse, PathOrder, UpdateDocumentRequest } from '../models/index';
 export interface CreateDocumentOperationRequest {
     createDocumentRequest: CreateDocumentRequest;
     ksUat?: string;
@@ -23,8 +23,14 @@ export interface GetDocumentRequest {
     documentId: string;
     ksUat?: string;
 }
+export interface IngestDocumentRequest {
+    file: Blob;
+    folderId: string;
+    ksUat?: string;
+    name?: string;
+}
 export interface ListDocumentsRequest {
-    parentId?: string;
+    parentFolderId?: string;
     sortOrder?: PathOrder;
     limit?: number;
     offset?: number;
@@ -88,9 +94,26 @@ export interface DocumentsApiInterface {
      */
     getDocument(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
     /**
-     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_id is not provided, lists documents in the root folder.
+     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
+     * @summary Ingest Document Handler
+     * @param {Blob} file
+     * @param {string} folderId Parent folder ID
+     * @param {string} [ksUat]
+     * @param {string} [name] Document name (defaults to filename)
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DocumentsApiInterface
+     */
+    ingestDocumentRaw(requestParameters: IngestDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IngestDocumentResponse>>;
+    /**
+     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
+     * Ingest Document Handler
+     */
+    ingestDocument(requestParameters: IngestDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IngestDocumentResponse>;
+    /**
+     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_folder_id is not provided, lists documents in the root folder.
      * @summary List Documents Handler
-     * @param {string} [parentId] Parent folder PathPart ID (defaults to root)
+     * @param {string} [parentFolderId] Parent folder ID (defaults to root)
      * @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
@@ -101,12 +124,12 @@ export interface DocumentsApiInterface {
      */
     listDocumentsRaw(requestParameters: ListDocumentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentResponse>>;
     /**
-     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_id is not provided, lists documents in the root folder.
+     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_folder_id is not provided, lists documents in the root folder.
      * List Documents Handler
      */
     listDocuments(requestParameters: ListDocumentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentResponse>;
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_folder_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * @summary Update Document Handler
      * @param {string} documentId
      * @param {UpdateDocumentRequest} updateDocumentRequest
@@ -117,7 +140,7 @@ export interface DocumentsApiInterface {
      */
     updateDocumentRaw(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentResponse>>;
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_folder_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * Update Document Handler
      */
     updateDocument(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
@@ -157,22 +180,32 @@ export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsAp
      */
     getDocument(requestParameters: GetDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
     /**
-     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_id is not provided, lists documents in the root folder.
+     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
+     * Ingest Document Handler
+     */
+    ingestDocumentRaw(requestParameters: IngestDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<IngestDocumentResponse>>;
+    /**
+     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
+     * Ingest Document Handler
+     */
+    ingestDocument(requestParameters: IngestDocumentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<IngestDocumentResponse>;
+    /**
+     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_folder_id is not provided, lists documents in the root folder.
      * List Documents Handler
      */
     listDocumentsRaw(requestParameters: ListDocumentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentResponse>>;
     /**
-     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_id is not provided, lists documents in the root folder.
+     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_folder_id is not provided, lists documents in the root folder.
      * List Documents Handler
      */
     listDocuments(requestParameters?: ListDocumentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentResponse>;
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_folder_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * Update Document Handler
      */
     updateDocumentRaw(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentResponse>>;
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_folder_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * Update Document Handler
      */
     updateDocument(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;

package/dist/esm/apis/DocumentsApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { CreateDocumentRequestToJSON, DocumentResponseFromJSON, PaginatedResponseDocumentResponseFromJSON, UpdateDocumentRequestToJSON, } from '../models/index';
+import { CreateDocumentRequestToJSON, DocumentResponseFromJSON, IngestDocumentResponseFromJSON, PaginatedResponseDocumentResponseFromJSON, UpdateDocumentRequestToJSON, } from '../models/index';
 /**
  *
  */
@@ -123,14 +123,73 @@ export class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_id is not provided, lists documents in the root folder.
+     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
+     * Ingest Document Handler
+     */
+    ingestDocumentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['file'] == null) {
+                throw new runtime.RequiredError('file', 'Required parameter "file" was null or undefined when calling ingestDocument().');
+            }
+            if (requestParameters['folderId'] == null) {
+                throw new runtime.RequiredError('folderId', 'Required parameter "folderId" was null or undefined when calling ingestDocument().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            const consumes = [
+                { contentType: 'multipart/form-data' },
+            ];
+            // @ts-ignore: canConsumeForm may be unused
+            const canConsumeForm = runtime.canConsumeForm(consumes);
+            let formParams;
+            let useForm = false;
+            // use FormData to transmit files using content-type "multipart/form-data"
+            useForm = canConsumeForm;
+            if (useForm) {
+                formParams = new FormData();
+            }
+            else {
+                formParams = new URLSearchParams();
+            }
+            if (requestParameters['file'] != null) {
+                formParams.append('file', requestParameters['file']);
+            }
+            if (requestParameters['folderId'] != null) {
+                formParams.append('folder_id', requestParameters['folderId']);
+            }
+            if (requestParameters['name'] != null) {
+                formParams.append('name', requestParameters['name']);
+            }
+            let urlPath = `/v1/documents/ingest`;
+            const response = yield this.request({
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: formParams,
+            }, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => IngestDocumentResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Upload a file, create document + version, and trigger ingestion workflow.  Returns 201 with the Temporal workflow ID.  Design decision — S3 upload happens *before* the DB write: We pre-generate document and version UUIDs, upload the source file to S3, and only then persist the DB records. If the DB write fails, an orphaned S3 object is left behind (acceptable storage cost cleaned up by the S3 deletion cronjob). The reverse — a committed DB record pointing to a missing S3 object — would crash downstream pipeline activities that expect the file to exist.
+     * Ingest Document Handler
+     */
+    ingestDocument(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.ingestDocumentRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_folder_id is not provided, lists documents in the root folder.
      * List Documents Handler
      */
     listDocumentsRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
-            if (requestParameters['parentId'] != null) {
-                queryParameters['parent_id'] = requestParameters['parentId'];
+            if (requestParameters['parentFolderId'] != null) {
+                queryParameters['parent_folder_id'] = requestParameters['parentFolderId'];
             }
             if (requestParameters['sortOrder'] != null) {
                 queryParameters['sort_order'] = requestParameters['sortOrder'];
@@ -153,7 +212,7 @@ export class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_id is not provided, lists documents in the root folder.
+     * List documents in a folder.  Returns only direct child documents (depth=1) of the specified parent folder. If parent_folder_id is not provided, lists documents in the root folder.
      * List Documents Handler
      */
     listDocuments() {
@@ -163,7 +222,7 @@ export class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_folder_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * Update Document Handler
      */
     updateDocumentRaw(requestParameters, initOverrides) {
@@ -190,7 +249,7 @@ export class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_folder_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
      * Update Document Handler
      */
     updateDocument(requestParameters, initOverrides) {