@epilot/file-client 1.8.0-rc1 → 1.8.0

package/dist/definition.js

@@ -1 +1 @@
-!function(e,i){for(var t in i)e[t]=i[t];i.__esModule&&Object.defineProperty(e,"__esModule",{value:!0})}(exports,(()=>{"use strict";var e={914:function(e,i,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(i,"__esModule",{value:!0});var r=n(t(946));i.default=r.default},946:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"paths":{"/v1/files/public/upload":{"post":{"operationId":"uploadFilePublic","requestBody":{"content":{"application/json":{}}}}},"/v1/files/upload":{"post":{"operationId":"uploadFile","parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}}}},"/v1/files":{"post":{"operationId":"saveFile","requestBody":{"content":{"application/json":{}}}}},"/v1/files/{id}/download":{"get":{"operationId":"downloadFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"attachment","in":"query"}]}},"/v1/files:downloadFiles":{"post":{"operationId":"downloadFiles","requestBody":{"content":{"application/json":{}}}}},"/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"}]}},"/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"}]}},"/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"}]}},"/v1/files:previewS3":{"get":{"operationId":"previewS3FileGet","parameters":[{"name":"key","in":"query","required":true},{"name":"bucket","in":"query","required":true},{"name":"w","in":"query"},{"name":"h","in":"query"}]},"post":{"operationId":"previewS3File","parameters":[{"name":"w","in":"query"},{"name":"h","in":"query"}],"requestBody":{"content":{"application/json":{}}}}},"/v1/files/delete":{"delete":{"operationId":"deleteFile","requestBody":{"content":{"application/json":{}}}}},"/v1/files/session":{"post":{"operationId":"getSession"},"delete":{"operationId":"deleteSession"}}},"components":{},"servers":[{"url":"https://file.sls.epilot.io"}]}')}},i={};return function t(n){if(i[n])return i[n].exports;var r=i[n]={exports:{}};return e[n].call(r.exports,r,r.exports,t),r.exports}(914)})());
+(()=>{"use strict";var e={914:function(e,i,t){var n=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(i,"__esModule",{value:!0});var r=n(t(240));i.default=r.default},240:e=>{e.exports=JSON.parse('{"openapi":"3.0.3","info":{"title":"","version":""},"paths":{"/v1/files/public/upload":{"post":{"operationId":"uploadFilePublic","requestBody":{"content":{"application/json":{}}}}},"/v1/files/upload":{"post":{"operationId":"uploadFile","parameters":[{"name":"file_entity_id","in":"query"}],"requestBody":{"content":{"application/json":{}}}}},"/v1/files":{"post":{"operationId":"saveFile","requestBody":{"content":{"application/json":{}}}}},"/v1/files/{id}/download":{"get":{"operationId":"downloadFile","parameters":[{"name":"id","in":"path","required":true},{"name":"version","in":"query"},{"name":"attachment","in":"query"}]}},"/v1/files/download:verify":{"post":{"operationId":"verifyCustomDownloadUrl","requestBody":{"content":{"application/json":{}}}}},"/v1/files:downloadFiles":{"post":{"operationId":"downloadFiles","requestBody":{"content":{"application/json":{}}}}},"/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"}]}},"/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"}]}},"/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"}]}},"/v1/files:previewS3":{"get":{"operationId":"previewS3FileGet","parameters":[{"name":"key","in":"query","required":true},{"name":"bucket","in":"query","required":true},{"name":"w","in":"query"},{"name":"h","in":"query"}]},"post":{"operationId":"previewS3File","parameters":[{"name":"w","in":"query"},{"name":"h","in":"query"}],"requestBody":{"content":{"application/json":{}}}}},"/v1/files/delete":{"delete":{"operationId":"deleteFile","requestBody":{"content":{"application/json":{}}}}},"/v1/files/session":{"get":{"operationId":"getSession"},"delete":{"operationId":"deleteSession"}}},"components":{},"servers":[{"url":"https://file.sls.epilot.io"}]}')}},i={},t=function t(n){var r=i[n];if(void 0!==r)return r.exports;var o=i[n]={exports:{}};return e[n].call(o.exports,o,o.exports,t),o.exports}(914),n=exports;for(var r in t)n[r]=t[r];t.__esModule&&Object.defineProperty(n,"__esModule",{value:!0})})();

