@bytescale/sdk 3.27.0 → 3.29.0

package/dist/browser/cjs/main.js

@@ -44,6 +44,7 @@ __lib_require__.d(__lib_exports__, {
   "BinaryResult": function() { return /* reexport */ BinaryResult; },
   "BytescaleApiClientConfigUtils": function() { return /* reexport */ BytescaleApiClientConfigUtils; },
   "BytescaleApiError": function() { return /* reexport */ BytescaleApiError; },
+  "BytescaleGenericError": function() { return /* reexport */ BytescaleGenericError; },
   "CancelledError": function() { return /* reexport */ CancelledError; },
   "CommonTypesNoOp": function() { return /* reexport */ CommonTypesNoOp; },
   "FileApi": function() { return /* reexport */ FileApi; },
@@ -55,6 +56,7 @@ __lib_require__.d(__lib_exports__, {
   "UrlBuilder": function() { return /* reexport */ UrlBuilder; },
   "UrlBuilderTypesNoOp": function() { return /* reexport */ UrlBuilderTypesNoOp; },
   "VoidApiResponse": function() { return /* reexport */ VoidApiResponse; },
+  "encodeBytescaleQuerystringKVP": function() { return /* reexport */ encodeBytescaleQuerystringKVP; },
   "querystring": function() { return /* reexport */ querystring; }
 });
 
@@ -549,8 +551,10 @@ var BaseAPI = /*#__PURE__*/function () {
                 }
                 // HTTP-level errors from intermediary services (e.g. AWS or the user's own infrastructure/proxies). On the browser,
                 // this error is unlikely to be triggered since these errors will masqurade as CORS errors (see above) but in Node.js
-                // this error will appear from any intermediary service failure.
-                throw new Error("Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+                // this error will appear from any intermediary service failure. Also occurs when calling ProcessFile for an
+                // asynchronous media job, where the transformation is initiated using the primary artifact: in this instance,
+                // a 404 JSON response is returned containing the transformation job until it completes.
+                throw new BytescaleGenericError(response, errorText, errorJson);
               });
             }
           }, function (_result2) {
@@ -577,18 +581,39 @@ var CancelledError = /*#__PURE__*/function (_Error) {
   }
   return runtime_createClass(CancelledError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
-var BytescaleApiError = /*#__PURE__*/function (_Error2) {
-  _inherits(BytescaleApiError, _Error2);
-  var _super2 = _createSuper(BytescaleApiError);
-  function BytescaleApiError(response) {
+/**
+ * Thrown when the Bytescale API cannot be reached or when an error is returned that cannot be parsed as a JSON error response.
+ */
+var BytescaleGenericError = /*#__PURE__*/function (_Error2) {
+  _inherits(BytescaleGenericError, _Error2);
+  var _super2 = _createSuper(BytescaleGenericError);
+  function BytescaleGenericError(response, responseText, responseJson) {
     var _this6;
-    runtime_classCallCheck(this, BytescaleApiError);
-    _this6 = _super2.call(this, response.error.message);
-    _this6.name = "BytescaleApiError";
-    _this6.errorCode = response.error.code;
-    _this6.details = response.error.details;
+    runtime_classCallCheck(this, BytescaleGenericError);
+    _this6 = _super2.call(this, "Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+    _this6.response = response;
+    _this6.responseText = responseText;
+    _this6.responseJson = responseJson;
+    _this6.name = "BytescaleGenericError";
     return _this6;
   }
+  return runtime_createClass(BytescaleGenericError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+/**
+ * Thrown when the Bytescale API returns a JSON error response.
+ */
+var BytescaleApiError = /*#__PURE__*/function (_Error3) {
+  _inherits(BytescaleApiError, _Error3);
+  var _super3 = _createSuper(BytescaleApiError);
+  function BytescaleApiError(response) {
+    var _this7;
+    runtime_classCallCheck(this, BytescaleApiError);
+    _this7 = _super3.call(this, response.error.message);
+    _this7.name = "BytescaleApiError";
+    _this7.errorCode = response.error.code;
+    _this7.details = response.error.details;
+    return _this7;
+  }
   return runtime_createClass(BytescaleApiError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 function querystring(params) {
@@ -603,7 +628,20 @@ function querystringSingleKey(key, value) {
     // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
-  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
+  return encodeBytescaleQuerystringKVP(key, String(value));
+}
+/**
+ * Handles artifacts specially as these must use "/" instead of "%2F" in order for relative paths within the artifact's
+ * contents to work (assumes user has replaced "?" with "!"). For example, M3U8 artifacts that contain relative URLs to
+ * other M3U8s and/or media segments will only work if the user replaces "?" with "!" in the URL _and_ the artifact
+ * query param value has been written using "/" instead of "%2F", as this then means the URLs become relative to the
+ * artifact, as opposed to the file path.
+ */
+function encodeBytescaleQuerystringKVP(key, value) {
+  if (key === "a" || key === "artifact") {
+    return "".concat(key, "=").concat(encodeURIComponent(value).replace(/%2F/g, "/"));
+  }
+  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
 }
 var JSONApiResponse = /*#__PURE__*/function () {
   function JSONApiResponse(raw) {
@@ -614,8 +652,8 @@ var JSONApiResponse = /*#__PURE__*/function () {
     key: "value",
     value: function value() {
       try {
-        var _this8 = this;
-        return runtime_await(_this8.raw.json());
+        var _this9 = this;
+        return runtime_await(_this9.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -656,8 +694,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "text",
     value: function text() {
       try {
-        var _this10 = this;
-        return runtime_await(_this10.raw.text());
+        var _this11 = this;
+        return runtime_await(_this11.raw.text());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -666,8 +704,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "blob",
     value: function blob() {
       try {
-        var _this12 = this;
-        return runtime_await(_this12.raw.blob());
+        var _this13 = this;
+        return runtime_await(_this13.raw.blob());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -676,8 +714,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "json",
     value: function json() {
       try {
-        var _this14 = this;
-        return runtime_await(_this14.raw.json());
+        var _this15 = this;
+        return runtime_await(_this15.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -1732,7 +1770,7 @@ var UrlBuilder = /*#__PURE__*/function () {
         var _ref4 = _slicedToArray(_ref3, 2),
           key = _ref4[0],
           value = _ref4[1];
-        return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        return encodeBytescaleQuerystringKVP(key, value);
       }).join("&"));
     }
   }]);

package/dist/browser/esm/main.mjs

@@ -29,6 +29,7 @@ __lib_require__.d(__lib_exports__, {
   "BinaryResult": function() { return /* reexport */ BinaryResult; },
   "BytescaleApiClientConfigUtils": function() { return /* reexport */ BytescaleApiClientConfigUtils; },
   "BytescaleApiError": function() { return /* reexport */ BytescaleApiError; },
+  "BytescaleGenericError": function() { return /* reexport */ BytescaleGenericError; },
   "CancelledError": function() { return /* reexport */ CancelledError; },
   "CommonTypesNoOp": function() { return /* reexport */ CommonTypesNoOp; },
   "FileApi": function() { return /* reexport */ FileApi; },
@@ -40,6 +41,7 @@ __lib_require__.d(__lib_exports__, {
   "UrlBuilder": function() { return /* reexport */ UrlBuilder; },
   "UrlBuilderTypesNoOp": function() { return /* reexport */ UrlBuilderTypesNoOp; },
   "VoidApiResponse": function() { return /* reexport */ VoidApiResponse; },
+  "encodeBytescaleQuerystringKVP": function() { return /* reexport */ encodeBytescaleQuerystringKVP; },
   "querystring": function() { return /* reexport */ querystring; }
 });
 
@@ -534,8 +536,10 @@ var BaseAPI = /*#__PURE__*/function () {
                 }
                 // HTTP-level errors from intermediary services (e.g. AWS or the user's own infrastructure/proxies). On the browser,
                 // this error is unlikely to be triggered since these errors will masqurade as CORS errors (see above) but in Node.js
-                // this error will appear from any intermediary service failure.
-                throw new Error("Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+                // this error will appear from any intermediary service failure. Also occurs when calling ProcessFile for an
+                // asynchronous media job, where the transformation is initiated using the primary artifact: in this instance,
+                // a 404 JSON response is returned containing the transformation job until it completes.
+                throw new BytescaleGenericError(response, errorText, errorJson);
               });
             }
           }, function (_result2) {
@@ -562,18 +566,39 @@ var CancelledError = /*#__PURE__*/function (_Error) {
   }
   return runtime_createClass(CancelledError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
-var BytescaleApiError = /*#__PURE__*/function (_Error2) {
-  _inherits(BytescaleApiError, _Error2);
-  var _super2 = _createSuper(BytescaleApiError);
-  function BytescaleApiError(response) {
+/**
+ * Thrown when the Bytescale API cannot be reached or when an error is returned that cannot be parsed as a JSON error response.
+ */
+var BytescaleGenericError = /*#__PURE__*/function (_Error2) {
+  _inherits(BytescaleGenericError, _Error2);
+  var _super2 = _createSuper(BytescaleGenericError);
+  function BytescaleGenericError(response, responseText, responseJson) {
     var _this6;
-    runtime_classCallCheck(this, BytescaleApiError);
-    _this6 = _super2.call(this, response.error.message);
-    _this6.name = "BytescaleApiError";
-    _this6.errorCode = response.error.code;
-    _this6.details = response.error.details;
+    runtime_classCallCheck(this, BytescaleGenericError);
+    _this6 = _super2.call(this, "Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+    _this6.response = response;
+    _this6.responseText = responseText;
+    _this6.responseJson = responseJson;
+    _this6.name = "BytescaleGenericError";
     return _this6;
   }
+  return runtime_createClass(BytescaleGenericError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+/**
+ * Thrown when the Bytescale API returns a JSON error response.
+ */
+var BytescaleApiError = /*#__PURE__*/function (_Error3) {
+  _inherits(BytescaleApiError, _Error3);
+  var _super3 = _createSuper(BytescaleApiError);
+  function BytescaleApiError(response) {
+    var _this7;
+    runtime_classCallCheck(this, BytescaleApiError);
+    _this7 = _super3.call(this, response.error.message);
+    _this7.name = "BytescaleApiError";
+    _this7.errorCode = response.error.code;
+    _this7.details = response.error.details;
+    return _this7;
+  }
   return runtime_createClass(BytescaleApiError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 function querystring(params) {
@@ -588,7 +613,20 @@ function querystringSingleKey(key, value) {
     // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
-  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
+  return encodeBytescaleQuerystringKVP(key, String(value));
+}
+/**
+ * Handles artifacts specially as these must use "/" instead of "%2F" in order for relative paths within the artifact's
+ * contents to work (assumes user has replaced "?" with "!"). For example, M3U8 artifacts that contain relative URLs to
+ * other M3U8s and/or media segments will only work if the user replaces "?" with "!" in the URL _and_ the artifact
+ * query param value has been written using "/" instead of "%2F", as this then means the URLs become relative to the
+ * artifact, as opposed to the file path.
+ */
+function encodeBytescaleQuerystringKVP(key, value) {
+  if (key === "a" || key === "artifact") {
+    return "".concat(key, "=").concat(encodeURIComponent(value).replace(/%2F/g, "/"));
+  }
+  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
 }
 var JSONApiResponse = /*#__PURE__*/function () {
   function JSONApiResponse(raw) {
@@ -599,8 +637,8 @@ var JSONApiResponse = /*#__PURE__*/function () {
     key: "value",
     value: function value() {
       try {
-        var _this8 = this;
-        return runtime_await(_this8.raw.json());
+        var _this9 = this;
+        return runtime_await(_this9.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -641,8 +679,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "text",
     value: function text() {
       try {
-        var _this10 = this;
-        return runtime_await(_this10.raw.text());
+        var _this11 = this;
+        return runtime_await(_this11.raw.text());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -651,8 +689,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "blob",
     value: function blob() {
       try {
-        var _this12 = this;
-        return runtime_await(_this12.raw.blob());
+        var _this13 = this;
+        return runtime_await(_this13.raw.blob());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -661,8 +699,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "json",
     value: function json() {
       try {
-        var _this14 = this;
-        return runtime_await(_this14.raw.json());
+        var _this15 = this;
+        return runtime_await(_this15.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -1717,7 +1755,7 @@ var UrlBuilder = /*#__PURE__*/function () {
         var _ref4 = _slicedToArray(_ref3, 2),
           key = _ref4[0],
           value = _ref4[1];
-        return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        return encodeBytescaleQuerystringKVP(key, value);
       }).join("&"));
     }
   }]);
@@ -2956,6 +2994,7 @@ var __lib_exports__BaseAPI = __lib_exports__.BaseAPI;
 var __lib_exports__BinaryResult = __lib_exports__.BinaryResult;
 var __lib_exports__BytescaleApiClientConfigUtils = __lib_exports__.BytescaleApiClientConfigUtils;
 var __lib_exports__BytescaleApiError = __lib_exports__.BytescaleApiError;
+var __lib_exports__BytescaleGenericError = __lib_exports__.BytescaleGenericError;
 var __lib_exports__CancelledError = __lib_exports__.CancelledError;
 var __lib_exports__CommonTypesNoOp = __lib_exports__.CommonTypesNoOp;
 var __lib_exports__FileApi = __lib_exports__.FileApi;
@@ -2967,5 +3006,6 @@ var __lib_exports__UploadManager = __lib_exports__.UploadManager;
 var __lib_exports__UrlBuilder = __lib_exports__.UrlBuilder;
 var __lib_exports__UrlBuilderTypesNoOp = __lib_exports__.UrlBuilderTypesNoOp;
 var __lib_exports__VoidApiResponse = __lib_exports__.VoidApiResponse;
+var __lib_exports__encodeBytescaleQuerystringKVP = __lib_exports__.encodeBytescaleQuerystringKVP;
 var __lib_exports__querystring = __lib_exports__.querystring;
-export { __lib_exports__AuthManager as AuthManager, __lib_exports__BaseAPI as BaseAPI, __lib_exports__BinaryResult as BinaryResult, __lib_exports__BytescaleApiClientConfigUtils as BytescaleApiClientConfigUtils, __lib_exports__BytescaleApiError as BytescaleApiError, __lib_exports__CancelledError as CancelledError, __lib_exports__CommonTypesNoOp as CommonTypesNoOp, __lib_exports__FileApi as FileApi, __lib_exports__FolderApi as FolderApi, __lib_exports__JSONApiResponse as JSONApiResponse, __lib_exports__JobApi as JobApi, __lib_exports__UploadApi as UploadApi, __lib_exports__UploadManager as UploadManager, __lib_exports__UrlBuilder as UrlBuilder, __lib_exports__UrlBuilderTypesNoOp as UrlBuilderTypesNoOp, __lib_exports__VoidApiResponse as VoidApiResponse, __lib_exports__querystring as querystring };
+export { __lib_exports__AuthManager as AuthManager, __lib_exports__BaseAPI as BaseAPI, __lib_exports__BinaryResult as BinaryResult, __lib_exports__BytescaleApiClientConfigUtils as BytescaleApiClientConfigUtils, __lib_exports__BytescaleApiError as BytescaleApiError, __lib_exports__BytescaleGenericError as BytescaleGenericError, __lib_exports__CancelledError as CancelledError, __lib_exports__CommonTypesNoOp as CommonTypesNoOp, __lib_exports__FileApi as FileApi, __lib_exports__FolderApi as FolderApi, __lib_exports__JSONApiResponse as JSONApiResponse, __lib_exports__JobApi as JobApi, __lib_exports__UploadApi as UploadApi, __lib_exports__UploadManager as UploadManager, __lib_exports__UrlBuilder as UrlBuilder, __lib_exports__UrlBuilderTypesNoOp as UrlBuilderTypesNoOp, __lib_exports__VoidApiResponse as VoidApiResponse, __lib_exports__encodeBytescaleQuerystringKVP as encodeBytescaleQuerystringKVP, __lib_exports__querystring as querystring };

package/dist/node/cjs/main.js

@@ -44,6 +44,7 @@ __lib_require__.d(__lib_exports__, {
   "BinaryResult": function() { return /* reexport */ BinaryResult; },
   "BytescaleApiClientConfigUtils": function() { return /* reexport */ BytescaleApiClientConfigUtils; },
   "BytescaleApiError": function() { return /* reexport */ BytescaleApiError; },
+  "BytescaleGenericError": function() { return /* reexport */ BytescaleGenericError; },
   "CancelledError": function() { return /* reexport */ CancelledError; },
   "CommonTypesNoOp": function() { return /* reexport */ CommonTypesNoOp; },
   "FileApi": function() { return /* reexport */ FileApi; },
@@ -55,6 +56,7 @@ __lib_require__.d(__lib_exports__, {
   "UrlBuilder": function() { return /* reexport */ UrlBuilder; },
   "UrlBuilderTypesNoOp": function() { return /* reexport */ UrlBuilderTypesNoOp; },
   "VoidApiResponse": function() { return /* reexport */ VoidApiResponse; },
+  "encodeBytescaleQuerystringKVP": function() { return /* reexport */ encodeBytescaleQuerystringKVP; },
   "querystring": function() { return /* reexport */ querystring; }
 });
 
@@ -549,8 +551,10 @@ var BaseAPI = /*#__PURE__*/function () {
                 }
                 // HTTP-level errors from intermediary services (e.g. AWS or the user's own infrastructure/proxies). On the browser,
                 // this error is unlikely to be triggered since these errors will masqurade as CORS errors (see above) but in Node.js
-                // this error will appear from any intermediary service failure.
-                throw new Error("Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+                // this error will appear from any intermediary service failure. Also occurs when calling ProcessFile for an
+                // asynchronous media job, where the transformation is initiated using the primary artifact: in this instance,
+                // a 404 JSON response is returned containing the transformation job until it completes.
+                throw new BytescaleGenericError(response, errorText, errorJson);
               });
             }
           }, function (_result2) {
@@ -577,18 +581,39 @@ var CancelledError = /*#__PURE__*/function (_Error) {
   }
   return runtime_createClass(CancelledError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
-var BytescaleApiError = /*#__PURE__*/function (_Error2) {
-  _inherits(BytescaleApiError, _Error2);
-  var _super2 = _createSuper(BytescaleApiError);
-  function BytescaleApiError(response) {
+/**
+ * Thrown when the Bytescale API cannot be reached or when an error is returned that cannot be parsed as a JSON error response.
+ */
+var BytescaleGenericError = /*#__PURE__*/function (_Error2) {
+  _inherits(BytescaleGenericError, _Error2);
+  var _super2 = _createSuper(BytescaleGenericError);
+  function BytescaleGenericError(response, responseText, responseJson) {
     var _this6;
-    runtime_classCallCheck(this, BytescaleApiError);
-    _this6 = _super2.call(this, response.error.message);
-    _this6.name = "BytescaleApiError";
-    _this6.errorCode = response.error.code;
-    _this6.details = response.error.details;
+    runtime_classCallCheck(this, BytescaleGenericError);
+    _this6 = _super2.call(this, "Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+    _this6.response = response;
+    _this6.responseText = responseText;
+    _this6.responseJson = responseJson;
+    _this6.name = "BytescaleGenericError";
     return _this6;
   }
+  return runtime_createClass(BytescaleGenericError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+/**
+ * Thrown when the Bytescale API returns a JSON error response.
+ */
+var BytescaleApiError = /*#__PURE__*/function (_Error3) {
+  _inherits(BytescaleApiError, _Error3);
+  var _super3 = _createSuper(BytescaleApiError);
+  function BytescaleApiError(response) {
+    var _this7;
+    runtime_classCallCheck(this, BytescaleApiError);
+    _this7 = _super3.call(this, response.error.message);
+    _this7.name = "BytescaleApiError";
+    _this7.errorCode = response.error.code;
+    _this7.details = response.error.details;
+    return _this7;
+  }
   return runtime_createClass(BytescaleApiError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 function querystring(params) {
@@ -603,7 +628,20 @@ function querystringSingleKey(key, value) {
     // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
-  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
+  return encodeBytescaleQuerystringKVP(key, String(value));
+}
+/**
+ * Handles artifacts specially as these must use "/" instead of "%2F" in order for relative paths within the artifact's
+ * contents to work (assumes user has replaced "?" with "!"). For example, M3U8 artifacts that contain relative URLs to
+ * other M3U8s and/or media segments will only work if the user replaces "?" with "!" in the URL _and_ the artifact
+ * query param value has been written using "/" instead of "%2F", as this then means the URLs become relative to the
+ * artifact, as opposed to the file path.
+ */
+function encodeBytescaleQuerystringKVP(key, value) {
+  if (key === "a" || key === "artifact") {
+    return "".concat(key, "=").concat(encodeURIComponent(value).replace(/%2F/g, "/"));
+  }
+  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
 }
 var JSONApiResponse = /*#__PURE__*/function () {
   function JSONApiResponse(raw) {
@@ -614,8 +652,8 @@ var JSONApiResponse = /*#__PURE__*/function () {
     key: "value",
     value: function value() {
       try {
-        var _this8 = this;
-        return runtime_await(_this8.raw.json());
+        var _this9 = this;
+        return runtime_await(_this9.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -656,8 +694,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "text",
     value: function text() {
       try {
-        var _this10 = this;
-        return runtime_await(_this10.raw.text());
+        var _this11 = this;
+        return runtime_await(_this11.raw.text());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -666,8 +704,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "blob",
     value: function blob() {
       try {
-        var _this12 = this;
-        return runtime_await(_this12.raw.blob());
+        var _this13 = this;
+        return runtime_await(_this13.raw.blob());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -676,8 +714,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "json",
     value: function json() {
       try {
-        var _this14 = this;
-        return runtime_await(_this14.raw.json());
+        var _this15 = this;
+        return runtime_await(_this15.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -1732,7 +1770,7 @@ var UrlBuilder = /*#__PURE__*/function () {
         var _ref4 = _slicedToArray(_ref3, 2),
           key = _ref4[0],
           value = _ref4[1];
-        return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        return encodeBytescaleQuerystringKVP(key, value);
       }).join("&"));
     }
   }]);

package/dist/node/esm/main.mjs

@@ -31,6 +31,7 @@ __lib_require__.d(__lib_exports__, {
   "BinaryResult": function() { return /* reexport */ BinaryResult; },
   "BytescaleApiClientConfigUtils": function() { return /* reexport */ BytescaleApiClientConfigUtils; },
   "BytescaleApiError": function() { return /* reexport */ BytescaleApiError; },
+  "BytescaleGenericError": function() { return /* reexport */ BytescaleGenericError; },
   "CancelledError": function() { return /* reexport */ CancelledError; },
   "CommonTypesNoOp": function() { return /* reexport */ CommonTypesNoOp; },
   "FileApi": function() { return /* reexport */ FileApi; },
@@ -42,6 +43,7 @@ __lib_require__.d(__lib_exports__, {
   "UrlBuilder": function() { return /* reexport */ UrlBuilder; },
   "UrlBuilderTypesNoOp": function() { return /* reexport */ UrlBuilderTypesNoOp; },
   "VoidApiResponse": function() { return /* reexport */ VoidApiResponse; },
+  "encodeBytescaleQuerystringKVP": function() { return /* reexport */ encodeBytescaleQuerystringKVP; },
   "querystring": function() { return /* reexport */ querystring; }
 });
 
@@ -536,8 +538,10 @@ var BaseAPI = /*#__PURE__*/function () {
                 }
                 // HTTP-level errors from intermediary services (e.g. AWS or the user's own infrastructure/proxies). On the browser,
                 // this error is unlikely to be triggered since these errors will masqurade as CORS errors (see above) but in Node.js
-                // this error will appear from any intermediary service failure.
-                throw new Error("Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+                // this error will appear from any intermediary service failure. Also occurs when calling ProcessFile for an
+                // asynchronous media job, where the transformation is initiated using the primary artifact: in this instance,
+                // a 404 JSON response is returned containing the transformation job until it completes.
+                throw new BytescaleGenericError(response, errorText, errorJson);
               });
             }
           }, function (_result2) {
@@ -564,18 +568,39 @@ var CancelledError = /*#__PURE__*/function (_Error) {
   }
   return runtime_createClass(CancelledError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
-var BytescaleApiError = /*#__PURE__*/function (_Error2) {
-  _inherits(BytescaleApiError, _Error2);
-  var _super2 = _createSuper(BytescaleApiError);
-  function BytescaleApiError(response) {
+/**
+ * Thrown when the Bytescale API cannot be reached or when an error is returned that cannot be parsed as a JSON error response.
+ */
+var BytescaleGenericError = /*#__PURE__*/function (_Error2) {
+  _inherits(BytescaleGenericError, _Error2);
+  var _super2 = _createSuper(BytescaleGenericError);
+  function BytescaleGenericError(response, responseText, responseJson) {
     var _this6;
-    runtime_classCallCheck(this, BytescaleApiError);
-    _this6 = _super2.call(this, response.error.message);
-    _this6.name = "BytescaleApiError";
-    _this6.errorCode = response.error.code;
-    _this6.details = response.error.details;
+    runtime_classCallCheck(this, BytescaleGenericError);
+    _this6 = _super2.call(this, "Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+    _this6.response = response;
+    _this6.responseText = responseText;
+    _this6.responseJson = responseJson;
+    _this6.name = "BytescaleGenericError";
     return _this6;
   }
+  return runtime_createClass(BytescaleGenericError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+/**
+ * Thrown when the Bytescale API returns a JSON error response.
+ */
+var BytescaleApiError = /*#__PURE__*/function (_Error3) {
+  _inherits(BytescaleApiError, _Error3);
+  var _super3 = _createSuper(BytescaleApiError);
+  function BytescaleApiError(response) {
+    var _this7;
+    runtime_classCallCheck(this, BytescaleApiError);
+    _this7 = _super3.call(this, response.error.message);
+    _this7.name = "BytescaleApiError";
+    _this7.errorCode = response.error.code;
+    _this7.details = response.error.details;
+    return _this7;
+  }
   return runtime_createClass(BytescaleApiError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 function querystring(params) {
@@ -590,7 +615,20 @@ function querystringSingleKey(key, value) {
     // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
-  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
+  return encodeBytescaleQuerystringKVP(key, String(value));
+}
+/**
+ * Handles artifacts specially as these must use "/" instead of "%2F" in order for relative paths within the artifact's
+ * contents to work (assumes user has replaced "?" with "!"). For example, M3U8 artifacts that contain relative URLs to
+ * other M3U8s and/or media segments will only work if the user replaces "?" with "!" in the URL _and_ the artifact
+ * query param value has been written using "/" instead of "%2F", as this then means the URLs become relative to the
+ * artifact, as opposed to the file path.
+ */
+function encodeBytescaleQuerystringKVP(key, value) {
+  if (key === "a" || key === "artifact") {
+    return "".concat(key, "=").concat(encodeURIComponent(value).replace(/%2F/g, "/"));
+  }
+  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
 }
 var JSONApiResponse = /*#__PURE__*/function () {
   function JSONApiResponse(raw) {
@@ -601,8 +639,8 @@ var JSONApiResponse = /*#__PURE__*/function () {
     key: "value",
     value: function value() {
       try {
-        var _this8 = this;
-        return runtime_await(_this8.raw.json());
+        var _this9 = this;
+        return runtime_await(_this9.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -643,8 +681,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "text",
     value: function text() {
       try {
-        var _this10 = this;
-        return runtime_await(_this10.raw.text());
+        var _this11 = this;
+        return runtime_await(_this11.raw.text());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -653,8 +691,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "blob",
     value: function blob() {
       try {
-        var _this12 = this;
-        return runtime_await(_this12.raw.blob());
+        var _this13 = this;
+        return runtime_await(_this13.raw.blob());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -663,8 +701,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "json",
     value: function json() {
       try {
-        var _this14 = this;
-        return runtime_await(_this14.raw.json());
+        var _this15 = this;
+        return runtime_await(_this15.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -1719,7 +1757,7 @@ var UrlBuilder = /*#__PURE__*/function () {
         var _ref4 = _slicedToArray(_ref3, 2),
           key = _ref4[0],
           value = _ref4[1];
-        return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        return encodeBytescaleQuerystringKVP(key, value);
       }).join("&"));
     }
   }]);
@@ -2974,6 +3012,7 @@ var __lib_exports__BaseAPI = __lib_exports__.BaseAPI;
 var __lib_exports__BinaryResult = __lib_exports__.BinaryResult;
 var __lib_exports__BytescaleApiClientConfigUtils = __lib_exports__.BytescaleApiClientConfigUtils;
 var __lib_exports__BytescaleApiError = __lib_exports__.BytescaleApiError;
+var __lib_exports__BytescaleGenericError = __lib_exports__.BytescaleGenericError;
 var __lib_exports__CancelledError = __lib_exports__.CancelledError;
 var __lib_exports__CommonTypesNoOp = __lib_exports__.CommonTypesNoOp;
 var __lib_exports__FileApi = __lib_exports__.FileApi;
@@ -2985,5 +3024,6 @@ var __lib_exports__UploadManager = __lib_exports__.UploadManager;
 var __lib_exports__UrlBuilder = __lib_exports__.UrlBuilder;
 var __lib_exports__UrlBuilderTypesNoOp = __lib_exports__.UrlBuilderTypesNoOp;
 var __lib_exports__VoidApiResponse = __lib_exports__.VoidApiResponse;
+var __lib_exports__encodeBytescaleQuerystringKVP = __lib_exports__.encodeBytescaleQuerystringKVP;
 var __lib_exports__querystring = __lib_exports__.querystring;
-export { __lib_exports__AuthManager as AuthManager, __lib_exports__BaseAPI as BaseAPI, __lib_exports__BinaryResult as BinaryResult, __lib_exports__BytescaleApiClientConfigUtils as BytescaleApiClientConfigUtils, __lib_exports__BytescaleApiError as BytescaleApiError, __lib_exports__CancelledError as CancelledError, __lib_exports__CommonTypesNoOp as CommonTypesNoOp, __lib_exports__FileApi as FileApi, __lib_exports__FolderApi as FolderApi, __lib_exports__JSONApiResponse as JSONApiResponse, __lib_exports__JobApi as JobApi, __lib_exports__UploadApi as UploadApi, __lib_exports__UploadManager as UploadManager, __lib_exports__UrlBuilder as UrlBuilder, __lib_exports__UrlBuilderTypesNoOp as UrlBuilderTypesNoOp, __lib_exports__VoidApiResponse as VoidApiResponse, __lib_exports__querystring as querystring };
+export { __lib_exports__AuthManager as AuthManager, __lib_exports__BaseAPI as BaseAPI, __lib_exports__BinaryResult as BinaryResult, __lib_exports__BytescaleApiClientConfigUtils as BytescaleApiClientConfigUtils, __lib_exports__BytescaleApiError as BytescaleApiError, __lib_exports__BytescaleGenericError as BytescaleGenericError, __lib_exports__CancelledError as CancelledError, __lib_exports__CommonTypesNoOp as CommonTypesNoOp, __lib_exports__FileApi as FileApi, __lib_exports__FolderApi as FolderApi, __lib_exports__JSONApiResponse as JSONApiResponse, __lib_exports__JobApi as JobApi, __lib_exports__UploadApi as UploadApi, __lib_exports__UploadManager as UploadManager, __lib_exports__UrlBuilder as UrlBuilder, __lib_exports__UrlBuilderTypesNoOp as UrlBuilderTypesNoOp, __lib_exports__VoidApiResponse as VoidApiResponse, __lib_exports__encodeBytescaleQuerystringKVP as encodeBytescaleQuerystringKVP, __lib_exports__querystring as querystring };

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

@@ -74,6 +74,19 @@ export declare class CancelledError extends Error {
     name: "CancelledError";
     constructor();
 }
+/**
+ * Thrown when the Bytescale API cannot be reached or when an error is returned that cannot be parsed as a JSON error response.
+ */
+export declare class BytescaleGenericError extends Error {
+    readonly response: Response;
+    readonly responseText: string | undefined;
+    readonly responseJson: object | undefined;
+    name: "BytescaleGenericError";
+    constructor(response: Response, responseText: string | undefined, responseJson: object | undefined);
+}
+/**
+ * Thrown when the Bytescale API returns a JSON error response.
+ */
 export declare class BytescaleApiError extends Error {
     name: "BytescaleApiError";
     readonly errorCode: string;
@@ -107,6 +120,14 @@ export interface RequestOpts {
     body?: HTTPBody;
 }
 export declare function querystring(params: HTTPQuery): string;
+/**
+ * Handles artifacts specially as these must use "/" instead of "%2F" in order for relative paths within the artifact's
+ * contents to work (assumes user has replaced "?" with "!"). For example, M3U8 artifacts that contain relative URLs to
+ * other M3U8s and/or media segments will only work if the user replaces "?" with "!" in the URL _and_ the artifact
+ * query param value has been written using "/" instead of "%2F", as this then means the URLs become relative to the
+ * artifact, as opposed to the file path.
+ */
+export declare function encodeBytescaleQuerystringKVP(key: string, value: string): string;
 export interface ApiResponse<T> {
     raw: Response;
     value(): Promise<T>;

package/dist/worker/cjs/main.js

@@ -44,6 +44,7 @@ __lib_require__.d(__lib_exports__, {
   "BinaryResult": function() { return /* reexport */ BinaryResult; },
   "BytescaleApiClientConfigUtils": function() { return /* reexport */ BytescaleApiClientConfigUtils; },
   "BytescaleApiError": function() { return /* reexport */ BytescaleApiError; },
+  "BytescaleGenericError": function() { return /* reexport */ BytescaleGenericError; },
   "CancelledError": function() { return /* reexport */ CancelledError; },
   "CommonTypesNoOp": function() { return /* reexport */ CommonTypesNoOp; },
   "FileApi": function() { return /* reexport */ FileApi; },
@@ -55,6 +56,7 @@ __lib_require__.d(__lib_exports__, {
   "UrlBuilder": function() { return /* reexport */ UrlBuilder; },
   "UrlBuilderTypesNoOp": function() { return /* reexport */ UrlBuilderTypesNoOp; },
   "VoidApiResponse": function() { return /* reexport */ VoidApiResponse; },
+  "encodeBytescaleQuerystringKVP": function() { return /* reexport */ encodeBytescaleQuerystringKVP; },
   "querystring": function() { return /* reexport */ querystring; }
 });
 
@@ -549,8 +551,10 @@ var BaseAPI = /*#__PURE__*/function () {
                 }
                 // HTTP-level errors from intermediary services (e.g. AWS or the user's own infrastructure/proxies). On the browser,
                 // this error is unlikely to be triggered since these errors will masqurade as CORS errors (see above) but in Node.js
-                // this error will appear from any intermediary service failure.
-                throw new Error("Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+                // this error will appear from any intermediary service failure. Also occurs when calling ProcessFile for an
+                // asynchronous media job, where the transformation is initiated using the primary artifact: in this instance,
+                // a 404 JSON response is returned containing the transformation job until it completes.
+                throw new BytescaleGenericError(response, errorText, errorJson);
               });
             }
           }, function (_result2) {
@@ -577,18 +581,39 @@ var CancelledError = /*#__PURE__*/function (_Error) {
   }
   return runtime_createClass(CancelledError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
-var BytescaleApiError = /*#__PURE__*/function (_Error2) {
-  _inherits(BytescaleApiError, _Error2);
-  var _super2 = _createSuper(BytescaleApiError);
-  function BytescaleApiError(response) {
+/**
+ * Thrown when the Bytescale API cannot be reached or when an error is returned that cannot be parsed as a JSON error response.
+ */
+var BytescaleGenericError = /*#__PURE__*/function (_Error2) {
+  _inherits(BytescaleGenericError, _Error2);
+  var _super2 = _createSuper(BytescaleGenericError);
+  function BytescaleGenericError(response, responseText, responseJson) {
     var _this6;
-    runtime_classCallCheck(this, BytescaleApiError);
-    _this6 = _super2.call(this, response.error.message);
-    _this6.name = "BytescaleApiError";
-    _this6.errorCode = response.error.code;
-    _this6.details = response.error.details;
+    runtime_classCallCheck(this, BytescaleGenericError);
+    _this6 = _super2.call(this, "Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+    _this6.response = response;
+    _this6.responseText = responseText;
+    _this6.responseJson = responseJson;
+    _this6.name = "BytescaleGenericError";
     return _this6;
   }
+  return runtime_createClass(BytescaleGenericError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+/**
+ * Thrown when the Bytescale API returns a JSON error response.
+ */
+var BytescaleApiError = /*#__PURE__*/function (_Error3) {
+  _inherits(BytescaleApiError, _Error3);
+  var _super3 = _createSuper(BytescaleApiError);
+  function BytescaleApiError(response) {
+    var _this7;
+    runtime_classCallCheck(this, BytescaleApiError);
+    _this7 = _super3.call(this, response.error.message);
+    _this7.name = "BytescaleApiError";
+    _this7.errorCode = response.error.code;
+    _this7.details = response.error.details;
+    return _this7;
+  }
   return runtime_createClass(BytescaleApiError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 function querystring(params) {
@@ -603,7 +628,20 @@ function querystringSingleKey(key, value) {
     // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
-  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
+  return encodeBytescaleQuerystringKVP(key, String(value));
+}
+/**
+ * Handles artifacts specially as these must use "/" instead of "%2F" in order for relative paths within the artifact's
+ * contents to work (assumes user has replaced "?" with "!"). For example, M3U8 artifacts that contain relative URLs to
+ * other M3U8s and/or media segments will only work if the user replaces "?" with "!" in the URL _and_ the artifact
+ * query param value has been written using "/" instead of "%2F", as this then means the URLs become relative to the
+ * artifact, as opposed to the file path.
+ */
+function encodeBytescaleQuerystringKVP(key, value) {
+  if (key === "a" || key === "artifact") {
+    return "".concat(key, "=").concat(encodeURIComponent(value).replace(/%2F/g, "/"));
+  }
+  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
 }
 var JSONApiResponse = /*#__PURE__*/function () {
   function JSONApiResponse(raw) {
@@ -614,8 +652,8 @@ var JSONApiResponse = /*#__PURE__*/function () {
     key: "value",
     value: function value() {
       try {
-        var _this8 = this;
-        return runtime_await(_this8.raw.json());
+        var _this9 = this;
+        return runtime_await(_this9.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -656,8 +694,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "text",
     value: function text() {
       try {
-        var _this10 = this;
-        return runtime_await(_this10.raw.text());
+        var _this11 = this;
+        return runtime_await(_this11.raw.text());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -666,8 +704,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "blob",
     value: function blob() {
       try {
-        var _this12 = this;
-        return runtime_await(_this12.raw.blob());
+        var _this13 = this;
+        return runtime_await(_this13.raw.blob());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -676,8 +714,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "json",
     value: function json() {
       try {
-        var _this14 = this;
-        return runtime_await(_this14.raw.json());
+        var _this15 = this;
+        return runtime_await(_this15.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -1732,7 +1770,7 @@ var UrlBuilder = /*#__PURE__*/function () {
         var _ref4 = _slicedToArray(_ref3, 2),
           key = _ref4[0],
           value = _ref4[1];
-        return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        return encodeBytescaleQuerystringKVP(key, value);
       }).join("&"));
     }
   }]);

package/dist/worker/esm/main.mjs

@@ -29,6 +29,7 @@ __lib_require__.d(__lib_exports__, {
   "BinaryResult": function() { return /* reexport */ BinaryResult; },
   "BytescaleApiClientConfigUtils": function() { return /* reexport */ BytescaleApiClientConfigUtils; },
   "BytescaleApiError": function() { return /* reexport */ BytescaleApiError; },
+  "BytescaleGenericError": function() { return /* reexport */ BytescaleGenericError; },
   "CancelledError": function() { return /* reexport */ CancelledError; },
   "CommonTypesNoOp": function() { return /* reexport */ CommonTypesNoOp; },
   "FileApi": function() { return /* reexport */ FileApi; },
@@ -40,6 +41,7 @@ __lib_require__.d(__lib_exports__, {
   "UrlBuilder": function() { return /* reexport */ UrlBuilder; },
   "UrlBuilderTypesNoOp": function() { return /* reexport */ UrlBuilderTypesNoOp; },
   "VoidApiResponse": function() { return /* reexport */ VoidApiResponse; },
+  "encodeBytescaleQuerystringKVP": function() { return /* reexport */ encodeBytescaleQuerystringKVP; },
   "querystring": function() { return /* reexport */ querystring; }
 });
 
@@ -534,8 +536,10 @@ var BaseAPI = /*#__PURE__*/function () {
                 }
                 // HTTP-level errors from intermediary services (e.g. AWS or the user's own infrastructure/proxies). On the browser,
                 // this error is unlikely to be triggered since these errors will masqurade as CORS errors (see above) but in Node.js
-                // this error will appear from any intermediary service failure.
-                throw new Error("Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+                // this error will appear from any intermediary service failure. Also occurs when calling ProcessFile for an
+                // asynchronous media job, where the transformation is initiated using the primary artifact: in this instance,
+                // a 404 JSON response is returned containing the transformation job until it completes.
+                throw new BytescaleGenericError(response, errorText, errorJson);
               });
             }
           }, function (_result2) {
@@ -562,18 +566,39 @@ var CancelledError = /*#__PURE__*/function (_Error) {
   }
   return runtime_createClass(CancelledError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
-var BytescaleApiError = /*#__PURE__*/function (_Error2) {
-  _inherits(BytescaleApiError, _Error2);
-  var _super2 = _createSuper(BytescaleApiError);
-  function BytescaleApiError(response) {
+/**
+ * Thrown when the Bytescale API cannot be reached or when an error is returned that cannot be parsed as a JSON error response.
+ */
+var BytescaleGenericError = /*#__PURE__*/function (_Error2) {
+  _inherits(BytescaleGenericError, _Error2);
+  var _super2 = _createSuper(BytescaleGenericError);
+  function BytescaleGenericError(response, responseText, responseJson) {
     var _this6;
-    runtime_classCallCheck(this, BytescaleApiError);
-    _this6 = _super2.call(this, response.error.message);
-    _this6.name = "BytescaleApiError";
-    _this6.errorCode = response.error.code;
-    _this6.details = response.error.details;
+    runtime_classCallCheck(this, BytescaleGenericError);
+    _this6 = _super2.call(this, "Unable to connect to the Bytescale API (".concat(response.status, "): please try again."));
+    _this6.response = response;
+    _this6.responseText = responseText;
+    _this6.responseJson = responseJson;
+    _this6.name = "BytescaleGenericError";
     return _this6;
   }
+  return runtime_createClass(BytescaleGenericError);
+}( /*#__PURE__*/_wrapNativeSuper(Error));
+/**
+ * Thrown when the Bytescale API returns a JSON error response.
+ */
+var BytescaleApiError = /*#__PURE__*/function (_Error3) {
+  _inherits(BytescaleApiError, _Error3);
+  var _super3 = _createSuper(BytescaleApiError);
+  function BytescaleApiError(response) {
+    var _this7;
+    runtime_classCallCheck(this, BytescaleApiError);
+    _this7 = _super3.call(this, response.error.message);
+    _this7.name = "BytescaleApiError";
+    _this7.errorCode = response.error.code;
+    _this7.details = response.error.details;
+    return _this7;
+  }
   return runtime_createClass(BytescaleApiError);
 }( /*#__PURE__*/_wrapNativeSuper(Error));
 function querystring(params) {
@@ -588,7 +613,20 @@ function querystringSingleKey(key, value) {
     // Matches 'array' or 'object' (which we want).
     return querystring(value);
   }
-  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(String(value)));
+  return encodeBytescaleQuerystringKVP(key, String(value));
+}
+/**
+ * Handles artifacts specially as these must use "/" instead of "%2F" in order for relative paths within the artifact's
+ * contents to work (assumes user has replaced "?" with "!"). For example, M3U8 artifacts that contain relative URLs to
+ * other M3U8s and/or media segments will only work if the user replaces "?" with "!" in the URL _and_ the artifact
+ * query param value has been written using "/" instead of "%2F", as this then means the URLs become relative to the
+ * artifact, as opposed to the file path.
+ */
+function encodeBytescaleQuerystringKVP(key, value) {
+  if (key === "a" || key === "artifact") {
+    return "".concat(key, "=").concat(encodeURIComponent(value).replace(/%2F/g, "/"));
+  }
+  return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
 }
 var JSONApiResponse = /*#__PURE__*/function () {
   function JSONApiResponse(raw) {
@@ -599,8 +637,8 @@ var JSONApiResponse = /*#__PURE__*/function () {
     key: "value",
     value: function value() {
       try {
-        var _this8 = this;
-        return runtime_await(_this8.raw.json());
+        var _this9 = this;
+        return runtime_await(_this9.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -641,8 +679,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "text",
     value: function text() {
       try {
-        var _this10 = this;
-        return runtime_await(_this10.raw.text());
+        var _this11 = this;
+        return runtime_await(_this11.raw.text());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -651,8 +689,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "blob",
     value: function blob() {
       try {
-        var _this12 = this;
-        return runtime_await(_this12.raw.blob());
+        var _this13 = this;
+        return runtime_await(_this13.raw.blob());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -661,8 +699,8 @@ var BinaryResult = /*#__PURE__*/function () {
     key: "json",
     value: function json() {
       try {
-        var _this14 = this;
-        return runtime_await(_this14.raw.json());
+        var _this15 = this;
+        return runtime_await(_this15.raw.json());
       } catch (e) {
         return Promise.reject(e);
       }
@@ -1717,7 +1755,7 @@ var UrlBuilder = /*#__PURE__*/function () {
         var _ref4 = _slicedToArray(_ref3, 2),
           key = _ref4[0],
           value = _ref4[1];
-        return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        return encodeBytescaleQuerystringKVP(key, value);
       }).join("&"));
     }
   }]);
@@ -2499,6 +2537,7 @@ var __lib_exports__BaseAPI = __lib_exports__.BaseAPI;
 var __lib_exports__BinaryResult = __lib_exports__.BinaryResult;
 var __lib_exports__BytescaleApiClientConfigUtils = __lib_exports__.BytescaleApiClientConfigUtils;
 var __lib_exports__BytescaleApiError = __lib_exports__.BytescaleApiError;
+var __lib_exports__BytescaleGenericError = __lib_exports__.BytescaleGenericError;
 var __lib_exports__CancelledError = __lib_exports__.CancelledError;
 var __lib_exports__CommonTypesNoOp = __lib_exports__.CommonTypesNoOp;
 var __lib_exports__FileApi = __lib_exports__.FileApi;
@@ -2510,5 +2549,6 @@ var __lib_exports__UploadManager = __lib_exports__.UploadManager;
 var __lib_exports__UrlBuilder = __lib_exports__.UrlBuilder;
 var __lib_exports__UrlBuilderTypesNoOp = __lib_exports__.UrlBuilderTypesNoOp;
 var __lib_exports__VoidApiResponse = __lib_exports__.VoidApiResponse;
+var __lib_exports__encodeBytescaleQuerystringKVP = __lib_exports__.encodeBytescaleQuerystringKVP;
 var __lib_exports__querystring = __lib_exports__.querystring;
-export { __lib_exports__AuthManager as AuthManager, __lib_exports__BaseAPI as BaseAPI, __lib_exports__BinaryResult as BinaryResult, __lib_exports__BytescaleApiClientConfigUtils as BytescaleApiClientConfigUtils, __lib_exports__BytescaleApiError as BytescaleApiError, __lib_exports__CancelledError as CancelledError, __lib_exports__CommonTypesNoOp as CommonTypesNoOp, __lib_exports__FileApi as FileApi, __lib_exports__FolderApi as FolderApi, __lib_exports__JSONApiResponse as JSONApiResponse, __lib_exports__JobApi as JobApi, __lib_exports__UploadApi as UploadApi, __lib_exports__UploadManager as UploadManager, __lib_exports__UrlBuilder as UrlBuilder, __lib_exports__UrlBuilderTypesNoOp as UrlBuilderTypesNoOp, __lib_exports__VoidApiResponse as VoidApiResponse, __lib_exports__querystring as querystring };
+export { __lib_exports__AuthManager as AuthManager, __lib_exports__BaseAPI as BaseAPI, __lib_exports__BinaryResult as BinaryResult, __lib_exports__BytescaleApiClientConfigUtils as BytescaleApiClientConfigUtils, __lib_exports__BytescaleApiError as BytescaleApiError, __lib_exports__BytescaleGenericError as BytescaleGenericError, __lib_exports__CancelledError as CancelledError, __lib_exports__CommonTypesNoOp as CommonTypesNoOp, __lib_exports__FileApi as FileApi, __lib_exports__FolderApi as FolderApi, __lib_exports__JSONApiResponse as JSONApiResponse, __lib_exports__JobApi as JobApi, __lib_exports__UploadApi as UploadApi, __lib_exports__UploadManager as UploadManager, __lib_exports__UrlBuilder as UrlBuilder, __lib_exports__UrlBuilderTypesNoOp as UrlBuilderTypesNoOp, __lib_exports__VoidApiResponse as VoidApiResponse, __lib_exports__encodeBytescaleQuerystringKVP as encodeBytescaleQuerystringKVP, __lib_exports__querystring as querystring };

package/package.json

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

package/tests/UrlBuilder.test.ts

@@ -49,7 +49,7 @@ describe("UrlBuilder", () => {
       filePath: "/example.jpg",
       options: { transformation: "preset", transformationPreset: "thumbnail", artifact: "/foo" }
     });
-    const expected = "https://upcdn.io/1234abc/thumbnail/example.jpg?artifact=%2Ffoo";
+    const expected = "https://upcdn.io/1234abc/thumbnail/example.jpg?artifact=/foo";
     expect(actual).toEqual(expected);
   });
 
@@ -59,7 +59,7 @@ describe("UrlBuilder", () => {
       filePath: "/example.jpg",
       options: { transformation: "preset", transformationPreset: "thumbnail", artifact: "/foo" }
     });
-    const expected = "https://upcdn.io/1234abc/thumbnail/example.jpg?artifact=%2Ffoo";
+    const expected = "https://upcdn.io/1234abc/thumbnail/example.jpg?artifact=/foo";
     expect(actual).toEqual(expected);
   });
 
@@ -74,7 +74,7 @@ describe("UrlBuilder", () => {
         cachePermanently: false
       }
     });
-    const expected = "https://upcdn.io/1234abc/thumbnail/example.jpg?cache_perm=false&artifact=%2Ffoo";
+    const expected = "https://upcdn.io/1234abc/thumbnail/example.jpg?cache_perm=false&artifact=/foo";
     expect(actual).toEqual(expected);
   });
 
@@ -121,7 +121,7 @@ describe("UrlBuilder", () => {
         auth: true
       }
     });
-    const expected = "https://upcdn.io/1234abc/image/example.jpg?w=42&h=50&version=50&cache_perm=auto&artifact=%2Ffoo";
+    const expected = "https://upcdn.io/1234abc/image/example.jpg?w=42&h=50&version=50&cache_perm=auto&artifact=/foo";
     expect(actual).toEqual(expected);
   });