@epilot/sdk 2.14.4 → 2.14.5

package/dist/{file.d-BN417xok.d.ts → file.d-zFneCEyY.d.ts}

@@ -2445,6 +2445,12 @@ declare namespace Components {
              * 1.2 MB
              */
             readable_size?: string;
+            /**
+             * Content hash (S3 ETag) of the latest file version. For single-part uploads this is the hex MD5 of the content and is stable across orgs, so identical content yields an identical etag. Used to detect real content changes without re-downloading the bytes.
+             * example:
+             * 9bb58f26192e4ba00f01e2e7b136bbd8
+             */
+            etag?: string;
             access_control?: "private" | "public-read";
             /**
              * Direct URL for file (public only if file access control is public-read)
@@ -2666,6 +2672,12 @@ declare namespace Components {
              * 1.2 MB
              */
             readable_size?: string;
+            /**
+             * Content hash (S3 ETag) of the latest file version. For single-part uploads this is the hex MD5 of the content and is stable across orgs, so identical content yields an identical etag. Used to detect real content changes without re-downloading the bytes.
+             * example:
+             * 9bb58f26192e4ba00f01e2e7b136bbd8
+             */
+            etag?: string;
             access_control: "private" | "public-read";
             /**
              * Direct URL for file (public only if file access control is public-read)
@@ -2757,6 +2769,12 @@ declare namespace Components {
              * image/jpeg
              */
             mime_type?: string;
+            /**
+             * Content hash (S3 ETag) of this file version
+             * example:
+             * 9bb58f26192e4ba00f01e2e7b136bbd8
+             */
+            etag?: string;
         }
         export interface FileRelationItem {
             entity_id: /**
@@ -2818,6 +2836,37 @@ declare namespace Components {
          * Current state of a file summary job.
          */
         export type FileSummaryJobStatus = "queued" | "waiting_for_extraction" | "processing" | "completed" | "failed" | "unsupported" | "stale";
+        export type FileText = {
+            status: /* Availability of the plain-text representation for a file entity. */ FileTextStatus;
+            text?: string;
+            truncated?: boolean;
+            total_chars?: number;
+        } & (FileTextReady | FileTextNotReady | FileTextUnsupported);
+        export interface FileTextNotReady {
+            status: "not_ready";
+        }
+        export interface FileTextReady {
+            status: "ready";
+            /**
+             * Plain-text representation, trimmed and truncated to a server-side limit of 50000 characters.
+             */
+            text: string;
+            /**
+             * True when the returned text was cut off by the character limit.
+             */
+            truncated: boolean;
+            /**
+             * Length of the full text before truncation.
+             */
+            total_chars: number;
+        }
+        /**
+         * Availability of the plain-text representation for a file entity.
+         */
+        export type FileTextStatus = "ready" | "not_ready" | "unsupported";
+        export interface FileTextUnsupported {
+            status: "unsupported";
+        }
         export type FileType = "document" | "document_template" | "text" | "image" | "video" | "audio" | "spreadsheet" | "presentation" | "font" | "archive" | "application" | "unknown";
         export interface FileUpload {
             s3ref?: S3Reference;
@@ -2929,6 +2978,12 @@ declare namespace Components {
              * 1.2 MB
              */
             readable_size?: string;
+            /**
+             * Content hash (S3 ETag) of the latest file version. For single-part uploads this is the hex MD5 of the content and is stable across orgs, so identical content yields an identical etag. Used to detect real content changes without re-downloading the bytes.
+             * example:
+             * 9bb58f26192e4ba00f01e2e7b136bbd8
+             */
+            etag?: string;
             access_control?: "private" | "public-read";
             /**
              * Direct URL for file (public only if file access control is public-read)
@@ -3030,6 +3085,12 @@ declare namespace Components {
              * 1.2 MB
              */
             readable_size?: string;
+            /**
+             * Content hash (S3 ETag) of the latest file version. For single-part uploads this is the hex MD5 of the content and is stable across orgs, so identical content yields an identical etag. Used to detect real content changes without re-downloading the bytes.
+             * example:
+             * 9bb58f26192e4ba00f01e2e7b136bbd8
+             */
+            etag?: string;
             access_control?: "private" | "public-read";
             /**
              * Direct URL for file (public only if file access control is public-read)
@@ -3139,6 +3200,12 @@ declare namespace Components {
              * 1.2 MB
              */
             readable_size?: string;
+            /**
+             * Content hash (S3 ETag) of the latest file version. For single-part uploads this is the hex MD5 of the content and is stable across orgs, so identical content yields an identical etag. Used to detect real content changes without re-downloading the bytes.
+             * example:
+             * 9bb58f26192e4ba00f01e2e7b136bbd8
+             */
+            etag?: string;
             access_control?: "private" | "public-read";
             /**
              * Direct URL for file (public only if file access control is public-read)
@@ -3741,6 +3808,15 @@ declare namespace Paths {
              * }
              */
             Components.Responses.UnauthorizedError;
+            export type $403 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 403,
+             *   "error": "Forbidden: You do not have permission to access this file"
+             * }
+             */
+            Components.Responses.ForbiddenError;
             export type $404 = /**
              * A generic error returned by the API
              * example:
@@ -4119,6 +4195,66 @@ declare namespace Paths {
             Components.Responses.InternalServerError;
         }
     }
+    namespace GetFileText {
+        namespace Parameters {
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.FileEntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.FileText;
+            export type $400 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 400,
+             *   "error": "Bad Request: filename is required"
+             * }
+             */
+            Components.Responses.BadRequestError;
+            export type $401 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 401,
+             *   "error": "Unauthorized: Invalid or expired token"
+             * }
+             */
+            Components.Responses.UnauthorizedError;
+            export type $403 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 403,
+             *   "error": "Forbidden: You do not have permission to access this file"
+             * }
+             */
+            Components.Responses.ForbiddenError;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found: File entity not found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+            export type $500 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 500,
+             *   "error": "Internal Server Error"
+             * }
+             */
+            Components.Responses.InternalServerError;
+        }
+    }
     namespace GetFilesInCollection {
         namespace Parameters {
             export type CollectionSlug = string;
@@ -4354,6 +4490,10 @@ declare namespace Paths {
         }
         namespace Responses {
             export type $200 = string; // binary
+            export interface $204 {
+            }
+            export interface $302 {
+            }
             export interface $304 {
             }
             export type $403 = /* A generic error returned by the API */ Components.Schemas.ErrorObject;
@@ -5075,6 +5215,16 @@ interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.GenerateFileSummary.Responses.$202>
+  /**
+   * getFileText - getFileText
+   * 
+   * Get the plain-text representation of a file entity. Returns status `not_ready` while text is being prepared and `unsupported` when text is unavailable for the file or organization.
+   */
+  'getFileText'(
+    parameters?: Parameters<Paths.GetFileText.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetFileText.Responses.$200>
   /**
    * previewFile - previewFile
    * 
@@ -5129,7 +5279,7 @@ interface OperationMethods {
     parameters?: Parameters<Paths.PreviewPublicFile.QueryParameters & Paths.PreviewPublicFile.PathParameters> | null,
     data?: any,
     config?: AxiosRequestConfig  
-  ): OperationResponse<Paths.PreviewPublicFile.Responses.$200>
+  ): OperationResponse<Paths.PreviewPublicFile.Responses.$200 | Paths.PreviewPublicFile.Responses.$204>
   /**
    * getSession - getSession
    * 
@@ -5586,6 +5736,18 @@ interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.GenerateFileSummary.Responses.$202>
   }
+  ['/v1/files/{id}/text']: {
+    /**
+     * getFileText - getFileText
+     * 
+     * Get the plain-text representation of a file entity. Returns status `not_ready` while text is being prepared and `unsupported` when text is unavailable for the file or organization.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetFileText.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetFileText.Responses.$200>
+  }
   ['/v1/files/{id}/preview']: {
     /**
      * previewFile - previewFile
@@ -5645,7 +5807,7 @@ interface PathsDictionary {
       parameters?: Parameters<Paths.PreviewPublicFile.QueryParameters & Paths.PreviewPublicFile.PathParameters> | null,
       data?: any,
       config?: AxiosRequestConfig  
-    ): OperationResponse<Paths.PreviewPublicFile.Responses.$200>
+    ): OperationResponse<Paths.PreviewPublicFile.Responses.$200 | Paths.PreviewPublicFile.Responses.$204>
   }
   ['/v1/files/session']: {
     /**
@@ -5898,6 +6060,11 @@ type FileRelationItem = Components.Schemas.FileRelationItem;
 type FileSummary = Components.Schemas.FileSummary;
 type FileSummaryJob = Components.Schemas.FileSummaryJob;
 type FileSummaryJobStatus = Components.Schemas.FileSummaryJobStatus;
+type FileText = Components.Schemas.FileText;
+type FileTextNotReady = Components.Schemas.FileTextNotReady;
+type FileTextReady = Components.Schemas.FileTextReady;
+type FileTextStatus = Components.Schemas.FileTextStatus;
+type FileTextUnsupported = Components.Schemas.FileTextUnsupported;
 type FileType = Components.Schemas.FileType;
 type FileUpload = Components.Schemas.FileUpload;
 type PublicLink = Components.Schemas.PublicLink;
@@ -5912,4 +6079,4 @@ type UploadFilePayload = Components.Schemas.UploadFilePayload;
 type VerifyCustomDownloadUrlPayload = Components.Schemas.VerifyCustomDownloadUrlPayload;
 type ZipJob = Components.Schemas.ZipJob;
 
-export { type ActivityId as A, type BaseEntityAcl as B, type Client as C, type DownloadFilesPayload as D, type EntityId as E, type FileAttributes as F, type SaveFileFromSourceURLPayload as G, type SaveFilePayload as H, type SaveFilePayloadV2 as I, type SaveS3FilePayload as J, type OperationMethods as O, Paths as P, type S3Ref as S, type UploadFilePayload as U, type VerifyCustomDownloadUrlPayload as V, type ZipJob as Z, Components as a, type PathsDictionary as b, type BaseEntityOwner as c, type BatchSaveFileVersionPayload as d, type CommonSaveFilePayload as e, type CreateZipJobPayload as f, type CustomDownloadUrl as g, type CustomDownloadUrlAuth as h, type EntitySlug as i, type ErrorObject as j, type FileCollectionAttributes as k, type FileCollectionCreateRequest as l, type FileCollectionId as m, type FileCollectionItem as n, type FileEntity as o, type FileEntityId as p, type FileItem as q, type FileRelationItem as r, type FileSummary as s, type FileSummaryJob as t, type FileSummaryJobStatus as u, type FileType as v, type FileUpload as w, type PublicLink as x, type S3Reference as y, type SaveCustomFilePayload as z };
+export { type ActivityId as A, type BaseEntityAcl as B, type Client as C, type DownloadFilesPayload as D, type EntityId as E, type FileAttributes as F, type FileType as G, type FileUpload as H, type PublicLink as I, type S3Reference as J, type SaveCustomFilePayload as K, type SaveFileFromSourceURLPayload as L, type SaveFilePayload as M, type SaveFilePayloadV2 as N, type OperationMethods as O, Paths as P, type SaveS3FilePayload as Q, type S3Ref as S, type UploadFilePayload as U, type VerifyCustomDownloadUrlPayload as V, type ZipJob as Z, Components as a, type PathsDictionary as b, type BaseEntityOwner as c, type BatchSaveFileVersionPayload as d, type CommonSaveFilePayload as e, type CreateZipJobPayload as f, type CustomDownloadUrl as g, type CustomDownloadUrlAuth as h, type EntitySlug as i, type ErrorObject as j, type FileCollectionAttributes as k, type FileCollectionCreateRequest as l, type FileCollectionId as m, type FileCollectionItem as n, type FileEntity as o, type FileEntityId as p, type FileItem as q, type FileRelationItem as r, type FileSummary as s, type FileSummaryJob as t, type FileSummaryJobStatus as u, type FileText as v, type FileTextNotReady as w, type FileTextReady as x, type FileTextStatus as y, type FileTextUnsupported as z };

package/dist/index.cjs

@@ -63,7 +63,7 @@ var _chunkWQBBB6BNcjs = require('./chunk-WQBBB6BN.cjs');
 var _chunkFDS727SLcjs = require('./chunk-FDS727SL.cjs');
 
 
-var _chunkLNLUCLPLcjs = require('./chunk-LNLUCLPL.cjs');
+var _chunk3SZOSNO2cjs = require('./chunk-3SZOSNO2.cjs');
 
 
 var _chunkYO4M3BZLcjs = require('./chunk-YO4M3BZL.cjs');
@@ -158,7 +158,7 @@ var _chunkDVM27A7Ecjs = require('./chunk-DVM27A7E.cjs');
 
 
 
-var _chunkOIHW7ECMcjs = require('./chunk-OIHW7ECM.cjs');
+var _chunkCD4J6HXVcjs = require('./chunk-CD4J6HXV.cjs');
 
 
 var _chunkNJK5F5TFcjs = require('./chunk-NJK5F5TF.cjs');
@@ -225,7 +225,7 @@ var resolveClient = (params) => {
   }
   if (!entry.instance) {
     const definition = entry.loader();
-    entry.instance = _chunkOIHW7ECMcjs.createApiClient.call(void 0, {
+    entry.instance = _chunkCD4J6HXVcjs.createApiClient.call(void 0, {
       definition,
       token: state.token,
       headers: state.globalHeaders,
@@ -258,7 +258,7 @@ var resetAllClients = (registry) => {
 };
 
 // src/apis/_registry.ts
-var expandDef = (mod) => _chunkOIHW7ECMcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
+var expandDef = (mod) => _chunkCD4J6HXVcjs.expand.call(void 0, _nullishCoalesce(mod.default, () => ( mod)));
 var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
@@ -383,7 +383,7 @@ var registerBuiltinApis = (registry) => {
   registerApi({
     registry,
     name: "file",
-    loader: () => expandDef(_chunkLNLUCLPLcjs.require_file_runtime.call(void 0, ))
+    loader: () => expandDef(_chunk3SZOSNO2cjs.require_file_runtime.call(void 0, ))
   });
   registerApi({
     registry,
@@ -601,9 +601,9 @@ var createSDK = () => {
       const available = [...registry.keys()].join(", ");
       throw new Error(`Unknown API: "${name}". Available: ${available}`);
     }
-    return _chunkOIHW7ECMcjs.createApiHandle.call(void 0, {
+    return _chunkCD4J6HXVcjs.createApiHandle.call(void 0, {
       resolveClient: () => resolveClient({ registry, name, state }),
-      createClient: () => _chunkOIHW7ECMcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
+      createClient: () => _chunkCD4J6HXVcjs.createApiClient.call(void 0, { definition: entry.loader(), apiName: name }),
       apiName: name
     });
   };
@@ -651,9 +651,9 @@ var createSDK = () => {
           return interceptorUse;
         }
         case "help":
-          return (apiName) => _chunkOIHW7ECMcjs.help.call(void 0, apiName);
+          return (apiName) => _chunkCD4J6HXVcjs.help.call(void 0, apiName);
         case "openapi":
-          return (apiName) => _chunkOIHW7ECMcjs.openapi.call(void 0, apiName);
+          return (apiName) => _chunkCD4J6HXVcjs.openapi.call(void 0, apiName);
         case "then":
         case "catch":
         case "finally":
@@ -683,4 +683,4 @@ var epilot = createSDK();
 
 
 
-exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkOIHW7ECMcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkOIHW7ECMcjs.help; exports.openapi = _chunkOIHW7ECMcjs.openapi;
+exports.applyLargeResponseInterceptor = applyLargeResponseInterceptor; exports.applyRetryInterceptor = applyRetryInterceptor; exports.authorize = _chunkCD4J6HXVcjs.authorize; exports.createSDK = createSDK; exports.epilot = epilot; exports.help = _chunkCD4J6HXVcjs.help; exports.openapi = _chunkCD4J6HXVcjs.openapi;

package/dist/index.d.cts

@@ -27,7 +27,7 @@ import { C as Client$k } from './entity.d-fospShiN.cjs';
 import { C as Client$l } from './entity-mapping.d-DKSW3sfy.cjs';
 import { C as Client$m } from './environments.d-BvqvN-PD.cjs';
 import { C as Client$n } from './event-catalog.d-QIhhewVH.cjs';
-import { C as Client$o } from './file.d-BN417xok.cjs';
+import { C as Client$o } from './file.d-zFneCEyY.cjs';
 import { C as Client$p } from './iban.d-BwdiGbxi.cjs';
 import { C as Client$q } from './integration-toolkit.d-7q19qDTD.cjs';
 import { C as Client$r } from './journey.d-B1sOeMHw.cjs';

package/dist/index.d.ts

@@ -27,7 +27,7 @@ import { C as Client$k } from './entity.d-fospShiN.js';
 import { C as Client$l } from './entity-mapping.d-DKSW3sfy.js';
 import { C as Client$m } from './environments.d-BvqvN-PD.js';
 import { C as Client$n } from './event-catalog.d-QIhhewVH.js';
-import { C as Client$o } from './file.d-BN417xok.js';
+import { C as Client$o } from './file.d-zFneCEyY.js';
 import { C as Client$p } from './iban.d-BwdiGbxi.js';
 import { C as Client$q } from './integration-toolkit.d-7q19qDTD.js';
 import { C as Client$r } from './journey.d-B1sOeMHw.js';

package/dist/index.js

@@ -63,7 +63,7 @@ import {
 } from "./chunk-M4FO2MI4.js";
 import {
   require_file_runtime
-} from "./chunk-G5KVG3RU.js";
+} from "./chunk-G7IFFKKJ.js";
 import {
   require_iban_runtime
 } from "./chunk-5MFHAXBT.js";
@@ -158,7 +158,7 @@ import {
   expand,
   help,
   openapi
-} from "./chunk-YUA47URH.js";
+} from "./chunk-62BXSTL6.js";
 import {
   __require
 } from "./chunk-YPSWSI3M.js";

package/docs/file.md

@@ -39,6 +39,7 @@ const { data } = await fileClient.uploadFileV2(...)
 - [`getCurrentFileSummaryJob`](#getcurrentfilesummaryjob)
 - [`getFileSummaryJob`](#getfilesummaryjob)
 - [`generateFileSummary`](#generatefilesummary)
+- [`getFileText`](#getfiletext)
 - [`verifyCustomDownloadUrl`](#verifycustomdownloadurl)
 - [`uploadFilePublic`](#uploadfilepublic)
 
@@ -76,6 +77,11 @@ const { data } = await fileClient.uploadFileV2(...)
 - [`FileSummaryJobStatus`](#filesummaryjobstatus)
 - [`FileSummaryJob`](#filesummaryjob)
 - [`FileSummary`](#filesummary)
+- [`FileTextStatus`](#filetextstatus)
+- [`FileText`](#filetext)
+- [`FileTextReady`](#filetextready)
+- [`FileTextNotReady`](#filetextnotready)
+- [`FileTextUnsupported`](#filetextunsupported)
 - [`CustomDownloadUrl`](#customdownloadurl)
 - [`CustomDownloadUrlAuth`](#customdownloadurlauth)
 - [`FileEntity`](#fileentity)
@@ -179,6 +185,7 @@ const { data } = await client.saveFileV2(
     mime_type: 'application/pdf',
     size_bytes: 1234,
     readable_size: '1.2 MB',
+    etag: '9bb58f26192e4ba00f01e2e7b136bbd8',
     access_control: 'private',
     public_url: 'https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf',
     custom_download_url: 'https://some-api-url.com/download?file_id=123',
@@ -209,6 +216,7 @@ const { data } = await client.saveFileV2(
   "mime_type": "application/pdf",
   "size_bytes": 1234,
   "readable_size": "1.2 MB",
+  "etag": "9bb58f26192e4ba00f01e2e7b136bbd8",
   "access_control": "private",
   "public_url": "https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf",
   "custom_download_url": "https://some-api-url.com/download?file_id=123",
@@ -225,7 +233,8 @@ const { data } = await client.saveFileV2(
       "filename": "document.pdf",
       "size_bytes": 1234,
       "readable_size": "1.2 MB",
-      "mime_type": "image/jpeg"
+      "mime_type": "image/jpeg",
+      "etag": "9bb58f26192e4ba00f01e2e7b136bbd8"
     }
   ],
   "_updated_at": "1970-01-01T00:00:00.000Z",
@@ -281,6 +290,7 @@ const { data } = await client.getFile({
   "mime_type": "application/pdf",
   "size_bytes": 1234,
   "readable_size": "1.2 MB",
+  "etag": "9bb58f26192e4ba00f01e2e7b136bbd8",
   "access_control": "private",
   "public_url": "https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf",
   "custom_download_url": "https://some-api-url.com/download?file_id=123",
@@ -297,7 +307,8 @@ const { data } = await client.getFile({
       "filename": "document.pdf",
       "size_bytes": 1234,
       "readable_size": "1.2 MB",
-      "mime_type": "image/jpeg"
+      "mime_type": "image/jpeg",
+      "etag": "9bb58f26192e4ba00f01e2e7b136bbd8"
     }
   ],
   "_updated_at": "1970-01-01T00:00:00.000Z",
@@ -353,6 +364,7 @@ const { data } = await client.deleteFile({
   "mime_type": "application/pdf",
   "size_bytes": 1234,
   "readable_size": "1.2 MB",
+  "etag": "9bb58f26192e4ba00f01e2e7b136bbd8",
   "access_control": "private",
   "public_url": "https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf",
   "custom_download_url": "https://some-api-url.com/download?file_id=123",
@@ -369,7 +381,8 @@ const { data } = await client.deleteFile({
       "filename": "document.pdf",
       "size_bytes": 1234,
       "readable_size": "1.2 MB",
-      "mime_type": "image/jpeg"
+      "mime_type": "image/jpeg",
+      "etag": "9bb58f26192e4ba00f01e2e7b136bbd8"
     }
   ],
   "_updated_at": "1970-01-01T00:00:00.000Z",
@@ -659,6 +672,34 @@ const { data } = await client.generateFileSummary({
 
 ---
 
+### `getFileText`
+
+Get the plain-text representation of a file entity. Returns status `not_ready` while text is being prepared and `unsupported` when text is unavailable for the file or organization.
+
+`GET /v1/files/{id}/text`
+
+```ts
+const { data } = await client.getFileText({
+  id: '123e4567-e89b-12d3-a456-426614174000',
+})
+```
+
+<details>
+<summary>Response</summary>
+
+```json
+{
+  "status": "ready",
+  "text": "string",
+  "truncated": true,
+  "total_chars": 0
+}
+```
+
+</details>
+
+---
+
 ### `previewFile`
 
 Generate a thumbnail preview for a file entity.
@@ -1072,6 +1113,7 @@ const { data } = await client.getFilesInCollection({
     "mime_type": "application/pdf",
     "size_bytes": 1234,
     "readable_size": "1.2 MB",
+    "etag": "9bb58f26192e4ba00f01e2e7b136bbd8",
     "access_control": "private",
     "public_url": "https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf",
     "custom_download_url": "https://some-api-url.com/download?file_id=123",
@@ -1088,7 +1130,8 @@ const { data } = await client.getFilesInCollection({
         "filename": "document.pdf",
         "size_bytes": 1234,
         "readable_size": "1.2 MB",
-        "mime_type": "image/jpeg"
+        "mime_type": "image/jpeg",
+        "etag": "9bb58f26192e4ba00f01e2e7b136bbd8"
       }
     ],
     "_updated_at": "1970-01-01T00:00:00.000Z",
@@ -1191,6 +1234,7 @@ type FileAttributes = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1243,6 +1287,56 @@ type FileSummary = {
 }
 ```
 
+### `FileTextStatus`
+
+Availability of the plain-text representation for a file entity.
+
+```ts
+type FileTextStatus = "ready" | "not_ready" | "unsupported"
+```
+
+### `FileText`
+
+```ts
+type FileText = {
+  status: "ready"
+  text: string
+  truncated: boolean
+  total_chars: number
+} | {
+  status: "not_ready"
+} | {
+  status: "unsupported"
+}
+```
+
+### `FileTextReady`
+
+```ts
+type FileTextReady = {
+  status: "ready"
+  text: string
+  truncated: boolean
+  total_chars: number
+}
+```
+
+### `FileTextNotReady`
+
+```ts
+type FileTextNotReady = {
+  status: "not_ready"
+}
+```
+
+### `FileTextUnsupported`
+
+```ts
+type FileTextUnsupported = {
+  status: "unsupported"
+}
+```
+
 ### `CustomDownloadUrl`
 
 Custom external download url used for the file
@@ -1275,6 +1369,7 @@ type FileEntity = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1291,6 +1386,7 @@ type FileEntity = {
     size_bytes?: number
     readable_size?: string
     mime_type?: string
+    etag?: string
   }>
   _updated_at?: string // date-time
   _created_at?: string // date-time
@@ -1340,6 +1436,7 @@ type SaveS3FilePayload = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1371,6 +1468,7 @@ type SaveFileFromSourceURLPayload = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1402,6 +1500,7 @@ type SaveCustomFilePayload = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1432,6 +1531,7 @@ type SaveFilePayload = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1457,6 +1557,7 @@ type SaveFilePayload = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1482,6 +1583,7 @@ type SaveFilePayload = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1512,6 +1614,7 @@ type SaveFilePayloadV2 = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1537,6 +1640,7 @@ type SaveFilePayloadV2 = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1562,6 +1666,7 @@ type SaveFilePayloadV2 = {
   mime_type?: string
   size_bytes?: number
   readable_size?: string
+  etag?: string
   access_control?: "private" | "public-read"
   public_url?: string // url
   custom_download_url?: string // uri
@@ -1691,6 +1796,7 @@ type FileItem = {
   size_bytes?: number
   readable_size?: string
   mime_type?: string
+  etag?: string
 }
 ```