@api-client/core 0.19.10 → 0.19.11

package/build/src/amf/AmfMixin.js

@@ -1,1138 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/* eslint-disable @typescript-eslint/no-unused-vars */
-/**
-@license
-Copyright 2018 The Advanced REST client authors <arc@mulesoft.com>
-Licensed under the Apache License, Version 2.0 (the "License"); you may not
-use this file except in compliance with the License. You may obtain a copy of
-the License at
-http://www.apache.org/licenses/LICENSE-2.0
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
-WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
-License for the specific language governing permissions and limitations under
-the License.
-*/
-import { AmfModelExpander } from 'amf-json-ld-lib';
-import { AmfNamespace as ns } from './definitions/Namespace.js';
-export const findAmfType = Symbol('findAmfType');
-export const findReferenceObject = Symbol('findReferenceObject');
-export const getArrayItems = Symbol('getArrayItems');
-export const computeReferenceSecurity = Symbol('computeReferenceSecurity');
-/**
- * Common functions used by AMF components to compute AMF values.
- */
-export const AmfMixin = (superClass) => {
-    class AmfMixin extends superClass {
-        _amf;
-        __cachedKeys;
-        __lastSetValue;
-        get amf() {
-            return this._amf;
-        }
-        set amf(value) {
-            if (this._amf === value || this.__lastSetValue === value) {
-                return;
-            }
-            this.__lastSetValue = value;
-            const expanded = value ? this._expand(value) : undefined;
-            // Cached keys cannot be static as this element can be used in the sane
-            // document with different AMF models
-            this.__cachedKeys = {};
-            this._amf = expanded;
-            this._amfChanged(expanded);
-        }
-        /**
-         * This is an abstract method to be implemented by the components.
-         * If, instead, the component uses `amf` setter you must use `super.amf` to
-         * set the value.
-         * @param amf Current AMF model. Can be undefined.
-         */
-        _amfChanged(amf) {
-            // ...
-        }
-        /**
-         * Expands flattened AMF model
-         */
-        _expand(amf) {
-            return AmfModelExpander.expand(amf);
-        }
-        /**
-         * Returns compact model key for given value.
-         * @param property AMF original property
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Compact model property name or the same value if value not found in the context.
-         */
-        _getAmfKey(property, context) {
-            if (!property) {
-                return '';
-            }
-            let { amf } = this;
-            if (!amf && !context) {
-                return property;
-            }
-            if (Array.isArray(amf)) {
-                ;
-                [amf] = amf;
-            }
-            if (!this.__cachedKeys) {
-                this.__cachedKeys = {};
-            }
-            const ctx = (context || (amf && amf['@context']));
-            if (!ctx || !property) {
-                return property;
-            }
-            const cache = this.__cachedKeys;
-            if (property in cache) {
-                return cache[property];
-            }
-            property = String(property);
-            const hashIndex = property.indexOf('#');
-            const hashProperty = property.substring(0, hashIndex + 1);
-            const keys = Object.keys(ctx);
-            for (let i = 0, len = keys.length; i < len; i++) {
-                const k = keys[i];
-                if (ctx[k] === property) {
-                    cache[property] = k;
-                    return k;
-                }
-                if (hashIndex === -1 && property.indexOf(ctx[k]) === 0) {
-                    const result = property.replace(ctx[k], `${k}:`);
-                    cache[property] = result;
-                    return result;
-                }
-                if (ctx[k] === hashProperty) {
-                    const result = `${k}:${property.substring(hashIndex + 1)}`;
-                    cache[property] = result;
-                    return result;
-                }
-            }
-            return property;
-        }
-        /**
-         * Ensures that the model is AMF object.
-         *
-         * @param amf AMF json/ld model
-         * @returns The API spec
-         */
-        _ensureAmfModel(amf) {
-            if (!amf) {
-                return undefined;
-            }
-            if (Array.isArray(amf)) {
-                ;
-                [amf] = amf;
-            }
-            if (this._hasType(amf, ns.aml.vocabularies.document.Document)) {
-                return amf;
-            }
-            return undefined;
-        }
-        /**
-         * Ensures that the value is an array.
-         * It returns undefined when there's no value.
-         * It returns the same array if the value is already an array.
-         * It returns new array of the item is not an array.
-         *
-         * @param value An item to test
-         */
-        _ensureArray(value) {
-            if (!value) {
-                return undefined;
-            }
-            if (value instanceof Array) {
-                return value;
-            }
-            return [value];
-        }
-        /**
-         * Gets a single scalar value from a model.
-         * @param model Amf model to extract the value from.
-         * @param untrustedKey Model key to search for the value
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Value for key
-         */
-        _getValue(model, untrustedKey, context) {
-            const key = this._getAmfKey(untrustedKey, context);
-            if (!key) {
-                return undefined;
-            }
-            let data = model && model[key];
-            if (!data) {
-                // This includes "undefined", "false", "null" and "0"
-                return data;
-            }
-            if (Array.isArray(data)) {
-                ;
-                [data] = data;
-            }
-            if (!data) {
-                return undefined;
-            }
-            const type = typeof data;
-            if (['string', 'number', 'boolean', 'undefined'].includes(type)) {
-                return data;
-            }
-            return data['@value'];
-        }
-        /**
-         * Gets values from a model as an array of `@value` properties.
-         * @param model Amf model to extract the value from.
-         * @param untrustedKey Model key to search for the value
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns The value for key
-         */
-        _getValueArray(model, untrustedKey, context) {
-            const key = this._getAmfKey(untrustedKey, context);
-            if (!key) {
-                return undefined;
-            }
-            const data = model && this._ensureArray(model[key]);
-            if (!Array.isArray(data)) {
-                return undefined;
-            }
-            return data.map((item) => item['@value'] || item);
-        }
-        /**
-         * Reads an array from the model.
-         *
-         * @param model Amf model to extract the value from.
-         * @param untrustedKey Model key to search for the value
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Value for the key
-         */
-        [getArrayItems](model, untrustedKey, context) {
-            const k = this._getAmfKey(untrustedKey, context);
-            if (!k) {
-                return undefined;
-            }
-            const data = model && this._ensureArray(model[k]);
-            if (!Array.isArray(data)) {
-                return undefined;
-            }
-            return data;
-        }
-        /**
-         * Reads the value of the `@id` property.
-         * @param model Amf model to extract the value from.
-         * @param untrustedKey Model key to search for the @id
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _getLinkValue(model, untrustedKey, context) {
-            const k = this._getAmfKey(untrustedKey, context);
-            if (!k) {
-                return undefined;
-            }
-            let data = model && model[k];
-            if (!data) {
-                return undefined;
-            }
-            if (Array.isArray(data)) {
-                ;
-                [data] = data;
-            }
-            if (!data) {
-                return undefined;
-            }
-            return data['@id'];
-        }
-        /**
-         * Reads the list of value for the `@id` property.
-         * @param model Amf model to extract the value from.
-         * @param untrustedKey Model key to search for the @id
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _getLinkValues(model, untrustedKey, context) {
-            const k = this._getAmfKey(untrustedKey, context);
-            if (!k) {
-                return undefined;
-            }
-            let data = (model && model[k]);
-            if (!data) {
-                return undefined;
-            }
-            if (!Array.isArray(data)) {
-                data = [data];
-            }
-            return data.map((i) => i['@id']);
-        }
-        /**
-         * Checks if a model has a type.
-         * @param model Model to test
-         * @param type Type name
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns True if model has a type.
-         */
-        _hasType(model, type, context) {
-            const types = this._ensureArray(model && model['@type']);
-            if (!types || !types.length) {
-                return false;
-            }
-            const key = this._getAmfKey(type, context);
-            for (const type of types) {
-                if (type === key) {
-                    return true;
-                }
-            }
-            return false;
-        }
-        /**
-         * Checks if a shape has a property.
-         * @param shape The shape to test
-         * @param untrustedKey Property name to test
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _hasProperty(shape, untrustedKey, context) {
-            const key = this._getAmfKey(untrustedKey, context);
-            return !!(shape && key && key in shape);
-        }
-        /**
-         * Computes array value of a property in a model (shape).
-         *
-         * @param shape AMF shape object
-         * @param untrustedKey Property name
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _computePropertyArray(shape, untrustedKey, context) {
-            if (!shape) {
-                return undefined;
-            }
-            const key = this._getAmfKey(untrustedKey, context);
-            if (!key) {
-                return undefined;
-            }
-            const data = this._ensureArray(shape && shape[key]);
-            if (!data || !Array.isArray(data)) {
-                return undefined;
-            }
-            return data;
-        }
-        /**
-         * Computes API version from the AMF model.
-         *
-         * @param amf
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _computeApiVersion(amf, context) {
-            const api = this._computeApi(amf);
-            if (!api) {
-                return undefined;
-            }
-            return this._getValue(api, ns.aml.vocabularies.core.version, context);
-        }
-        /**
-         * Computes model's `encodes` property.
-         *
-         * @param model AMF data model
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns List of encodes
-         */
-        _computeEncodes(model, context) {
-            if (!model) {
-                return undefined;
-            }
-            if (Array.isArray(model)) {
-                ;
-                [model] = model;
-            }
-            const key = this._getAmfKey(ns.aml.vocabularies.document.encodes, context);
-            if (!key) {
-                return undefined;
-            }
-            const data = model[key];
-            if (data) {
-                return Array.isArray(data) ? data[0] : data;
-            }
-            return undefined;
-        }
-        /**
-         * Computes list of declarations in the AMF api model.
-         *
-         * @param model AMF json/ld model for an API
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns List of declarations
-         */
-        _computeDeclares(model, context) {
-            if (!model) {
-                return undefined;
-            }
-            if (Array.isArray(model)) {
-                ;
-                [model] = model;
-            }
-            if (!model) {
-                return undefined;
-            }
-            const key = this._getAmfKey(ns.aml.vocabularies.document.declares, context);
-            if (!key) {
-                return undefined;
-            }
-            const data = this._ensureArray(model[key]);
-            return Array.isArray(data) ? data : undefined;
-        }
-        /**
-         * Computes list of references in the AMF api model.
-         *
-         * @param model AMF json/ld model for an API
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns List of declarations
-         */
-        _computeReferences(model, context) {
-            if (!model) {
-                return undefined;
-            }
-            if (Array.isArray(model)) {
-                ;
-                [model] = model;
-            }
-            if (!model) {
-                return undefined;
-            }
-            const key = this._getAmfKey(ns.aml.vocabularies.document.references, context);
-            if (!key) {
-                return undefined;
-            }
-            const data = this._ensureArray(model[key]);
-            return data instanceof Array ? data : undefined;
-        }
-        /**
-         * Computes AMF's `http://schema.org/WebAPI` model
-         *
-         * @param model AMF json/ld model for an API
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Web API declaration.
-         */
-        _computeWebApi(model, context) {
-            const enc = this._computeEncodes(model, context);
-            if (!enc) {
-                return undefined;
-            }
-            if (this._hasType(enc, ns.aml.vocabularies.apiContract.WebAPI, context)) {
-                return enc;
-            }
-            return undefined;
-        }
-        /**
-         * Computes AMF's `http://schema.org/API` model
-         *
-         * @param model AMF json/ld model for an API
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns  API declaration.
-         */
-        _computeApi(model, context) {
-            const enc = this._computeEncodes(model, context);
-            if (!enc) {
-                return undefined;
-            }
-            if (this._isAPI(model, context) || this._isWebAPI(model, context) || this._isAsyncAPI(model, context)) {
-                return enc;
-            }
-            return undefined;
-        }
-        /**
-         * Returns whether an AMF node is a WebAPI node
-         *
-         * @param model  AMF json/ld model for an API
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _isWebAPI(model, context) {
-            const enc = this._computeEncodes(model, context);
-            if (!enc) {
-                return false;
-            }
-            return this._hasType(enc, ns.aml.vocabularies.apiContract.WebAPI, context);
-        }
-        /**
-         * Returns whether an AMF node is an AsyncAPI node
-         *
-         * @param model  AMF json/ld model for an API
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _isAsyncAPI(model, context) {
-            const enc = this._computeEncodes(model, context);
-            if (!enc) {
-                return false;
-            }
-            return this._hasType(enc, ns.aml.vocabularies.apiContract.AsyncAPI, context);
-        }
-        /**
-         * Returns whether an AMF node is an API node
-         *
-         * @param model  AMF json/ld model for an API
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _isAPI(model, context) {
-            const enc = this._computeEncodes(model, context);
-            if (!enc) {
-                return false;
-            }
-            return this._hasType(enc, ns.aml.vocabularies.apiContract.API, context);
-        }
-        /**
-         * Determines whether a partial model is valid for reading servers from
-         * Current valid values:
-         * - Operation
-         * - Endpoint
-         * @param model The partial model to evaluate
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Whether the model's type is part of the array of valid node types from which
-         * to read servers
-         * @private
-         */
-        _isValidServerPartial(model, context) {
-            if (Array.isArray(model)) {
-                ;
-                [model] = model;
-            }
-            if (!model) {
-                return false;
-            }
-            const oKey = ns.aml.vocabularies.apiContract.Operation;
-            const eKey = ns.aml.vocabularies.apiContract.EndPoint;
-            const allowedPartialModelTypes = [this._getAmfKey(oKey, context), this._getAmfKey(eKey, context)];
-            const types = model['@type'];
-            for (const type of types) {
-                if (allowedPartialModelTypes.indexOf(type) !== -1) {
-                    return true;
-                }
-            }
-            return false;
-        }
-        /**
-         * @param options Server query options
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns List of servers for method, if defined, or endpoint, if defined, or root level
-         */
-        _getServers(options = {}, context) {
-            const { endpointId, methodId } = options;
-            const { amf } = this;
-            if (!amf) {
-                return undefined;
-            }
-            let api = this._computeApi(amf, context);
-            if (Array.isArray(api)) {
-                ;
-                [api] = api;
-            }
-            if (!api) {
-                if (this._isValidServerPartial(amf, context)) {
-                    api = amf;
-                }
-                else {
-                    return undefined;
-                }
-            }
-            const serverKey = this._getAmfKey(ns.aml.vocabularies.apiContract.server, context);
-            const getRootServers = () => this[getArrayItems](api, serverKey, context);
-            const getEndpointServers = () => {
-                const endpoint = this._computeEndpointModel(api, endpointId, context);
-                const servers = this[getArrayItems](endpoint, serverKey, context);
-                if (servers) {
-                    return servers;
-                }
-                return getRootServers();
-            };
-            const getMethodServers = () => {
-                const method = this._computeMethodModel(api, methodId, context);
-                const servers = this[getArrayItems](method, serverKey, context);
-                if (servers) {
-                    return servers;
-                }
-                return getEndpointServers();
-            };
-            if (methodId) {
-                return getMethodServers();
-            }
-            if (endpointId) {
-                return getEndpointServers();
-            }
-            return getRootServers();
-        }
-        /**
-         * Computes value for the `expects` property.
-         *
-         * @param method AMF `supportedOperation` model
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _computeExpects(method, context) {
-            const operationKey = ns.aml.vocabularies.apiContract.Operation;
-            const expectsKey = ns.aml.vocabularies.apiContract.expects;
-            if (this._hasType(method, operationKey, context)) {
-                const key = this._getAmfKey(expectsKey, context);
-                const expects = this._ensureArray(method[key]);
-                if (expects) {
-                    return Array.isArray(expects) ? expects[0] : expects;
-                }
-            }
-            return undefined;
-        }
-        /**
-         * Computes list of endpoints from a WebApi model.
-         * @param webApi
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns An array of endpoints.
-         */
-        _computeEndpoints(webApi, context) {
-            if (!webApi) {
-                return [];
-            }
-            const endpointKey = ns.aml.vocabularies.apiContract.endpoint;
-            const key = this._getAmfKey(endpointKey, context);
-            return this._ensureArray(webApi[key]);
-        }
-        /**
-         * Computes model for an endpoint documentation.
-         *
-         * @param webApi Current value of `webApi` property
-         * @param id Selected shape ID
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns An endpoint definition
-         */
-        _computeEndpointModel(webApi, id, context) {
-            if (this._hasType(webApi, ns.aml.vocabularies.apiContract.EndPoint, context)) {
-                return webApi;
-            }
-            const endpoints = this._computeEndpoints(webApi, context);
-            if (!endpoints) {
-                return undefined;
-            }
-            return endpoints.find((item) => item['@id'] === id);
-        }
-        /**
-         * Computes method for the method documentation.
-         *
-         * @param webApi Current value of `webApi` property
-         * @param selected Selected shape
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns A method definition
-         */
-        _computeMethodModel(webApi, selected, context) {
-            const methods = this.__computeMethodsListForMethod(webApi, selected, context);
-            if (!methods) {
-                return undefined;
-            }
-            return methods.find((item) => item['@id'] === selected);
-        }
-        /**
-         * Computes an endpoint for a method.
-         * @param webApi The WebApi AMF model
-         * @param methodId Method id
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns An endpoint model of undefined.
-         */
-        _computeMethodEndpoint(webApi, methodId, context) {
-            if (!webApi || !methodId) {
-                return undefined;
-            }
-            if (this._hasType(webApi, ns.aml.vocabularies.apiContract.EndPoint, context)) {
-                return webApi;
-            }
-            const endpoints = this._computeEndpoints(webApi, context);
-            if (!endpoints) {
-                return undefined;
-            }
-            const opKey = this._getAmfKey(ns.aml.vocabularies.apiContract.supportedOperation, context);
-            for (let i = 0, len = endpoints.length; i < len; i++) {
-                const endpoint = endpoints[i];
-                let methods = endpoint[opKey];
-                if (!methods) {
-                    continue;
-                }
-                if (!Array.isArray(methods)) {
-                    methods = [methods];
-                }
-                for (let j = 0, jLen = methods.length; j < jLen; j++) {
-                    if (methods[j]['@id'] === methodId) {
-                        return endpoint;
-                    }
-                }
-            }
-            return undefined;
-        }
-        /**
-         * Computes a list of methods for an endpoint that contains a method with
-         * given id.
-         *
-         * @param webApi WebApi model
-         * @param methodId Method id.
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns A list of sibling methods or undefined.
-         */
-        __computeMethodsListForMethod(webApi, methodId, context) {
-            const endpoint = this._computeMethodEndpoint(webApi, methodId, context);
-            if (!endpoint) {
-                return undefined;
-            }
-            const opKey = this._getAmfKey(ns.aml.vocabularies.apiContract.supportedOperation, context);
-            return this._ensureArray(endpoint[opKey]);
-        }
-        /**
-         * Computes a type documentation model.
-         *
-         * @param declares Current value of `declares` property
-         * @param references Current value of `references` property
-         * @param selected Selected shape
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns A type definition
-         */
-        _computeType(declares, references, selected, context) {
-            if ((!declares && !references) || !selected) {
-                return undefined;
-            }
-            // In compact model some IDs are presented in long version (in source maps for examples)
-            // This must test for this case as well.
-            const compactId = selected.replace('amf://id', '');
-            let type = declares && declares.find((item) => item['@id'] === selected || item['@id'] === compactId);
-            if (!type && references && references.length) {
-                for (let i = 0, len = references.length; i < len; i++) {
-                    if (!this._hasType(references[i], ns.aml.vocabularies.document.Module)) {
-                        continue;
-                    }
-                    type = this._computeReferenceType(references[i], selected, context);
-                    if (type) {
-                        break;
-                    }
-                }
-            }
-            return type;
-        }
-        /**
-         * Finds a type in the model declares and references.
-         * @param domainId The domain id of the type (AMF's shape).
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns The AMF shape or undefined when not found.
-         */
-        [findAmfType](domainId, context) {
-            let { amf } = this;
-            if (!amf || !domainId) {
-                return undefined;
-            }
-            if (Array.isArray(amf)) {
-                ;
-                [amf] = amf;
-            }
-            const declares = this._computeDeclares(amf, context);
-            const compactId = domainId.replace('amf://id', '');
-            if (Array.isArray(declares)) {
-                const result = declares.find((item) => item['@id'] === domainId || item['@id'] === compactId);
-                if (result) {
-                    return result;
-                }
-            }
-            return this[findReferenceObject](domainId);
-        }
-        /**
-         * Searches for an object in model's references list.
-         * It does not resolve the object (useful for handling links correctly).
-         *
-         * @param domainId The domain of the object to find in the references.
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns The domain object or undefined.
-         */
-        [findReferenceObject](domainId, context) {
-            let { amf } = this;
-            if (Array.isArray(amf)) {
-                ;
-                [amf] = amf;
-            }
-            if (!amf) {
-                return undefined;
-            }
-            const references = this._computeReferences(amf, context);
-            if (!Array.isArray(references) || !references.length) {
-                return undefined;
-            }
-            const compactId = domainId.replace('amf://id', '');
-            for (let i = 0, len = references.length; i < len; i++) {
-                const ref = /** @type IAmfDocument */ references[i];
-                const declares = this._computeDeclares(ref, context);
-                if (!Array.isArray(declares)) {
-                    continue;
-                }
-                for (let j = 0, lenDecl = declares.length; j < lenDecl; j++) {
-                    let declared = declares[j];
-                    if (Array.isArray(declared)) {
-                        ;
-                        [declared] = declared;
-                    }
-                    if (declared['@id'] === domainId || declared['@id'] === compactId) {
-                        return declared;
-                    }
-                }
-            }
-            return undefined;
-        }
-        /**
-         * Computes a type model from a reference (library for example).
-         * @param reference AMF model for a reference to extract the data from
-         * @param selected Node ID to look for
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Type definition or undefined if not found.
-         */
-        _computeReferenceType(reference, selected, context) {
-            const declare = this._computeDeclares(reference, context);
-            if (!declare || !selected) {
-                return undefined;
-            }
-            // In compact model some IDs are presented in long version (in source maps for examples)
-            // This must test for this case as well.
-            const compactId = selected.replace('amf://id', '');
-            let result = declare.find((item) => {
-                if (Array.isArray(item)) {
-                    ;
-                    [item] = item;
-                }
-                return item['@id'] === selected || item['@id'] === compactId;
-            });
-            if (Array.isArray(result)) {
-                ;
-                [result] = result;
-            }
-            return this._resolve(result);
-        }
-        /**
-         * Computes a documentation model.
-         *
-         * @param webApi Current value of `webApi` property
-         * @param selected Selected shape
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        _computeDocument(webApi, selected, context) {
-            if (!webApi || !selected) {
-                return undefined;
-            }
-            const key = this._getAmfKey(ns.aml.vocabularies.core.documentation, context);
-            const docs = this._ensureArray(webApi[key]);
-            return docs && docs.find((item) => item['@id'] === selected);
-        }
-        /**
-         * Resolves a reference to an external fragment.
-         *
-         * @param shape A shape to resolve
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Resolved shape.
-         */
-        _resolve(shape, context) {
-            const { amf } = this;
-            if (typeof shape !== 'object' || Array.isArray(shape) || !amf || shape.__apicResolved) {
-                return shape;
-            }
-            let refKey = this._getAmfKey(ns.aml.vocabularies.document.linkTarget, context);
-            let refValue = this._ensureArray(shape[refKey]);
-            let refData;
-            if (refValue) {
-                const rk = refValue[0]['@id'];
-                if (rk === shape['@id']) {
-                    // recursive shape.
-                    shape.__apicResolved = true;
-                    return shape;
-                }
-                refData = this._getLinkTarget(amf, rk, context);
-            }
-            else {
-                refKey = this._getAmfKey(ns.aml.vocabularies.document.referenceId, context);
-                refValue = this._ensureArray(shape[refKey]);
-                if (refValue) {
-                    const rk = refValue[0]['@id'];
-                    if (rk === shape['@id']) {
-                        // recursive shape.
-                        shape.__apicResolved = true;
-                        return shape;
-                    }
-                    refData = this._getReferenceId(amf, rk, context);
-                }
-            }
-            if (!refData) {
-                this._resolveRecursive(shape);
-                shape.__apicResolved = true;
-                return shape;
-            }
-            const copy = { ...refData };
-            delete copy['@id'];
-            const types = copy['@type'];
-            if (types) {
-                if (shape['@type']) {
-                    shape['@type'] = shape['@type'].concat(types);
-                }
-                else {
-                    shape['@type'] = types;
-                }
-                delete copy['@type'];
-            }
-            this._mergeShapes(shape, copy, context);
-            shape.__apicResolved = true;
-            this._resolveRecursive(shape);
-            return shape;
-        }
-        /**
-         * @param amf References object to search in
-         * @param id Id of the shape to resolve
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Resolved shape for given reference, undefined otherwise
-         */
-        _getLinkTarget(amf, id, context) {
-            if (!amf || !id) {
-                return undefined;
-            }
-            let target;
-            const declares = this._computeDeclares(amf, context);
-            if (declares) {
-                target = this._findById(declares, id);
-            }
-            if (!target) {
-                const references = this._computeReferences(amf, context);
-                target = this._obtainShapeFromReferences(references, id, context);
-            }
-            if (!target) {
-                return undefined;
-            }
-            // Declaration may contain references
-            target = this._resolve(target);
-            return target;
-        }
-        /**
-         * Resolves the shape of a given reference.
-         *
-         * @param references References object to search in
-         * @param id Id of the shape to resolve
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Resolved shape for given reference, undefined otherwise
-         */
-        _obtainShapeFromReferences(references, id, context) {
-            if (!Array.isArray(references) || !references.length) {
-                return undefined;
-            }
-            let target;
-            for (const _ref of references) {
-                // case of fragment that encodes the shape
-                const encoded = this._computeEncodes(_ref, context);
-                if (encoded && encoded['@id'] === id) {
-                    target = encoded;
-                    break;
-                }
-                // case of a library which declares types
-                if (!encoded) {
-                    target = this._findById(this._computeDeclares(_ref, context), id);
-                    if (target)
-                        break;
-                }
-            }
-            return target;
-        }
-        /**
-         * Searches a node with a given ID in an array
-         *
-         * @param array Array to search for a given ID
-         * @param id Id to search for
-         * @returns Node with the given ID when found, undefined otherwise
-         */
-        _findById(array, id) {
-            if (!array)
-                return undefined;
-            let target;
-            for (const _current of array) {
-                if (_current && _current['@id'] === id) {
-                    target = _current;
-                    break;
-                }
-            }
-            return target;
-        }
-        _getReferenceId(amf, id, context) {
-            if (!amf || !id) {
-                return undefined;
-            }
-            const refs = this._computeReferences(amf, context);
-            if (!refs) {
-                return undefined;
-            }
-            for (const _ref of refs) {
-                const enc = this._computeEncodes(_ref, context);
-                if (enc) {
-                    if (enc['@id'] === id) {
-                        return enc;
-                    }
-                }
-            }
-            return undefined;
-        }
-        _resolveRecursive(shape, context) {
-            Object.keys(shape).forEach((key) => {
-                const currentShape = shape[key];
-                if (Array.isArray(currentShape)) {
-                    for (let i = 0, len = currentShape.length; i < len; i++) {
-                        currentShape[i] = this._resolve(currentShape[i]);
-                    }
-                }
-                else if (typeof currentShape === 'object') {
-                    shape[key] = this._resolve(currentShape, context);
-                }
-            });
-        }
-        /**
-         * Merge two shapes together. If the resulting shape has one of the "special merge" keys,
-         * then the special merge function for that key will be used to match that property
-         * @param shapeA AMF node
-         * @param shapeB AMF node
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Merged AMF node
-         */
-        _mergeShapes(shapeA, shapeB, context) {
-            const merged = { ...shapeA, ...shapeB };
-            const specialMerges = [
-                {
-                    key: this._getAmfKey(ns.aml.vocabularies.docSourceMaps.sources, context),
-                    merger: this._mergeSourceMapsSources.bind(this),
-                },
-            ];
-            specialMerges.forEach(({ key, merger }) => {
-                if (this._hasProperty(merged, key, context)) {
-                    merged[key] = merger(shapeA, shapeB, context);
-                }
-            });
-            return Object.assign(shapeA, merged);
-        }
-        /**
-         * Obtains source map sources value from two shapes and returns the merged result
-         * If neither shape has a sources node, then an empty object will be returned.
-         * Result is wrapped in an array as per AMF model standard
-         * @param shapeA AMF node
-         * @param shapeB AMF node
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Empty object or resulting merge, wrapped in an array
-         * @private
-         */
-        _mergeSourceMapsSources(shapeA, shapeB, context) {
-            const sourcesKey = this._getAmfKey(ns.aml.vocabularies.docSourceMaps.sources, context);
-            let aSources = shapeA[sourcesKey] || {};
-            if (Array.isArray(aSources)) {
-                aSources = aSources[0];
-            }
-            let bSources = shapeB[sourcesKey] || {};
-            if (Array.isArray(bSources)) {
-                bSources = bSources[0];
-            }
-            return [Object.assign(aSources, bSources)];
-        }
-        /**
-         * Expands the key property from compacted mode to full mode.
-         * @param value The value to process
-         * @returns The expanded value.
-         */
-        _expandKey(value, context) {
-            let { amf } = this;
-            if (!value || typeof value !== 'string' || (!amf && !context)) {
-                return value;
-            }
-            if (Array.isArray(amf)) {
-                ;
-                [amf] = amf;
-            }
-            const ctx = context || (amf && amf['@context']);
-            if (!ctx) {
-                return value;
-            }
-            const [root, key] = value.split(':');
-            if (!root || !key) {
-                return value;
-            }
-            const prefix = ctx[root];
-            if (!prefix) {
-                return value;
-            }
-            return `${prefix}${key}`;
-        }
-        /**
-         * Computes a security model from a reference (library for example).
-         * @param domainId Domain id of the security requirement to find.
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Type definition or undefined if not found.
-         */
-        findSecurityScheme(domainId, context) {
-            const { amf } = this;
-            const declares = this._computeDeclares(amf, context);
-            let result;
-            if (declares) {
-                result = declares.find((item) => item['@id'] === domainId);
-            }
-            if (result) {
-                result = this._resolve(result);
-                return result;
-            }
-            const references = this._computeReferences(amf, context);
-            if (Array.isArray(references) && references.length) {
-                for (const ref of references) {
-                    if (this._hasType(ref, ns.aml.vocabularies.document.Module, context)) {
-                        result = this[computeReferenceSecurity](ref, domainId, context);
-                        if (result) {
-                            result = this._resolve(result);
-                            return result;
-                        }
-                    }
-                }
-            }
-            return undefined;
-        }
-        /**
-         * Computes a security model from a reference (library for example).
-         * @param reference AMF model for a reference to extract the data from
-         * @param selected Node ID to look for
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         * @returns Type definition or undefined if not found.
-         */
-        [computeReferenceSecurity](reference, selected, context) {
-            const declare = this._computeDeclares(reference, context);
-            if (!declare) {
-                return undefined;
-            }
-            let result = declare.find((item) => {
-                let declared = item;
-                if (Array.isArray(declared)) {
-                    ;
-                    [declared] = declared;
-                }
-                return declared['@id'] === selected;
-            });
-            if (Array.isArray(result)) {
-                ;
-                [result] = result;
-            }
-            return this._resolve(result);
-        }
-        /**
-         * Collects domain objects by a domain type.
-         * @param source The element to search for declare/encoded objects.
-         * @param type The domain type
-         * @param context A context to use. If not set, it looks for the context of the passed model
-         */
-        getByType(source, type, context) {
-            if (!source) {
-                return [];
-            }
-            let result = [];
-            const declares = this._computeDeclares(source);
-            const key = this._getAmfKey(type, context);
-            if (declares && declares.length) {
-                declares.forEach((declared) => {
-                    if (this._hasType(declared, key)) {
-                        result.push(declared);
-                    }
-                });
-            }
-            const references = this._computeReferences(source);
-            if (Array.isArray(references) && references.length) {
-                for (const ref of references) {
-                    if (this._hasType(ref, ns.aml.vocabularies.document.Module)) {
-                        const items = this.getByType(ref, type, context);
-                        if (items.length) {
-                            result = result.concat(items);
-                        }
-                    }
-                }
-            }
-            return result;
-        }
-    }
-    return AmfMixin;
-};
-//# sourceMappingURL=AmfMixin.js.map