@ama-sdk/client-fetch 11.3.0-prerelease.33

package/LICENSE

@@ -0,0 +1,26 @@
+Copyright Amadeus SAS
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,33 @@
+# Ama SDK Fetch Client
+
+[![Stable Version](https://img.shields.io/npm/v/@ama-sdk/client-fetch?style=for-the-badge)](https://www.npmjs.com/package/@ama-sdk/client-fetch)
+[![Bundle Size](https://img.shields.io/bundlephobia/min/@ama-sdk/client-fetch?color=green&style=for-the-badge)](https://www.npmjs.com/package/@ama-sdk/client-fetch)
+
+This package exposes the **Api Fetch Client** from an SDK based on [@ama-sdk/core](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/core).
+
+This package contains all the [Fetch Plugins](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins), helpers and object definitions to dialog with an API following the `ama-sdk` architecture.
+
+> [!TIP]
+> Please refer to the [SDK initializer](https://www.npmjs.com/package/@ama-sdk/create) package for getting started with an API client SDK based on `ama-sdk` architecture.
+
+## Setup
+
+The **Api Fetch Client** can be added to your project via the following command:
+
+```shell
+ng add @ama-sdk/client-fetch
+```
+
+> [!NOTE]
+> In case of migration from deprecated `ApiFetchClient` imported from `@ama-sdk/core`, the `ng add` command will replace, in your existing code, the import from `@ama-sdk/core` to `@ama-sdk/client-fetch` for the deprecated dependencies.
+
+## Available plugins
+
+- [abort](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/abort)
+- [concurrent](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/concurrent)
+- [keepalive](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/keepalive)
+- [mock-intercept](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/mock-intercept)
+- [perf-metric](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/perf-metric)
+- [retry](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/retry)
+- [timeout](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/timeout)
+- [wait-for](https://github.com/AmadeusITGroup/otter/tree/main/packages/%40ama-sdk/client-fetch/src/plugins/wait-for)

package/cjs/api-fetch-client.js

@@ -0,0 +1,581 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ApiFetchClient", {
+    enumerable: true,
+    get: function() {
+        return ApiFetchClient;
+    }
+});
+var _core = require("@ama-sdk/core");
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _class_call_check(instance, Constructor) {
+    if (!(instance instanceof Constructor)) {
+        throw new TypeError("Cannot call a class as a function");
+    }
+}
+function _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, descriptor.key, descriptor);
+    }
+}
+function _create_class(Constructor, protoProps, staticProps) {
+    if (protoProps) _defineProperties(Constructor.prototype, protoProps);
+    if (staticProps) _defineProperties(Constructor, staticProps);
+    return Constructor;
+}
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, g, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    };
+    return g = {
+        next: verb(0),
+        "throw": verb(1),
+        "return": verb(2)
+    }, typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+        return this;
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(_)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var DEFAULT_OPTIONS = {
+    replyPlugins: [
+        new _core.ReviverReply(),
+        new _core.ExceptionReply()
+    ],
+    fetchPlugins: [],
+    requestPlugins: [],
+    enableTokenization: false,
+    disableFallback: false
+};
+var ApiFetchClient = /*#__PURE__*/ function() {
+    "use strict";
+    function ApiFetchClient(options) {
+        _class_call_check(this, ApiFetchClient);
+        /** @inheritdoc */ _define_property(this, "options", void 0);
+        this.options = _object_spread({}, DEFAULT_OPTIONS, options);
+    }
+    _create_class(ApiFetchClient, [
+        {
+            key: "extractQueryParams",
+            value: /** @inheritdoc */ function extractQueryParams(data, names) {
+                return (0, _core.extractQueryParams)(data, names);
+            }
+        },
+        {
+            key: "tokenizeRequestOptions",
+            value: /** @inheritdoc */ function tokenizeRequestOptions(url, queryParameters, piiParamTokens, data) {
+                return this.options.enableTokenization ? (0, _core.tokenizeRequestOptions)(url, queryParameters, piiParamTokens, data) : undefined;
+            }
+        },
+        {
+            key: "getRequestOptions",
+            value: /** @inheritdoc */ function getRequestOptions(requestOptionsParameters) {
+                var _this = this;
+                return _async_to_generator(function() {
+                    var opts, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, plugin, _requestOptionsParameters_api, err;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                opts = _object_spread_props(_object_spread({}, requestOptionsParameters), {
+                                    headers: new Headers((0, _core.filterUndefinedValues)(requestOptionsParameters.headers)),
+                                    queryParams: (0, _core.filterUndefinedValues)(requestOptionsParameters.queryParams)
+                                });
+                                if (!_this.options.requestPlugins) return [
+                                    3,
+                                    8
+                                ];
+                                _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    6,
+                                    7,
+                                    8
+                                ]);
+                                _iterator = _this.options.requestPlugins[Symbol.iterator]();
+                                _state.label = 2;
+                            case 2:
+                                if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                                    3,
+                                    5
+                                ];
+                                plugin = _step.value;
+                                return [
+                                    4,
+                                    plugin.load({
+                                        logger: _this.options.logger,
+                                        apiName: (_requestOptionsParameters_api = requestOptionsParameters.api) === null || _requestOptionsParameters_api === void 0 ? void 0 : _requestOptionsParameters_api.apiName
+                                    }).transform(opts)
+                                ];
+                            case 3:
+                                opts = _state.sent();
+                                _state.label = 4;
+                            case 4:
+                                _iteratorNormalCompletion = true;
+                                return [
+                                    3,
+                                    2
+                                ];
+                            case 5:
+                                return [
+                                    3,
+                                    8
+                                ];
+                            case 6:
+                                err = _state.sent();
+                                _didIteratorError = true;
+                                _iteratorError = err;
+                                return [
+                                    3,
+                                    8
+                                ];
+                            case 7:
+                                try {
+                                    if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                        _iterator.return();
+                                    }
+                                } finally{
+                                    if (_didIteratorError) {
+                                        throw _iteratorError;
+                                    }
+                                }
+                                return [
+                                    7
+                                ];
+                            case 8:
+                                return [
+                                    2,
+                                    opts
+                                ];
+                        }
+                    });
+                })();
+            }
+        },
+        {
+            key: "prepareUrl",
+            value: /** @inheritdoc */ function prepareUrl(url) {
+                var queryParameters = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
+                return (0, _core.prepareUrl)(url, queryParameters);
+            }
+        },
+        {
+            key: "processFormData",
+            value: /** @inheritdoc */ function processFormData(data, type) {
+                return (0, _core.processFormData)(data, type);
+            }
+        },
+        {
+            key: "processCall",
+            value: function processCall(url, options, apiType, apiName, revivers, operationId) {
+                var _this = this;
+                return _async_to_generator(function() {
+                    var response, asyncResponse, root, body, exception, origin, _options_metadata, metadataSignal, controller, loadedPlugins, _loadedPlugins, canStart, isCanceledBy, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, plugin, e, reviver, replyPlugins, parsedData, _iteratorNormalCompletion1, _didIteratorError1, _iteratorError1, _iterator1, _step1, pluginRunner, err;
+                    return _ts_generator(this, function(_state) {
+                        switch(_state.label){
+                            case 0:
+                                origin = options.headers.get('Origin');
+                                _state.label = 1;
+                            case 1:
+                                _state.trys.push([
+                                    1,
+                                    5,
+                                    ,
+                                    6
+                                ]);
+                                metadataSignal = (_options_metadata = options.metadata) === null || _options_metadata === void 0 ? void 0 : _options_metadata.signal;
+                                metadataSignal === null || metadataSignal === void 0 ? void 0 : metadataSignal.throwIfAborted();
+                                controller = new AbortController();
+                                options.signal = controller.signal;
+                                metadataSignal === null || metadataSignal === void 0 ? void 0 : metadataSignal.addEventListener('abort', function() {
+                                    return controller.abort();
+                                });
+                                loadedPlugins = [];
+                                if (_this.options.fetchPlugins) {
+                                    ;
+                                    (_loadedPlugins = loadedPlugins).push.apply(_loadedPlugins, _to_consumable_array(_this.options.fetchPlugins.map(function(plugin) {
+                                        return plugin.load({
+                                            url: url,
+                                            options: options,
+                                            fetchPlugins: loadedPlugins,
+                                            controller: controller,
+                                            apiClient: _this,
+                                            logger: _this.options.logger
+                                        });
+                                    })));
+                                }
+                                return [
+                                    4,
+                                    Promise.all(loadedPlugins.map(function(plugin) {
+                                        return !plugin.canStart || plugin.canStart();
+                                    }))
+                                ];
+                            case 2:
+                                canStart = _state.sent();
+                                isCanceledBy = canStart.indexOf(false);
+                                if (isCanceledBy >= 0) {
+                                    // One of the fetch plugins cancelled the execution of the call
+                                    asyncResponse = Promise.reject(new _core.CanceledCallError("Is canceled by the plugin ".concat(isCanceledBy), isCanceledBy, _this.options.fetchPlugins[isCanceledBy], {
+                                        apiName: apiName,
+                                        operationId: operationId,
+                                        url: url,
+                                        origin: origin
+                                    }));
+                                } else {
+                                    asyncResponse = fetch(url, options);
+                                }
+                                _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                                try {
+                                    for(_iterator = loadedPlugins[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                        plugin = _step.value;
+                                        asyncResponse = plugin.transform(asyncResponse);
+                                    }
+                                } catch (err) {
+                                    _didIteratorError = true;
+                                    _iteratorError = err;
+                                } finally{
+                                    try {
+                                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                            _iterator.return();
+                                        }
+                                    } finally{
+                                        if (_didIteratorError) {
+                                            throw _iteratorError;
+                                        }
+                                    }
+                                }
+                                return [
+                                    4,
+                                    asyncResponse
+                                ];
+                            case 3:
+                                response = _state.sent();
+                                return [
+                                    4,
+                                    response.text()
+                                ];
+                            case 4:
+                                body = _state.sent();
+                                return [
+                                    3,
+                                    6
+                                ];
+                            case 5:
+                                e = _state.sent();
+                                if (_instanceof(e, _core.CanceledCallError)) {
+                                    exception = e;
+                                } else {
+                                    exception = new _core.EmptyResponseError(e.message || 'Fail to Fetch', undefined, {
+                                        apiName: apiName,
+                                        operationId: operationId,
+                                        url: url,
+                                        origin: origin
+                                    });
+                                }
+                                return [
+                                    3,
+                                    6
+                                ];
+                            case 6:
+                                try {
+                                    root = body ? JSON.parse(body) : undefined;
+                                } catch (e) {
+                                    exception = new _core.ResponseJSONParseError(e.message || 'Fail to parse response body', response && response.status || 0, body, {
+                                        apiName: apiName,
+                                        operationId: operationId,
+                                        url: url,
+                                        origin: origin
+                                    });
+                                }
+                                // eslint-disable-next-line no-console
+                                reviver = (0, _core.getResponseReviver)(revivers, response, operationId, {
+                                    disableFallback: _this.options.disableFallback,
+                                    log: console.error
+                                });
+                                replyPlugins = _this.options.replyPlugins ? _this.options.replyPlugins.map(function(plugin) {
+                                    return plugin.load({
+                                        dictionaries: root && root.dictionaries,
+                                        response: response,
+                                        reviver: reviver,
+                                        apiType: apiType,
+                                        apiName: apiName,
+                                        exception: exception,
+                                        operationId: operationId,
+                                        url: url,
+                                        origin: origin,
+                                        logger: _this.options.logger
+                                    });
+                                }) : [];
+                                parsedData = root;
+                                _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+                                _state.label = 7;
+                            case 7:
+                                _state.trys.push([
+                                    7,
+                                    12,
+                                    13,
+                                    14
+                                ]);
+                                _iterator1 = replyPlugins[Symbol.iterator]();
+                                _state.label = 8;
+                            case 8:
+                                if (!!(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done)) return [
+                                    3,
+                                    11
+                                ];
+                                pluginRunner = _step1.value;
+                                return [
+                                    4,
+                                    pluginRunner.transform(parsedData)
+                                ];
+                            case 9:
+                                parsedData = _state.sent();
+                                _state.label = 10;
+                            case 10:
+                                _iteratorNormalCompletion1 = true;
+                                return [
+                                    3,
+                                    8
+                                ];
+                            case 11:
+                                return [
+                                    3,
+                                    14
+                                ];
+                            case 12:
+                                err = _state.sent();
+                                _didIteratorError1 = true;
+                                _iteratorError1 = err;
+                                return [
+                                    3,
+                                    14
+                                ];
+                            case 13:
+                                try {
+                                    if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                                        _iterator1.return();
+                                    }
+                                } finally{
+                                    if (_didIteratorError1) {
+                                        throw _iteratorError1;
+                                    }
+                                }
+                                return [
+                                    7
+                                ];
+                            case 14:
+                                if (exception) {
+                                    throw exception;
+                                }
+                                return [
+                                    2,
+                                    parsedData
+                                ];
+                        }
+                    });
+                })();
+            }
+        }
+    ]);
+    return ApiFetchClient;
+}();

package/cjs/fetch-plugin.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});