package/dist/openapi-runtime.json

@@ -61,6 +61,16 @@
         ]
       }
     },
+    "/v1/files/download:verify": {
+      "post": {
+        "operationId": "verifyCustomDownloadUrl",
+        "requestBody": {
+          "content": {
+            "application/json": {}
+          }
+        }
+      }
+    },
     "/v1/files:downloadFiles": {
       "post": {
         "operationId": "downloadFiles",
@@ -198,7 +208,7 @@
       }
     },
     "/v1/files/session": {
-      "post": {
+      "get": {
         "operationId": "getSession"
       },
       "delete": {

package/dist/openapi.d.ts

@@ -9,6 +9,25 @@ import type {
 
 declare namespace Components {
     namespace Schemas {
+        export interface CommonSaveFilePayload {
+            [name: string]: any;
+            /**
+             * if passed, adds a new version to existing file entity
+             */
+            file_entity_id?: string;
+            document_type?: "document" | "document_template" | "text" | "image" | "video" | "audio" | "spreadsheet" | "presentation" | "font" | "archive" | "application" | "unknown";
+            /**
+             * example:
+             * document.pdf
+             */
+            filename?: string;
+            _tags?: string[];
+            access_control?: "private" | "public-read";
+            /**
+             * List of entities to relate the file to
+             */
+            relations?: FileRelationItem[];
+        }
         export interface DeleteFilePayload {
             s3ref: S3Reference;
         }
@@ -25,6 +44,17 @@ declare namespace Components {
              */
             version?: number;
         }[];
+        /**
+         * example:
+         * ef7d985c-2385-44f4-9c71-ae06a52264f8
+         */
+        export type EntityId = string;
+        /**
+         * URL-friendly identifier for the entity schema
+         * example:
+         * contact
+         */
+        export type EntitySlug = string;
         export interface FileEntity {
             _id?: /**
              * example:
@@ -93,6 +123,20 @@ declare namespace Components {
              */
             mime_type?: string;
         }
+        export interface FileRelationItem {
+            entity_id: /**
+             * example:
+             * ef7d985c-2385-44f4-9c71-ae06a52264f8
+             */
+            EntityId;
+            _schema?: /**
+             * URL-friendly identifier for the entity schema
+             * example:
+             * contact
+             */
+            EntitySlug;
+            _tags?: string[];
+        }
         export interface S3Reference {
             /**
              * example:
@@ -105,9 +149,8 @@ declare namespace Components {
              */
             key: string;
         }
-        export interface SaveFilePayload {
+        export interface SaveCustomFilePayload {
             [name: string]: any;
-            s3ref: S3Reference;
             /**
              * if passed, adds a new version to existing file entity
              */
@@ -120,6 +163,35 @@ declare namespace Components {
             filename?: string;
             _tags?: string[];
             access_control?: "private" | "public-read";
+            /**
+             * List of entities to relate the file to
+             */
+            relations?: FileRelationItem[];
+            /**
+             * Custom external download url used for the file
+             */
+            custom_download_url: string; // uri
+        }
+        export type SaveFilePayload = SaveS3FilePayload | SaveCustomFilePayload;
+        export interface SaveS3FilePayload {
+            [name: string]: any;
+            /**
+             * if passed, adds a new version to existing file entity
+             */
+            file_entity_id?: string;
+            document_type?: "document" | "document_template" | "text" | "image" | "video" | "audio" | "spreadsheet" | "presentation" | "font" | "archive" | "application" | "unknown";
+            /**
+             * example:
+             * document.pdf
+             */
+            filename?: string;
+            _tags?: string[];
+            access_control?: "private" | "public-read";
+            /**
+             * List of entities to relate the file to
+             */
+            relations?: FileRelationItem[];
+            s3ref: S3Reference;
         }
         export interface UploadFilePayload {
             /**
@@ -134,6 +206,14 @@ declare namespace Components {
              */
             mime_type?: string;
         }
+        export interface VerifyCustomDownloadUrlPayload {
+            /**
+             * Custom external download url with signature and expiration time
+             * example:
+             * https://some-api-url.com?file_id=123&expires_at=1699273500029&signature=abcdefg
+             */
+            custom_download_url: string; // uri
+        }
     }
 }
 declare namespace Paths {
@@ -368,6 +448,14 @@ declare namespace Paths {
             }
         }
     }
+    namespace VerifyCustomDownloadUrl {
+        export type RequestBody = Components.Schemas.VerifyCustomDownloadUrlPayload;
+        namespace Responses {
+            export interface $200 {
+                valid?: boolean;
+            }
+        }
+    }
 }
 
 export interface OperationMethods {
@@ -422,6 +510,16 @@ export interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig  
   ): OperationResponse<Paths.DownloadFile.Responses.$200>
+  /**
+   * verifyCustomDownloadUrl - verifyCustomDownloadUrl
+   * 
+   * Verify a pre-signed custom download url for a file
+   */
+  'verifyCustomDownloadUrl'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.VerifyCustomDownloadUrl.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.VerifyCustomDownloadUrl.Responses.$200>
   /**
    * downloadFiles - downloadFiles
    * 
@@ -577,6 +675,18 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig  
     ): OperationResponse<Paths.DownloadFile.Responses.$200>
   }
+  ['/v1/files/download:verify']: {
+    /**
+     * verifyCustomDownloadUrl - verifyCustomDownloadUrl
+     * 
+     * Verify a pre-signed custom download url for a file
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.VerifyCustomDownloadUrl.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.VerifyCustomDownloadUrl.Responses.$200>
+  }
   ['/v1/files:downloadFiles']: {
     /**
      * downloadFiles - downloadFiles
@@ -668,7 +778,7 @@ export interface PathsDictionary {
      * Allows using preview urls directly in img src for private files using cookie authentication.
      * 
      */
-    'post'(
+    'get'(
       parameters?: Parameters<UnknownParamsObject> | null,
       data?: any,
       config?: AxiosRequestConfig  

package/dist/openapi.json

@@ -157,6 +157,58 @@
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/SaveFilePayload"
+              },
+              "examples": {
+                "S3File": {
+                  "description": "Standard epilot file entity with S3 Ref",
+                  "value": {
+                    "file_entity_id": "string",
+                    "document_type": "document",
+                    "filename": "document.pdf",
+                    "_tags": [
+                      "string"
+                    ],
+                    "access_control": "private",
+                    "s3ref": {
+                      "bucket": "epilot-files-prod",
+                      "key": "123/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf"
+                    }
+                  }
+                },
+                "CustomFile": {
+                  "description": "Custom file entity with custom download url",
+                  "value": {
+                    "file_entity_id": "string",
+                    "document_type": "document",
+                    "filename": "document.pdf",
+                    "_tags": [
+                      "string"
+                    ],
+                    "access_control": "private",
+                    "custom_download_url": "https://some-api-url.com/download?file_id=123",
+                    "shared_with_end_customer": true
+                  }
+                },
+                "CustomFileWithRelations": {
+                  "description": "Custom file entity with custom download url",
+                  "value": {
+                    "file_entity_id": "string",
+                    "document_type": "document",
+                    "filename": "document.pdf",
+                    "_tags": [
+                      "string"
+                    ],
+                    "access_control": "private",
+                    "custom_download_url": "https://some-api-url.com/download?file_id=123",
+                    "shared_with_end_customer": true,
+                    "relations": [
+                      {
+                        "entity_id": "77a1e0cc-7b92-4d41-8cce-eefd317ec004",
+                        "_schema": "contact"
+                      }
+                    ]
+                  }
+                }
               }
             }
           }
@@ -232,6 +284,42 @@
         }
       }
     },
