@bytescale/sdk 3.50.0 → 3.52.0

package/dist/node/esm/main.mjs

@@ -274,6 +274,29 @@ var ConsoleUtils = /*#__PURE__*/function () {
     }
   }]);
 }();
+;// CONCATENATED MODULE: ./src/private/FilePathUtils.ts
+function FilePathUtils_typeof(o) { "@babel/helpers - typeof"; return FilePathUtils_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, FilePathUtils_typeof(o); }
+function FilePathUtils_classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function FilePathUtils_defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, FilePathUtils_toPropertyKey(descriptor.key), descriptor); } }
+function FilePathUtils_createClass(Constructor, protoProps, staticProps) { if (protoProps) FilePathUtils_defineProperties(Constructor.prototype, protoProps); if (staticProps) FilePathUtils_defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function FilePathUtils_toPropertyKey(t) { var i = FilePathUtils_toPrimitive(t, "string"); return "symbol" == FilePathUtils_typeof(i) ? i : i + ""; }
+function FilePathUtils_toPrimitive(t, r) { if ("object" != FilePathUtils_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != FilePathUtils_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+var FilePathUtils = /*#__PURE__*/function () {
+  function FilePathUtils() {
+    FilePathUtils_classCallCheck(this, FilePathUtils);
+  }
+  return FilePathUtils_createClass(FilePathUtils, null, [{
+    key: "encodeFilePath",
+    value: function encodeFilePath(filePath) {
+      // To convert a Bytescale File Path into a Bytescale File URL:
+      // a) Call encodeURIComponent() on the file path. (This allows file paths to contain ANY character.)
+      // b) Replace all occurrences of "%2F" with "/". (Allows file paths to appear as hierarchical paths on the URL.)
+      // c) Replace all occurrences of "!" with "%21". (Prevents file paths with "!" inside being treated as "query bangs".)
+      // SYNC: FileUrlUtils.makeFileUrl (internal)
+      return encodeURIComponent(filePath).replace(/%2F/g, "/").replace(/!/g, "%21");
+    }
+  }]);
+}();
 ;// CONCATENATED MODULE: ./src/public/shared/generated/runtime.ts
 function runtime_await(value, then, direct) {
   if (direct) {
@@ -331,6 +354,7 @@ function runtime_toPropertyKey(t) { var i = runtime_toPrimitive(t, "string"); re
 function runtime_toPrimitive(t, r) { if ("object" != runtime_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != runtime_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 
 
+
 var BytescaleApiClientConfigUtils = /*#__PURE__*/function () {
   function BytescaleApiClientConfigUtils() {
     runtime_classCallCheck(this, BytescaleApiClientConfigUtils);
@@ -433,15 +457,14 @@ var BaseAPI = /*#__PURE__*/function () {
       }
     }
   }, {
-    key: "encodeParam",
-    value: function encodeParam(paramName, paramValue) {
+    key: "encodePathParam",
+    value: function encodePathParam(paramName, paramValue) {
       if (paramName === "filePath") {
         if (!paramValue.startsWith("/")) {
           // Non-obvious errors are returned by the Bytescale CDN if forward slashes are omitted, so catch it client-side:
           throw new Error("The 'filePath' parameter must begin with a '/' character.");
         }
-        // We must not encode the filePath param (as slashes are valid).
-        return paramValue;
+        return FilePathUtils.encodeFilePath(paramValue);
       }
       return encodeURIComponent(paramValue);
     }
@@ -783,7 +806,7 @@ var CacheApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return CacheApi_await(_this.request({
           path: "/v2/accounts/{accountId}/cache/reset".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this.encodeParam("accountId", params.accountId)),
+          _this.encodePathParam("accountId", params.accountId)),
           method: "POST",
           headers: headers,
           query: query,
@@ -856,7 +879,7 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FileApi_await(_this.request({
           path: "/v2/accounts/{accountId}/files/copy".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this.encodeParam("accountId", params.accountId)),
+          _this.encodePathParam("accountId", params.accountId)),
           method: "POST",
           headers: headers,
           query: query,
@@ -882,7 +905,7 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FileApi_await(_this2.request({
           path: "/v2/accounts/{accountId}/files/copy/batch".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this2.encodeParam("accountId", params.accountId)),
+          _this2.encodePathParam("accountId", params.accountId)),
           method: "POST",
           headers: headers,
           query: query,
@@ -910,7 +933,7 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FileApi_await(_this3.request({
           path: "/v2/accounts/{accountId}/files".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this3.encodeParam("accountId", params.accountId)),
+          _this3.encodePathParam("accountId", params.accountId)),
           method: "DELETE",
           headers: headers,
           query: query
@@ -935,7 +958,7 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FileApi_await(_this4.request({
           path: "/v2/accounts/{accountId}/files/batch".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this4.encodeParam("accountId", params.accountId)),
+          _this4.encodePathParam("accountId", params.accountId)),
           method: "DELETE",
           headers: headers,
           query: query,
@@ -960,10 +983,13 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
           query["cache"] = params.cache;
         }
         if (params.cacheTtl !== undefined) {
-          query["cache_ttl"] = params.cacheTtl;
+          query["cache-ttl"] = params.cacheTtl;
         }
         if (params.cacheTtl404 !== undefined) {
-          query["cache_ttl_404"] = params.cacheTtl404;
+          query["cache-ttl-404"] = params.cacheTtl404;
+        }
+        if (params.exp !== undefined) {
+          query["exp"] = params.exp;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -972,9 +998,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FileApi_await(_this5.request({
           path: "/{accountId}/raw{filePath}".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this5.encodeParam("accountId", params.accountId)).replace("{".concat("filePath", "}"),
+          _this5.encodePathParam("accountId", params.accountId)).replace("{".concat("filePath", "}"),
           // @ts-ignore
-          _this5.encodeParam("filePath", params.filePath)),
+          _this5.encodePathParam("filePath", params.filePath)),
           method: "GET",
           headers: headers,
           query: query
@@ -1001,7 +1027,7 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FileApi_await(_this6.request({
           path: "/v2/accounts/{accountId}/files/details".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this6.encodeParam("accountId", params.accountId)),
+          _this6.encodePathParam("accountId", params.accountId)),
           method: "GET",
           headers: headers,
           query: query
@@ -1021,6 +1047,9 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
       try {
         var _this7 = this;
         var query = {};
+        if (params.transformationParams !== undefined) {
+          query["&lt;transformation-params&gt;"] = params.transformationParams;
+        }
         if (params.artifact !== undefined) {
           query["artifact"] = params.artifact;
         }
@@ -1028,19 +1057,19 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
           query["cache"] = params.cache;
         }
         if (params.cacheOnly !== undefined) {
-          query["cache_only"] = params.cacheOnly;
+          query["cache-only"] = params.cacheOnly;
         }
         if (params.cachePerm !== undefined) {
-          query["cache_perm"] = params.cachePerm;
+          query["cache-perm"] = params.cachePerm;
         }
         if (params.cacheTtl !== undefined) {
-          query["cache_ttl"] = params.cacheTtl;
+          query["cache-ttl"] = params.cacheTtl;
         }
         if (params.cacheTtl404 !== undefined) {
-          query["cache_ttl_404"] = params.cacheTtl404;
+          query["cache-ttl-404"] = params.cacheTtl404;
         }
-        if (params.transformationParams !== undefined) {
-          query["transformationParams"] = params.transformationParams;
+        if (params.exp !== undefined) {
+          query["exp"] = params.exp;
         }
         if (params.version !== undefined) {
           query["version"] = params.version;
@@ -1049,11 +1078,11 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FileApi_await(_this7.request({
           path: "/{accountId}/{transformation}{filePath}".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this7.encodeParam("accountId", params.accountId)).replace("{".concat("filePath", "}"),
+          _this7.encodePathParam("accountId", params.accountId)).replace("{".concat("filePath", "}"),
           // @ts-ignore
-          _this7.encodeParam("filePath", params.filePath)).replace("{".concat("transformation", "}"),
+          _this7.encodePathParam("filePath", params.filePath)).replace("{".concat("transformation", "}"),
           // @ts-ignore
-          _this7.encodeParam("transformation", params.transformation)),
+          _this7.encodePathParam("transformation", params.transformation)),
           method: "GET",
           headers: headers,
           query: query
@@ -1074,18 +1103,18 @@ var FileApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         var _this8 = this;
         var query = {};
         if (params.transformationParams !== undefined) {
-          query["transformationParams"] = params.transformationParams;
+          query["&lt;transformation-params&gt;"] = params.transformationParams;
         }
         var headers = {};
         headers["Content-Type"] = "application/json";
         return FileApi_await(_this8.request({
           path: "/{accountId}/save/{transformation}{filePath}".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this8.encodeParam("accountId", params.accountId)).replace("{".concat("filePath", "}"),
+          _this8.encodePathParam("accountId", params.accountId)).replace("{".concat("filePath", "}"),
           // @ts-ignore
-          _this8.encodeParam("filePath", params.filePath)).replace("{".concat("transformation", "}"),
+          _this8.encodePathParam("filePath", params.filePath)).replace("{".concat("transformation", "}"),
           // @ts-ignore
-          _this8.encodeParam("transformation", params.transformation)),
+          _this8.encodePathParam("transformation", params.transformation)),
           method: "POST",
           headers: headers,
           query: query,
@@ -1158,7 +1187,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FolderApi_await(_this.request({
           path: "/v2/accounts/{accountId}/folders/copy".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this.encodeParam("accountId", params.accountId)),
+          _this.encodePathParam("accountId", params.accountId)),
           method: "POST",
           headers: headers,
           query: query,
@@ -1184,7 +1213,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FolderApi_await(_this2.request({
           path: "/v2/accounts/{accountId}/folders/copy/batch".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this2.encodeParam("accountId", params.accountId)),
+          _this2.encodePathParam("accountId", params.accountId)),
           method: "POST",
           headers: headers,
           query: query,
@@ -1210,7 +1239,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FolderApi_await(_this3.request({
           path: "/v2/accounts/{accountId}/folders".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this3.encodeParam("accountId", params.accountId)),
+          _this3.encodePathParam("accountId", params.accountId)),
           method: "DELETE",
           headers: headers,
           query: query,
@@ -1236,7 +1265,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FolderApi_await(_this4.request({
           path: "/v2/accounts/{accountId}/folders/batch".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this4.encodeParam("accountId", params.accountId)),
+          _this4.encodePathParam("accountId", params.accountId)),
           method: "DELETE",
           headers: headers,
           query: query,
@@ -1264,7 +1293,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FolderApi_await(_this5.request({
           path: "/v2/accounts/{accountId}/folders".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this5.encodeParam("accountId", params.accountId)),
+          _this5.encodePathParam("accountId", params.accountId)),
           method: "GET",
           headers: headers,
           query: query
@@ -1315,7 +1344,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FolderApi_await(_this6.request({
           path: "/v2/accounts/{accountId}/folders/list".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this6.encodeParam("accountId", params.accountId)),
+          _this6.encodePathParam("accountId", params.accountId)),
           method: "GET",
           headers: headers,
           query: query
@@ -1340,7 +1369,7 @@ var FolderApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return FolderApi_await(_this7.request({
           path: "/v2/accounts/{accountId}/folders".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this7.encodeParam("accountId", params.accountId)),
+          _this7.encodePathParam("accountId", params.accountId)),
           method: "PUT",
           headers: headers,
           query: query,
@@ -1412,11 +1441,11 @@ var JobApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return JobApi_await(_this.request({
           path: "/v2/accounts/{accountId}/jobs/{jobType}/{jobId}".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this.encodeParam("accountId", params.accountId)).replace("{".concat("jobId", "}"),
+          _this.encodePathParam("accountId", params.accountId)).replace("{".concat("jobId", "}"),
           // @ts-ignore
-          _this.encodeParam("jobId", params.jobId)).replace("{".concat("jobType", "}"),
+          _this.encodePathParam("jobId", params.jobId)).replace("{".concat("jobType", "}"),
           // @ts-ignore
-          _this.encodeParam("jobType", params.jobType)),
+          _this.encodePathParam("jobType", params.jobType)),
           method: "DELETE",
           headers: headers,
           query: query
@@ -1440,11 +1469,11 @@ var JobApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return JobApi_await(_this2.request({
           path: "/v2/accounts/{accountId}/jobs/{jobType}/{jobId}".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this2.encodeParam("accountId", params.accountId)).replace("{".concat("jobId", "}"),
+          _this2.encodePathParam("accountId", params.accountId)).replace("{".concat("jobId", "}"),
           // @ts-ignore
-          _this2.encodeParam("jobId", params.jobId)).replace("{".concat("jobType", "}"),
+          _this2.encodePathParam("jobId", params.jobId)).replace("{".concat("jobType", "}"),
           // @ts-ignore
-          _this2.encodeParam("jobType", params.jobType)),
+          _this2.encodePathParam("jobType", params.jobType)),
           method: "GET",
           headers: headers,
           query: query
@@ -1471,7 +1500,7 @@ var JobApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return JobApi_await(_this3.request({
           path: "/v2/accounts/{accountId}/jobs".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this3.encodeParam("accountId", params.accountId)),
+          _this3.encodePathParam("accountId", params.accountId)),
           method: "GET",
           headers: headers,
           query: query
@@ -1543,7 +1572,7 @@ var UploadApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return UploadApi_await(_this.request({
           path: "/v2/accounts/{accountId}/uploads".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this.encodeParam("accountId", params.accountId)),
+          _this.encodePathParam("accountId", params.accountId)),
           method: "POST",
           headers: headers,
           query: query,
@@ -1569,11 +1598,11 @@ var UploadApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return UploadApi_await(_this2.request({
           path: "/v2/accounts/{accountId}/uploads/{uploadId}/parts/{uploadPartIndex}".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this2.encodeParam("accountId", params.accountId)).replace("{".concat("uploadId", "}"),
+          _this2.encodePathParam("accountId", params.accountId)).replace("{".concat("uploadId", "}"),
           // @ts-ignore
-          _this2.encodeParam("uploadId", params.uploadId)).replace("{".concat("uploadPartIndex", "}"),
+          _this2.encodePathParam("uploadId", params.uploadId)).replace("{".concat("uploadPartIndex", "}"),
           // @ts-ignore
-          _this2.encodeParam("uploadPartIndex", params.uploadPartIndex)),
+          _this2.encodePathParam("uploadPartIndex", params.uploadPartIndex)),
           method: "PUT",
           headers: headers,
           query: query,
@@ -1598,11 +1627,11 @@ var UploadApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return UploadApi_await(_this3.request({
           path: "/v2/accounts/{accountId}/uploads/{uploadId}/parts/{uploadPartIndex}".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this3.encodeParam("accountId", params.accountId)).replace("{".concat("uploadId", "}"),
+          _this3.encodePathParam("accountId", params.accountId)).replace("{".concat("uploadId", "}"),
           // @ts-ignore
-          _this3.encodeParam("uploadId", params.uploadId)).replace("{".concat("uploadPartIndex", "}"),
+          _this3.encodePathParam("uploadId", params.uploadId)).replace("{".concat("uploadPartIndex", "}"),
           // @ts-ignore
-          _this3.encodeParam("uploadPartIndex", params.uploadPartIndex)),
+          _this3.encodePathParam("uploadPartIndex", params.uploadPartIndex)),
           method: "GET",
           headers: headers,
           query: query
@@ -1626,9 +1655,9 @@ var UploadApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return UploadApi_await(_this4.request({
           path: "/v2/accounts/{accountId}/uploads/{uploadId}/parts".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this4.encodeParam("accountId", params.accountId)).replace("{".concat("uploadId", "}"),
+          _this4.encodePathParam("accountId", params.accountId)).replace("{".concat("uploadId", "}"),
           // @ts-ignore
-          _this4.encodeParam("uploadId", params.uploadId)),
+          _this4.encodePathParam("uploadId", params.uploadId)),
           method: "GET",
           headers: headers,
           query: query
@@ -1653,7 +1682,7 @@ var UploadApi = /*#__PURE__*/function (_runtime$BaseAPI) {
         return UploadApi_await(_this5.request({
           path: "/v2/accounts/{accountId}/uploads/url".replace("{".concat("accountId", "}"),
           // @ts-ignore
-          _this5.encodeParam("accountId", params.accountId)),
+          _this5.encodePathParam("accountId", params.accountId)),
           method: "POST",
           headers: headers,
           query: query,
@@ -1712,6 +1741,7 @@ function UrlBuilder_toPropertyKey(t) { var i = UrlBuilder_toPrimitive(t, "string
 function UrlBuilder_toPrimitive(t, r) { if ("object" != UrlBuilder_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != UrlBuilder_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 
 
+
 var UrlBuilder = /*#__PURE__*/function () {
   function UrlBuilder() {
     UrlBuilder_classCallCheck(this, UrlBuilder);
@@ -1766,11 +1796,7 @@ var UrlBuilder = /*#__PURE__*/function () {
     value: function getBaseUrl(params, prefix) {
       var _a, _b;
       var cdnUrl = (_b = (_a = params.options) === null || _a === void 0 ? void 0 : _a.cdnUrl) !== null && _b !== void 0 ? _b : BytescaleApiClientConfigUtils.defaultCdnUrl;
-      // To convert a Bytescale File Path into a Bytescale File URL:
-      // a) Call encodeURIComponent() on the file path. (This allows file paths to contain ANY character.)
-      // b) Replace all occurrences of "%2F" with "/". (Allows file paths to appear as hierarchical paths on the URL.)
-      // c) Replace all occurrences of "!" with "%21". (Prevents file paths with "!" inside being treated as "query bangs".)
-      var filePathEncoded = encodeURIComponent(params.filePath).replace(/%2F/g, "/").replace(/!/g, "%21");
+      var filePathEncoded = FilePathUtils.encodeFilePath(params.filePath);
       return "".concat(cdnUrl, "/").concat(params.accountId, "/").concat(prefix).concat(filePathEncoded);
     }
   }, {

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

@@ -0,0 +1,3 @@
+export declare class FilePathUtils {
+    static encodeFilePath(filePath: string): string;
+}

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

@@ -49,6 +49,16 @@ export interface DownloadFileParams {
      * Default: Please refer to your account's default cache settings in the Bytescale Dashboard.
      */
     cacheTtl404?: number;
+    /**
+     * Expires the URL at the given Unix epoch timestamp.
+     *
+     * The value can be provided in either milliseconds or seconds since January 1, 1970, 00:00:00 UTC.
+     *
+     * Must less than 7 days in the future.
+     *
+     * See: Secure URLs
+     */
+    exp?: number;
     /**
      * Downloads the latest version of your file (if you have overwritten it) when added to the URL with a unique value.
      *
@@ -69,6 +79,18 @@ export interface ProcessFileParams {
      * The name of the File Processing API (e.g. `image`, `video`, `audio`) or transformation preset (created in the Bytescale Dashboard) to use when processing the file.
      */
     transformation: string;
+    /**
+     * Each File Processing API requires additional query string parameters to specify the desired transformation behavior.
+     *
+     * For details, refer to the relevant documentation:
+     *
+     * - https://www.bytescale.com/docs/image-processing-api
+     * - https://www.bytescale.com/docs/video-processing-api
+     * - https://www.bytescale.com/docs/audio-processing-api
+     * - https://www.bytescale.com/docs/archive-processing-api
+     * - https://www.bytescale.com/docs/antivirus-api
+     */
+    transformationParams?: TransformationParams;
     /**
      * Some transformations output multiple files, called artifacts.
      *
@@ -80,7 +102,7 @@ export interface ProcessFileParams {
      *
      * If set to `false` the transformation will be executed on every request.
      *
-     * *Recommendation:* instead of disabling the cache, a more performant solution is to use the `version` parameter and to increment it each time you require an updated result.
+     * *Recommendation:* instead of disabling the cache, a more performant solution is to use the `version` or `v` parameter and to increment it each time you require an updated result.
      *
      * Default: true
      */
@@ -102,7 +124,7 @@ export interface ProcessFileParams {
      *
      * When `cache=false` this parameter is automatically set to `false`.
      *
-     * When `cache_perm=auto` the perma-cache will only be used for files that take more than 1000ms to process.
+     * When `cache-perm=auto` the perma-cache will only be used for files that take more than 500ms to process.
      *
      * When the perma-cache is used, approximately 200ms of latency is added to the initial request. Thereafter, files will be served from the Bytescale CDN's edge cache or perma-cache, so will have minimal latency.
      *
@@ -116,7 +138,7 @@ export interface ProcessFileParams {
      *
      * If the file is not perma-cached, then the file will be reprocessed on edge cache misses.
      *
-     * For more information on perma-caching, see: `cache_perm`
+     * For more information on perma-caching, see: `cache-perm`
      *
      * Default: Please refer to your account's default cache settings in the Bytescale Dashboard.
      */
@@ -128,16 +150,15 @@ export interface ProcessFileParams {
      */
     cacheTtl404?: number;
     /**
-     * Parameters to submit to the File Processing API (e.g. the Image Processing API).
+     * Expires the URL at the given Unix epoch timestamp.
      *
-     * Please see the documentation for each File Processing API to determine which values can appear here:
+     * The value can be provided in either milliseconds or seconds since January 1, 1970, 00:00:00 UTC.
      *
-     * - https://www.bytescale.com/docs/image-processing-api
-     * - https://www.bytescale.com/docs/video-processing-api
-     * - https://www.bytescale.com/docs/audio-processing-api
-     * - https://www.bytescale.com/docs/archive-processing-api
+     * Must less than 7 days in the future.
+     *
+     * See: Secure URLs
      */
-    transformationParams?: TransformationParams;
+    exp?: number;
     /**
      * Add this parameter and increment its value to force the file to be reprocessed.
      *
@@ -161,14 +182,15 @@ export interface ProcessFileAndSaveOperationParams {
      */
     processFileAndSaveRequest: ProcessFileAndSaveRequest;
     /**
-     * Parameters to submit to the File Processing API (e.g. the Image Processing API).
+     * Each File Processing API requires additional query string parameters to specify the desired transformation behavior.
      *
-     * Please see the documentation for each File Processing API to determine which values can appear here:
+     * For details, refer to the relevant documentation:
      *
      * - https://www.bytescale.com/docs/image-processing-api
      * - https://www.bytescale.com/docs/video-processing-api
      * - https://www.bytescale.com/docs/audio-processing-api
      * - https://www.bytescale.com/docs/archive-processing-api
+     * - https://www.bytescale.com/docs/antivirus-api
      */
     transformationParams?: TransformationParams;
 }

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

@@ -2387,6 +2387,12 @@ export interface WebStorage {
      * @memberof WebStorage
      */
     baseUrl?: string;
+    /**
+     *
+     * @type {WebStorageQueryStringForwarding}
+     * @memberof WebStorage
+     */
+    queryStringForwarding?: WebStorageQueryStringForwarding;
     /**
      * The type of this storage layer.
      * @type {string}
@@ -2398,6 +2404,55 @@ export interface WebStorage {
  * @export
  */
 export type WebStorageTypeEnum = "Web";
+/**
+ * This object is used for the value of the `queryStringForwarding` field on the `WebStorage` object, and defines how user-provided query strings are forwarded to the HTTP origin. If left unset, no user-provided query strings will be forwarded to the HTTP origin.
+ *
+ * *Instructions:*
+ * - To *block all* query string parameters: use `"Whitelist"` with an empty `parameters` array (default if unset).
+ * - To *allow all* query string parameters: use `"Blacklist"` with an empty `parameters` array.
+ * - To *allow some* query string parameters: use either `"Blacklist"` or `"Whitelist"` with one or more `parameters`.
+ * @export
+ * @interface WebStorageQueryStringForwarding
+ */
+export interface WebStorageQueryStringForwarding {
+    /**
+     * Determines which parameters to forward based on the `type` field:
+     *
+     * If `"Whitelist"` is set in the `type` field:
+     * - Only parameters in this array will be forwarded.
+     * - An empty array prevents all parameters from being forwarded.
+     *
+     * If `"Blacklist"` is set in the `type` field:
+     * - Only parameters in this array will be blocked.
+     * - An empty array allows all parameters to be forwarded.
+     * @type {Array<WebStorageQueryStringParam>}
+     * @memberof WebStorageQueryStringForwarding
+     */
+    parameters: Array<WebStorageQueryStringParam>;
+    /**
+     * Determines whether the `parameters` array is interpreted as a blacklist or a whitelist.
+     * @type {string}
+     * @memberof WebStorageQueryStringForwarding
+     */
+    type: WebStorageQueryStringForwardingTypeEnum;
+}
+/**
+ * @export
+ */
+export type WebStorageQueryStringForwardingTypeEnum = "Whitelist" | "Blacklist";
+/**
+ * Matches exactly one query string parameter. The value of the `name` field must be URL encoded.
+ * @export
+ * @interface WebStorageQueryStringParam
+ */
+export interface WebStorageQueryStringParam {
+    /**
+     * Query string parameter name. Must be URL-encoded.
+     * @type {string}
+     * @memberof WebStorageQueryStringParam
+     */
+    name: string;
+}
 /**
  *
  * @export

package/dist/types/public/shared/generated/runtime.d.ts

@@ -67,7 +67,7 @@ export declare class BaseAPI {
         isBytescaleApi: boolean;
     }): Promise<Response>;
     protected request(context: RequestOpts, initOverrides: RequestInit | InitOverrideFunction | undefined, baseUrlOverride: string | undefined): Promise<Response>;
-    protected encodeParam(paramName: string, paramValue: string): string;
+    protected encodePathParam(paramName: string, paramValue: string): string;
     private createFetchParams;
 }
 export declare class CancelledError extends Error {