@epilot/file-client 1.15.1 → 1.16.0-alpha.0

package/dist/definition.js

@@ -1 +1 @@
-(()=>{"use strict";var e={390:function(e,r,i){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var t=n(i(466));r.default=t.default},466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"paths":{"/v2/files/upload":{"post":{"operationId":"uploadFileV2","parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files":{"post":{"operationId":"saveFileV2","parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/FillActivityQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/upload":{"post":{"operationId":"uploadFile","deprecated":true,"parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files":{"post":{"operationId":"saveFile","deprecated":true,"parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files/{id}":{"get":{"operationId":"getFile","parameters":[{"name":"id","in":"path","required":true},{"name":"source_url","in":"query"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"}],"responses":{}},"delete":{"operationId":"deleteFile","parameters":[{"name":"id","in":"path","required":true},{"name":"purge","in":"query"},{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"}],"responses":{}}},"/v1/files/{id}/download":{"get":{"operationId":"downloadFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadS3":{"post":{"operationId":"downloadS3File","parameters":[{"name":"s3_key","in":"query","required":true},{"name":"s3_bucket","in":"query","required":true},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadFiles":{"post":{"operationId":"downloadFiles","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/{id}/preview":{"get":{"operationId":"previewFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files:previewS3":{"post":{"operationId":"previewS3File","parameters":[{"name":"w","in":"query"},{"name":"h","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}},"get":{"operationId":"previewS3FileGet","parameters":[{"name":"key","in":"query","required":true},{"name":"bucket","in":"query","required":true},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files/public/{id}/preview":{"get":{"operationId":"previewPublicFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"},{"name":"org_id","in":"query"}],"responses":{}}},"/v1/files/session":{"get":{"operationId":"getSession","responses":{}},"delete":{"operationId":"deleteSession","responses":{}}},"/v1/files/{id}/public/links":{"post":{"operationId":"generatePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}},"get":{"operationId":"listPublicLinksForFile","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/public/links/{id}/{filename}":{"get":{"operationId":"accessPublicLink","parameters":[{"name":"id","in":"path","required":true},{"name":"filename","in":"path","required":true},{"name":"hash","in":"query","required":false}],"responses":{}}},"/v1/files/public/links/{id}":{"delete":{"operationId":"revokePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/download:verify":{"post":{"operationId":"verifyCustomDownloadUrl","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/public/upload":{"post":{"operationId":"uploadFilePublic","requestBody":{"content":{"application/json":{}}},"responses":{}}}},"components":{"parameters":{"StrictQueryParam":{"name":"strict","in":"query","required":false},"ActivityIdQueryParam":{"name":"activity_id","in":"query","required":false},"FillActivityQueryParam":{"name":"fill_activity","in":"query","required":false},"AsyncOperationQueryParam":{"name":"async","in":"query","required":false}}},"servers":[{"url":"https://file.sls.epilot.io"}]}')}},r={},i=function i(n){var t=r[n];if(void 0!==t)return t.exports;var a=r[n]={exports:{}};return e[n].call(a.exports,a,a.exports,i),a.exports}(390),n=exports;for(var t in i)n[t]=i[t];i.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();
+(()=>{"use strict";var e={466:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"paths":{"/v2/files/upload":{"post":{"operationId":"uploadFileV2","parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files":{"post":{"operationId":"saveFileV2","parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/FillActivityQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"},{"$ref":"#/components/parameters/DeleteTempFileQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/upload":{"post":{"operationId":"uploadFile","deprecated":true,"parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files":{"post":{"operationId":"saveFile","deprecated":true,"parameters":[{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"}],"requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v2/files/{id}":{"get":{"operationId":"getFile","parameters":[{"name":"id","in":"path","required":true},{"name":"source_url","in":"query"},{"$ref":"#/components/parameters/StrictQueryParam"},{"$ref":"#/components/parameters/AsyncOperationQueryParam"}],"responses":{}},"delete":{"operationId":"deleteFile","parameters":[{"name":"id","in":"path","required":true},{"name":"purge","in":"query"},{"$ref":"#/components/parameters/ActivityIdQueryParam"},{"$ref":"#/components/parameters/StrictQueryParam"}],"responses":{}}},"/v1/files/{id}/download":{"get":{"operationId":"downloadFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadS3":{"post":{"operationId":"downloadS3File","parameters":[{"name":"s3_key","in":"query","required":true},{"name":"s3_bucket","in":"query","required":true},{"name":"attachment","in":"query"}],"responses":{}}},"/v1/files:downloadFiles":{"post":{"operationId":"downloadFiles","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/{id}/preview":{"get":{"operationId":"previewFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files:previewS3":{"post":{"operationId":"previewS3File","parameters":[{"name":"w","in":"query"},{"name":"h","in":"query"}],"requestBody":{"content":{"application/json":{}}},"responses":{}},"get":{"operationId":"previewS3FileGet","parameters":[{"name":"key","in":"query","required":true},{"name":"bucket","in":"query","required":true},{"name":"w","in":"query"},{"name":"h","in":"query"}],"responses":{}}},"/v1/files/public/{id}/preview":{"get":{"operationId":"previewPublicFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"w","in":"query"},{"name":"h","in":"query"},{"name":"org_id","in":"query"}],"responses":{}}},"/v1/files/session":{"get":{"operationId":"getSession","responses":{}},"delete":{"operationId":"deleteSession","responses":{}}},"/v1/files/{id}/public/links":{"post":{"operationId":"generatePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}},"get":{"operationId":"listPublicLinksForFile","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/public/links/{id}/{filename}":{"get":{"operationId":"accessPublicLink","parameters":[{"name":"id","in":"path","required":true},{"name":"filename","in":"path","required":true},{"name":"hash","in":"query","required":false}],"responses":{}}},"/v1/files/public/links/{id}":{"delete":{"operationId":"revokePublicLink","parameters":[{"name":"id","in":"path","required":true}],"responses":{}}},"/v1/files/download:verify":{"post":{"operationId":"verifyCustomDownloadUrl","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/files/public/upload":{"post":{"operationId":"uploadFilePublic","requestBody":{"content":{"application/json":{}}},"responses":{}}},"/v1/entity/{id}/folders":{"get":{"operationId":"getFileFolders","parameters":[{"$ref":"#/components/parameters/EntityIdPathParam"},{"name":"parents","in":"query","required":false,"style":"form","explode":true}],"responses":{}},"post":{"operationId":"createFileFolder","parameters":[{"$ref":"#/components/parameters/EntityIdPathParam"}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}}},"/v1/entity/{id}/folders/{folderSlug}":{"put":{"operationId":"updateFileFolder","parameters":[{"$ref":"#/components/parameters/EntityIdPathParam"},{"name":"folderSlug","in":"path","required":true}],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{}},"delete":{"operationId":"deleteFileFolder","parameters":[{"$ref":"#/components/parameters/EntityIdPathParam"},{"name":"folderSlug","in":"path","required":true}],"responses":{}}},"/v1/entity/{id}/folders/{folderSlug}/files":{"get":{"operationId":"getFilesInFolder","parameters":[{"$ref":"#/components/parameters/EntityIdPathParam"},{"name":"folderSlug","in":"path","required":true}],"responses":{}}}},"components":{"parameters":{"EntityIdPathParam":{"name":"id","in":"path","required":true},"StrictQueryParam":{"name":"strict","in":"query","required":false},"ActivityIdQueryParam":{"name":"activity_id","in":"query","required":false},"FillActivityQueryParam":{"name":"fill_activity","in":"query","required":false},"AsyncOperationQueryParam":{"name":"async","in":"query","required":false},"DeleteTempFileQueryParam":{"name":"delete_temp_file","in":"query","required":false}},"responses":{"NotFoundError":{"content":{"application/json":{}}}}},"servers":[{"url":"https://file.sls.epilot.io"}]}')},757:function(e,r,t){var a=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(r,"__esModule",{value:!0});var n=a(t(466));r.default=n.default}},r={},t=function t(a){var n=r[a];if(void 0!==n)return n.exports;var i=r[a]={exports:{}};return e[a].call(i.exports,i,i.exports,t),i.exports}(757),a=exports;for(var n in t)a[n]=t[n];t.__esModule&&Object.defineProperty(a,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -37,6 +37,9 @@
           },
           {
             "$ref": "#/components/parameters/AsyncOperationQueryParam"
+          },
+          {
+            "$ref": "#/components/parameters/DeleteTempFileQueryParam"
           }
         ],
         "requestBody": {
@@ -373,10 +376,100 @@
         },
         "responses": {}
       }
+    },
+    "/v1/entity/{id}/folders": {
+      "get": {
+        "operationId": "getFileFolders",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "parents",
+            "in": "query",
+            "required": false,
+            "style": "form",
+            "explode": true
+          }
+        ],
+        "responses": {}
+      },
+      "post": {
+        "operationId": "createFileFolder",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      }
+    },
+    "/v1/entity/{id}/folders/{folderSlug}": {
+      "put": {
+        "operationId": "updateFileFolder",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "folderSlug",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {}
+          }
+        },
+        "responses": {}
+      },
+      "delete": {
+        "operationId": "deleteFileFolder",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "folderSlug",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
+    },
+    "/v1/entity/{id}/folders/{folderSlug}/files": {
+      "get": {
+        "operationId": "getFilesInFolder",
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "folderSlug",
+            "in": "path",
+            "required": true
+          }
+        ],
+        "responses": {}
+      }
     }
   },
   "components": {
     "parameters": {
+      "EntityIdPathParam": {
+        "name": "id",
+        "in": "path",
+        "required": true
+      },
       "StrictQueryParam": {
         "name": "strict",
         "in": "query",
@@ -396,6 +489,18 @@
         "name": "async",
         "in": "query",
         "required": false
+      },
+      "DeleteTempFileQueryParam": {
+        "name": "delete_temp_file",
+        "in": "query",
+        "required": false
+      }
+    },
+    "responses": {
+      "NotFoundError": {
+        "content": {
+          "application/json": {}
+        }
       }
     }
   },

package/dist/openapi.d.ts

@@ -17,14 +17,48 @@ declare namespace Components {
          */
         Schemas.ActivityId /* ulid */;
         export type AsyncOperationQueryParam = boolean;
+        export type DeleteTempFileQueryParam = boolean;
+        export type EntityIdPathParam = /**
+         * example:
+         * ef7d985c-2385-44f4-9c71-ae06a52264f8
+         */
+        Schemas.EntityId;
         export type FillActivityQueryParam = boolean;
         export type StrictQueryParam = boolean;
     }
+    export interface PathParameters {
+        EntityIdPathParam?: Parameters.EntityIdPathParam;
+    }
     export interface QueryParameters {
         StrictQueryParam?: Parameters.StrictQueryParam;
         ActivityIdQueryParam?: Parameters.ActivityIdQueryParam;
         FillActivityQueryParam?: Parameters.FillActivityQueryParam;
         AsyncOperationQueryParam?: Parameters.AsyncOperationQueryParam;
+        DeleteTempFileQueryParam?: Parameters.DeleteTempFileQueryParam;
+    }
+    namespace Responses {
+        /**
+         * A generic error returned by the API
+         * example:
+         * {
+         *   "status": 404,
+         *   "error": "Not Found"
+         * }
+         */
+        export interface NotFoundError {
+            /**
+             * The HTTP status code of the error
+             * example:
+             * 400
+             */
+            status?: number;
+            /**
+             * The error message
+             * example:
+             * Bad Request
+             */
+            error?: string;
+        }
     }
     namespace Schemas {
         /**
@@ -106,6 +140,23 @@ declare namespace Components {
          * contact
          */
         export type EntitySlug = string;
+        /**
+         * A generic error returned by the API
+         */
+        export interface ErrorObject {
+            /**
+             * The HTTP status code of the error
+             * example:
+             * 400
+             */
+            status?: number;
+            /**
+             * The error message
+             * example:
+             * Bad Request
+             */
+            error?: string;
+        }
         export interface FileAttributes {
             /**
              * example:
@@ -245,7 +296,7 @@ declare namespace Components {
              * https://productengineer-content.s3.eu-west-1.amazonaws.com/product-engineer-checklist.pdf
              */
             source_url?: string;
-            s3ref?: S3Ref;
+            s3ref?: S3Reference;
             versions: FileItem[];
             _updated_at?: string; // date-time
             _created_at?: string; // date-time
@@ -269,6 +320,104 @@ declare namespace Components {
          * ef7d985c-2385-44f4-9c71-ae06a52264f8
          */
         export type FileEntityId = string;
+        export interface FileFolderAttributes {
+            /**
+             * Name of the file folder
+             */
+            name?: string;
+            /**
+             * Optional parent folder slug. If not provided, the folder will be created at the top level
+             */
+            parent?: string;
+            /**
+             * Array of file IDs in this folder
+             */
+            files?: string /* uuid */[];
+        }
+        /**
+         * Request body for creating a file folder
+         */
+        export interface FileFolderCreateRequest {
+            /**
+             * Name of the file folder
+             */
+            name: string;
+            /**
+             * Optional parent folder slug. If not provided, the folder will be created at the top level
+             */
+            parent?: string;
+            /**
+             * Array of file IDs in this folder
+             */
+            files?: string /* uuid */[];
+        }
+        /**
+         * Generated uuid for a file folder
+         */
+        export type FileFolderId = string; // uuid
+        /**
+         * A file folder with identifiers and timestamps
+         */
+        export interface FileFolderItem {
+            id: /* Generated uuid for a file folder */ FileFolderId /* uuid */;
+            /**
+             * Organization ID
+             * example:
+             * 123
+             */
+            orgId: string;
+            entityId: /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            EntityId;
+            /**
+             * Logical type for this item (e.g. "folder")
+             * example:
+             * folder
+             */
+            type: string;
+            /**
+             * example:
+             * MyFolderOfImportantFiles
+             */
+            name: string;
+            entity_id: /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            EntityId;
+            /**
+             * URL-friendly identifier for the folder
+             * example:
+             * documents
+             */
+            slug: string;
+            /**
+             * Array of file IDs in this folder
+             * example:
+             * [
+             *   "123e4567-e89b-12d3-a456-426614174000"
+             * ]
+             */
+            files: string /* uuid */[];
+            /**
+             * User ID who created the folder
+             * example:
+             * 17622
+             */
+            created_by: string;
+            /**
+             * example:
+             * 2025-08-20T12:01:00Z
+             */
+            created_at: string; // date-time
+            /**
+             * example:
+             * 2025-08-20T12:01:00Z
+             */
+            updated_at: string; // date-time
+        }
         export interface FileItem {
             s3ref?: S3Ref;
             /**
@@ -664,6 +813,31 @@ declare namespace Paths {
             }
         }
     }
+    namespace CreateFileFolder {
+        namespace Parameters {
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.EntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        export type RequestBody = /* Request body for creating a file folder */ Components.Schemas.FileFolderCreateRequest;
+        namespace Responses {
+            export type $201 = /* A file folder with identifiers and timestamps */ Components.Schemas.FileFolderItem;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+        }
+    }
     namespace DeleteFile {
         namespace Parameters {
             export type ActivityId = /**
@@ -677,6 +851,9 @@ declare namespace Paths {
              * ef7d985c-2385-44f4-9c71-ae06a52264f8
              */
             Components.Schemas.FileEntityId;
+            /**
+             * Provide `true` to permanently delete the file from storage, otherwise it will be soft-deleted
+             */
             export type Purge = boolean;
             export type Strict = boolean;
         }
@@ -684,7 +861,7 @@ declare namespace Paths {
             id: Parameters.Id;
         }
         export interface QueryParameters {
-            purge?: Parameters.Purge;
+            purge?: /* Provide `true` to permanently delete the file from storage, otherwise it will be soft-deleted */ Parameters.Purge;
             activity_id?: Parameters.ActivityId;
             strict?: Parameters.Strict;
         }
@@ -692,6 +869,41 @@ declare namespace Paths {
             export type $200 = Components.Schemas.FileEntity;
         }
     }
+    namespace DeleteFileFolder {
+        namespace Parameters {
+            /**
+             * example:
+             * documents
+             */
+            export type FolderSlug = string;
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.EntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+            folderSlug: /**
+             * example:
+             * documents
+             */
+            Parameters.FolderSlug;
+        }
+        namespace Responses {
+            export interface $200 {
+            }
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+        }
+    }
     namespace DeleteSession {
         namespace Responses {
             export interface $200 {
@@ -804,6 +1016,75 @@ declare namespace Paths {
             export type $200 = Components.Schemas.FileEntity;
         }
     }
+    namespace GetFileFolders {
+        namespace Parameters {
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.EntityId;
+            export type Parents = string[];
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        export interface QueryParameters {
+            parents?: Parameters.Parents;
+        }
+        namespace Responses {
+            export interface $200 {
+                results?: /* A file folder with identifiers and timestamps */ Components.Schemas.FileFolderItem[];
+            }
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+        }
+    }
+    namespace GetFilesInFolder {
+        namespace Parameters {
+            /**
+             * example:
+             * documents
+             */
+            export type FolderSlug = string;
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.EntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+            folderSlug: /**
+             * example:
+             * documents
+             */
+            Parameters.FolderSlug;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.FileEntity[];
+            export interface $403 {
+                /**
+                 * example:
+                 * User must have permission to view this entity to access its files
+                 */
+                error?: string;
+            }
+            export interface $404 {
+                /**
+                 * example:
+                 * Entity not found
+                 */
+                error?: string;
+            }
+        }
+    }
     namespace GetSession {
         namespace Responses {
             export interface $200 {
@@ -953,6 +1234,7 @@ declare namespace Paths {
              */
             Components.Schemas.ActivityId /* ulid */;
             export type Async = boolean;
+            export type DeleteTempFile = boolean;
             export type FillActivity = boolean;
             export type Strict = boolean;
         }
@@ -961,12 +1243,48 @@ declare namespace Paths {
             fill_activity?: Parameters.FillActivity;
             strict?: Parameters.Strict;
             async?: Parameters.Async;
+            delete_temp_file?: Parameters.DeleteTempFile;
         }
         export type RequestBody = Components.Schemas.SaveFilePayloadV2;
         namespace Responses {
             export type $200 = Components.Schemas.FileEntity;
         }
     }
+    namespace UpdateFileFolder {
+        namespace Parameters {
+            /**
+             * example:
+             * documents
+             */
+            export type FolderSlug = string;
+            export type Id = /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            Components.Schemas.EntityId;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+            folderSlug: /**
+             * example:
+             * documents
+             */
+            Parameters.FolderSlug;
+        }
+        export type RequestBody = /* Request body for creating a file folder */ Components.Schemas.FileFolderCreateRequest;
+        namespace Responses {
+            export type $200 = /* A file folder with identifiers and timestamps */ Components.Schemas.FileFolderItem;
+            export type $404 = /**
+             * A generic error returned by the API
+             * example:
+             * {
+             *   "status": 404,
+             *   "error": "Not Found"
+             * }
+             */
+            Components.Responses.NotFoundError;
+        }
+    }
     namespace UploadFile {
         namespace Parameters {
             export type FileEntityId = /**
@@ -1006,6 +1324,11 @@ declare namespace Paths {
                  * https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/temp/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf?AWSParams=123
                  */
                 upload_url?: string; // url
+                /**
+                 * example:
+                 * File entity not found
+                 */
+                error?: string;
             }
         }
     }
@@ -1268,6 +1591,56 @@ export interface OperationMethods {
     data?: Paths.UploadFilePublic.RequestBody,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.UploadFilePublic.Responses.$201>
+  /**
+   * getFileFolders - getFileFolders
+   * 
+   * Gets a list of folders that exist for an entity
+   */
+  'getFileFolders'(
+    parameters?: Parameters<Paths.GetFileFolders.QueryParameters & Paths.GetFileFolders.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetFileFolders.Responses.$200>
+  /**
+   * createFileFolder - createFileFolder
+   * 
+   * Creates a new file folder for the specified entity
+   */
+  'createFileFolder'(
+    parameters?: Parameters<Paths.CreateFileFolder.PathParameters> | null,
+    data?: Paths.CreateFileFolder.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.CreateFileFolder.Responses.$201>
+  /**
+   * updateFileFolder - updateFileFolder
+   * 
+   * Updates a specific file folder by slug
+   */
+  'updateFileFolder'(
+    parameters?: Parameters<Paths.UpdateFileFolder.PathParameters> | null,
+    data?: Paths.UpdateFileFolder.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.UpdateFileFolder.Responses.$200>
+  /**
+   * deleteFileFolder - deleteFileFolder
+   * 
+   * Deletes a specific file folder by slug
+   */
+  'deleteFileFolder'(
+    parameters?: Parameters<Paths.DeleteFileFolder.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DeleteFileFolder.Responses.$200>
+  /**
+   * getFilesInFolder - getFilesInFolder
+   * 
+   * Gets all files within a specific folder for an entity
+   */
+  'getFilesInFolder'(
+    parameters?: Parameters<Paths.GetFilesInFolder.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetFilesInFolder.Responses.$200>
 }
 
 export interface PathsDictionary {
@@ -1536,6 +1909,62 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.UploadFilePublic.Responses.$201>
   }
+  ['/v1/entity/{id}/folders']: {
+    /**
+     * getFileFolders - getFileFolders
+     * 
+     * Gets a list of folders that exist for an entity
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetFileFolders.QueryParameters & Paths.GetFileFolders.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetFileFolders.Responses.$200>
+    /**
+     * createFileFolder - createFileFolder
+     * 
+     * Creates a new file folder for the specified entity
+     */
+    'post'(
+      parameters?: Parameters<Paths.CreateFileFolder.PathParameters> | null,
+      data?: Paths.CreateFileFolder.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.CreateFileFolder.Responses.$201>
+  }
+  ['/v1/entity/{id}/folders/{folderSlug}']: {
+    /**
+     * updateFileFolder - updateFileFolder
+     * 
+     * Updates a specific file folder by slug
+     */
+    'put'(
+      parameters?: Parameters<Paths.UpdateFileFolder.PathParameters> | null,
+      data?: Paths.UpdateFileFolder.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.UpdateFileFolder.Responses.$200>
+    /**
+     * deleteFileFolder - deleteFileFolder
+     * 
+     * Deletes a specific file folder by slug
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteFileFolder.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DeleteFileFolder.Responses.$200>
+  }
+  ['/v1/entity/{id}/folders/{folderSlug}/files']: {
+    /**
+     * getFilesInFolder - getFilesInFolder
+     * 
+     * Gets all files within a specific folder for an entity
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetFilesInFolder.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetFilesInFolder.Responses.$200>
+  }
 }
 
 export type Client = OpenAPIClient<OperationMethods, PathsDictionary>
@@ -1549,9 +1978,14 @@ export type CustomDownloadUrl = Components.Schemas.CustomDownloadUrl;
 export type DownloadFilesPayload = Components.Schemas.DownloadFilesPayload;
 export type EntityId = Components.Schemas.EntityId;
 export type EntitySlug = Components.Schemas.EntitySlug;
+export type ErrorObject = Components.Schemas.ErrorObject;
 export type FileAttributes = Components.Schemas.FileAttributes;
 export type FileEntity = Components.Schemas.FileEntity;
 export type FileEntityId = Components.Schemas.FileEntityId;
+export type FileFolderAttributes = Components.Schemas.FileFolderAttributes;
+export type FileFolderCreateRequest = Components.Schemas.FileFolderCreateRequest;
+export type FileFolderId = Components.Schemas.FileFolderId;
+export type FileFolderItem = Components.Schemas.FileFolderItem;
 export type FileItem = Components.Schemas.FileItem;
 export type FileRelationItem = Components.Schemas.FileRelationItem;
 export type FileType = Components.Schemas.FileType;

package/dist/openapi.json

@@ -2,8 +2,8 @@
   "openapi": "3.0.3",
   "info": {
     "title": "File API",
-    "version": "0.2.0",
-    "description": "Upload and manage epilot Files"
+    "version": "1.0.0",
+    "description": "Upload and manage epilot Files\n\n## Changelog\n<a href=\"changelog\">View API Changelog</a>\n"
   },
   "tags": [
     {
@@ -30,6 +30,10 @@
       "name": "file_schema",
       "x-displayName": "File",
       "description": "<SchemaDefinition schemaRef=\"#/components/schemas/FileEntity\" />\n"
+    },
+    {
+      "name": "File Folders",
+      "description": "Folder management for organizing files within entities"
     }
   ],
   "x-tagGroups": [
@@ -40,6 +44,7 @@
         "Preview",
         "Public Links",
         "Session",
+        "File Folders",
         "Deprecated"
       ]
     },
@@ -136,6 +141,9 @@
           },
           {
             "$ref": "#/components/parameters/AsyncOperationQueryParam"
+          },
+          {
+            "$ref": "#/components/parameters/DeleteTempFileQueryParam"
           }
         ],
         "requestBody": {
@@ -394,7 +402,8 @@
             "in": "query",
             "schema": {
               "type": "boolean",
-              "default": false
+              "default": false,
+              "description": "Provide `true` to permanently delete the file from storage, otherwise it will be soft-deleted"
             }
           },
           {
@@ -1072,6 +1081,253 @@
                       "type": "string",
                       "format": "url",
                       "example": "https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/temp/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf?AWSParams=123"
+                    },
+                    "error": {
+                      "type": "string",
+                      "example": "File entity not found"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/entity/{id}/folders": {
+      "get": {
+        "operationId": "getFileFolders",
+        "summary": "getFileFolders",
+        "description": "Gets a list of folders that exist for an entity",
+        "tags": [
+          "File Folders"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "parents",
+            "in": "query",
+            "description": "Optional array of parent folder slugs to filter by",
+            "required": false,
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "style": "form",
+            "explode": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of folders for the entity",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/FileFolderItem"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          }
+        }
+      },
+      "post": {
+        "operationId": "createFileFolder",
+        "summary": "createFileFolder",
+        "description": "Creates a new file folder for the specified entity",
+        "tags": [
+          "File Folders"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/FileFolderCreateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "File folder created successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileFolderItem"
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          }
+        }
+      }
+    },
+    "/v1/entity/{id}/folders/{folderSlug}": {
+      "put": {
+        "operationId": "updateFileFolder",
+        "summary": "updateFileFolder",
+        "description": "Updates a specific file folder by slug",
+        "tags": [
+          "File Folders"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "folderSlug",
+            "in": "path",
+            "required": true,
+            "description": "The slug identifier for the folder",
+            "schema": {
+              "type": "string",
+              "example": "documents"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/FileFolderCreateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "File folder updated successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FileFolderItem"
+                }
+              }
+            }
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "deleteFileFolder",
+        "summary": "deleteFileFolder",
+        "description": "Deletes a specific file folder by slug",
+        "tags": [
+          "File Folders"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "folderSlug",
+            "in": "path",
+            "required": true,
+            "description": "The slug identifier for the folder",
+            "schema": {
+              "type": "string",
+              "example": "documents"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "File folder deleted successfully"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFoundError"
+          }
+        }
+      }
+    },
+    "/v1/entity/{id}/folders/{folderSlug}/files": {
+      "get": {
+        "operationId": "getFilesInFolder",
+        "summary": "getFilesInFolder",
+        "description": "Gets all files within a specific folder for an entity",
+        "tags": [
+          "File Folders"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/EntityIdPathParam"
+          },
+          {
+            "name": "folderSlug",
+            "in": "path",
+            "required": true,
+            "description": "The slug identifier for the folder",
+            "schema": {
+              "type": "string",
+              "example": "documents"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of files in the folder",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/FileEntity"
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "User must have permission to view this entity to access its files",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string",
+                      "example": "User must have permission to view this entity to access its files"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Entity or folder not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string",
+                      "example": "Entity not found"
                     }
                   }
                 }
@@ -1255,8 +1511,14 @@
                 "example": "https://productengineer-content.s3.eu-west-1.amazonaws.com/product-engineer-checklist.pdf"
               },
               "s3ref": {
-                "$ref": "#/components/schemas/S3Ref",
-                "readOnly": true
+                "allOf": [
+                  {
+                    "$ref": "#/components/schemas/S3Ref"
+                  },
+                  {
+                    "readOnly": true
+                  }
+                ]
               },
               "versions": {
                 "type": "array",
@@ -1638,9 +1900,148 @@
             }
           }
         }
+      },
+      "FileFolderId": {
+        "description": "Generated uuid for a file folder",
+        "type": "string",
+        "format": "uuid"
+      },
+      "FileFolderItem": {
+        "description": "A file folder with identifiers and timestamps",
+        "type": "object",
+        "properties": {
+          "id": {
+            "$ref": "#/components/schemas/FileFolderId"
+          },
+          "orgId": {
+            "type": "string",
+            "description": "Organization ID",
+            "example": "123"
+          },
+          "entityId": {
+            "$ref": "#/components/schemas/EntityId"
+          },
+          "type": {
+            "type": "string",
+            "description": "Logical type for this item (e.g. \"folder\")",
+            "example": "folder"
+          },
+          "name": {
+            "type": "string",
+            "example": "MyFolderOfImportantFiles"
+          },
+          "entity_id": {
+            "$ref": "#/components/schemas/EntityId"
+          },
+          "slug": {
+            "type": "string",
+            "description": "URL-friendly identifier for the folder",
+            "example": "documents"
+          },
+          "files": {
+            "type": "array",
+            "description": "Array of file IDs in this folder",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            },
+            "example": [
+              "123e4567-e89b-12d3-a456-426614174000"
+            ]
+          },
+          "created_by": {
+            "type": "string",
+            "description": "User ID who created the folder",
+            "example": "17622"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2025-08-20T12:01:00Z"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2025-08-20T12:01:00Z"
+          }
+        },
+        "required": [
+          "id",
+          "orgId",
+          "entityId",
+          "type",
+          "name",
+          "entity_id",
+          "slug",
+          "files",
+          "created_by",
+          "created_at",
+          "updated_at"
+        ]
+      },
+      "ErrorObject": {
+        "description": "A generic error returned by the API",
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "integer",
+            "description": "The HTTP status code of the error",
+            "example": 400
+          },
+          "error": {
+            "type": "string",
+            "description": "The error message",
+            "example": "Bad Request"
+          }
+        }
+      },
+      "FileFolderAttributes": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Name of the file folder"
+          },
+          "parent": {
+            "type": "string",
+            "description": "Optional parent folder slug. If not provided, the folder will be created at the top level"
+          },
+          "files": {
+            "type": "array",
+            "description": "Array of file IDs in this folder",
+            "items": {
+              "type": "string",
+              "format": "uuid"
+            }
+          }
+        },
+        "additionalProperties": false
+      },
+      "FileFolderCreateRequest": {
+        "description": "Request body for creating a file folder",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/FileFolderAttributes"
+          },
+          {
+            "type": "object",
+            "required": [
+              "name"
+            ]
+          }
+        ]
       }
     },
     "parameters": {
+      "EntityIdPathParam": {
+        "name": "id",
+        "description": "Entity id",
+        "in": "path",
+        "required": true,
+        "schema": {
+          "$ref": "#/components/schemas/EntityId"
+        }
+      },
       "StrictQueryParam": {
         "name": "strict",
         "in": "query",
@@ -1679,6 +2080,38 @@
           "type": "boolean",
           "default": false
         }
+      },
+      "DeleteTempFileQueryParam": {
+        "name": "delete_temp_file",
+        "description": "Delete the temp file from S3 after copying it permanently",
+        "in": "query",
+        "required": false,
+        "schema": {
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "responses": {
+      "NotFoundError": {
+        "description": "The requested resource was not found",
+        "content": {
+          "application/json": {
+            "schema": {
+              "allOf": [
+                {
+                  "$ref": "#/components/schemas/ErrorObject"
+                },
+                {
+                  "example": {
+                    "status": 404,
+                    "error": "Not Found"
+                  }
+                }
+              ]
+            }
+          }
+        }
       }
     }
   },

package/package.json

@@ -1,12 +1,24 @@
 {
   "name": "@epilot/file-client",
-  "version": "1.15.1",
+  "version": "1.16.0-alpha.0",
   "description": "Client library for the epilot File API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "author": "epilot GmbH",
   "license": "MIT",
   "private": false,
+  "scripts": {
+    "test": "jest",
+    "typescript": "tsc",
+    "bundle-definition": "webpack",
+    "openapi": "node ../../scripts/update-openapi.js https://docs.api.epilot.io/file.yaml",
+    "typegen": "openapi typegen src/openapi.json --client -b '/* eslint-disable */' > src/openapi.d.ts",
+    "build": "tsc && npm run build:patch && npm run bundle-definition",
+    "build:patch": "sed -i'' -e '/^__exportStar.*openapi.*$/d' dist/index.js",
+    "build:watch": "npm run build && tsc -w",
+    "prepublishOnly": "npm run typegen && npm run build",
+    "lint": "pnpm exec eslint src"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/epilot-dev/sdk-js.git",
@@ -49,26 +61,15 @@
     "@types/jest": "^26.0.20",
     "axios": "^1.11.0",
     "copy-webpack-plugin": "^7.0.0",
-    "jest": "^26.6.3",
+    "jest": "^29.6.2",
     "json-loader": "^0.5.7",
     "openapicmd": "^2.7.0",
-    "ts-jest": "^26.5.0",
+    "ts-jest": "^29.4.1",
     "ts-loader": "^8.0.14",
     "ts-node": "^10.9.1",
     "typescript": "^4.1.3",
     "webpack": "^5.18.0",
     "webpack-cli": "^4.4.0"
   },
-  "gitHead": "39426e86cfb320fa3227dc03f60ee6a10848e7c7",
-  "scripts": {
-    "test": "jest",
-    "typescript": "tsc",
-    "bundle-definition": "webpack",
-    "openapi": "node ../../scripts/update-openapi.js https://docs.api.epilot.io/file.yaml",
-    "typegen": "openapi typegen src/openapi.json --client -b '/* eslint-disable */' > src/openapi.d.ts",
-    "build": "tsc && npm run build:patch && npm run bundle-definition",
-    "build:patch": "sed -i'' -e '/^__exportStar.*openapi.*$/d' dist/index.js",
-    "build:watch": "npm run build && tsc -w",
-    "lint": "pnpm exec eslint src"
-  }
-}
+  "gitHead": "39426e86cfb320fa3227dc03f60ee6a10848e7c7"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2025 epilot GmbH
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.