+    "/v1/files/download:verify": {
+      "post": {
+        "operationId": "verifyCustomDownloadUrl",
+        "summary": "verifyCustomDownloadUrl",
+        "description": "Verify a pre-signed custom download url for a file",
+        "tags": [
+          "files"
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/VerifyCustomDownloadUrlPayload"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Download Url matches signature and has not expired",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "valid": {
+                      "type": "boolean"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/v1/files:downloadFiles": {
       "post": {
         "operationId": "downloadFiles",
@@ -574,7 +662,7 @@
       }
     },
     "/v1/files/session": {
-      "post": {
+      "get": {
         "operationId": "getSession",
         "summary": "getSession",
         "description": "Start a browser session by setting passed Authorization token in a server side cookie.\n\nAllows using preview urls directly in img src for private files using cookie authentication.\n",
@@ -618,6 +706,15 @@
       }
     },
     "schemas": {
+      "EntityId": {
+        "type": "string",
+        "example": "ef7d985c-2385-44f4-9c71-ae06a52264f8"
+      },
+      "EntitySlug": {
+        "description": "URL-friendly identifier for the entity schema",
+        "type": "string",
+        "example": "contact"
+      },
       "FileEntityId": {
         "type": "string",
         "example": "ef7d985c-2385-44f4-9c71-ae06a52264f8"
@@ -724,12 +821,9 @@
           ]
         }
       },
-      "SaveFilePayload": {
+      "CommonSaveFilePayload": {
         "type": "object",
         "properties": {
-          "s3ref": {
-            "$ref": "#/components/schemas/S3Reference"
-          },
           "file_entity_id": {
             "type": "string",
             "description": "if passed, adds a new version to existing file entity"
@@ -768,11 +862,63 @@
               "private",
               "public-read"
             ]
+          },
+          "relations": {
+            "type": "array",
+            "description": "List of entities to relate the file to",
+            "items": {
+              "$ref": "#/components/schemas/FileRelationItem"
+            }
           }
         },
-        "additionalProperties": true,
-        "required": [
-          "s3ref"
+        "additionalProperties": true
+      },
+      "SaveS3FilePayload": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommonSaveFilePayload"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "s3ref": {
+                "$ref": "#/components/schemas/S3Reference"
+              }
+            },
+            "required": [
+              "s3ref"
+            ]
+          }
+        ]
+      },
+      "SaveCustomFilePayload": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CommonSaveFilePayload"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "custom_download_url": {
+                "description": "Custom external download url used for the file",
+                "type": "string",
+                "format": "uri"
+              }
+            },
+            "required": [
+              "custom_download_url"
+            ]
+          }
+        ]
+      },
+      "SaveFilePayload": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/SaveS3FilePayload"
+          },
+          {
+            "$ref": "#/components/schemas/SaveCustomFilePayload"
+          }
         ]
       },
       "DeleteFilePayload": {
@@ -786,6 +932,20 @@
           "s3ref"
         ]
       },
