@bytescale/sdk 3.24.0 → 3.26.0

package/dist/browser/cjs/main.js

@@ -600,6 +600,7 @@ function querystring(params) {
 }
 function querystringSingleKey(key, value) {
   if (value instanceof Object) {
+    // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
   return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
@@ -912,6 +913,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cache !== undefined) {
           query["cache"] = params.cache;
         }
+        if (params.cacheOnly !== undefined) {
+          query["cache_only"] = params.cacheOnly;
+        }
         if (params.cachePerm !== undefined) {
           query["cache_perm"] = params.cachePerm;
         }
@@ -1078,7 +1082,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolder",
@@ -1104,7 +1108,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1656,23 +1660,40 @@ var UrlBuilder = /*#__PURE__*/function () {
   }, {
     key: "getCommonTransformationQueryParams",
     value: function getCommonTransformationQueryParams(trans) {
-      return this.makeQueryParams(["cachePermanently", "artifact"], {
+      return this.makeQueryParams({
+        cacheOnly: null,
+        cachePermanently: null,
+        // Keep this as the last param: this is the convention for transformation URLs (although not required).
+        artifact: null
+      }, {
+        cacheOnly: "cache_only",
         cachePermanently: "cache_perm"
       })(trans);
     }
   }, {
     key: "getCommonQueryParams",
     value: function getCommonQueryParams(params) {
-      return this.makeQueryParams(["cache", "cacheTtl", "version", "forceDownloadPrompt"], {
+      return this.makeQueryParams({
+        cache: null,
+        cacheTtl: null,
+        version: null,
+        forceDownloadPrompt: null
+      }, {
         cacheTtl: "cache_ttl",
         forceDownloadPrompt: "download"
       })(params);
     }
+    /**
+     * Masks the querystring params per the 'keys' array.
+     *
+     * Order sensitive: querystring params will appear per the order of the 'keys' array.
+     */
   }, {
     key: "makeQueryParams",
-    value: function makeQueryParams(keys, keyOverrides) {
+    value: function makeQueryParams(keyPrototype, keyOverrides) {
       return function (data) {
         var result = [];
+        var keys = Object.keys(keyPrototype);
         keys.forEach(function (key) {
           var _a;
           var value = data[key];

package/dist/browser/esm/main.mjs

@@ -585,6 +585,7 @@ function querystring(params) {
 }
 function querystringSingleKey(key, value) {
   if (value instanceof Object) {
+    // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
   return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
@@ -897,6 +898,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cache !== undefined) {
           query["cache"] = params.cache;
         }
+        if (params.cacheOnly !== undefined) {
+          query["cache_only"] = params.cacheOnly;
+        }
         if (params.cachePerm !== undefined) {
           query["cache_perm"] = params.cachePerm;
         }
@@ -1063,7 +1067,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolder",
@@ -1089,7 +1093,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1641,23 +1645,40 @@ var UrlBuilder = /*#__PURE__*/function () {
   }, {
     key: "getCommonTransformationQueryParams",
     value: function getCommonTransformationQueryParams(trans) {
-      return this.makeQueryParams(["cachePermanently", "artifact"], {
+      return this.makeQueryParams({
+        cacheOnly: null,
+        cachePermanently: null,
+        // Keep this as the last param: this is the convention for transformation URLs (although not required).
+        artifact: null
+      }, {
+        cacheOnly: "cache_only",
         cachePermanently: "cache_perm"
       })(trans);
     }
   }, {
     key: "getCommonQueryParams",
     value: function getCommonQueryParams(params) {
-      return this.makeQueryParams(["cache", "cacheTtl", "version", "forceDownloadPrompt"], {
+      return this.makeQueryParams({
+        cache: null,
+        cacheTtl: null,
+        version: null,
+        forceDownloadPrompt: null
+      }, {
         cacheTtl: "cache_ttl",
         forceDownloadPrompt: "download"
       })(params);
     }
+    /**
+     * Masks the querystring params per the 'keys' array.
+     *
+     * Order sensitive: querystring params will appear per the order of the 'keys' array.
+     */
   }, {
     key: "makeQueryParams",
-    value: function makeQueryParams(keys, keyOverrides) {
+    value: function makeQueryParams(keyPrototype, keyOverrides) {
       return function (data) {
         var result = [];
+        var keys = Object.keys(keyPrototype);
         keys.forEach(function (key) {
           var _a;
           var value = data[key];

package/dist/node/cjs/main.js

@@ -600,6 +600,7 @@ function querystring(params) {
 }
 function querystringSingleKey(key, value) {
   if (value instanceof Object) {
+    // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
   return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
@@ -912,6 +913,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cache !== undefined) {
           query["cache"] = params.cache;
         }
+        if (params.cacheOnly !== undefined) {
+          query["cache_only"] = params.cacheOnly;
+        }
         if (params.cachePerm !== undefined) {
           query["cache_perm"] = params.cachePerm;
         }
@@ -1078,7 +1082,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolder",
@@ -1104,7 +1108,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1656,23 +1660,40 @@ var UrlBuilder = /*#__PURE__*/function () {
   }, {
     key: "getCommonTransformationQueryParams",
     value: function getCommonTransformationQueryParams(trans) {
-      return this.makeQueryParams(["cachePermanently", "artifact"], {
+      return this.makeQueryParams({
+        cacheOnly: null,
+        cachePermanently: null,
+        // Keep this as the last param: this is the convention for transformation URLs (although not required).
+        artifact: null
+      }, {
+        cacheOnly: "cache_only",
         cachePermanently: "cache_perm"
       })(trans);
     }
   }, {
     key: "getCommonQueryParams",
     value: function getCommonQueryParams(params) {
-      return this.makeQueryParams(["cache", "cacheTtl", "version", "forceDownloadPrompt"], {
+      return this.makeQueryParams({
+        cache: null,
+        cacheTtl: null,
+        version: null,
+        forceDownloadPrompt: null
+      }, {
         cacheTtl: "cache_ttl",
         forceDownloadPrompt: "download"
       })(params);
     }
+    /**
+     * Masks the querystring params per the 'keys' array.
+     *
+     * Order sensitive: querystring params will appear per the order of the 'keys' array.
+     */
   }, {
     key: "makeQueryParams",
-    value: function makeQueryParams(keys, keyOverrides) {
+    value: function makeQueryParams(keyPrototype, keyOverrides) {
       return function (data) {
         var result = [];
+        var keys = Object.keys(keyPrototype);
         keys.forEach(function (key) {
           var _a;
           var value = data[key];

package/dist/node/esm/main.mjs

@@ -587,6 +587,7 @@ function querystring(params) {
 }
 function querystringSingleKey(key, value) {
   if (value instanceof Object) {
+    // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
   return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
@@ -899,6 +900,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cache !== undefined) {
           query["cache"] = params.cache;
         }
+        if (params.cacheOnly !== undefined) {
+          query["cache_only"] = params.cacheOnly;
+        }
         if (params.cachePerm !== undefined) {
           query["cache_perm"] = params.cachePerm;
         }
@@ -1065,7 +1069,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolder",
@@ -1091,7 +1095,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1643,23 +1647,40 @@ var UrlBuilder = /*#__PURE__*/function () {
   }, {
     key: "getCommonTransformationQueryParams",
     value: function getCommonTransformationQueryParams(trans) {
-      return this.makeQueryParams(["cachePermanently", "artifact"], {
+      return this.makeQueryParams({
+        cacheOnly: null,
+        cachePermanently: null,
+        // Keep this as the last param: this is the convention for transformation URLs (although not required).
+        artifact: null
+      }, {
+        cacheOnly: "cache_only",
         cachePermanently: "cache_perm"
       })(trans);
     }
   }, {
     key: "getCommonQueryParams",
     value: function getCommonQueryParams(params) {
-      return this.makeQueryParams(["cache", "cacheTtl", "version", "forceDownloadPrompt"], {
+      return this.makeQueryParams({
+        cache: null,
+        cacheTtl: null,
+        version: null,
+        forceDownloadPrompt: null
+      }, {
         cacheTtl: "cache_ttl",
         forceDownloadPrompt: "download"
       })(params);
     }
+    /**
+     * Masks the querystring params per the 'keys' array.
+     *
+     * Order sensitive: querystring params will appear per the order of the 'keys' array.
+     */
   }, {
     key: "makeQueryParams",
-    value: function makeQueryParams(keys, keyOverrides) {
+    value: function makeQueryParams(keyPrototype, keyOverrides) {
       return function (data) {
         var result = [];
+        var keys = Object.keys(keyPrototype);
         keys.forEach(function (key) {
           var _a;
           var value = data[key];

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

@@ -25,6 +25,11 @@ export declare class UrlBuilder {
     private static getBaseUrl;
     private static getCommonTransformationQueryParams;
     private static getCommonQueryParams;
+    /**
+     * Masks the querystring params per the 'keys' array.
+     *
+     * Order sensitive: querystring params will appear per the order of the 'keys' array.
+     */
     private static makeQueryParams;
     private static getTransformationParams;
     private static addQueryParams;

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

@@ -23,11 +23,13 @@ export interface UrlBuilderParams {
 export declare type UrlBuilderOptions = UrlBuilderOptionsRaw | UrlBuilderTransformationOptions;
 export declare type UrlBuilderTransformationOptions = UrlBuilderTransformationApiOptions | UrlBuilderOptionsPreset;
 export declare type UrlBuilderTransformationApiOptions = UrlBuilderOptionsImage | UrlBuilderOptionsVideo | UrlBuilderOptionsAudio | UrlBuilderOptionsArchive;
-export interface UrlBuilderOptionsBase {
+export interface UrlBuilderOptionsBase extends NonDeprecatedCommonQueryParams, DeprecatedCommonQueryParams {
     /**
-     * @deprecated This field has no effect: the 'auth' querystring parameter is no-longer required by the Bytescale CDN. You may remove this field from your code.
+     * The base URL of the Bytescale CDN. (Excludes trailing "/".)
      */
-    auth?: boolean;
+    cdnUrl?: string;
+}
+export interface NonDeprecatedCommonQueryParams {
     /**
      * Specifies whether to use caching for this request, or to always re-request the file.
      *
@@ -42,10 +44,6 @@ export interface UrlBuilderOptionsBase {
      * Default: Please refer to your account's default cache settings in the Bytescale Dashboard.
      */
     cacheTtl?: number;
-    /**
-     * The base URL of the Bytescale CDN. (Excludes trailing "/".)
-     */
-    cdnUrl?: string;
     /**
      * Forces the browser to display a download prompt for the file, instead of displaying the file in the browser.
      *
@@ -63,6 +61,12 @@ export interface UrlBuilderOptionsBase {
      */
     version?: string;
 }
+export interface DeprecatedCommonQueryParams {
+    /**
+     * @deprecated This field has no effect: the 'auth' querystring parameter is no-longer required by the Bytescale CDN. You may remove this field from your code.
+     */
+    auth?: boolean;
+}
 export interface UrlBuilderOptionsRaw extends UrlBuilderOptionsBase {
     transformation?: undefined;
 }
@@ -127,7 +131,8 @@ export interface UrlBuilderOptionsTransformationApi<T> extends UrlBuilderOptions
      */
     transformationParams?: T | T[];
 }
-export interface UrlBuilderOptionsTransformation extends UrlBuilderOptionsBase {
+export declare type UrlBuilderOptionsTransformation = UrlBuilderOptionsTransformationOnly & UrlBuilderOptionsBase;
+export interface UrlBuilderOptionsTransformationOnly {
     /**
      * The transformation artifact to download.
      *
@@ -138,6 +143,16 @@ export interface UrlBuilderOptionsTransformation extends UrlBuilderOptionsBase {
      * Default: "/"
      */
     artifact?: string;
+    /**
+     * Only serve transformations from the cache; do not perform new transformations on cache miss.
+     *
+     * If true, then if the transformation result does not exist in the cache, a 404 will be returned. No transformations will be performed.
+     *
+     * If false, then if the transformation result does not exist in the cache, a new transformation will be performed to produce the result.
+     *
+     * Default: false
+     */
+    cacheOnly?: boolean;
     /**
      * Specifies whether to permanently cache the transformed result in the Bytescale CDN.
      *

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

@@ -10,7 +10,8 @@
  * Do not edit the class manually.
  */
 import * as runtime from "../runtime";
-import type { AsyncResponse, CopyFileBatchRequest, CopyFileRequest, CopyFileResponse, DeleteFileBatchRequest, FileDetails, ProcessFileAndSaveRequest, ProcessFileAndSaveResponse, ProcessFileTransformationParamsParameterValue } from "../models";
+import type { AsyncResponse, CopyFileBatchRequest, CopyFileRequest, CopyFileResponse, DeleteFileBatchRequest, FileDetails, ProcessFileAndSaveRequest, ProcessFileAndSaveResponse } from "../models";
+import type { ProcessFileTransformationParamsParameter } from "../models";
 export interface CopyFileOperationParams {
     accountId: string;
     copyFileRequest: CopyFileRequest;
@@ -78,6 +79,16 @@ export interface ProcessFileParams {
      * Default: true
      */
     cache?: boolean;
+    /**
+     * Only serve transformations from the cache; do not perform new transformations on cache miss.
+     *
+     * If `true`, then if the transformation result does not exist in the cache, a 404 will be returned. No transformations will be performed.
+     *
+     * If `false`, then if the transformation result does not exist in the cache, a new transformation will be performed to produce the result.
+     *
+     * Default: `false`
+     */
+    cacheOnly?: boolean;
     /**
      * Specifies whether to cache the transformed result in the Bytescale CDN perma-cache.
      *
@@ -114,9 +125,7 @@ export interface ProcessFileParams {
      * - https://www.bytescale.com/docs/audio-processing-api
      * - https://www.bytescale.com/docs/archive-processing-api
      */
-    transformationParams?: {
-        [key: string]: ProcessFileTransformationParamsParameterValue;
-    };
+    transformationParams?: ProcessFileTransformationParamsParameter;
     /**
      * Add this parameter and increment its value to force the file to be reprocessed.
      *
@@ -149,9 +158,7 @@ export interface ProcessFileAndSaveOperationParams {
      * - https://www.bytescale.com/docs/audio-processing-api
      * - https://www.bytescale.com/docs/archive-processing-api
      */
-    transformationParams?: {
-        [key: string]: ProcessFileTransformationParamsParameterValue;
-    };
+    transformationParams?: ProcessFileTransformationParamsParameter;
 }
 export declare class FileApi extends runtime.BaseAPI {
     /**

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.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
     deleteFolder(params: DeleteFolderOperationParams): Promise<AsyncResponse>;
     /**
-     * Deletes multiple folders asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
     deleteFolderBatch(params: DeleteFolderBatchOperationParams): Promise<AsyncResponse>;
     /**

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

@@ -266,15 +266,10 @@ export interface CopyFolderRequest {
      */
     copyFiles?: boolean;
     /**
-     * If `true` then copies files from folders that have overridden storage settings, else skips them.
      *
-     * If the `source` folder overrides its storage settings, then its files will only be copied if this flag is `true`.
+     * If `false` then if a file's parent folder has overridden storage settings, the file won't be copied.
      *
-     * If the `source` folder inherits its storage settings, then its files will be copied regardless of this flag.
-     *
-     * In all cases, files will only be copied if `copyFiles` is also set to `true`.
-     *
-     * You can ignore this setting if your account does not use folders with overridden storage settings, such as custom AWS S3 buckets.
+     * If you don't use folders with custom storage settings (like AWS S3 buckets), you don't need to worry about this setting.
      *
      * Conditional: `copyVirtualFolders` and `copyOverriddenStorage` cannot both be `true`.
      *
@@ -409,9 +404,9 @@ export interface DeleteFolderBatchRequest {
 /**
  * Request body for DeleteFolder.
  *
- * If the folder has overridden storage settings, then no files will be deleted.
- *
  * 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.
  * @export
  * @interface DeleteFolderRequest
  */
@@ -1591,11 +1586,21 @@ export interface ProcessFileAndSaveResponseSync {
  */
 export declare type ProcessFileAndSaveResponseSyncAsyncEnum = false;
 /**
- * @type ProcessFileTransformationParamsParameterValue
+ * @type ProcessFileTransformationParamsParameter
+ *
+ * @export
+ */
+export declare type ProcessFileTransformationParamsParameter = Array<{
+    [key: string]: ProcessFileTransformationParamsParameterOneOfValue;
+}> | {
+    [key: string]: ProcessFileTransformationParamsParameterOneOfValue;
+};
+/**
+ * @type ProcessFileTransformationParamsParameterOneOfValue
  *
  * @export
  */
-export declare type ProcessFileTransformationParamsParameterValue = boolean | number | string;
+export declare type ProcessFileTransformationParamsParameterOneOfValue = boolean | number | string;
 /**
  * Permissions applied to anonymous users who attempt to download files from a folder.
  *

package/dist/worker/cjs/main.js

@@ -600,6 +600,7 @@ function querystring(params) {
 }
 function querystringSingleKey(key, value) {
   if (value instanceof Object) {
+    // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
   return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
@@ -912,6 +913,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cache !== undefined) {
           query["cache"] = params.cache;
         }
+        if (params.cacheOnly !== undefined) {
+          query["cache_only"] = params.cacheOnly;
+        }
         if (params.cachePerm !== undefined) {
           query["cache_perm"] = params.cachePerm;
         }
@@ -1078,7 +1082,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolder",
@@ -1104,7 +1108,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1656,23 +1660,40 @@ var UrlBuilder = /*#__PURE__*/function () {
   }, {
     key: "getCommonTransformationQueryParams",
     value: function getCommonTransformationQueryParams(trans) {
-      return this.makeQueryParams(["cachePermanently", "artifact"], {
+      return this.makeQueryParams({
+        cacheOnly: null,
+        cachePermanently: null,
+        // Keep this as the last param: this is the convention for transformation URLs (although not required).
+        artifact: null
+      }, {
+        cacheOnly: "cache_only",
         cachePermanently: "cache_perm"
       })(trans);
     }
   }, {
     key: "getCommonQueryParams",
     value: function getCommonQueryParams(params) {
-      return this.makeQueryParams(["cache", "cacheTtl", "version", "forceDownloadPrompt"], {
+      return this.makeQueryParams({
+        cache: null,
+        cacheTtl: null,
+        version: null,
+        forceDownloadPrompt: null
+      }, {
         cacheTtl: "cache_ttl",
         forceDownloadPrompt: "download"
       })(params);
     }
+    /**
+     * Masks the querystring params per the 'keys' array.
+     *
+     * Order sensitive: querystring params will appear per the order of the 'keys' array.
+     */
   }, {
     key: "makeQueryParams",
-    value: function makeQueryParams(keys, keyOverrides) {
+    value: function makeQueryParams(keyPrototype, keyOverrides) {
       return function (data) {
         var result = [];
+        var keys = Object.keys(keyPrototype);
         keys.forEach(function (key) {
           var _a;
           var value = data[key];

package/dist/worker/esm/main.mjs

@@ -585,6 +585,7 @@ function querystring(params) {
 }
 function querystringSingleKey(key, value) {
   if (value instanceof Object) {
+    // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
   return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
@@ -897,6 +898,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         if (params.cache !== undefined) {
           query["cache"] = params.cache;
         }
+        if (params.cacheOnly !== undefined) {
+          query["cache_only"] = params.cacheOnly;
+        }
         if (params.cachePerm !== undefined) {
           query["cache_perm"] = params.cachePerm;
         }
@@ -1063,7 +1067,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes a folder asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolder",
@@ -1089,7 +1093,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       }
     }
     /**
-     * Deletes multiple folders asynchronously.  If the folder has overridden storage settings, then no files will be deleted.  You can use ListFolder to preview the operation using the `dryRun` parameter.  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.  *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.
      */
   }, {
     key: "deleteFolderBatch",
@@ -1641,23 +1645,40 @@ var UrlBuilder = /*#__PURE__*/function () {
   }, {
     key: "getCommonTransformationQueryParams",
     value: function getCommonTransformationQueryParams(trans) {
-      return this.makeQueryParams(["cachePermanently", "artifact"], {
+      return this.makeQueryParams({
+        cacheOnly: null,
+        cachePermanently: null,
+        // Keep this as the last param: this is the convention for transformation URLs (although not required).
+        artifact: null
+      }, {
+        cacheOnly: "cache_only",
         cachePermanently: "cache_perm"
       })(trans);
     }
   }, {
     key: "getCommonQueryParams",
     value: function getCommonQueryParams(params) {
-      return this.makeQueryParams(["cache", "cacheTtl", "version", "forceDownloadPrompt"], {
+      return this.makeQueryParams({
+        cache: null,
+        cacheTtl: null,
+        version: null,
+        forceDownloadPrompt: null
+      }, {
         cacheTtl: "cache_ttl",
         forceDownloadPrompt: "download"
       })(params);
     }
+    /**
+     * Masks the querystring params per the 'keys' array.
+     *
+     * Order sensitive: querystring params will appear per the order of the 'keys' array.
+     */
   }, {
     key: "makeQueryParams",
-    value: function makeQueryParams(keys, keyOverrides) {
+    value: function makeQueryParams(keyPrototype, keyOverrides) {
       return function (data) {
         var result = [];
+        var keys = Object.keys(keyPrototype);
         keys.forEach(function (key) {
           var _a;
           var value = data[key];

package/package.json

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