@bytescale/sdk 3.43.0 → 3.45.0

package/dist/browser/cjs/main.js

@@ -971,8 +971,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -1045,8 +1045,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.transformationParams !== undefined) {
           query["transformationParams"] = params.transformationParams;
@@ -1206,7 +1206,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolder",
@@ -1232,7 +1232,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1802,12 +1802,12 @@ var UrlBuilder = /*#__PURE__*/function () {
       return this.makeQueryParams({
         cache: null,
         cacheTtl: null,
-        cacheTtlNotFound: null,
+        cacheTtl404: null,
         version: null,
         forceDownloadPrompt: null
       }, {
         cacheTtl: "cache_ttl",
-        cacheTtlNotFound: "cache_ttl_not_found",
+        cacheTtl404: "cache_ttl_404",
         forceDownloadPrompt: "download"
       })(params);
     }
@@ -3084,6 +3084,14 @@ function Scheduler_createClass(Constructor, protoProps, staticProps) { if (proto
 function Scheduler_toPropertyKey(t) { var i = Scheduler_toPrimitive(t, "string"); return "symbol" == Scheduler_typeof(i) ? i : i + ""; }
 function Scheduler_toPrimitive(t, r) { if ("object" != Scheduler_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != Scheduler_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 
+/**
+ * -------------------------
+ * Q: Why not use 'setTimeout'?
+ * -------------------------
+ * A: setTimeout can be paused (e.g., during hibernation), risking JWT expiration before it triggers.
+ *    We therefore use a scheduler to check wall-clock time every second and execute the callback at the scheduled time.
+ * -------------------------
+ */
 var Scheduler = /*#__PURE__*/function () {
   function Scheduler() {
     Scheduler_classCallCheck(this, Scheduler);
@@ -3381,6 +3389,8 @@ var AuthManagerImpl = /*#__PURE__*/function () {
               ConsoleUtils.warn("Unable to refresh JWT access token: ".concat(e));
             });
           }, function (_wasThrown, _result) {
+            // 'setTimeout' can be paused (e.g., during hibernation), risking JWT expiration before it triggers. We use a
+            // scheduler to check wall-clock time every second and execute the callback at the scheduled time (below).
             session.accessTokenRefreshHandle = _this3.scheduler.schedule(expires, function () {
               _this3.refreshAccessToken(session).then(function () {},
               // Should not occur, as this method shouldn't throw errors.

package/dist/browser/esm/main.mjs

@@ -956,8 +956,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -1030,8 +1030,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.transformationParams !== undefined) {
           query["transformationParams"] = params.transformationParams;
@@ -1191,7 +1191,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolder",
@@ -1217,7 +1217,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1787,12 +1787,12 @@ var UrlBuilder = /*#__PURE__*/function () {
       return this.makeQueryParams({
         cache: null,
         cacheTtl: null,
-        cacheTtlNotFound: null,
+        cacheTtl404: null,
         version: null,
         forceDownloadPrompt: null
       }, {
         cacheTtl: "cache_ttl",
-        cacheTtlNotFound: "cache_ttl_not_found",
+        cacheTtl404: "cache_ttl_404",
         forceDownloadPrompt: "download"
       })(params);
     }
@@ -3069,6 +3069,14 @@ function Scheduler_createClass(Constructor, protoProps, staticProps) { if (proto
 function Scheduler_toPropertyKey(t) { var i = Scheduler_toPrimitive(t, "string"); return "symbol" == Scheduler_typeof(i) ? i : i + ""; }
 function Scheduler_toPrimitive(t, r) { if ("object" != Scheduler_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != Scheduler_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 
+/**
+ * -------------------------
+ * Q: Why not use 'setTimeout'?
+ * -------------------------
+ * A: setTimeout can be paused (e.g., during hibernation), risking JWT expiration before it triggers.
+ *    We therefore use a scheduler to check wall-clock time every second and execute the callback at the scheduled time.
+ * -------------------------
+ */
 var Scheduler = /*#__PURE__*/function () {
   function Scheduler() {
     Scheduler_classCallCheck(this, Scheduler);
@@ -3366,6 +3374,8 @@ var AuthManagerImpl = /*#__PURE__*/function () {
               ConsoleUtils.warn("Unable to refresh JWT access token: ".concat(e));
             });
           }, function (_wasThrown, _result) {
+            // 'setTimeout' can be paused (e.g., during hibernation), risking JWT expiration before it triggers. We use a
+            // scheduler to check wall-clock time every second and execute the callback at the scheduled time (below).
             session.accessTokenRefreshHandle = _this3.scheduler.schedule(expires, function () {
               _this3.refreshAccessToken(session).then(function () {},
               // Should not occur, as this method shouldn't throw errors.

package/dist/node/cjs/main.js

@@ -971,8 +971,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -1045,8 +1045,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.transformationParams !== undefined) {
           query["transformationParams"] = params.transformationParams;
@@ -1206,7 +1206,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolder",
@@ -1232,7 +1232,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1802,12 +1802,12 @@ var UrlBuilder = /*#__PURE__*/function () {
       return this.makeQueryParams({
         cache: null,
         cacheTtl: null,
-        cacheTtlNotFound: null,
+        cacheTtl404: null,
         version: null,
         forceDownloadPrompt: null
       }, {
         cacheTtl: "cache_ttl",
-        cacheTtlNotFound: "cache_ttl_not_found",
+        cacheTtl404: "cache_ttl_404",
         forceDownloadPrompt: "download"
       })(params);
     }

package/dist/node/esm/main.mjs

@@ -958,8 +958,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -1032,8 +1032,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.transformationParams !== undefined) {
           query["transformationParams"] = params.transformationParams;
@@ -1193,7 +1193,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolder",
@@ -1219,7 +1219,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1789,12 +1789,12 @@ var UrlBuilder = /*#__PURE__*/function () {
       return this.makeQueryParams({
         cache: null,
         cacheTtl: null,
-        cacheTtlNotFound: null,
+        cacheTtl404: null,
         version: null,
         forceDownloadPrompt: null
       }, {
         cacheTtl: "cache_ttl",
-        cacheTtlNotFound: "cache_ttl_not_found",
+        cacheTtl404: "cache_ttl_404",
         forceDownloadPrompt: "download"
       })(params);
     }

package/dist/types/private/Scheduler.d.ts

@@ -1,3 +1,11 @@
+/**
+ * -------------------------
+ * Q: Why not use 'setTimeout'?
+ * -------------------------
+ * A: setTimeout can be paused (e.g., during hibernation), risking JWT expiration before it triggers.
+ *    We therefore use a scheduler to check wall-clock time every second and execute the callback at the scheduled time.
+ * -------------------------
+ */
 export declare class Scheduler {
     private callbacks;
     private nextId;

package/dist/types/public/shared/UrlBuilderTypes.d.ts

@@ -49,7 +49,7 @@ export interface NonDeprecatedCommonQueryParams {
      *
      * Default: Please refer to your account's default cache settings in the Bytescale Dashboard.
      */
-    cacheTtlNotFound?: number;
+    cacheTtl404?: number;
     /**
      * Forces the browser to display a download prompt for the file, instead of displaying the file in the browser.
      *

package/dist/types/public/shared/generated/apis/FileApi.d.ts

@@ -48,7 +48,7 @@ export interface DownloadFileParams {
      *
      * Default: Please refer to your account's default cache settings in the Bytescale Dashboard.
      */
-    cacheTtlNotFound?: number;
+    cacheTtl404?: number;
     /**
      * Downloads the latest version of your file (if you have overwritten it) when added to the URL with a unique value.
      *
@@ -126,7 +126,7 @@ export interface ProcessFileParams {
      *
      * Default: Please refer to your account's default cache settings in the Bytescale Dashboard.
      */
-    cacheTtlNotFound?: number;
+    cacheTtl404?: number;
     /**
      * Parameters to submit to the File Processing API (e.g. the Image Processing API).
      *

package/dist/types/public/shared/generated/apis/FolderApi.d.ts

@@ -57,11 +57,11 @@ export declare class FolderApi extends runtime.BaseAPI {
      */
     copyFolderBatch(params: CopyFolderBatchOperationParams): Promise<AsyncResponse>;
     /**
-     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
     deleteFolder(params: DeleteFolderOperationParams): Promise<AsyncResponse>;
     /**
-     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
     deleteFolderBatch(params: DeleteFolderBatchOperationParams): Promise<AsyncResponse>;
     /**

package/dist/types/public/shared/generated/models/index.d.ts

@@ -343,9 +343,9 @@ export interface CopyFolderRequest {
      */
     copyOverriddenStorage?: boolean;
     /**
-     * If `true` then copies virtual folders at the current path and below, else only files will be copied.
+     * If `true` then copies virtual folders at the current path and below (virtual folders are folders created using the PutFolder operation).
      *
-     * Virtual folders are folders that have been created using the PutFolder operation.
+     * If `false` then virtual folders will not be copied, meaning no folder settings will be copied to the destination, but the files of any virtual folders will still be copied if `copyFiles` is set to `true`.
      *
      * Conditional: `copyVirtualFolders` and `copyOverriddenStorage` cannot both be `true`.
      *
@@ -536,7 +536,7 @@ export interface DeleteFolderBatchRequest {
  *
  * You can use ListFolder to preview the operation using the `dryRun` parameter.
  *
- * *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won't be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.
+ * *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.
  * @export
  * @interface DeleteFolderRequest
  */
@@ -550,7 +550,7 @@ export interface DeleteFolderRequest {
      */
     deleteFiles?: boolean;
     /**
-     * If `true` then deletes folder settings.
+     * If `true` then deletes virtual folders (virtual folders are folders created using the PutFolder operation).
      *
      * Default: true
      * @type {boolean}
@@ -890,7 +890,7 @@ export interface FileSummary {
  */
 export type FileSummaryTypeEnum = "File";
 /**
- *
+ * Full details of a given folder.
  * @export
  * @interface FolderDetails
  */

package/dist/worker/cjs/main.js

@@ -971,8 +971,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -1045,8 +1045,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.transformationParams !== undefined) {
           query["transformationParams"] = params.transformationParams;
@@ -1206,7 +1206,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolder",
@@ -1232,7 +1232,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1802,12 +1802,12 @@ var UrlBuilder = /*#__PURE__*/function () {
       return this.makeQueryParams({
         cache: null,
         cacheTtl: null,
-        cacheTtlNotFound: null,
+        cacheTtl404: null,
         version: null,
         forceDownloadPrompt: null
       }, {
         cacheTtl: "cache_ttl",
-        cacheTtlNotFound: "cache_ttl_not_found",
+        cacheTtl404: "cache_ttl_404",
         forceDownloadPrompt: "download"
       })(params);
     }

package/dist/worker/esm/main.mjs

@@ -956,8 +956,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -1030,8 +1030,8 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cacheTtl !== undefined) {
           query["cache_ttl"] = params.cacheTtl;
         }
-        if (params.cacheTtlNotFound !== undefined) {
-          query["cache_ttl_not_found"] = params.cacheTtlNotFound;
+        if (params.cacheTtl404 !== undefined) {
+          query["cache_ttl_404"] = params.cacheTtl404;
         }
         if (params.transformationParams !== undefined) {
           query["transformationParams"] = params.transformationParams;
@@ -1191,7 +1191,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes a folder asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolder",
@@ -1217,7 +1217,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *When deleting a folder with external storage:* if the folder at `folderPath` has overridden storage settings (like an AWS S3 bucket), no files will be deleted, regardless of the parameters you pass. Only the mapping will be removed. If the folder at `folderPath` has inherited storage settings but includes subfolders with overridden storage settings, files in those subfolders won\'t be deleted, regardless of the parameters you pass. In summary, files in folders with overridden storage are never deleted, unless you directly delete a subfolder of such a folder.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
+     * Deletes multiple folders asynchronously.  You can use ListFolder to preview the operation using the `dryRun` parameter.  *External storage:* external files are only deleted when you directly delete a file or subfolder of a folder that has external storage configured. If you delete the folder itself, only the mapping is removed.  Requires a `secret_*` API key. Alternatively, you can use a `public_*` API key and JWT-based auth.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1787,12 +1787,12 @@ var UrlBuilder = /*#__PURE__*/function () {
       return this.makeQueryParams({
         cache: null,
         cacheTtl: null,
-        cacheTtlNotFound: null,
+        cacheTtl404: null,
         version: null,
         forceDownloadPrompt: null
       }, {
         cacheTtl: "cache_ttl",
-        cacheTtlNotFound: "cache_ttl_not_found",
+        cacheTtl404: "cache_ttl_404",
         forceDownloadPrompt: "download"
       })(params);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytescale/sdk",
-  "version": "3.43.0",
+  "version": "3.45.0",
   "description": "Bytescale JavaScript SDK",
   "author": "Bytescale <hello@bytescale.com> (https://www.bytescale.com)",
   "license": "MIT",