@bytescale/sdk - npm Package Compare versions

Comparing version 3.30.0 to 3.31.0

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

@@ -14,3 +14,3 @@ /**
 import type { AsyncResponse, CopyFileBatchRequest, CopyFileRequest, CopyFileResponse, DeleteFileBatchRequest, FileDetails, ProcessFileAndSaveRequest, ProcessFileAndSaveResponse } from "../models";
-import type { ProcessFileTransformationParamsParameter } from "../models";
+import type { TransformationParams } from "../models";
 export interface CopyFileOperationParams {
@@ -129,3 +129,3 @@ accountId: string;
      */
-    transformationParams?: ProcessFileTransformationParamsParameter;
+    transformationParams?: TransformationParams;
     /**
@@ -163,3 +163,3 @@ * Add this parameter and increment its value to force the file to be reprocessed.
      */
-    transformationParams?: ProcessFileTransformationParamsParameter;
+    transformationParams?: TransformationParams;
 }
@@ -166,0 +166,0 @@ export declare class FileApi extends runtime.BaseAPI {

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

@@ -1427,2 +1427,8 @@ /**
      *
+     * @type {TransformationParams}
+     * @memberof ProcessFileAndSaveRequest
+     */
+    extendedParams?: TransformationParams;
+    /**
+     *
      * @type {CopyableFileDataFileMetadata}
@@ -1590,18 +1596,2 @@ * @memberof ProcessFileAndSaveRequest
 /**
- * @type ProcessFileTransformationParamsParameter
- *
- * @export
- */
-export declare type ProcessFileTransformationParamsParameter = Array<{
-    [key: string]: ProcessFileTransformationParamsParameterOneOfValue;
-}> | {
-    [key: string]: ProcessFileTransformationParamsParameterOneOfValue;
-};
-/**
- * @type ProcessFileTransformationParamsParameterOneOfValue
- *
- * @export
- */
-export declare type ProcessFileTransformationParamsParameterOneOfValue = boolean | number | string;
-/**
  * Permissions applied to anonymous users who attempt to download files from a folder.
@@ -1887,2 +1877,46 @@ *
 /**
+ * @type TransformationParamValue
+ * A single transformation parameter provided to a Bytescale File Processing API.
+ *
+ * See TransformationParams for more information.
+ * @export
+ */
+export declare type TransformationParamValue = boolean | number | string;
+/**
+ * @type TransformationParams
+ * Transformation parameters provided to a Bytescale File Processing API.
+ *
+ * *Array support:*
+ *
+ * Arrays are specified by repeating the same parameter name multiple times on the querystring.
+ *
+ * For example, the following querystring declares a `file` parameter as an array containing two values (`/file1.txt` and `/file2.txt`):
+ *
+ * ```?file=/file1.txt&file=/file2.txt```
+ *
+ * The Bytescale SDKs and the ProcessFileAndSave request body (the `extendedParams` field) also support arrays of transformation parameters. These are specified by providing an array of objects as the field value instead of an object, for example:
+ *
+ * ```transformationParams: [{ file: "/file1.txt" }, { file: "/file2.txt" }]```
+ *
+ * This structure allows parameter groups to be retained, which is important for certain transformations. For example, the Video Processing API allows developers to specify multiple clusters of `w`, `h` and `q` parameters when specifying the Adaptive Bitrate (ABR) variants in an HTTP Live Streaming (HLS) output video.
+ *
+ * *Parameters are order sensitive:*
+ *
+ * The order of the parameters may be important. Please refer to the documentation of each File Processing API for more information.
+ *
+ * *Maximum URL length:*
+ *
+ * Bytescale URLs have a maximum total length of 1000 bytes (excluding the hostname and protocol).
+ *
+ * To provide a longer list of parameters to a Bytescale File Processing API, you must use ProcessFileAndSave (POST) instead of ProcessFile (GET). This allows you to specify parameters via the ProcessFileAndSave HTTP request body (via the `extendedParams` field) instead of via the querystring.
+ *
+ * The `extendedParams` field supports up to 400KB of transformation parameter data.
+ * @export
+ */
+export declare type TransformationParams = Array<{
+    [key: string]: TransformationParamValue;
+}> | {
+    [key: string]: TransformationParamValue;
+};
+/**
  * This data type specifies no update is to be performed.
@@ -1889,0 +1923,0 @@ * @export

package.json

 {
   "name": "@bytescale/sdk",
-  "version": "3.30.0",
+  "version": "3.31.0",
   "description": "Bytescale JavaScript SDK",
@@ -5,0 +5,0 @@ "author": "Bytescale <[e-mail]> (https://www.bytescale.com)",

No alert changes

Improved metrics

Total package byte prevSize

1062224

increased by0.17%

Lines of code

21594

increased by0.16%

No dependency changes