+      "VerifyCustomDownloadUrlPayload": {
+        "type": "object",
+        "properties": {
+          "custom_download_url": {
+            "description": "Custom external download url with signature and expiration time",
+            "type": "string",
+            "format": "uri",
+            "example": "https://some-api-url.com?file_id=123&expires_at=1699273500029&signature=abcdefg"
+          }
+        },
+        "required": [
+          "custom_download_url"
+        ]
+      },
       "S3Reference": {
         "type": "object",
         "properties": {
@@ -826,10 +986,33 @@
             }
           }
         ]
+      },
+      "FileRelationItem": {
+        "type": "object",
+        "properties": {
+          "entity_id": {
+            "$ref": "#/components/schemas/EntityId"
+          },
+          "_schema": {
+            "$ref": "#/components/schemas/EntitySlug"
+          },
+          "_tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "entity_id"
+        ]
       }
     }
   },
   "servers": [
+    {
+      "url": "https://file.sls.epilot.io"
+    },
     {
       "url": "https://file.sls.epilot.io"
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/file-client",
-  "version": "1.8.0-rc1",
+  "version": "1.8.0",
   "description": "Client library for the epilot File API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -50,7 +50,7 @@
   "dependencies": {
     "buffer": "^6.0.3",
     "https-browserify": "^1.0.0",
-    "openapi-client-axios": "^6.0.0",
+    "openapi-client-axios": "^7.1.3",
     "stream-http": "^3.1.1",
     "url": "^0.11.0",
     "util": "^0.12.3"
@@ -61,7 +61,7 @@
     "copy-webpack-plugin": "^7.0.0",
     "jest": "^26.6.3",
     "json-loader": "^0.5.7",
-    "openapi-client-axios-typegen": "^7.2.0",
+    "openapi-client-axios-typegen": "^7.4.1",
     "openapicmd": "^1.16.2",
     "ts-jest": "^26.5.0",
     "ts-loader": "^8.0.14",
@@ -71,4 +71,4 @@
     "webpack-cli": "^4.4.0"
   },
   "gitHead": "39426e86cfb320fa3227dc03f60ee6a10848e7c7"
-}
+}